Campos
El marco webforJ soporta once tipos de componentes de campo, incluyendo cuatro campos enmascarados, cada uno con diferentes comportamientos e implementaciones que se adaptan a diversas necesidades de entrada. Aunque cada uno de estos componentes tiene variaciones en sus implementaciones, este artículo describe las propiedades compartidas entre todas las clases de campos.
Esta sección describe características comunes de varios componentes de campo en webforJ, y no es en sí misma una clase que pueda ser instanciada y utilizada.
Propiedades compartidas de los campos
Etiqueta
Una etiqueta de campo es un texto o título descriptivo que está asociado con el campo y que puede ser definido en el constructor o utilizando el método setLabel(). Las etiquetas proporcionan una breve explicación o indicación para ayudar a los usuarios a entender el propósito o la entrada esperada para ese campo en particular. Las etiquetas de campo son importantes para la usabilidad y juegan un papel crucial en la accesibilidad, ya que permiten que los lectores de pantalla y las tecnologías asistivas brinden información precisa y faciliten la navegación por teclado.
Texto de ayuda
Cada campo puede mostrar texto de ayuda debajo de la entrada utilizando el método setHelperText(). Este texto de ayuda ofrece contexto adicional o explicaciones sobre las entradas disponibles, asegurando que los usuarios tengan la información necesaria para realizar selecciones informadas.
Requerido
Puedes llamar al método setRequired(true) para exigir que los usuarios proporcionen un valor antes de enviar un formulario. Esta propiedad funciona en conjunto con la etiqueta del campo, proporcionando una indicación visual de que un campo es necesario. Esta señal visual ayuda a las personas a completar formularios de manera precisa.
Los componentes de campo contienen validación visual incorporada para notificar a los usuarios cuando un campo requerido está vacío o si un usuario ha eliminado un valor.
Comprobación ortográfica
Al usar setSpellCheck(true), puedes permitir que el navegador o el agente de usuario verifiquen la ortografía del texto ingresado por el usuario e identifiquen errores.
Prefijo y sufijo
Los slots proporcionan opciones flexibles para mejorar la capacidad de los componentes de campo. Puedes tener íconos, etiquetas, spinners de carga, capacidad de limpiar/restablecer, fotos de avatar/perfil y otros componentes beneficiosos anidados dentro de un campo para aclarar aún más el significado previsto para los usuarios. Los campos tienen dos slots: el slot prefijo y el slot sufijo. Utiliza los métodos setPrefixComponent() y setSuffixComponent() para insertar varios componentes antes y después de la opción mostrada dentro de un campo. Aquí hay un ejemplo usando el campo TextField:
TextField textField = new TextField();
textField.setPrefixComponent(TablerIcon.create("box"));
textField.setSuffixComponent(TablerIcon.create("box"));
Estilo
Debido a que todos los componentes de campo están construidos a partir de un componente web singular, todos comparten los siguientes Shadow Parts y valores de propiedades CSS
Temas
Campos enmascarados
4 artículos
ColorField
A component that provides a default browser-based color picker, allowing users to select a color from an input field.
DateField
A component that provides a default browser-based date picker for selecting a date through an input field.
DateTimeField
A component that provides a default browser-based date and time picker for selecting both date and time through a single input field.
NumberField
A component that provides a default browser-based input field for entering numeric values, with built-in controls for incrementing or decrementing the value.
PasswordField
A single-line input component for securely entering and masking password data.
TextField
A single-line input component for entering and editing text data.
TimeField
A component that provides a default browser-based time picker for selecting a time value through an input field.
