Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
controles:wedit [05/01/2020 19:44] pedro |
controles:wedit [26/03/2022 12:16] (actual) pedro [Ejemplo de uso] |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
====== wEdit ====== | ====== wEdit ====== | ||
Este control nos permite la introducción de datos en el AppWeb para que luego pueda ser enviado a nuestro CGI, puede ser Alfanumérico, Numérico, Contraseña, Email, Memo y Autocompletado. | Este control nos permite la introducción de datos en el AppWeb para que luego pueda ser enviado a nuestro CGI, puede ser Alfanumérico, Numérico, Contraseña, Email, Memo y Autocompletado. | ||
+ | |||
+ | Como Edit Memo el alto es dinámico para que quepa el texto. | ||
+ | |||
+ | Este control puede también funcionar como Date y Time, pero creemos que es mas interesante utilizar [[controles:wDatePicker]] y [[controles:wTimePicker]], que en el fondo heredan de wEdit pero añaden funcionalidades más visuales. | ||
Si es parte de un [[controles:wForm]] al hacer el submit, se utiliza la propiedad cName como parámetro que recibirá el CGI, si no se define esta propiedad se le asignara el [[propiedades:cId]]. | Si es parte de un [[controles:wForm]] al hacer el submit, se utiliza la propiedad cName como parámetro que recibirá el CGI, si no se define esta propiedad se le asignara el [[propiedades:cId]]. | ||
===== Ejemplo de uso ===== | ===== Ejemplo de uso ===== | ||
+ | |||
+ | {{url>https://samples.nefele.dev/wiki/wedit 100%,360px}} | ||
+ | |||
+ | ---- | ||
+ | |||
<Code:xailer linenums:1> | <Code:xailer linenums:1> | ||
WITH OBJECT WEdit():New(:WO) | WITH OBJECT WEdit():New(:WO) | ||
:cId := "departamento" | :cId := "departamento" | ||
- | :cTitle := "Departamento" | + | :cTitle := "Departamento (cTitle)" |
- | :cIcon := "lock" | + | :cHint := "Indique departamento (cHint)" |
- | :nLength := 10 | + | :cIcon := "folder_shared" |
:SetAutocomplete({"Comercial","Autoventa","Preventa","Postventa",; | :SetAutocomplete({"Comercial","Autoventa","Preventa","Postventa",; | ||
"Administración","Contabilidad","Recursos Humanos",; | "Administración","Contabilidad","Recursos Humanos",; | ||
Línea 19: | Línea 28: | ||
WITH OBJECT WEdit():New(:WO) | WITH OBJECT WEdit():New(:WO) | ||
:cId := "nombre" | :cId := "nombre" | ||
- | :cTitle := "Nombre" | + | :cTitle := "Nombre (cTitle)" |
:cIcon := "person" | :cIcon := "person" | ||
- | :nLength := 15 | + | :nLength := 25 |
:SetRequired() | :SetRequired() | ||
:Create() | :Create() | ||
Línea 29: | Línea 38: | ||
:cTitle := "Password" | :cTitle := "Password" | ||
:cIcon := "lock" | :cIcon := "lock" | ||
+ | :cHelp := "Recuerde usar siempre contraseñas seguras (cHelp)" | ||
:nLength := 10 | :nLength := 10 | ||
+ | :lSubmit := .T. | ||
:SetPassword() | :SetPassword() | ||
:SetRequired() | :SetRequired() | ||
Línea 35: | Línea 46: | ||
END WITH | END WITH | ||
</Code> | </Code> | ||
- | {{url>https://samples.nefele.dev/wedit 100%,300px}} | + | |
---- | ---- | ||
===== Propiedades ===== | ===== Propiedades ===== | ||
^Nombre ^Init ^Descripción ^Versión ^ | ^Nombre ^Init ^Descripción ^Versión ^ | ||
+ | |aAutoComplete | {""} | Lista de valores a buscar en caso de xc_Autocomplete (**1**) | 0.1| | ||
|[[propiedades:cClassId]] | edt | | 0.1| | |[[propiedades:cClassId]] | edt | | 0.1| | ||
- | |cIcon | | Icono junto al área de escritura, se puede elegir uno de la lista de [[https://materializecss.com/icons.html|Materialize]] | 0.1| | + | |[[propiedades:cIcon]] | | Icono junto al área de escritura, se puede elegir uno de la lista de [[https://materializecss.com/icons.html|Materialize]] | 0.1| |
|cName | | Nombre de la propiedad que recibe el CGI y que podrá leerse con [[ocgi:getcgivalue|oCGI:GetCgiValue]] | 0.1| | |cName | | Nombre de la propiedad que recibe el CGI y que podrá leerse con [[ocgi:getcgivalue|oCGI:GetCgiValue]] | 0.1| | ||
- | |[[contantes:nStyle para wEdit|nStyle]] | xc_Text | Estilo de la Caja de Texto (ver en [[contantes:nStyle para wEdit|constantes]]) | 0.1| | + | |cHelp | | Texto de Ayuda debajo del control | 0.1| |
- | |lAutoFocus | .f. | | 0.1| | + | |cHint | | Mensaje que aparece en el control cuando esta vació\\ Si está vacío pero existe cTitle, mostrará este último en su lugar | 0.1| |
+ | |cTitle | | Texto que aparecerá en la cabecera del control, si no existe cHint y no tiene el foco hace la función de cHint, al tomar el foco sube a su posición | 0.1 | ||
+ | |nLength | 0 | Longitud del campo 0 = indefinido si se indica una longitud no se dejarán introducir más que esos caracteres | 0.1| | ||
+ | |lAutoFocus | .f. | Fuerza a que sea el control que reciba el foco al cargar la página | 0.1| | ||
+ | |lAutoSelect | .t. | Selecciona el contenido del control al hacer click con el ratón | 0.1| | ||
+ | |lReadOnly | .f. | Activa el modo solo lectura | 0.1| | ||
|lRequired | .f. | Es un campo obligatorio | 0.1| | |lRequired | .f. | Es un campo obligatorio | 0.1| | ||
|lSubmit | .f. | Si es **.t.** un intro en este campo causa que se pulse sobre el botón submit | 0.1| | |lSubmit | .f. | Si es **.t.** un intro en este campo causa que se pulse sobre el botón submit | 0.1| | ||
- | |cHint | | Mensaje que aparece en el control cuando esta vacio y no tiene el foco | 0.1| | + | |lValidate | .f. | Fuerza la validación del tipo de dato (xc_Numeric y xc_Email) | 0.1| |
- | |cHelp | | Texto de Ayuda debajo del control | 0.1| | + | |cHelpMargin | -2px | Margen superior para el cHelp | 0.1| |
+ | |ccHelpWidth | initial | Anchura para el cHelp | 0.1| | ||
+ | |nMaxValue | | Valor máximo admitido | 0.1| | ||
+ | |nPreviewStyle | 1 | Valor por defecto para el [[preview]] del control | 0.1| | ||
+ | |nMinValue | | Valor mínimo admitido | 0.1| | ||
+ | |[[nefele:constantes#nStyle para wEdit|nStyle]] | xc_Text | Estilo de la Caja de Texto (ver en [[nefele:constantes#nStyle para wEdit|constantes]]) | 0.1| | ||
+ | |[[oMask]] | | Objeto para el manejo de pictures del control | 0.1| | ||
+ | |||
+ | |||
+ | 1.- Puede ser un array simple de elementos {"elem1","elem2",...}, | ||
+ | un array de array de elementos {{"elem1"},{"elem2"},...} que es lo que nos devuelve QueryArray, | ||
+ | o un array de array de Pares {{"elem1","imagen1"},{"elem2","imagen2"},...} | ||
+ | para incluir una imagen a la derecha de cada elemento | ||
+ | |||
+ | |||
+ | ===== Metodos ===== | ||
+ | ^Nombre ^Descripción ^Versión ^ | ||
+ | |SetNumeric | Define el control como Numérico | 0.1| | ||
+ | |SetPassword | Define el control como Password | 0.1| | ||
+ | |SetEmail | Define el control como Email | 0.1| | ||
+ | |SetMemo | Define el control como Memo | 0.1| | ||
+ | |SetText | Define el control como Texto | 0.1| | ||
+ | |SetAutocomplete(aAutoComplete)| Habilita el modo AutoCompletar y asigna el array de elementos (**1**) | 0.1| | ||
+ | |SetRequired | Asignación rapida de lRequired | 0.1| | ||
+ | |SetSubmit | Asignación rapida de lSubmit | 0.1| | ||
+ | |SetValidate | Asignación rapida de lValidate | 0.1| | ||
+ | |||
+ | ===== Hereda de... ===== | ||
+ | ====== wControl ====== | ||
+ | {{page>controles:wcontrol#propiedades}} | ||
+ | |||
+ | {{page>controles:wcontrol#metodos}} | ||
- | PROPERTY lValidate INIT .F. // Fuerza la validación del tipo de dato | ||
- | PROPERTY lReadOnly INIT .F. // solo lectura | + | {{ youtube>RmLM56p1B2M?large }} |
- | Property nLength Init 0 // Longitud del campo 0 = indefinido si se indica una longitud no se dejarán introducir más que esos caracteres | + | ~~DISCUSSION|Comentario wEdit~~ |
- | Property nMinValue Init 0 // Valor mínimo (solo xc_Numeric) | + | |
- | Property nMaxValue Init 9999999999999 // Valor máximo (solo xc_Numeric) | + | |
- | Property aAutoComplete Init {""} //Lista de valores a buscar en caso de xc_Autocomplete son pares de valores el 1º es el valor que devuelve al seleccionarlo y el 2º el que se muestra | + | |
- | |