Wstawki JavaScript

Obsługa dynamicznej treści (wstawki JavaScript)

System umożliwia wstawianie dynamicznej treści za pomocą wstawek JavaScript. Mogą one być używane w następujących miejscach:

• w komponentach Treść formatowana (TextContent),
• w komponentach Etykieta,
• we właściwości Etykieta dostępnej w innych komponentach.

Funkcjonalność nie obejmuje komponentu Treść formatowana (TextContent) umieszczonego w obszarze Footera.

Format wstawki JavaScript

Wstawki mają postać:

<?js: return "wartość"; /** przykładowy kod JS zwracający wartość */ ?>

Treść wstawki musi zawsze zwracać wartość (np. string).

---

Przykłady użycia

1. Zwracanie wartości w zależności od pola formularza

Poniższa wstawka zwróci tekst "m1. " tylko wtedy, gdy pole o identyfikatorze GesTextField1 zostało wypełnione:

<?js: return getValue("GesTextField1") ? "m1. " : ""; ?>

---

2. Obsługa wartości domyślnej i własnej (zmienne sesyjne)

W przykładzie poniżej, jeśli zmienna etykietaWlasna jest pusta lub ma wartość null, zostanie użyta wartość z etykietaDomyslna. Obie wartości są dostępne jako zmienne sesyjne:

<?js: return (getValue("etykietaWlasna") == "" || getValue("etykietaWlasna") == null)
    ? "${etykietaDomyslna}"
    : "${etykietaWlasna}"; ?>

---

3. Wstawka z formatowaniem HTML

W zależności od wartości pola channel dynamicznie zwracana jest treść zawierająca HTML:

<?js:
  return getValue("channel") == "mobile"
    ? "<b>Zgoda na kontakt telefoniczny w celu marketingowym.</b> <span class='optional' style='color:#bec2c3;'>(opcjonalne)</span>"
    : "Zgoda na kontakt telefoniczny w celu marketingowym. <span class='optional' style='color:#bec2c3;'>(opcjonalne)</span>";
?>

---

Dostępne metody JavaScript

W ramach wstawek można korzystać z metod opisanych w sekcji:

Język wyrażeń definiowania warunków

Pozwala to m.in. na odwoływanie się do wartości pól, porównania, sprawdzanie pustych wartości itp.

---

Ważna uwaga dotycząca identyfikatorów

W treści wstawek nie poprzedzamy identyfikatorów komponentów ani nazw zmiennych symbolem @. Przykład poprawny:

getValue("GesTextField1")

Przykład niepoprawny:

getValue("@GesTextField1")