Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

string(): texto com nome para conteúdo gerado das páginas

Distingue a função proposta para cadeias com nome do texto CSS normal entre aspas e verifica o motor real.

Versão: CSS Modules

Sintaxe

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

string() obtém uma cadeia com nome atribuída anteriormente por string-set. Pertence aos trabalhos sobre conteúdo gerado e meios paginados, por exemplo para o título corrente de um capítulo na margem. Não é o tipo normal <string>, uma conversão JavaScript nem uma consulta de propriedade personalizada. O nome é um identificador e o valor obtido é inserido através de content.

O seletor opcional de valor da página é first por predefinição: a primeira atribuição na página ou o valor de entrada se não houver nenhuma. start usa a primeira atribuição se o seu elemento iniciar a página; caso contrário, usa o valor de entrada. last escolhe o valor de saída. first-except funciona como first, mas produz uma cadeia vazia numa página onde o valor seja atribuído. Estas escolhas dizem respeito ao documento paginado e não se demonstram lendo um título normal no ecrã.

O projeto CSS Generated Content ligado e os trabalhos GCPM relacionados descrevem o mecanismo, mas não provam a sua implementação no navegador. No teste, o Chromium 157 suporta um literal de conteúdo entre aspas, mas não a atribuição com nome nem as duas formas de obtenção. O exemplo mantém um literal de recurso anterior num pseudoelemento e na declaração analisada da margem da página. Não renderiza um cabeçalho corrente com nome, não cria PDF nem testa os seletores num motor de paginação.

Exemplos

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

Resultado

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

É uma verificação executada de suporte e alternativa, com resultados false indicados com clareza. A compatibilidade do tipo normal de cadeia CSS não comprova a função. Mantém os títulos essenciais no documento e testa separadamente o motor de impressão pretendido.

Fontes