NumberField

Abrir en ChatGPT

Sombra dwc-field 23.02

Java API

El componente NumberField acepta entradas numéricas y rechaza automáticamente los valores no válidos. Soporta límites mínimo y máximo, intervalos de paso y texto de marcador de posición.

Usando NumberField

Inheritance

This class is a Field component, and inherits its features and behaviors. For an overview of Field properties, events, and other important information, please refer to the Field documentation.

NumberField extiende la clase Field compartida, que proporciona características comunes en todos los componentes de campo. El siguiente ejemplo crea un NumberField con una etiqueta y texto de marcador de posición.

Mostrar Código

Java

Valor del campo

El componente NumberField almacena su valor como un Double, permitiendo un manejo preciso tanto de números enteros como de decimales.

Obteniendo el valor actual

Puedes recuperar el valor numérico ingresado por el usuario usando:

Double currentValue = numberField.getValue();

Estableciendo un nuevo valor

Para establecer el campo programáticamente:

numberField.setValue(42.5);

Si no se ha ingresado ningún valor y no se ha establecido un valor predeterminado, getValue() devolverá null.

sugerencia

Aunque el campo está diseñado para aceptar solo entradas numéricas válidas, ten en cuenta que el valor subyacente puede ser nulo. Siempre prueba si es nulo antes de usar el resultado.

Usos

El NumberField es mejor utilizado en situaciones donde capturar, mostrar o manipular datos numéricos es esencial para tu aplicación. Aquí hay algunos ejemplos de cuándo usar el NumberField:

1. Formularios de Entrada Numérica: Al diseñar formularios que requieren entradas numéricas, usar un NumberField simplifica el proceso de entrada para los usuarios. Esto es particularmente útil para aplicaciones que recolectan datos de usuarios o requieren valores numéricos.

2. Análisis de Datos y Cálculos: Un NumberField es particularmente valioso en aplicaciones que involucran análisis de datos, cálculos u operaciones matemáticas. Permiten a los usuarios ingresar o manipular valores numéricos con precisión.

3. Aplicaciones Financieras y de Presupuestos: Las aplicaciones que involucran cálculos financieros, presupuestos o seguimiento de gastos a menudo requieren entradas numéricas precisas. Un NumberField asegura la entrada correcta de cifras financieras.

4. Mediciones y Conversión de Unidades: En aplicaciones que manejan mediciones o conversiones de unidades, el NumberField es ideal para ingresar valores numéricos con unidades como longitud, peso o volumen.

Valor mínimo y máximo

Con el método setMin(), puedes especificar el valor mínimo aceptable en el campo numérico. Si un usuario ingresa un valor inferior a este umbral, el componente fallará la validación de restricciones y proporcionará una retroalimentación apropiada.

NumberField numberField = new NumberField();
numberField.setMin(0.0); // Mínimo permitido: 0.0

Por separado, el método setMax() te permite definir el valor máximo aceptable. Si un usuario ingresa un valor superior a este límite, la entrada será rechazada. Cuando se configuran tanto los valores mínimo como máximo, el máximo debe ser mayor o igual al mínimo.

numberField.setMax(100.0); // Máximo permitido: 100.0

En esta configuración, ingresar un valor como -5 o 150 sería inválido, mientras que los valores entre 0 y 100 son aceptados.

Granularidad

Puedes utilizar el método setStep() para especificar la granularidad a la que debe adherirse el valor al usar las teclas de flecha para modificar el valor. Esto incrementará o disminuirá el valor del componente por un cierto paso cada vez. Esto no aplica cuando un usuario ingresa un valor directamente, sino solo al interactuar con el NumberField usando las teclas de flecha.

Texto de marcador de posición

Puedes establecer texto de marcador de posición para el NumberField usando el método setPlaceholder(). El texto de marcador de posición se muestra cuando el campo está vacío, ayudando a indicar al usuario que ingrese una entrada apropiada en el NumberField.

Proporciona un contexto claro para la precisión

Si la entrada numérica se relaciona con una unidad de medida específica o tiene un contexto particular, proporciona una etiquetación clara o información adicional para guiar a los usuarios y asegurar una entrada precisa.

Mejores prácticas

Para asegurar una integración fluida y una experiencia óptima para el usuario, considera las siguientes mejores prácticas al utilizar el NumberField:

• Accesibilidad: Utiliza el componente NumberField con la accesibilidad en mente, adhiriéndote a estándares de accesibilidad como etiquetado adecuado, soporte de navegación por teclado y compatibilidad con tecnologías asistivas. Asegúrate de que los usuarios con discapacidades puedan interactuar con el NumberField de manera efectiva.

• Utiliza botones de incrementar/decrementar: Si es apropiado para tu aplicación, considera utilizar botones de incremento y decremento con el NumberField. Esto permite a los usuarios ajustar el valor numérico por un incremento o decremento específico con un solo clic.