DojoFilteringSelect

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'.
maxHeight
Eine ganze Zahl, die die maximale Höhe für die Dropdown-Liste dieses Widgets angibt.