Combo Box

Die Combo Box erlaubt die Auswahl aus DropDown Listen. Diese können verschieden konfiguriert werden, wie z.B. mit der Möglichkeit der automatischen Vervollständigung.

In diesem Artikel lesen Sie folgende Inhalte: 

Combo Box Properties

Combo Box Funktionalitäten

Tipp! Hier sehen Sie mehr über die Komponente.

1. Combo Box Properties

Properties

Beschreibung

ID

Bezeichnung / Benamung der Combo Box

Color scheme

Initiale Farbschemen:

  • Normal: schwarz

  • Default: blau

  • Success: grün

  • Danger: rot

Konfiguriert in Color Schemes

CSS class

Elemente einer Gruppe/Klasse zuordnen, für die dann bestimmte Formatierungen gelten

Tab index

Sprungreihenfolge durch Tab Taste

Access

Zugriffsrechte auf Komponente

Key Column / Display

Key Column: Primärschlüssel des Datensatzes

Display: Spaltenwert- /inhalt, welcher im Drop Down der Combo Box angezeigt werden soll

  • Col value (einzelner Spaltenwert)

  • String Expression (kombinierte Angabe mehrerer Spaltenwerte)

  • hier z.B.: Id der Artikeluntergruppe - Artikelname

 TD_FT_ComboBox
  • Custom Expression (Java Script Custom Expression)

Display

  • Enable search → Sucheingabe als Vorfilter in Combo Box ermöglichen

  • Show clear button → Löschen der Sucheingabe möglich

 TD_FT_ComboBox2

Writeable

  • read only → Auswahl- / Bearbeitungsmöglichkeiten der ComboBox sind blockiert

Integraded label / Label

3 Auswahlmöglichkeiten:

  • Do not use → es wird kein Label angezeigt

  • Static → Label integriert in Combo Box Rahmen (hier: Artikelname)

 TD_FT_ComboBox3
  • Floating → Label wandert bei Klick / Auswahl in der Combo Box in den Rahmen der Komponente (hier: Artikelname)

 TD_FT_ComboBox4

Empty text

Anzeigetext, wenn keine Einstellungen bei Integraded label / Label getroffen sind (“Do not use”-Einstellung)

 TD_FT_ComboBox5

No data text

Anzeigetext, wenn keine passenden Daten zur Sucheingabe enthalten sind

 TD_FT_ComboBox6

Hint

Mouse Over Hinweis / Text

State storing / Session variable

 

  • No state storing

  • Save state in page → Zustand / Auswahl der Combo Box für Seite speichern

  • Save state in session → Zustand / Auswahl der Combo Box für die ganze Session speichern

2. Combo Box Funktionalitäten 

Events

Event

Beschreibung

selectionChanged

This event fires when the selection was changed anyhow.

changedByUser

This event fires when the selection was changed by the user.

enterKey

This event fires when the enter key was pressed.

Actions

Kategorisierung

Action

Beschreibung

State

enable()

Enable the combo box.

disable()

Disable the combo box.

setEnabled(enabled)

Enable/disable the combo box.
enabled: Flag to indicate enabled or disabled.

show()

Shows the combo box.

hide()

Hides the combo box.

setVisible(visible)

Show/hide the combo box.
visible: Flag to indicate shown or hidden.

writeable()

Make the combo box writeable.

readonly()

Make the combo box read-only.

setReadOnly(readOnly)

Set the combo box to read-only/writeable.
readOnly: Flag to indicate read-only or writeable.

focus()

Sets focus on the combo box.

Data

refresh()

Refresh

clearSelection()

Clear the selection.

selectValue(value)

Select a value of the combo box.
value: The value to select.

selectKey(key)

Select a key of the combo box.
key: The key to select.

selectFirst()

Select the first item of the combo box.

selectFirstIfEmpty()

Select the first item of the combo box if there is no selection.