jQuery EasyUI Formular-Plugin -Combo

jQuery EasyUI 插件jQuery EasyUI Plugins

Erbt von $.fn.validatebox.defaults. Überschreiben Sie die Standardwerte über $.fn.combo.defaults.

Combo zeigt ein editierbares Textfeld und ein Dropdown-Panel auf einer HTML-Seite an. Es ist die Basiskomponente zum Erstellen anderer komplexer Combo-Komponenten (wie: combobox, combotree, combogrid usw.).

Abhängigkeiten

  • validatebox
  • panel

Nutzung

Combo kann mit JavaScript aus einem <select>- oder <input>-Element erstellt werden. Bitte beachten Sie, dass das Erstellen eines Combos aus Markup nicht gültig ist.

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

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

Eigenschaften

Diese Eigenschaften erben von validatebox. Die folgenden sind die hinzugefügten Eigenschaften für Combo.

Name Type Beschreibung Standardwert
width number Die Breite der Komponente. auto
height number Die Höhe der Komponente. Diese Eigenschaft ist seit Version 1.3.2 verfügbar. 22
panelWidth number Die Breite des Dropdown-Panels. null
panelHeight number Die Höhe des Dropdown-Panels. 200
multiple boolesch Legt fest, ob Mehrfachauswahl unterstützt wird. false
selectOnNavigation boolesch Legt fest, ob ein Element ausgewählt werden soll, wenn Elemente per Tastatur navigiert werden. Diese Eigenschaft ist seit Version 1.3.3 verfügbar. wahr
separator string Das Trennzeichen für Text, wenn Mehrfachauswahl aktiviert ist. ,
editable boolesch Legt fest, ob der Benutzer Text direkt in das Textfeld eingeben kann. wahr
disabled boolesch Legt fest, ob das Textfeld deaktiviert ist. false
readonly boolesch Legt fest, ob die Komponente schreibgeschützt ist. Diese Eigenschaft ist seit Version 1.3.3 verfügbar. false
hasDownArrow boolesch Legt fest, ob die Schaltfläche mit dem Abwärtspfeil angezeigt werden soll. wahr
value string Standardwert.
delay number Verzögert die Suche ab dem letzten Tasteneingabe-Ereignis. 200
keyHandler Objekt Die Funktion, die aufgerufen wird, wenn der Benutzer eine Taste drückt. Der standardmäßige keyHandler ist wie folgt definiert:
keyHandler: {
    up: function(){},
    down: function(){},
    enter: function(){},
    query: function(q){}
}

Ereignisse

Name Parameters Beschreibung
onShowPanel none Wird ausgelöst, wenn das Drop-down-Panel angezeigt wird.
onHidePanel none Wird ausgelöst, wenn das Drop-down-Panel ausgeblendet wird.
onChange newValue, oldValue Wird ausgelöst, wenn sich der Wert des Textfelds ändert.

Methoden

Diese Methoden erben von validatebox. Im Folgenden sind die hinzugefügten Methoden für combo aufgeführt.

Name Parameters Beschreibung
options none Gibt das Optionsobjekt zurück.
panel none Gibt das Drop-down-Panel-Objekt zurück.
textbox none Gibt das Textfeldobjekt zurück.
destroy none Zerstört die Komponente.
resize width Passt die Breite der Komponente an.
showPanel none Zeigt das Drop-down-Panel an.
hidePanel none Blendet das Drop-down-Panel aus.
disable none Deaktiviert die Komponente.
enable none Aktiviert die Komponente.
readonly mode Aktiviert/deaktiviert den Nur-Lese-Modus. Diese Methode ist seit Version 1.3.3 verfügbar.
Anwendungsbeispiel:
$('#cc').combo('readonly');        // enable readonly mode
$('#cc').combo('readonly', true);    // enable readonly mode
$('#cc').combo('readonly', false);    // disable readonly mode
validate none Validiert den Eingabewert.
isValid none Gibt das Validierungsergebnis zurück.
clear none Löscht den Wert der Komponente.
Zurücksetzen none Setzt den Wert der Komponente zurück. Diese Methode ist seit Version 1.3.2 verfügbar.
getText none Ruft den Eingabetext ab.
setText none Legt den Textwert fest.
getValues none Ruft das Array der Komponentenwerte ab.
setValues none Legt das Array der Komponentenwerte fest.
getValue none Ruft den Wert der Komponente ab.
setValue none Legt den Wert der Komponente fest.
jQuery EasyUI 插件jQuery EasyUI Plugins Weitere Erweiterungen