Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

string(): pojmenovaný text v generovaném obsahu stránek

Odlište navrhovanou funkci pojmenovaných řetězců od běžného textu CSS v uvozovkách a ověřte podporu enginu.

Verze: CSS Modules

Syntaxe

@page { @top-center { content: string(chapter, first); } }

Funkce string() načítá pojmenovaný řetězec dříve přiřazený pomocí string-set. Patří ke generovanému obsahu a stránkovaným médiím, typicky pro průběžný název kapitoly v okrajovém poli stránky. Nejde o běžný typ <string>, konverzi JavaScriptu ani načtení vlastní vlastnosti. Název je identifikátor a získanou hodnotu vkládá vlastnost content.

Volba hodnoty na stránce má výchozí variantu first: první přiřazení na stránce, případně vstupní hodnotu, pokud žádné nenastane. start použije první přiřazení, pokud jeho prvek začíná stránku, jinak vstupní hodnotu. last vybírá výstupní hodnotu. first-except se chová jako první varianta, ale na stránce, kde byla hodnota přiřazena, vloží prázdný řetězec. Tyto možnosti se týkají stránkovaného dokumentu a nelze je předvést pouhým čtením běžného nadpisu na obrazovce.

Odkazovaný návrh CSS Generated Content a související práce GCPM tento mechanismus popisují; jejich existence nedokazuje implementaci v prohlížeči. V testovaném Chromium 157 je podporován obsahový literál v uvozovkách, nikoli pojmenované přiřazení a obě formy načtení. Příklad zachová předchozí náhradní literál v pseudoprvku a v načtené deklaraci okraje stránky. Nevykresluje pojmenované průběžné záhlaví, nevytváří PDF ani netestuje význam variant ve stránkovacím enginu.

Příklady

console.log('quoted literal:', CSS.supports('content','"Chapter"'));
console.log('named assignment:', CSS.supports('string-set','chapter "Chapter"'));
console.log('named retrieval:', CSS.supports('content','string(chapter)'));
console.log('page selector argument:', CSS.supports('content','string(chapter,last)'));
const style = document.createElement('style');
style.textContent = '#named-string-probe::before { content:"Fallback"; content:string(chapter); }'
  + '@page { @top-center { content:"Fallback"; content:string(chapter,last); } }';
document.head.append(style);
const box = document.createElement('div');
box.id = 'named-string-probe';
document.body.append(box);
console.log('pseudo fallback:', getComputedStyle(box,'::before').content);
console.log('page margin declaration:', style.sheet.cssRules[1].cssRules[0].style.content);
box.remove();
style.remove();

Výsledek

quoted literal: true
named assignment: false
named retrieval: false
page selector argument: false
pseudo fallback: "Fallback"
page margin declaration: "Fallback"

Jde o provedený test podpory a náhradního obsahu, který poctivě uvádí výsledky false. Údaj o kompatibilitě běžného řetězcového typu CSS nedokazuje podporu funkce. Důležité nadpisy ponechte v obsahu dokumentu a zamýšlený tiskový engine testujte samostatně.

Zdroje