jQuery EasyUI Complemento de formulario -Spinner (microajustador)


jQuery EasyUI 插件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.

jQuery EasyUI 插件Complementos de jQuery EasyUI Otras extensiones