Kontrolka w skrypcie reprezentowana jest jako pole tekstowe z przyciskiem rozwijania, który po kliknięciu otwiera listę opcji. Po wybraniu jednej opcji z listy, wybrana wartość jest wyświetlana w polu tekstowym.
Ikona kontrolki w zasobniku:

Listy rozwijane są używane sytuacjach, gdy użytkownikowi musi dokonać wyboru spośród różnych opcji a jednocześnie chcemy zachować kompaktowy wygląd skryptu. W skryptach zawierających wiele kategorii, listy rozwijane mogą być wykorzystywane do wyboru odpowiedniej kategorii lub podkategorii (na przykład do wyboru kraju, regionu, miasta itp.)
Wygląd przykładowej kontrolki Przyciski opcji w skrypcie:


test
|
Ogólne |
|
| Nazwa | Nazwa kontrolki umożliwiająca jej identyfikację np. w wyrażeniach zależności pól. |
| Nagłówek | Dodatkowy tekst opisujący przeznaczenie listy rozwijanej (możliwe jest stosowanie formatowania za pomocą tagów BBCode). |
| Pozycja nagłówka | Określa położenie nagłówka względem listy rozwijanej, możliwe wartości to po lewej lub na górze. |
| Szerokość nagłówka | Określa szerokość nagłówka. |
| Wymagalny | Określa, czy wypełnienie listy rozwijanej jest wymagalne. Jeśli listę rozwijaną ustawimy jako wymagalne (true), to walidator nie pozwoli przejść na kolejną stronę skryptu, jeśli użytkownik nie dokona żadnego wyboru, chyba że do listy rozwijanej przypisana była wartość domyślna (automatycznie wybrana jedna z dostępnych opcji) |
| Wartość domyślna | Jest to domyślnie wybrana jedna z dostępnych opcji. Wartość domyślna może być wprowadzona jako stała lub jako nazwa zmiennej której wartość zostanie ustawiona programowo (np. wartość z bazy danych). |
| Zapisz do zmiennej | Pozwala programowo zapisać wartość z listy rozwijanej do zmiennej. Wartość ze zmiennej może być zapisana do bazy lub wykorzystana w kolejnych krokach skryptu. Uwaga: Nie zapisanie zawartości listy rozwijanej do zmiennej nie oznacza utraty tej informacji po zamknięciu sesji skryptu. Wszystkie wartości pól edycyjnych są zapisywane w bazie danych bez względu na to, czy są przypisane do zmiennych, czy nie. |
|
Wartości |
|
| + Dodaj | Przycisk umożliwia dodanie nowej wartości do listy rozwijanej. |
![]() |
Przycisk umożliwia wklejenie listy opcji przechowywanych w schowku systemowym (na przykład lista skopiowana z pliku tekstowego czy pliku Ms Word). |
![]() |
Przycisk umożliwia wklejenie statusów które występują w skrypcie jako elementów listy rozwijanej. |
| Wartości | Dla każdej wartości dodanej do listy można określić wartość wyświetlaną i wartość zapisywaną. Np. Jeśli ustawimy wartość wyświetlaną na “Opcja 1" oraz wartość zapisywaną na “1” to w widoku skryptu dla użytkownika zostanie wyświetlony tekst “Opcja 1” ale po wybraniu go do bazy zapisana zostanie wartość “1” |
|
Zewnętrzne źródło danych Wartość zapisywana Wartość wyświetlana |
Jako źródło wartości listy rozwijanej można ustawić zewnętrzne źródło danych (Patrz: Dane→źródła danych). Jeśli takie źródło zwraca listę wartości w formacie słownikowym (klucz: wartość) to możliwe jest przypisanie ich odpowiednio jako wartość wyświetlana i wartość zapisywana |
| Edytowalny | Pozwala określić czy użytkownik będzie miał możliwość wpisać do pola listy dowolny tekst (true) lub czy będzie ograniczony tylko do wartości z listy (false) |
| Pokaż pole wyszukiwania | Pozwala określić czy do listy zostanie dodane pole wyszukiwania (widoczne po rozwinięciu listy) które pozwala na dynamiczne filtrowanie elementów listy (przydatne w przypadku list wieloelementowych) |
|
|
|
Wygląd |
|
| Widoczne | Domyślnie wartość tej właściwości jest ustawiona na widoczny (true), co oznacza, że kontrolka jest widoczna w skrypcie dla użytkownika. Jeśli wartość tej właściwości zostanie zmieniona na niewidoczny (false), kontrolka stanie się niewidoczna dla użytkownika, ale wciąż będzie istniała na stronie skryptu i możliwy będzie dostęp do jej właściwości np. w wyrażeniach zależności pól. |
| Kolor tła | Określa kolor tła kontrolki (chodzi o obszar otaczający kontrolkę i samą kontrolkę). Możliwe jest podanie koloru w formacie szesnastkowym lub wybór z wbudowanej palety barw. |
| Szerokość | Określa szerokość kontrolki podaną w pixelach. |
| Margines | Określa odstęp między kontrolką a sąsiednimi elementami w skrypcie. Można określić osobno każdy z marginesów: lewy, górny, prawy, dolny. |
| Podpowiedź | Umożliwia wprowadzenie tekstu który będzie pokazywany w momencie, gdy użytkownik najedzie kursorem na kontrolkę. |
|
Tekst |
|
| Rozmiar czcionki | Definiuje rozmiar czcionki tekstu wyświetlanego w kontrolce. W przypadku pola listy to ustawienie odnosi się do nagłówka. |
| Kolor czcionki | Definiuje kolor tekstu wyświetlanego w kontrolce. Można użyć tej właściwości, aby zmienić kolor tekstu na dowolny inny niż domyślny. W przypadku pola listy to ustawienie odnosi się do nagłówka. |
| Czcionka | Określa czcionkę, w której tekst jest wyświetlany w kontrolce. W przypadku pola listy to ustawienie odnosi się do nagłówka. |
| Grubość czcionki | Określa sposób wyróżnienia tekstu. W przypadku pola listy to ustawienie odnosi się do nagłówka. |
| Styl czcionki | Sposób ozdabiania lub wyróżniania tekstu poprzez dodanie efektów graficznych do wybranych fragmentów tekstu. Te efekty mogą obejmować podkreślenie, przekreślenie, podwójne podkreślenie, cieniowanie i inne. W przypadku pola listy to ustawienie odnosi się do nagłówka. |
| Dekorator czcionki | Umożliwia dodanie dekoratorów czcionki (jednego lub wielu): Podkreślenie, przekreślenie, linia nad tekstem. W przypadku pola listy to ustawienie odnosi się do nagłówka. |