Sekcja modalna

Służy do tworzenia sekcji oddzielonej od głównego interfejsu użytkownika, której można używać do obsługi pobocznego zadania lub wyświetlania informacji. Aby wznowić pracę nad interfejsem użytkownika, należy zamknąć sekcję modalną.
Sekcja modalna nie jest alertem i uniemożliwia użytkownikowi pracę w innych częściach interfejsu użytkownika. Zwykle w sekcji Modal stosowany jest układ innych widoków, takich jak Dobrze lub Panel.
Wskazówka: Właściwość widoczności widoku sekcji Modal należy ustawić na wartość Brak (w sekcji Właściwości > Widoczność), w przeciwnym razie sekcja Modal jest wyświetlana domyślnie.

Właściwości konfiguracyjne

W obszarze Konfiguracja można ustawić lub zmodyfikować właściwości wyglądu i zachowania widoku.

Wielkość ekranu
Właściwość konfiguracyjna, na której znajduje się ikona Rozmiarów ekranu Ikona wielkości 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ści konfiguracyjne wyglądu widoku Sekcja modalna znajdują się w poniższej tabeli:
Tabela 1. Właściwości konfiguracyjne wyglądu elementu Sekcja modalna
Właściwość konfiguracyjna wyglądu Opis Typ danych
Szerokość obiektu zastępczego modalnego Ikona wielkości ekranu Służy do podawania szerokości widoku, która jest wyrażana w pikselach (px), jako wartość procentowa pierwotnej szerokości (%) lub w firetach (em). String
Pokaż przyciski Powoduje wyświetlenie przycisków w oknie modalnym. Boolean
Styl koloru Styl koloru przycisku podstawowego. Dostępne opcje to: Domyślny, Podstawowy, Informacja, Sukces, Ostrzeżeniei Danger. ButtonColorStyle
Tekst na przycisku podstawowym Tekst na przycisku umożliwiającym użytkownikowi potwierdzenie czynności w oknie modalnym. Na przykład: Zapisz lub OK. String
Tekst na przycisku dodatkowym Tekst na przycisku umożliwiającym użytkownikowi rezygnację z czynności w oknie modalnym. Na przykład Zamknij lub Anuluj. String
Właściwości konfiguracyjne zachowania widoku Sekcja modalna znajdują się w poniższej tabeli:
Tabela 2. Właściwości konfiguracyjne zachowania elementu Sekcja modalna
Właściwość konfiguracyjna zachowania Opis Typ danych
Zamknij przy kliknięciu Jeśli zostanie wybrana opcja Zamknij przy kliknięciu, użytkownicy będą mogli zamknąć sekcję modalną, klikając dowolne miejsce poza nią. Domyślnie sekcja modalna nie może zostać zamknięta. Boolean

Zdarzenia

We właściwościach Zdarzenia można ustawiać i modyfikować 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 przypadku widoku Sekcja modalna można aktywować następujące typy procedur obsługi zdarzeń:
  • On load: aktywowano podczas ładowania strony, na przykład me.setVisible(true);
  • On close: Aktywowano, gdy okno sekcji Modal jest zamknięte, na przykład ${Output_Text1}.setText("Modal section closed...");, gdzie Output_Text1 jest identyfikatorem elementu sterującego w tekście wyjściowym.
  • On show: Aktywowano, gdy zostanie otwarte okno sekcji Modal, na przykład me.setText("Modal section is open...");
  • On primary button clicked: Aktywacja po kliknięciu przycisku podstawowego modalu. Na przykład:
    btn text: Save
    onclick: customized save function/actions
  • On secondary button clicked: Aktywacja po kliknięciu przycisku dodatkowego modalnego. Na przykład:
    btn text: Close
    onclick action: me.hide();

metody

Więcej informacji o dostępnych metodach można znaleźć w opisie interfejsu JavaScript API Sekcja modalna.

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.