Criterios
Un criterio es una entrada de una pantalla: obtiene un valor del usuario y lo envía al servidor. Su atributo component elige el
tipo de entrada y el resto de atributos (etiqueta, texto de ayuda, tamaño, validación...) valen para todos. Debajo está el criterio
real del cliente React de AWE con los atributos que comparten: cámbialos y el XML de debajo se actualiza. Escribe también en él: es un campo real.
<criteria id="demo" component="text" label="Customer" />
- Atributos
- Eventos y acciones
- Referencia completa
Los controles de arriba escriben estos atributos. La referencia lista todos los atributos, con su tipo y valor por defecto. Atributos en la referencia XSD
| Atributo | Control | Valores |
|---|---|---|
component | Componente | textselectcheckbox |
label | Etiqueta | text |
placeholder | Texto de ayuda | text |
icon | Icono | lucide:userlucide:maillucide:searchlucide:calendar |
size | Tamaño | smlg |
validation | Obligatorio | true / false |
readonly | Solo lectura | true / false |
| Acción (type) | Qué hace |
|---|---|
reset | Vacía el valor del criterio. |
restore | Devuelve el criterio a su valor inicial. |
validate | Ejecuta la validación del criterio (obligatorio, formatos) y muestra su error. |
set-invalid | Marca el criterio como inválido con el mensaje de la acción. |
set-valid | Borra el error de validación del criterio. |
copy-criterion-value-clipboard | Copia el valor del criterio al portapapeles. |
Tipos de criterios
Cada familia tiene su propia página, con un área de pruebas que cambia entre sus tipos:
- Entradas de texto:
text,password,textarea,markdown-editor,text-viewycolor. - Números y fechas:
numeric,date,date-range,timeyfiltered-calendar. - Selectores y sugerencias:
select,select-multiple,suggest,suggest-multipleypicklist. - Casilla y radio:
radio,button-radio,checkbox(también como interruptor) ybutton-checkbox. - Subida de archivos:
uploader.
hidden no es visible, así que no tiene área de pruebas: lleva un valor al servidor sin mostrarlo. La referencia de criterios describe todos los tipos.
Recetas
Un campo habitual, dibujado por el mismo componente. Las demás recetas están en la página de cada familia.
Campo obligatorio con icono
validation="required" hace obligatorio el campo y la etiqueta lo indica. El placeholder dice qué escribir y el icon va delante de la entrada.
<criteria id="email" component="text" label="Correo" placeholder="nombre@empresa.com" icon="lucide:mail" validation="required" />
Eventos y acciones
Un criterio no tiene un evento propio al que escuchar: cada cambio de su valor comprueba las dependencias cuyo
dependency-element lo nombra, y pulsar Intro en un campo de texto ejecuta el botón submit de su ventana. Las acciones
que actúan sobre criterios:
| Acción | Descripción |
|---|---|
reset | Vacía el valor del criterio |
restore | Devuelve el criterio a su valor inicial |
validate | Ejecuta la validación del criterio y muestra su error |
set-invalid | Marca el criterio como inválido con el mensaje de la acción |
set-valid | Borra el error de validación del criterio |
copy-criterion-value-clipboard | Copia el valor del criterio al portapapeles |
Más
- Documentación completa de los criterios: todos los tipos, atributos, validaciones y ejemplos.
- Referencia XSD del elemento
criteria.