jQuery EasyUI Plugin de formulario -Combo combinado

jQuery EasyUI 插件jQuery EasyUI Plugin

Extendido desde $.fn.validatebox.defaults. Se pueden sobrescribir los defaults predeterminados mediante $.fn.combo.defaults.

El combo es un campo de texto editable y un panel desplegable que se muestra en una página HTML. Es el componente base para crear otros componentes combinados complejos (como combobox, combotree, combogrid, etc.).

Dependencias

  • validatebox
  • panel

Uso

El combo se puede crear mediante JavaScript a partir de elementos <select> o <input>. Tenga en cuenta que crear un combo desde el marcado no es válido.

<input id="cc" value="001">

$('#cc').combo({
    required:true,
    multiple:true
});

Propiedades

Estas propiedades extienden el validatebox. A continuación se muestran las propiedades añadidas para el combo.

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
panelWidth number El ancho del panel desplegable. null
panelHeight number La altura del panel desplegable. 200
multiple boolean Define si se admite la selección múltiple. false
selectOnNavigation boolean Define si se selecciona el elemento al navegar por los elementos con el teclado. Esta propiedad está disponible desde la versión 1.3.3. true
separator string El separador de texto para la selección múltiple. ,
editable boolean Define si el usuario puede escribir texto directamente en el campo de texto. true
disabled boolean Define si se deshabilita el campo de texto. false
readonly boolean Define si el componente es de solo lectura. Esta propiedad está disponible desde la versión 1.3.3. false
hasDownArrow boolean Define si se muestra el botón de flecha hacia abajo. true
value string Valor por defecto.
delay number Realiza la búsqueda con retraso desde el último evento de entrada de tecla. 200
keyHandler object La función que se llama cuando el usuario pulsa una tecla. El keyHandler predeterminado se define de la siguiente manera:
keyHandler: {
    up: function(){},
    down: function(){},
    enter: function(){},
    query: function(q){}
}

Eventos

Nombre Parámetros Descripción
onShowPanel none Se dispara cuando se muestra el panel desplegable.
onHidePanel none Se dispara cuando se oculta el panel desplegable.
onChange newValue, oldValue Se dispara cuando cambia el valor del campo de texto.

Métodos

Estos métodos extienden el validatebox. A continuación se muestran los métodos añadidos para el combo.

Nombre Parámetros Descripción
options none Devuelve el objeto de opciones (options).
panel none Devuelve el objeto del panel desplegable.
textbox none Devuelve el objeto del campo de texto.
destroy none Destruye el componente.
resize width Ajusta el ancho del componente.
showPanel none Muestra el panel desplegable.
hidePanel none Oculta el panel desplegable.
disable none Deshabilita el componente.
enable none Habilita el componente.
readonly mode Habilita/deshabilita el modo de solo lectura. Este método está disponible desde la versión 1.3.3.
Ejemplo de uso:
$('#cc').combo('readonly');        // enable readonly mode
$('#cc').combo('readonly', true);    // enable readonly mode
$('#cc').combo('readonly', false);    // disable readonly mode
validate none Valida el valor ingresado.
isValid none Devuelve el resultado de la validación.
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.
getText none Obtiene el texto ingresado.
setText none Establece el valor de texto.
getValues none Obtiene el array de valores del componente.
setValues none Establece el array de valores del componente.
getValue none Obtiene el valor del componente.
setValue none Establece el valor del componente.
jQuery EasyUI 插件jQuery EasyUI Plugin Otras extensiones