Symboly

Symbol je znovupoužitelný blok, který uložíte jednou a vložíte na více míst — typicky hlavička, patička nebo opakující se karta. Když symbol upravíte, změna se propíše všude, kde je použitý.

Jak symbol použít

Než začnete stavět nový blok, zkontrolujte, jestli symbol už neexistuje (hlavně hlavička a patička).
Symbol vložíte na stránku jako jeden prvek. Když ho upravíte v jeho definici, změní se všechny instance najednou.
Typické využití: patička, hlavička, opakující se karta, CTA blok, banner.

Varianty

Symbol může mít víc variant (např. „světlá / tmavá“ nebo „velká / kompaktní“).

Jedna varianta je výchozí.
U konkrétní instance vyberete, kterou variantu chcete zobrazit.
Hodí se, když je blok vizuálně stejný typ, ale ve dvou až třech provedeních.

Props a sloty

Props (vlastnosti) jsou pole, která vyplníte u každé instance zvlášť — například nadpis, text tlačítka, odkaz nebo obrázek. Díky nim je jeden symbol (třeba tlačítko nebo karta) použitelný mnohokrát s jiným obsahem, ale jednotným vzhledem.

Sloty (slots) jsou místa, kam přímo na stránce vložíte libovolný obsah. Rozdíl oproti props: props vyplňujete hodnotami (text, odkaz, obrázek), do slotů vkládáte celé bloky.

Napojení na data z kolekce

Obsah v symbolu (i mimo něj) lze napojit na kolekci (CMS databázi) — tzv. binding.

Vzor: kolekce „Akce“ nebo „Články“ → blok se opakuje přes položky kolekce (each) a pro každou vykreslí kartu; texty, obrázky a odkazy se plní z polí položky.
Takto se dělají výpisy (seznam akcí, novinek): obsah spravujete v kolekci, layout máte jednou v symbolu nebo bloku.