Das Widget 'DojoFilteringSelect' definiert eine Schnittstelle, die ein Eingabefeld mit einer Dropdown-Liste enthält. Es akzeptiert eine Liste zulässiger Wertepaare, die sich aus zwei Arten von Text zusammensetzen. Bei der einen Textart handelt es sich um den Text, der im Eingabefeld angezeigt werden soll. Der andere Text ist der verdeckte Text, der übergeben werden soll. Sie können den Text auch eingeben und die teilweise übereinstimmenden Werte werden in einem Popup-Menü unter dem Feld mit dem Eingabetext angezeigt. Im Gegensatz zu einem DojoComboBox-Widget wird der Benutzertext ohne Entsprechung als Fehler markiert. Dieses Widget basiert auf der Definition für 'Dojo dijit.form.FilteringSelect'.
Eigenschaften
- name
- Eine Zeichenfolge, die bei der Übergabe des Formulars verwendet wird. Diese Eigenschaft entspricht dem Attribut 'name' von einfachen HTML-Elementen.
- nullable
- Ein boolescher Wert, der angibt, ob der Benutzer einen Wert in diesem Feld eingeben muss oder nicht.
- value
- Eine Zeichenfolge, die den verdeckten Wert des Eingabefeldes angibt.
- displayedValue
- Eine Zeichenfolge, die den angezeigten Wert im Eingabefeld angibt.
- data
- Ein Bereich für Werte eines beliebigen Typs. Diese Eigenschaft wird verwendet, um die Daten für dieses Widget anzugeben. Jede Dateneingabe kann ein Wörterverzeichnis oder ein Datensatz sein.
- idAttr
- Eine Zeichenfolge, die den Attributnamen in den Datenelementen angibt.
Die Zeichenfolge wird als ID des Datenelements behandelt.
- searchAttr
- Eine Zeichenfolge, die den Attributnamen in den Datenelementen angibt.
Sie wird während der Eingabe durch den Benutzer durchsucht.
- labelAttr
- Eine Zeichenfolge, die den Attributnamen in den Datenelementen angibt.
Sie wird in der Dropdown-Liste angezeigt.
- labelType
- Eine Zeichenfolge, die angibt, wie die Eigenschaft 'labelAttr' in den Datenelementen interpretiert werden soll. Sie kann "html" oder "text" lauten.
- placeholder
- Eine Zeichenfolge, die im Eingabefeld angezeigt wird, jedoch entfernt wird, sobald der Benutzer in das Feld klickt. Die Zeichenfolge wird im Feld erneut angezeigt, sobald es leer ist und der Benutzer es nicht bearbeitet.
- autoComplete
- Ein boolescher Wert, der angibt, ob, wenn ein Benutzer einen Teil einer Zeichenfolge eingibt und dann per Tabulatortaste das Eingabfeld verlässt, der erste Eintrag, der in der Dropdown-Liste angezeigt wird, automatisch in das Eingabefeld kopiert wird oder nicht.
- invalidMessage
- Eine Zeichenfolge, die die Nachricht angibt, die angezeigt werden soll, wenn der Wert ungültig ist.
- missingMessage
- Eine Zeichenfolge, die die Nachricht angibt, die angezeigt werden soll, wenn der Wert leer, das Feld aber erforderlich ist.
- labelBehavior
- Ein Stellvertreter, der für jeden Datensatz zum Generieren des zugehörigen zugeordneten 'label'-Attributs aufgerufen wird. Wenn diese Eigenschaft angegeben ist, überschreibt sie 'labelAttr'.