Textový blok

Textový blok pro nadpisy, odstavce a oddělovače.

Popis widgetu `textBlock`

Textový blok vloží do formuláře nadpis (H1 až H3), odstavec textu nebo vodorovný oddělovač s popiskem. Slouží ke strukturování dlouhého formuláře a k vysvětlujícím textům. Text může obsahovat placeholdery s hodnotami polí, takže se mění spolu s formulářem. Je to virtuální widget, neukládá se do položky.

Nastavení widgetu Text / Nadpis / Oddělovač: varianta, text, podnadpis, zarovnání a barva

Přidání do formuláře

Na kartě Widgety v levé paletě vyberte Text / Nadpis / Oddělovač a přetáhněte ho do sekce (nebo klikněte na „+“). Nový blok je nadpis H2 „Nadpis bloku“ přes celou šířku sekce.

Nastavení v inspektoru

Volba	Vlastnost	Význam	Výchozí
Varianta zobrazení	`textBlockConfig.variant`	`h1`, `h2`, `h3` (nadpisy tří velikostí), `paragraph` (odstavec, zachová zalomení řádků), `divider` (Čára).	`h2`
Text / Nadpis (podporuje [Pole])	`textBlockConfig.content`	Hlavní text. U varianty Čára je to volitelný popisek oddělovače.	prázdný
Podnadpis / doplňkový text	`textBlockConfig.subtitle`	Menší šedý text pod hlavním. U Čáry se nenabízí. Podporuje placeholdery.	prázdný
Zarovnání	`textBlockConfig.align`	`left` (Vlevo), `center` (Střed), `right` (Vpravo). U Čáry určuje polohu popisku.	`left`
Barva	`textBlockConfig.color`	`default` (Běžná), `brand` (Akcent, barva motivu), `muted` (Tlumená).	`default`
Vlastní popisek	`customLabel`	Název widgetu. Zobrazí se, když je `content` prázdný.	„Nadpis sekce“
Šířka v sekci, Viditelné	`colSpan`, `defaultVisible`	Společné volby všech widgetů.	12, ano

Chování za běhu

Blok je ve všech režimech (Nový, Úprava, Zobrazení) stejný a nemá žádné vstupy.
Blok sleduje jen pole, která jsou uvedená v jeho placeholderech. Při psaní do jiných polí se nepřekresluje.
Prázdný text se nahradí vlastním popiskem (customLabel), a když chybí i ten, výchozím názvem „Textový blok“. Prázdná Čára je jen linka.

Placeholdery a šablony

V hlavním textu i podnadpisu můžete použít:

Zápis	Dosadí se
`[Pole]` nebo `{Pole}`	aktuální hodnota pole podle interního názvu (u výběru, osoby, vyhledávání popisek). Prázdné nebo neznámé pole dá prázdný text.
`@Me`	jméno přihlášeného uživatele
`@Today`	dnešní datum ve tvaru `RRRR-MM-DD`

Je to čistá náhrada textu, žádné výpočty. Pro výpočty použijte výrazy v počítaném poli a to pak do textu vložte přes [Pole].

Překlady textů

Přeložit lze customLabel, textBlockContent a textBlockSubtitle (a textBlockHeading, viz omezení). Prázdný překlad se ignoruje. Viz Překlady a vícejazyčnost.

Pravidla a skripty

setVisible: zobrazí nebo skryje blok, například nadpis „Schválení“ jen ve stavu Ke schválení.
Text sám pravidla ani skripty nemění. Reaguje na hodnoty polí uvedených v placeholderech, takže stačí měnit je (ručně, pravidlem setValue nebo skriptem).

Příklad konfigurace (JSON)

{
  "internalName": "widget_text_projekt",
  "customLabel": "Nadpis projektu",
  "fieldType": "textBlock",
  "colSpan": 12,
  "defaultVisible": true,
  "textBlockConfig": {
    "variant": "h2",
    "content": "Projekt [Title]",
    "subtitle": "Vedoucí: [Vedouci], dnes je @Today",
    "align": "left",
    "color": "brand"
  }
}

Formulář s variantami H1, H2, odstavec a oddělovač s popiskem pod sebou, aby byl vidět rozdíl velikostí a barev

Omezení a tipy

Text je prostý: žádné tučné písmo, odkazy ani seznamy. Zalomení řádků se zachovají jen u varianty paragraph.
Vlastnost textBlockConfig.heading (Nadpis bloku) se zobrazí nad obsahem, pokud je vyplněný i content; podporuje stejné placeholdery [Pole] a je překládatelný. U varianty „Čára“ se nepoužije. Je-li vyplněný jen heading (bez content), vykreslí se jako hlavní text ve zvolené variantě.
Pro varovnou zprávu s barvou použijte spíše Banner. Samotnou mezeru mezi poli zajistí Mezera.