Przycisk
Powiązanie danych
Na karcie właściwości Ogólne można ustawiać i modyfikować powiązanie danych elementu Przycisk. Widok jest powiązany ze zmienną typu Wartość boolowska.
Właściwości konfiguracyjne
W obszarze Konfiguracja można ustawić lub zmodyfikować właściwości wyglądu i zachowania widoku. W obszarze Zdarzenia można ustawić właściwości konfiguracyjne formuły.
- Wielkość ekranu
- Właściwość konfiguracyjna, na której znajduje się ikona Rozmiarów ekranu
obok nazwy właściwości, może mieć różne wartości dla każdej wielkości ekranu. Jeśli nie zostanie ustawiona wartość, wielkość ekranu dziedziczy wartość następnej większej wielkości ekranu jako swoją wartość domyślną.
- Definicje kompozycji
- Definicje kompozycji służą do podawania kolorów i stylów widoku oraz do określania jego wyglądu. W edytorze kompozycji można wyświetlić podgląd wyglądu i zachowania widoku. Patrz Kompozycje.
| Właściwość konfiguracyjna wyglądu | Opis | Typ danych |
|---|---|---|
| Styl koloru | Styl koloru elementu Przycisk. Kolory odpowiadają zmiennym w podanej kompozycji. Dostępne opcje to: Domyślny, Podstawowy, Sukces, Danger, Ciemny. | String |
| Kształt | Kształt elementu Przycisk. | String |
| Wielkość | Wielkość przycisku. | String |
| Tylko kontur | Po umieszczeniu wskaźnika myszy nad elementem Przycisk jest on wyświetlany tylko przy użyciu stylu koloru. Domyślnie ta właściwość nie jest wybrana. | Wartość boolowska |
| Ikona |
Nazwa ikony, która poprzedza tekst na przycisku. Na przykład: calendar, clock-o, camera, cloud-upload, bell, info, file-text. Pełna lista ikon znajduje się w sekcji Czcionka Awesome V4.7.0 . |
String |
| Szerokość |
Szerokość widoku. Szerokość jest wyrażana w następujących jednostkach: px (piksele), % (wartość procentowa) lub em (firety). Na przykład: 50 px, 20% lub 0,4 em. Jeśli typ jednostki nie jest określony, zakłada się, że piks jest przyjmowany.. | String |
| Położenie ikony | Położenie etykiety względem tekstu przycisku. Dostępne opcje to:
|
InputGroupButtonLoc |
| Tylko kontur | Uwidacznia kontur i ukrywa lite wypełnienie przycisku w wybranym stylu koloru. Lite wypełnienie jest wyświetlane po zatrzymaniu wskaźnika nad przyciskiem. | Boolean |
| Styl ducha | Wyświetla przycisk w wybranym stylu koloru bez kontury i bez litego wypełnienia. Po zatrzymaniu wskaźnika nad przyciskiem przycisk wyświetlany jest w postaci dezaktywowanej, z jasnoszarym tłem. | Boolean |
| Właściwość konfiguracyjna zachowania | Opis | Typ danych |
|---|---|---|
| Indeks przechodzenia | Indeks w sekwencji przechodzenia (przy użyciu klawisza Tab). Indeksy przechodzenia rozpoczynają się od 1 (niektórych indeksów może brakować). Na przykład: 1, 5, 10. Właściwość Indeks przechodzenia służy do decydowania o kolejności przechodzenia (za pomocą klawisza Tab) między obszarami interfejsu użytkownika. | Integer |
| Zapobiegaj wielokrotnym kliknięciom | Służy do blokowania użytkownikom możliwości kliknięcia przycisku więcej niż jeden raz. | Boolean |
Przykład
- W obszarze Formuła podaj nazwę przycisku jako tekst statyczny ujęty w podwójny cudzysłów (np. "OK").
- W obszarze Zachowanie wybierz właściwość Zapobiegaj wielokrotnym kliknięciom.
- W sekcji Wyglądustaw wartość Styl koloru na Success, a następnie pozostaw styl Styl kształtu i Styl wielkości ustawiony na wartość Default. W polu Ikonawpisz check.
- Zapisz zmiany.
W wyniku wykonania tych czynności powstanie prostokątny przycisk z etykietą OK na zielonym tle. Tekst na przycisku jest poprzedzony znacznikiem wyboru.
Zdarzenia
We właściwościach Zdarzenia można ustawiać i modyfikować właściwości konfiguracyjne formuły i procedury obsługi zdarzeń widoku. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z widokiem. Informacje na temat definiowania zdarzeń i kodu zdarzeń zawiera sekcja Zdarzenia zdefiniowane przez użytkownika.
| Właściwość konfiguracyjna formuły | Opis | Typ danych |
|---|---|---|
| Formuła wyznaczania etykiety | Wyrażenie lub formuła używane do ustawiania etykiety
widoku Przycisk. Etykietę można ustawić za pomocą statycznego string lub dynamicznie przy użyciu formuły. Na przykład:
Więcej informacji na temat formuł zawiera sekcja Formuły. |
String |
Element Przycisk ma następujące typy procedur obsługi zdarzeń:
- On load: aktywowane po załadowaniu formatki lub strony. Na przykład:
console.log("Button loaded") - On click: Activated po kliknięciu odsyłacza przed opuszczeniem strony. Jeśli wartościowane wyrażenie zwróci wartość
false, kliknięcie nie spowoduje uruchomienia zdarzenia granicznego. Na przykład:return ${Text1}.isValid(); - On boundary event: Aktywowane, gdy przepływ osiągnie zdarzenie pozostania na stronie po wyzwolenie zdarzenia granicznego przez widok Odsyłacz. Więcej informacji na ten temat zawiera opis właściwości context.trigger() w temacie Obiekt kontekstu widoku formatki . Na przykład:
alert("Stay on Page status '" + status + "'")
W zależności od konkretnego zdarzenia można użyć logiki JavaScript, aby zmodyfikować efekty działania widoku. Więcej informacji na temat używania zdarzeń z widokami znajduje się w temacie Zdarzenia zdefiniowane przez użytkownika.
metody
Szczegółowe informacje na temat dostępnych metod dla przycisku można znaleźć w sekcji Interfejs API języka JavaScript .
Zasoby dodatkowe
Więcej informacji na temat sposobu tworzenia formatki lub strony zawiera sekcja Budowanie formatek.
Informacje na temat standardowych właściwości (Ogólne, Konfiguracja, Pozycjonowanie, Widocznośći Atrybuty HTML) można znaleźć w sekcji Właściwości widoku.