Layout & CSS Mais detalhes A2 · especificação formal

CSS Custom Property

Propriedade personalizada do CSS

Uma CSS custom property é um valor CSS reutilizável, muitas vezes chamado de variável CSS. Ela segue a cascata e pode mudar de acordo com o escopo ou tema.

Veja como funciona
Você poderia chamar de CSS Custom Propertyvariável CSSPropriedade personalizada

Veja como funciona

Exemplo trabalhado originalPropriedade personalizada do CSS

Outro exemplo

Um cartão pega seus valores --surface e --text do tema claro ou escuro que está ativo.

Partes principais

  1. 01Foundation or token
  2. 02Applied component
  3. 03Visible state and rule

Use-o quando

Use propriedades personalizadas para temas, tokens de design e valores compartilhados no CSS.

Não o use quando

Nunca armazene o conteúdo da página ou cada número único em propriedades personalizadas globais.

Nome usado no código

--token-name

Antes de lançar

Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience.

Solicitação que você pode copiar

Outcome: Complete the task with Propriedade personalizada do CSS (CSS Custom Property). User context: Um cartão pega seus valores --surface e --text do tema claro ou escuro que está ativo. Design concept to apply: Propriedade personalizada do CSS (CSS Custom Property). Why it fits: Use propriedades personalizadas para temas, tokens de design e valores compartilhados no CSS. Do not use it when: Nunca armazene o conteúdo da página ou cada número único em propriedades personalizadas globais. Design requirements: Set the content order, shared design values, and reusable components. Define how the layout changes by screen size and state. Keep useful design choices separate from decoration. Inclusion and resilience: Check contrast, zoom, languages, themes, and reduced motion when needed. Do not use color or effects as the only way to show meaning. Acceptance criteria: The design stays clear on phones and desktops, at zoom, in every theme, and in all supported languages. Interactive states stay clear and consistent. Evidence and limits (evidence boundary): Um documento formal ainda pode ser rascunho, release candidate ou versão final. Cheque o status e o suporte no navegador ou plataforma. Unknowns to confirm: Brand limits, amount of content, supported themes and languages, target devices, and design-system rules.

Conferir este pedido

Review how Propriedade personalizada do CSS (CSS Custom Property) is used now. Definition: Uma CSS custom property é um valor CSS reutilizável, muitas vezes chamado de variável CSS. Ela segue a cascata e pode mudar de acordo com o escopo ou tema. Release checks: Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.

A2
Quão oficial é este termo?

especificação formal

Uma especificação formal publicada e com versão define este termo para a área técnica listada.

Um documento formal ainda pode ser rascunho, release candidate ou versão final. Cheque o status e o suporte no navegador ou plataforma.

Escopo
Apenas o que a fonte cobre:nome canônico、definição、semântica、implementação
Status do documento
rascunho
Verificado em
2026-07-30

Fontes e escopo da evidência

Fonte de autoridade + Referência do termo · W3C CSS Working Group · rascunho CSS Custom Properties for Cascading Variables Level 1 — Defining custom properties Defining custom properties Escopo: nome canônico、definição、semântica、implementação Papel aqui: Referência direta ao termo A fonte cobre: nome canônico, definição, semântica, implementação Fonte de autoridade · W3C CSS Working Group · rascunho CSS Custom Properties for Cascading Variables Level 1 Escopo: nome canônico、definição、semântica、implementação Papel aqui: Autoridade dentro do escopo definido A fonte cobre: nome canônico, definição, semântica, implementação

Copie você mesmo

O navegador não conseguiu copiar isso. Selecione a solicitação abaixo e copie você mesmo.