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ě.