jQuery EasyUI Complemento de formulario -Spinner (microajustador)
Complementos de jQuery EasyUI
Se extiende desde $.fn.validatebox.defaults. Sobrescribe los defaults por defecto a través de $.fn.spinner.defaults.
El microajustador (spinner) combina un cuadro de texto editable con dos pequeños botones, lo que permite al usuario elegir entre un rango de valores. Similar al cuadro combinado (combobox), el microajustador (spinner) permite al usuario introducir un valor, pero no tiene lista desplegable. El microajustador (spinner) es el componente base para crear otros componentes de microajustador (como numberspinner, timespinner, etc.).
Dependencias
- validatebox
Uso
El microajustador (spinner) debe crearse mediante JavaScript. No se permite crearlo a partir de marcado.
<input id="ss" value="2">
$('#ss').spinner({
required:true,
increment:10
});
Propiedades
Estas propiedades se extienden desde validatebox (cuadro de validación); a continuación se muestran las propiedades añadidas para el microajustador (spinner).
| Nombre | Tipo | Descripción | Valor por defecto |
|---|---|---|---|
| width | number | El ancho del componente. | auto |
| height | number | La altura del componente. Esta propiedad está disponible desde la versión 1.3.2. | 22 |
| value | string | Valor inicial. | |
| min | string | Valor mínimo permitido. | null |
| max | string | Valor máximo permitido. | null |
| increment | number | Valor de incremento al hacer clic en los botones del microajustador. | 1 |
| editable | boolean | Define si el usuario puede introducir valores directamente en el campo de texto. | true |
| disabled | boolean | Define si se deshabilita el campo de texto. | false |
| spin | function(down) | Función llamada cuando el usuario hace clic en los botones del microajustador. El parámetro 'down' indica si el usuario hizo clic en el botón de ajuste hacia abajo. |
Eventos
| Nombre | Parámetros | Descripción |
|---|---|---|
| onSpinUp | none | Se dispara cuando el usuario hace clic en el botón de ajuste hacia arriba. |
| onSpinDown | none | Se dispara cuando el usuario hace clic en el botón de ajuste hacia abajo. |
Métodos
Estos métodos se extienden desde validatebox (cuadro de validación); a continuación se muestran los métodos añadidos para el microajustador (spinner).
| Nombre | Parámetros | Descripción |
|---|---|---|
| options | none | Devuelve el objeto de opciones (options). |
| destroy | none | Destruye el componente microajustador (spinner). |
| resize | width | Restablece el ancho del componente. Sobrescribe el ancho inicial pasando el parámetro 'width'. Ejemplo de código:
$('#ss').spinner('resize'); // resize with original width
$('#ss').spinner('resize', 200); // resize with new width
|
| enable | none | Habilita el componente. |
| disable | none | Deshabilita el componente. |
| getValue | none | Obtiene el valor del componente. |
| setValue | value | Establece el valor del componente. |
| clear | none | Limpia el valor del componente. |
| reset | none | Restablece el valor del componente. Este método está disponible desde la versión 1.3.2. |
Complementos de jQuery EasyUI Otras extensiones