Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

string() : texte nommé pour le contenu généré des pages

Distinguez la fonction proposée pour les chaînes nommées du texte CSS entre guillemets et vérifiez le moteur réel.

Version : CSS Modules

Syntaxe

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

string() récupère une chaîne nommée précédemment affectée par string-set. Elle appartient aux travaux sur le contenu généré et les médias paginés, notamment pour un titre de chapitre courant dans une marge. Ce n’est ni le type ordinaire <string>, ni une conversion JavaScript, ni une lecture de propriété personnalisée. Le nom est un identifiant et la valeur récupérée est insérée par content.

Le sélecteur de valeur facultatif vaut par défaut first : première affectation sur la page, ou valeur d’entrée si aucune n’a lieu. start prend la première affectation si son élément commence la page, sinon la valeur d’entrée. last choisit la valeur de sortie. first-except suit first, mais produit une chaîne vide sur une page où la valeur est affectée. Ces choix concernent le document paginé ; lire un titre d’écran ordinaire ne les démontre pas.

Le projet CSS Generated Content lié et les travaux GCPM associés décrivent ce mécanisme, sans prouver son implémentation dans un navigateur. Chromium 157 accepte dans le test un littéral de contenu entre guillemets, mais pas l’affectation nommée ni les deux formes de récupération. L’exemple conserve un littéral de repli déclaré avant, dans un pseudo-élément et dans la déclaration de marge analysée. Il ne rend pas d’en-tête courant nommé, ne crée pas de PDF et ne teste pas ces sélecteurs dans un moteur de pagination.

Exemples

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

Résultat

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

C’est un test exécuté de prise en charge et de repli, qui rapporte honnêtement false. La compatibilité du type chaîne CSS ordinaire ne prouve pas celle de la fonction. Gardez les titres essentiels dans le document et testez séparément le moteur d’impression prévu.

Sources