CKTIS / CSS
string(): benoemde tekst voor gegenereerde pagina-inhoud
Onderscheid de voorgestelde functie voor benoemde tekst van gewone CSS-tekst tussen aanhalingstekens en test de echte engine.
Versie: CSS Modules
Syntax
@page { @top-center { content: string(chapter, first); } }string() haalt een benoemde tekenreeks op die eerder met string-set is toegewezen. De functie hoort bij gegenereerde inhoud en gepagineerde media, bijvoorbeeld een doorlopende hoofdstuktitel in een paginamarge. Het is niet het gewone type <string>, geen JavaScript-conversie en geen opvraag van een aangepaste eigenschap. De naam is een identifier; content voegt de opgehaalde waarde in.
De optionele paginawaardekeuze is standaard first: de eerste toewijzing op de pagina, of de beginwaarde als er geen is. start neemt de eerste toewijzing als het bijbehorende element de pagina begint, anders de beginwaarde. last kiest de eindwaarde. first-except werkt als first, maar geeft een lege tekenreeks op een pagina waarop wordt toegewezen. Deze keuzes betreffen het gepagineerde document; alleen een gewone schermkop uitlezen toont ze niet aan.
Het gekoppelde CSS Generated Content-concept en de verwante GCPM-teksten beschrijven het mechanisme, maar bewijzen geen browserimplementatie. Chromium 157 ondersteunt in de test een geciteerd inhoudsliteraal, maar niet de benoemde toewijzing of beide opvraagvormen. Het voorbeeld behoudt een eerder opgegeven terugvalliteral in een pseudo-element en in de geparseerde paginamargedeclaratie. Het rendert geen benoemde lopende kop, maakt geen PDF en test de keuzes niet in een pagineringsengine.
Voorbeelden
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();Resultaat
quoted literal: true named assignment: false named retrieval: false page selector argument: false pseudo fallback: "Fallback" page margin declaration: "Fallback"
Dit is een uitgevoerde ondersteunings- en terugvaltest die false eerlijk vermeldt. Compatibiliteit van het gewone CSS-tekenreekstype bewijst de functie niet. Houd essentiële koppen in de documentinhoud en test de beoogde afdrukengine afzonderlijk.