Select2tokenizer

(part of package 'Servoy Extra Components') Extends designtime/SolutionModel: JSWebComponent Extends runtime: RuntimeWebComponent

A Servoy Extra Component that provides a tokenized select input field with auto-complete and multi-selection capabilities.

This is a reference page; many components have detailed usage guides here.

Properties

allowNewEntries

When true, new entries can be added that are not present in the value list. Type: Boolean Default Value: false

---

clearSearchTextOnSelect

When true, the search text is cleared after an option is selected. Type: Boolean Default Value: false

---

closeOnSelect

When true, the dropdown closes after an option is selected. Type: Boolean Default Value: true

---

containSearchText

When true, only options containing the search text are displayed. Type: Boolean Default Value: false

---

dataProviderID

Bound data provider identifier for the tokenized select input value. Type: Dataprovider

---

editable

Flag indicating whether the component is editable. Type: Protected Default Value: true

---

enabled

Flag indicating whether the component is enabled for user interaction. Type: Enabled Default Value: true

---

hideSelectedItems

Flag indicating whether selected items should be hidden from the dropdown list after being chosen. Type: Boolean Default Value: false

---

location

Position of the component on the form. Type: Point

---

maximumSelectionSize

Maximum number of options that can be selected. Type: Number

---

noMatchesFoundText

Text displayed when no matching options are found. Type: Tagstring Default Value: "No matches found"

---

openOnUnselect

When true, the dropdown opens automatically when an item is unselected. Type: Boolean Default Value: true

---

overlayMode

Flag indicating whether the overlay mode will be applied when the dropdown list opens. Type: Boolean Default Value: true

---

placeholderText

Placeholder text displayed when no option is selected. Type: Tagstring Default Value: "Select..."

---

readOnly

Flag indicating whether the component is read-only. Type: Protected Default Value: false

---

searchingText

Text displayed while searching for options. Type: Tagstring Default Value: "Searching\u2026"

---

selectOnClose

When true, an option is automatically selected when the dropdown is closed. Type: Boolean Default Value: false

---

styleClass

CSS style classes applied to the component. Type: Styleclass Default Value: "select2-sm"

---

tabSeq

Tab sequence order for keyboard navigation. Type: Tabseq

---

toolTipText

Tooltip text displayed when hovering over the component. Type: Tagstring

---

valuelistConfig

Configuration for the value list. Type: ValuelistConfig

---

valuelistID

Identifier for the value list providing available options. Type: Valuelist Default Value: "autoVL"

---

visible

Flag indicating whether the component is visible. Type: Visible Default Value: true

---

Events

onDataChangeMethodID(oldValue,newValue,event)

Called when the value changes.

Parameters:

• {${dataproviderType}} oldValue The previous value from the data provider.

• {${dataproviderType}} newValue The new value to be set.

• {JSEvent} event The event object associated with the data change.

Returns: {Boolean}

---

onFocusGainedMethodID(event)

Called when the component gains focus.

Parameters:

• {JSEvent} event The event object containing details about the focus gained event.

---

onFocusLostMethodID(event)

Called when the component loses focus.

Parameters:

• {JSEvent} event The event object containing details about the focus lost event.

---

API

requestFocus(mustExecuteOnFocusGainedMethod)

Request the focus to this field.

Example:

myElement.requestFocus();

Parameters:

• {Boolean} [mustExecuteOnFocusGainedMethod] If false will not execute the onFocusGained method; the default value is true

---

---