WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

string(): benannter Text für generierten Seiteninhalt

Unterscheide die entworfene Funktion für benannte Zeichenketten von gewöhnlichem CSS-Text und prüfe die tatsächliche Engine-Unterstützung.

Version: CSS Modules

Syntax

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

string() liest eine benannte Zeichenkette, die zuvor mit string-set zugewiesen wurde. Die Funktion gehört zu generierten Inhalten und Seitenmedien, etwa für eine laufende Kapitelüberschrift im Seitenrand. Sie ist weder der gewöhnliche Typ <string> noch eine JavaScript-Konvertierung oder ein Zugriff auf eine benutzerdefinierte Eigenschaft. Der Name ist ein Bezeichner; der ermittelte Text wird über content eingefügt.

Die optionale Seitenauswahl ist standardmäßig first: erste Zuweisung auf der Seite oder bei deren Fehlen der Eingangswert. start nimmt die erste Zuweisung, wenn ihr Element die Seite beginnt, sonst den Eingangswert. last verwendet den Ausgangswert. first-except entspricht first, liefert aber auf einer Seite mit Zuweisung einen leeren Text. Diese Auswahl betrifft das paginierte Dokument und lässt sich nicht durch bloßes Lesen einer Bildschirmüberschrift demonstrieren.

Der verlinkte CSS-Generated-Content-Entwurf und die verwandten GCPM-Arbeiten beschreiben den Mechanismus; das beweist keine Browserimplementierung. Chromium 157 unterstützt im Test ein zitiertes Inhaltsliteral, aber weder die benannte Zuweisung noch beide Abrufformen. Das Beispiel erhält ein zuvor deklariertes Literal als Fallback im Pseudoelement und in der gelesenen Seitenranddeklaration. Es rendert keine benannte laufende Kopfzeile, erzeugt kein PDF und prüft die Auswahlsemantik nicht in einer Paginierungsengine.

Beispiele

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();

Ergebnis

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

Dies ist eine ausgeführte Unterstützungs- und Fallbackprüfung, die false ehrlich ausweist. Die Kompatibilität des normalen CSS-Zeichenkettentyps belegt nicht die Funktion. Wichtige Überschriften gehören in den Dokumentinhalt; der vorgesehene Druckrenderer braucht einen eigenen Test.

Quellen