Ustawienia początkowe
Mode- wybierz Multiple, aby móc wybrać wiele opcji z rozwijanej listy. W przeciwnym razie należy użyć trybu Single.
Ustawienia wyglądu i działania
Label(not mantory) do wykorzystania w celu pokazania etykiety komponentu.
Placeholder(nieobowiązkowy) - służy do wyświetlania placeholder komponentu.
Name (obowiązkowo) - nazwa komponentu.
Size(obowiązkowo) - rozmiar komponentu. Jest ustawiony na Domyślny podczas tworzenia komponentu.
Search(obowiązkowy) - możliwość wyszukiwania w ramach dostępnych opcji rozwijanych. Jest domyślnie wyłączona.
Clear icon (obowiązkowy) - pokazuje ikonę czystych opcji, jeśli jest włączona. Jest domyślnie wyłączona.
Disabled(obowiązkowy) - sprawia, że komponent jest wyłączony, jeśli jest włączony. Jest domyślnie wyłączony.
Visible(obowiązkowy) - sprawia, że komponent jest widoczny, jeśli jest włączony. Jest domyślnie włączony.
Opcje
Wybrane opcje mogą być predefiniowane w ustawieniach komponentu.
Wyzwalacze przepływu pracy
- onChange- odpala się, gdy opcja rozwijana jest zmieniana.
- onFocus- wywołuje się, gdy element Select jest skupiony.
- onBlur- wywołuje się, gdy komponent Wybierz jest zamazany.
- onCreate- wywołuje się, gdy komponent jest tworzony.
- onDestroy- zostanie wywołany, gdy komponent zostanie wyświetlony.
Akcje komponentu
Select Get Properties
Pobiera właściwości komponentu.
Parametry wejściowe:
- Component Id [string] - Identyfikator komponentu Select;
Parametry wyjściowe:
- Label[string] - etykieta komponentu;
- Placeholder[string] - miejsce komponentu;
- Allow Clear [boolean] - umożliwia wyczyszczenie zaznaczenia, jeżeli jest to prawda;
- Disable[boolean] - wyłącza komponent jeśli true;
- Tooltip[string] - łańcuch etykiety narzędzia;
- Required Mark [boolean] - pokazuje wymagane zaznaczenie, jeśli true;
- Debounce (ms) [integer] - opóźnienie zatwierdzenia wartości;
- Options[Select Option array] - tablica predefiniowanych opcji wyboru;
- Selected[Select Option array] - tablica wybranych opcji lub tylko tablica z pojedynczym elementem w przypadku Single Mode;
- Validate Icon[boolean] - ikona, która zostanie wyświetlona podczas walidacji wartości;
- Validate Status [Status type] - status, który ma być pokazany przy sprawdzaniu poprawności wartości;
- Validate Message[string] - wiadomość, która zostanie wyświetlona podczas walidacji wartości;
Select Set Properties
Ustawia właściwości komponentu.
Parametry wejściowe:
- Component Id [string] - Wybierz identyfikator komponentu;
- Label[string]- etykieta komponentu;
- Placeholder[string] - placeholder komponentu;
- Allow Clear [boolean] - umożliwia wyczyszczenie zaznaczenia, jeśli true;
- Disable[boolean] - wyłącza komponent jeśli true;
- Tooltip[string] - łańcuch etykiety narzędzia;
- Required Mark [boolean] - pokazuje wymagane zaznaczenie, jeśli true;
- Debounce (ms) [integer] - opóźnienie do zatwierdzenia wartości;
- Options [Select Option array] - tablicę predefiniowanych opcji wyboru;
- Validate Icon [boolean] - ikona, która zostanie wyświetlona podczas walidacji wartości;
- Validate Status [Status type] - status, który zostanie wyświetlony podczas walidacji wartości;
- Validate Message [string] - wiadomość, która zostanie wyświetlona podczas walidacji wartości;
Wybierz Aktualizuj właściwości
Aktualizuje właściwości komponentu.
Parametry wejściowe:
- Component Id [string] - Identyfikator komponentu select;
- Label[string]- etykieta komponentu;
- Placeholder[string] - placeholder komponentu;
- Allow Clear [boolean] - umożliwia wyczyszczenie zaznaczenia, jeśli true;
- Disable[boolean] - wyłącza komponent jeśli true;
- Tooltip[string] - łańcuch etykiety narzędzia;
- Required Mark [boolean] - pokazuje wymagane zaznaczenie, jeśli true;
- Debounce (ms) [integer] - opóźnienie do zatwierdzenia wartości;
- Options [Select Option array] - tablicę predefiniowanych opcji wyboru;
- Validate Icon [boolean] - ikona, która zostanie wyświetlona podczas walidacji wartości;
- Validate Status [Status type] - status, który zostanie wyświetlony podczas walidacji wartości;
- Validate Message [string] - wiadomość, która zostanie wyświetlona podczas walidacji wartości;
Make Select Option
Komponuje model Select Option z podanymi polami.
Parametry wejściowe:
- ID [integer] - ID opcji select;
- Label[string] - Wybierz etykietę opcji;
- Value[integer] - Wartość zamówienia opcji na liście rozwijanej;
- Icon[string] - ikona do wykorzystania w elemencie Wybierz opcję;
- Disabled[boolean] - wyłącza opcję Select Option, jeśli ma wartość true;
Parametry wyjściowe:
- Select Option [Select Option] - Select Option model;
Expand Select Option
Rozwija model Select Option.
Parametry wejściowe:
- Select Option [Select Option] - Model opcji Select Option;
Parametry wyjściowe:
- ID [integer] - ID opcji Select Option;
- Label[string] - Wybierz etykietę opcji;
- Value[integer] - Wartość zamówienia opcji Select Option na liście rozwijanej;
- Icon[string] - ikona, która ma być użyta w elemencie Select Option;
- Disabled[boolean] - wyłącza opcję Select Option, jeśli ma wartość true;
Przykład użycia.
Możliwe jest komponowanie i dodawanie nowych pozycji opcji Select Option do listy rozwijanej poprzez frontendowe procesy biznesowe.
Logika powinna być następująca:
- Komponuje nową pozycję Select Option z określonymi polami (Make Select Option)
- Pobierz istniejącą tablicę Select Option items (Select Get Properties) i połącz ją z utworzonym wcześniej elementem opcji Select (Append Array)
- Aktualizuj tablicę elementów opcji Select (Select Update Properties) dla określonego elementu Select
