jQuery EasyUI Form Plugin -Combo

jQuery EasyUI 插件Plugins jQuery EasyUI

Hérite de $.fn.validatebox.defaults. Remplacez les valeurs par défaut via $.fn.combo.defaults.

Combo affiche une zone de texte modifiable et un panneau déroulant sur une page HTML. Il s'agit du composant de base pour créer d'autres composants combo complexes (tels que : combobox, combotree, combogrid, etc.).

Dépendances

  • validatebox
  • panel

Utilisation

Combo peut être créé à l'aide de JavaScript à partir d'un élément <select> ou <input>. Veuillez noter que la création d'un combo à partir du balisage n'est pas valide.

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

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

Propriétés

Ces propriétés héritent de validatebox. Voici les propriétés ajoutées pour combo.

Name Type Description Valeur par défaut
width nombre La largeur du composant. auto
height nombre La hauteur du composant. Cette propriété est disponible depuis la version 1.3.2. 22
panelWidth nombre La largeur du panneau déroulant. null
panelHeight nombre La hauteur du panneau déroulant. 200
multiple booléen Définit si la sélection multiple est prise en charge. false
selectOnNavigation booléen Définit s'il faut sélectionner un élément lors de la navigation entre les éléments via le clavier. Cette propriété est disponible depuis la version 1.3.3. vrai
separator string Le séparateur pour le texte lorsque la sélection multiple est activée. ,
editable booléen Définit si l'utilisateur peut saisir directement du texte dans le champ de texte. vrai
disabled booléen Définit si le champ de texte est désactivé. false
readonly booléen Définit si le composant est en lecture seule. Cette propriété est disponible depuis la version 1.3.3. false
hasDownArrow booléen Définit s'il faut afficher le bouton flèche vers le bas. vrai
value string Valeur par défaut.
delay nombre Retarder la recherche à partir du dernier événement de saisie au clavier. 200
keyHandler objet La fonction appelée lorsque l'utilisateur appuie sur une touche. Le keyHandler par défaut est défini comme suit :
keyHandler: {
    up: function(){},
    down: function(){},
    enter: function(){},
    query: function(q){}
}

Événements

Name Parameters Description
onShowPanel none Déclenché lorsque le panneau déroulant est affiché.
onHidePanel none Déclenché lorsque le panneau déroulant est masqué.
onChange newValue, oldValue Déclenché lorsque la valeur du champ de texte change.

Méthodes

Ces méthodes dérivent de validatebox. Voici les méthodes ajoutées pour combo.

Name Parameters Description
options none Renvoie l'objet options.
panel none Retourne l'objet du panneau déroulant.
textbox none Renvoie l'objet zone de texte.
destroy none Détruit le composant.
resize width Ajuste la largeur du composant.
showPanel none Affiche le panneau déroulant.
hidePanel none Masque le panneau déroulant.
disable none Désactive le composant.
enable none Active le composant.
readonly mode Active/désactive le mode lecture seule. Cette méthode est disponible depuis la version 1.3.3.
Exemple d'utilisation :
$('#cc').combo('readonly');        // enable readonly mode
$('#cc').combo('readonly', true);    // enable readonly mode
$('#cc').combo('readonly', false);    // disable readonly mode
validate none Valide la valeur d'entrée.
isValid none Retourne le résultat de la validation.
clear none Efface la valeur du composant.
réinitialiser none Réinitialise la valeur du composant. Cette méthode est disponible depuis la version 1.3.2.
getText none Obtient le texte saisi.
setText none Définit la valeur du texte.
getValues none Obtient le tableau des valeurs des composants.
setValues none Définit le tableau des valeurs des composants.
getValue none Obtient la valeur du composant.
setValue none Définit la valeur du composant.
jQuery EasyUI 插件Plugins jQuery EasyUI Autres extensions