Plugin de formulario de jQuery EasyUI -Numberbox (cuadro numérico)
Plugin de jQuery EasyUI
Extiende desde $.fn.validatebox.defaults. Sobrescribe los defaults predeterminados mediante $.fn.numberbox.defaults.
El cuadro numérico (numberbox) se utiliza para permitir que el usuario solo pueda ingresar valores numéricos. Puede convertir el elemento de entrada en diferentes tipos de entrada (por ejemplo: numérico, porcentaje, moneda, etc.). Más tipos de entrada se definen mediante las funciones 'formatter' y 'parser'.
Dependencias
- validatebox
Uso
Crear un numberbox (cuadro numérico) a partir del marcado.
<input type="text" class="easyui-numberbox" value="100" data-options="min:0,precision:2">
Crear un numberbox (cuadro numérico) usando JavaScript.
<input type="text" id="nn">
$('#nn').numberbox({
min:0,
precision:2
});
Propiedades
Las propiedades se extienden desde validatebox (cuadro de validación); a continuación se enumeran las propiedades agregadas para numberbox (cuadro numérico).
| Nombre | Tipo | Descripción | Valor predeterminado |
|---|---|---|---|
| disabled | boolean | Define si se deshabilita este campo. | false |
| value | number | Valor predeterminado. | |
| min | number | Valor mínimo permitido. | null |
| max | number | Valor máximo permitido. | null |
| precision | number | Precisión máxima mostrada después del punto decimal. | 0 |
| decimalSeparator | string | Carácter que separa la parte entera y la parte decimal del número. | . |
| groupSeparator | string | Carácter que separa los grupos de enteros. | |
| prefix | string | Cadena de prefijo. | |
| suffix | string | Cadena de sufijo. | |
| filter | function(e) | Define cómo filtrar las teclas presionadas. Devuelve true para aceptar el carácter de entrada. Esta propiedad está disponible a partir de la versión 1.3.3. | |
| formatter | function(value) | Función para formatear el valor del numberbox (cuadro numérico). Devuelve el valor de cadena que se muestra en el cuadro. | |
| parser | function(s) | Función para parsear la cadena. Devuelve el valor del numberbox (cuadro numérico). |
Eventos
| Nombre | Parámetros | Descripción |
|---|---|---|
| onChange | newValue,oldValue | Se activa cuando cambia el valor del campo. |
Métodos
Los métodos se extienden desde validatebox (cuadro de validación); a continuación se muestran los métodos agregados o sobrescritos para numberbox (cuadro numérico).
| Nombre | Parámetros | Descripción |
|---|---|---|
| options | none | Devuelve el objeto de opciones (options). |
| destroy | none | Destruye el objeto numberbox (cuadro numérico). |
| disable | none | Deshabilita este campo. |
| enable | none | Habilita este campo. |
| fix | none | Fija el valor a un valor válido. |
| setValue | none | Establece el valor del numberbox (cuadro numérico). Ejemplo de código:
$('#nn').numberbox('setValue', 206.12);
|
| getValue | none | Obtiene el valor del numberbox (cuadro numérico). Ejemplo de código:
var v = $('#nn').numberbox('getValue');
alert(v);
|
| clear | none | Limpia el valor del numberbox (cuadro numérico). |
| reset | none | Restablece el valor del numberbox (cuadro numérico). Este método está disponible a partir de la versión 1.3.2. |
Plugin de jQuery EasyUI Otras extensiones