ToggleSection

Zastosowanie

Funkcja ToggleSection pokazuje albo ukrywa wskazaną sekcję w formularzu bieżącej sprawy, zależnie od wartości drugiego argumentu.

Efekt działania

Dla true sekcja jest widoczna, dla false sekcja jest ukryta razem z polami. Funkcja nie zwija ani nie rozwija sekcji.

Zmiana widoczności jest tymczasowym efektem interfejsu. Nie zapisuje się w bazie danych i może zmienić się po odświeżeniu strony, ponownym otwarciu sprawy albo ponownym przeliczeniu reguł. Jeżeli efekt ma się utrzymywać podczas edycji, używaj funkcji w regule automatycznej, która przelicza się w trakcie pracy z formularzem.

Składnia

ToggleSection("sectionName",visible);

Argumenty

Argument	Typ	Wymagany	Opis
`sectionName`	tekst	Tak	Nazwa sekcji, która ma zostać pokazana albo ukryta.
`visible`	wartość logiczna	Tak	`true` pokazuje sekcję, `false` ją ukrywa. Pusta wartość działa jak `false`.

Zwracana wartość

Funkcja zawsze zwraca true.

Przykłady

Przykład 1: widoczność zależna od pola

Sekcja GeneralSection jest widoczna, gdy pole show ma wartość true. W przeciwnym razie jest ukryta.

ToggleSection("GeneralSection",[show]);

Dobre praktyki

Podawaj nazwę sekcji dokładnie tak, jak w konfiguracji formularza.
Jako drugi argument przekazuj pole typu Tak/Nie, zmienną albo warunek, który daje wartość logiczną.

Typowe błędy

Nazwa sekcji z błędem. Funkcja nie znajdzie sekcji i niczego nie zmieni, ale też nie zgłosi błędu. Sprawdź nazwę sekcji w konfiguracji formularza.
Drugi argument, który nie jest wartością logiczną, np. tekst "tak". Reguła zakończy się błędem. Przekaż true, false albo wartość pola typu Tak/Nie.

Powiązane funkcje