Dokumentace vektorových šablon

Popis a dokumentace vektorových šablon

Vektorové šablony je deisgn systém, které lze snadno upravit podle potřeb.

Vektorové šablony

proč je používat a k čemu slouží

Vektorové šablony představují jednoduchý systém stylování popisků (widgetů) u produktů, kategorií a článků na blogu. Díky nim lze vytvořit různorodý a rozmanitý deisgn stránek pomocí CSS proměnných, které definují vzhled popisků.

V následujícím článku popíšeme jednoduché příklady, jak docílit změny rozestupů mezi widgety, změny velikosti nadpisů od H2 po H4, odstavců, odrážek a pod. Dále si vysvětlíme tzv. scope systém, díky kterému lze měnit vzhled konkrétního widgetu u konkrétním produktu, kategorii nebo článku.

Upozornění

Následující návod je pro určený pro programátory nebo kodéry, rizika plynoucí z úprav berete na svá bedra pouze a jen vy. Aby vektorové šablony fungovaly správně, je nutné mít deaktivovaný Pobo Deisgner a v nastavení vzhledu je zvolený vzhled "...".

Struktura widgetů 

Pro správné pochopení  vektorových šablon je nutné ukázat kód widgetů. Každý obsahuje HTML, které je nastylovaný BEM metodikou, zaručuje stabilní vzhled a předvídatelné chování. Nastavení vzhledu widgetů a jeho obsahu lze nastavit pomocí tzv. CSS proměnných, které vytváří a upravují v editoru kódu.

Před tím než si vytvoříme první design se přesvědčíme, že máme v nastavení režimu vzhledu zvolenou volbu "Generický systém stylování popisků". Dále v sekci "Vzhled" zvolte "Pobo original". 

Nadpisy (h2, h3, h4), tabulky, odrážky, odkazy, tlačítka

Stylování typografie

Obsah vložený přes tzv. wysiwyg editor, ve kterém lze obsah formátovat jako nadpis h2, h3, H3, odstavec, odrážky a pod. se styluje pomocí globálních proměnných.

Dokumentace vektorových šablon

V případě, že chceme změnit typografii nadpisů (h2, h3, h4) ve wysiwyg editoru, můžeme měnit vlastnosti jako je velikost, tučnost, barvu, výšku řádkování, typ fontu, vnější a vnitřní odsazení a v neposlední řadě využít (ve výchozím vypnuté) before pseudoelementy.

U nadpisů se nastavují tyto proměnné:

Nastavení nadpisů H2
--pobo-typo-h2-font-size: 25px;
--pobo-typo-h2-font-family: var(--pobo-font-family);
--pobo-typo-h2-line-height: 30px;
--pobo-typo-h2-font-weight: 600;
--pobo-typo-h2-font-color: #0c0c0c;
--pobo-typo-h2-padding: 0;
--pobo-typo-h2-margin: 0 0 20px 0;

--pobo-typo-h2-before-content: none;
--pobo-typo-h2-before-bottom: -10px;
--pobo-typo-h2-before-left: 0;
--pobo-typo-h2-before-width: 200px;
--pobo-typo-h2-before-height: 2px;
--pobo-typo-h2-before-bg: #eaeaea;
  
Nastavení nadpisů H3
--pobo-typo-h3-font-size: 22px;
--pobo-typo-h3-font-family: var(--pobo-font-family);
--pobo-typo-h3-line-height: 25px;
--pobo-typo-h3-font-weight: 600;
--pobo-typo-h3-font-color: #0c0c0c;
--pobo-typo-h3-padding: 0;
--pobo-typo-h3-margin: 0 0 20px 0;

--pobo-typo-h3-before-content: none;
--pobo-typo-h3-before-bottom: -10px;
--pobo-typo-h3-before-left: 0;
--pobo-typo-h3-before-width: 200px;
--pobo-typo-h3-before-height: 2px;
--pobo-typo-h3-before-bg: #eaeaea;
  
Nastavení nadpisů H4
--pobo-typo-h4-font-size: 20px;
--pobo-typo-h4-font-family: var(--pobo-font-family);
--pobo-typo-h4-line-height: 24px;
--pobo-typo-h4-font-weight: 600;
--pobo-typo-h4-font-color: #0c0c0c;
--pobo-typo-h4-padding: 0;
--pobo-typo-h4-margin: 0 0 20px 0;
  

Pro úpravu nadpisů vytvoříme v sekci „Vzhled“ nový kód s názvem „Úprav typografie“ a vložíme do něj následující obsah:

:root {
    [data-pobo-content="product"] { 
        --pobo-typo-h2-font-size: 35px;
        --pobo-typo-h2-line-height: 40px;
        --pobo-typo-h2-font-color: blue;

        --pobo-typo-h3-font-size: 30px;
        --pobo-typo-h3-line-height: 35px;
        --pobo-typo-h3-font-color: red;
    }
}

Výsledek

Po uložení kódu uvidíme změny barvy pro druhou a třetí úroveň nadpisů. Tato lze změnit také odsazení, přidat before pseudoelement pro přidání ikony nebo potržení vodorovnou čárou a pod.

Dokumentace vektorových šablon

Jak zjistit, které prvky lze upravovat pomocí proměnných

Nejrychlejší způsob je tzv. inspekce kódu, kdy stačí kliknout např. na odstavec pravým tlačítkem myší a z roletkového menu vybrat "Inspekce kódu" nebo "Prozkoumat" (v závislosti na operačním systému a prohlížeči). Následně se nám otevře panel, ve kterém je v levé části HTML popisku a pravé části seznam proměnných.

Proměnné začínající s prefixem --pobo-* lze je prokliknout a zjistit tak jejich výchozí hodnoty. Následně je lze upravit.

Maximální šířka a vertikální odsazení widgetů 

Všechny widgety mají ve výchozím nastavení následující maximální šířku, margin a padding:

  --pobo-global-widget-padding: 40px 0;
  --pobo-global-widget-margin: 0px auto;
  --pobo-global-widget-max-width: 1200px;

Tyto hodnoty lze upravit podle potřeb, např. snížit padding a tím se zmenšit prostor prostor mezi widgety. Důležité je také zmínit to, že se aplikují pro všechny widgety,  nicméně existuje cesta, jak nastavit konkrétnímu widgetu konkrétní vlastnosti jako je pozadí, odsazení a pod.   

Scope systém - úprava designu konkrétního widgetu  

Existují situace, kdy je potřeba ovlivnit konkrétní widget konkrétního produktu, kategorie nebo článku blogu. Pro tyto účely jsme vytvořili tzv. scope systém, který umožňuje ovlivňovat vzhled konkrétní widgetu(resp. jeho ID). Ukážeme si nyní, jak invertovat widget s pásem ikon, který vidíte na této stránce.