Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

string(): testo nominato per il contenuto generato delle pagine

Distingui la funzione proposta per stringhe nominate dal normale testo CSS tra virgolette e verifica il motore reale.

Versione: CSS Modules

Sintassi

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

string() recupera una stringa nominata assegnata in precedenza tramite string-set. Rientra nei lavori sui contenuti generati e sui media impaginati, per esempio per il titolo corrente del capitolo nel margine. Non è il tipo ordinario <string>, una conversione JavaScript o l’accesso a una proprietà personalizzata. Il nome è un identificatore e il valore recuperato viene inserito tramite content.

Il selettore facoltativo del valore di pagina è predefinito a first: la prima assegnazione sulla pagina, oppure il valore in ingresso se non ce ne sono. start usa la prima assegnazione se il suo elemento inizia la pagina, altrimenti il valore in ingresso. last sceglie il valore in uscita. first-except segue first, ma emette una stringa vuota su una pagina in cui avviene l’assegnazione. Queste scelte riguardano il documento impaginato e non si dimostrano leggendo un normale titolo sullo schermo.

La bozza CSS Generated Content collegata e i lavori GCPM correlati descrivono il meccanismo, senza dimostrarne l’implementazione nel browser. Nel test Chromium 157 supporta un letterale di contenuto tra virgolette, ma non l’assegnazione nominata né le due forme di recupero. L’esempio conserva un letterale di ripiego precedente in uno pseudoelemento e nella dichiarazione analizzata del margine. Non renderizza un’intestazione corrente nominata, non crea PDF e non prova i selettori in un motore di impaginazione.

Esempi

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

Risultato

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

È una prova eseguita di supporto e ripiego, con risultati false dichiarati chiaramente. La compatibilità del normale tipo stringa CSS non dimostra quella della funzione. Mantieni i titoli essenziali nel documento e prova separatamente il motore di stampa previsto.

Fonti