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.

Vista previa en vivo

ClaroOscuro

Controles

Componente

Etiqueta

Texto de ayuda

Icono

∅Sin iconousermailsearchcalendar

Tamaño

Por defectoPequeñoGrande

Obligatorio

Solo lectura

XML

<criteria id="demo" component="text" label="Customer" />

Atributos

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

Eventos y acciones

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.

Referencia completa

• Documentación completa de este componente
• Referencia XSD del elemento

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-view y color.
• Números y fechas: numeric, date, date-range, time y filtered-calendar.
• Selectores y sugerencias: select, select-multiple, suggest, suggest-multiple y picklist.
• Casilla y radio: radio, button-radio, checkbox (también como interruptor) y button-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.