Šablona:Zvýrazňovač/doc
Šablona zvýrazňovač umožňuje zvýraznění textu podobně jako označení zvýrazňovačem na papíře, a to i českými názvy některých základních barev (v ženském rodě).
Navíc šablona vybrané barvy předefinovává, aby je zesvětlila, jinak by běžný černý text na příliš tmavém pozadí standardních sytých barev byl špatně čitelný.
Použití
[editovat]Použijte tento copypaste: {{Zvýrazňovač|_text_|barva=_barva_|title=_title_}}
- Příklady
{{Zvýrazňovač|chci zelený podklad|barva=zelená|title=příklad: zelený podklad}}
dá chci zelený podklad, zde zrovna v barvě definované uvnitř samotné šablony.
Syntaxe
[editovat]{{Zvýrazňovač|_text_ [|barva=_barva_] [|title=_title_] }}
[...]
zde značí nepovinnost parametru
Pořadí parametrů není nutné dodržovat.
Parametry
[editovat]Text ke zvýraznění
[editovat]|1
– libovolný řetězec, text ke zvýraznění
Text prázdný nebo z mezer
[editovat]Vstup je sice je nepovinný, nevyhodí chybu, takové použití |1
však nemá smysl.
- Volání "
{{Zvýrazňovač}}
" dá výsledek "{{{1}}}". - Volání "
{{Zvýrazňovač|}}
" dá výsledek "". - Volání "
{{Zvýrazňovač| }}
" dá výsledek " ". - Volání "
{{Zvýrazňovač|  }}
" dá výsledek " ". - Volání "
{{Zvýrazňovač| <nowiki />}}
" dá výsledek " ".
Parametr barva
[editovat]|barva = žlutá
– kód barvy pozadí zvýrazňovaného textu; nepovinný.
- určení barvy
- kódem RGB pro požadovanou barevu, ve formátu #RRGGBB nebo #RGB, jak jsou používány v CSS,
- názvem barvy.
Možné názvy
[editovat]- standardní
Standardní názvy barev jsou definovány konsorciem W3C, viz seznam pojmenovaných barev.
- šablonou předefinované
Šablona některé názvy definuje úplně nové, zejména české, malými písmeny, některé již definované, existující a běžně používané, takto předefinovává na jiné hodnoty: Cílem je změna pozadí textu, typicky tedy jsou místně definované barvy poněkud zesvětlené, pro lepší čitelnost standardního černého textu.
Šablona manipuluje s těmito barvami a jejich názvy:
žlutá
– pro zvýraznění textu použita barva žlutá, yellow a Yellowsv.žlutá
– pro zvýraznění textu použita barva sv.žlutázelená
– pro zvýraznění textu použita barva zelená, green, ale standardně Greensv.zelená
– pro zvýraznění textu použita barva sv.zelenámodrá
– pro zvýraznění textu použita barva modrá, blue, ale standardně Bluesv.modrá
– pro zvýraznění textu použita barva sv.modráčervená
– pro zvýraznění textu použita barva červená, red, ale standardně Redrůžová
– pro zvýraznění textu použita barva růžová, pink, ale standardně Pinkcyanová
– pro zvýraznění textu použita barva cyanová, cyan a Cyansv.cyanová
– pro zvýraznění textu použita barva sv.cyanová, lightcyan a LightCyanšedá
– pro zvýraznění textu použita barva šedá, grey, ale standardně Greybílá
– pro zvýraznění textu použita barva bílá, white a Whitehnědá
– pro zvýraznění textu použita barva hnědá, brown, ale standardně Brown
Jiné barvy, zde neuvedené, šablona zobrazí beze změny, čímž je ponechána možnost odkazu na předefinované standardní názvy barev. (Například s velkými písmeny, což rozlišuje šablona, ne však CSS.)
Barva nezadána
[editovat]- hodnota délky nula
Jako výchozí hodnota pro určení barvy zvýraznění, když žádná není výslovně zadána ({prázdná}
), se používá žlutá
, taková je uvnitř šablony přednastavena.
- hodnota barvy neprázdná, ale mezera
Hodnoty pojmenovaných parametrů jsou běžně trimovány, přesto lze zadat vstup i jen z mezer, výslovně:
"{{Zvýrazňovač|barva ani nezmíněna|}}"
dá výsledek "barva ani nezmíněna""{{Zvýrazňovač|barva prázdná, bez mezer|barva=}}"
dá výsledek "barva prázdná, bez mezer""{{Zvýrazňovač|barva z mezer, ořezaných|barva= }}"
dá výsledek "barva z mezer, ořezaných""{{Zvýrazňovač|barva z výslovných mezer|barva=  }}"
dá výsledek "barva z výslovných mezer""{{Zvýrazňovač|barva z výslovných mezer|barva= <nowiki />}}"
dá výsledek "barva z výslovných mezer"
Parametr title
[editovat]|title = zvýrazněno
– tooltip, text ke zobrazení v bublině při nadjetí myší na zvýrazňovaný text; nepovinný.
Příklady použití
[editovat]Zvýraznění bez určení barvy
[editovat]Lorem ipsum {{Zvýrazňovač|dolor}} sit amet.
Zvýraznění barvou určenou názvem
[editovat]Lorem ipsum {{Zvýrazňovač|dolor|barva=zelená}} sit amet.
Zvýraznění barvou určenou kódem
[editovat]Používejte velmi uváženě jen tam, kde je to nezbytné.
Lorem ipsum {{Zvýrazňovač|dolor|barva=#C9F}} sit amet.
Určená barva nerozpoznána
[editovat]Lorem ipsum {{Zvýrazňovač|dolor|barva=132xyz}} sit amet.
Postup vyhodnocování:
- Detekce prázdného vstupu, použila by se přednastavená barva. (první default)
- Detekce hodnot ze seznamu, použila by se dohledaná barva z šablony.
- Barva šablonou nerozpoznána, vstupní hodnota tedy beze změny propadne šablonou (druhý default) do generovaného HTML (opravdu tam bude zapsaná), kde ji zpracuje browser jako CSS hodnotu:
- A to se mu buď povede,
- anebo ji bude ignorovat.
<span style="background-color: 132xyz;">dolor</span>