Referência de recursos CSS

Descubra novos fluxos de trabalho nesta referência abrangente dos recursos do Chrome DevTools relacionados à visualização e alteração de CSS.

Consulte Conferir e mudar o CSS para aprender o básico.

Selecione um elemento

O painel Elements do DevTools permite visualizar ou mudar o CSS de um elemento por vez.

Na captura de tela, o elemento h1 destacado em azul na árvore DOM é o elemento selecionado. À direita, os estilos do elemento são mostrados na guia Styles. À esquerda, o elemento é destacado na viewport, mas apenas porque o mouse está passando sobre ele na árvore DOM.

Consulte Visualizar o CSS de um elemento para conferir um tutorial.

Há muitas maneiras de selecionar um elemento:

• Na viewport, clique com o botão direito do mouse no elemento e selecione Inspecionar.
• Nas Ferramentas do desenvolvedor, clique em Selecionar um elemento ou pressione Command+Shift+C (Mac) ou Control+Shift+C (Windows, Linux) e clique no elemento na viewport.
• Nas Ferramentas do desenvolvedor, clique no elemento na árvore DOM.
• No DevTools, execute uma consulta como document.querySelector('p') no Console, clique com o botão direito do mouse no resultado e selecione Revelar no painel "Elements".

Conferir o CSS

Use as guias Elements > Styles e Computed para conferir as regras de CSS e diagnosticar problemas.

Navegar com links

A guia Estilo mostra links em vários lugares para vários outros lugares, incluindo, entre outros:

• Ao lado de regras CSS, folhas de estilo e origens CSS. Esses links abrem o painel Origens. Se a folha de estilo for minimizada, consulte Como tornar um arquivo minimizado legível.
• Nas seções Herdado de ..., para elementos principais.
• Em chamadas var(), para declarações de propriedades personalizadas.
• Nas propriedades abreviadas animation, para @keyframes.
• Links Saiba mais nas dicas de ferramentas da documentação.
• e muito mais.

Confira alguns deles:

Os links podem ter estilos diferentes. Se você não tiver certeza se algo é um link, clique nele para descobrir.

Mostrar dicas com documentação do CSS, especificidade e valores de propriedade personalizados

Elementos > Estilo mostra dicas com informações úteis quando você passa o cursor sobre elementos específicos.

Conferir a documentação do CSS

Para ver uma dica com uma breve descrição do CSS, passe o cursor sobre o nome da propriedade na guia Styles.

Clique em Saiba mais para acessar uma referência do CSS da MDN sobre essa propriedade.

Para desativar as dicas, marque Não mostrar.

Para reativá-las, marque Configurações > Preferências > Elementos > Mostrar dica de ferramenta da documentação do CSS.

Conferir a especificidade do seletor

Passe o cursor sobre um seletor para ver uma dica com o peso de especificidade dele.

Conferir os valores das propriedades personalizadas

Passe o cursor sobre um --custom-property para conferir o valor dele em uma dica.

Conferir CSS inválidos, substituídos, inativos e outros

A guia Estilos reconhece muitos tipos de problemas de CSS e os destaca de maneiras diferentes.

Consulte Entender o CSS na guia "Styles".

Visualizar apenas o CSS que é realmente aplicado a um elemento

A guia Styles mostra todas as regras aplicadas a um elemento, incluindo declarações que foram substituídas. Quando você não tem interesse em declarações substituídas, use a guia Computed para ver apenas o CSS que está sendo aplicado a um elemento.

1. Selecione um elemento.
2. Acesse a guia Computed no painel Elements.

Marque a caixa de seleção Mostrar tudo para ver todas as propriedades.

Consulte Entender o CSS na guia "Computed".

Mostrar propriedades CSS em ordem alfabética

Use a guia Computed. Consulte Visualizar apenas o CSS que é realmente aplicado a um elemento.

Conferir propriedades CSS herdadas

Marque a caixa de seleção Mostrar tudo na guia Processado. Consulte Exibir apenas o CSS que é realmente aplicado a um elemento.

Como alternativa, role a guia Styles e encontre as seções com o nome Inherited from <element_name>.

Conferir regras CSS

As regras at são instruções CSS que permitem controlar o comportamento do CSS. Elements > Styles mostra as seguintes regras de at em seções dedicadas:

• @property
• @supports
• @scope
• @font-palette-values
• @position-try

Acessar regras @property

A regra @property CSS permite definir propriedades personalizadas do CSS explicitamente e registrá-las em uma folha de estilo sem executar nenhum JavaScript.

Passe o cursor sobre o nome dessa propriedade na guia Styles para ver uma dica de ferramenta com o valor, os descritores e um link para o registro da propriedade na seção @property colapsável na parte de baixo da guia Styles.

Para editar uma regra @property, clique duas vezes no nome ou valor dela.

Acessar regras @supports

A guia Estilos mostra as regras @supports CSS se elas forem aplicadas a um elemento. Por exemplo, inspecione o seguinte elemento:

Se o navegador for compatível com a função lab(), o elemento será verde. Caso contrário, ele será roxo.

Acessar regras @scope

A guia Estilos mostra as regras @scope CSS se elas forem aplicadas a um elemento.

As novas regras at-rules @scope fazem parte da especificação de nível 6 de cascata e herança do CSS. Essas regras permitem que você defina o escopo dos estilos CSS, ou seja, aplique explicitamente estilos a elementos específicos.

Confira a regra @scope na visualização abaixo:

1. Inspecione o texto no card na visualização.
2. Na guia Estilos, encontre a regra @scope.

Neste exemplo, a regra @scope substitui a declaração global de CSS background-color para todos os elementos <p> dentro de elementos com uma classe card.

Para editar a regra @scope, clique duas vezes nela.

Acessar regras @font-palette-values

A @font-palette-values CSS at-rule permite personalizar os valores padrão da propriedade font-palette. Elementos > Estilos mostra essa at-rule em uma seção dedicada.

Confira a seção @font-palette-values na próxima visualização:

1. Inspecione a segunda linha de texto na visualização.
2. Em Styles, encontre a seção @font-palette-values.

Neste exemplo, os valores da paleta de fontes --New substituem os padrões da fonte colorida.

Para editar os valores personalizados, clique duas vezes neles.

Acessar regras @position-try

A regra de CSS @position-try com a propriedade position-try-options permite definir posições de âncora alternativas para elementos. Para saber mais, consulte Introdução à API de posicionamento de âncora do CSS.

Elementos > Estilos resolve e vincula o seguinte:

• valores da propriedade position-try-options para uma seção @position-try --name dedicada.
• Valores de propriedade position-anchor e argumentos anchor() para os elementos correspondentes com atributos popovertarget.

Inspecione os valores position-try-options e as seções @position-try na próxima visualização:

1. Na visualização, abra o submenu, ou seja, clique em SUA CONTA e depois em LOJA VIRTUAL.
2. Inspecione o elemento com id="submenu" na visualização.
3. Em Estilos, encontre a propriedade position-try-options e clique no valor --bottom. A guia Estilos leva você à seção @position-try correspondente.
4. Clique no link do valor position-anchor ou nos mesmos argumentos anchor(). O painel Elements seleciona o elemento com o atributo popovertarget correspondente, e a guia Styles mostra o CSS do elemento.

Para editar valores, clique duas vezes neles.

Conferir o modelo de caixa de um elemento

Para conferir o modelo de caixa de um elemento, acesse a guia Styles e clique no botão Show sidebar na barra de ações.

Para mudar um valor, clique duas vezes nele.

Pesquisar e filtrar o CSS de um elemento

Use a caixa Filtro nas guias Styles e Computed para pesquisar propriedades ou valores CSS específicos.

Para pesquisar propriedades herdadas na guia Computed, marque a caixa de seleção Show All.

Para navegar pela guia Computed, agrupe as propriedades filtradas em categorias colapsáveis marcando Group.

Emular uma página em foco

Se você mudar o foco da página para o DevTools, alguns elementos de sobreposição vão se ocultar automaticamente se forem acionados pelo foco. Por exemplo, listas suspensas, menus ou seletores de data. A opção check_box Emulate a focused page permite depurar esse elemento como se ele estivesse em foco.

Tente emular uma página em foco nesta página de demonstração:

1. Focar o elemento de entrada. Outro elemento aparece abaixo dele.
2. Abra o DevTools. A janela do DevTools agora está em foco em vez da página, então o elemento desaparece novamente.
3. Em Elements > Styles, clique em :hov, marque check_box Emulate a focused page e verifique se o elemento de entrada está selecionado. Agora você pode inspecionar o elemento abaixo dele.

Você também pode encontrar a mesma opção no painel Rendering.

Para descobrir mais maneiras de congelar um elemento, consulte Congelar a tela e inspecionar elementos que desaparecem.

Ativar uma pseudoclasse

Para alternar uma pseudoclasse:

1. Selecione um elemento.
2. No painel Elementos, acesse a guia Estilos.
3. Clique em :hov.
4. Marque a pseudoclasse que você quer ativar.

Neste exemplo, é possível ver que o DevTools aplica a declaração background-color ao elemento, mesmo que ele não esteja sendo apontado.

A guia Styles mostra as seguintes pseudoclasses para todos os elementos:

• :active
• :focus
• :focus-within
• :target
• :hover
• focus-visible

Além disso, alguns elementos podem ter as próprias pseudoclasses. Quando você seleciona um desses elementos, a guia Styles mostra uma seção Force specific element state que pode ser expandida para ativar as pseudoclasses específicas do elemento.

Consulte Adicionar um pseudoestado a uma classe para conferir um tutorial interativo.

Acessar pseudoelementos de destaque herdados

Os pseudoelementos permitem definir o estilo de partes específicas dos elementos. Os pseudoelementos de destaque são partes do documento com status "selecionado" e têm o estilo "destacado" para indicar esse status ao usuário. Por exemplo, esses pseudoelementos são ::selection, ::spelling-error, ::grammar-error e ::highlight.

Como mencionado na especificação, quando vários estilos entram em conflito, a cascata determina o estilo vencedor.

Para entender melhor a herança e a prioridade das regras, você pode conferir os pseudoelementos de destaque herdados:

1. Inspecione o texto abaixo.

   Herdei o estilo do pseudoelemento de destaque do meu elemento pai. Escolha-me!

2. Selecione uma parte do texto acima.

3. Na guia Estilos, role para baixo até encontrar a seção Inherited from ::selection pseudo of....

Conferir camadas em cascata

As camadas em cascata permitem um controle mais explícito dos arquivos CSS para evitar conflitos de especificidade de estilo. Isso é útil para bases de código grandes, sistemas de design e ao gerenciar estilos de terceiros em aplicativos.

Para conferir as camadas em cascata, inspecione o próximo elemento e abra Elementos > Estilos.

Na guia Estilo, confira as três camadas em cascata e os estilos delas: page, component e base.

Para conferir a ordem das camadas, clique no nome da camada ou no botão Ativar a visualização das camadas CSS.

A camada page tem a maior especificidade. Portanto, o plano de fundo do elemento é verde.

Conferir uma página no modo de impressão

Para ver uma página no modo de impressão:

1. Abra o Command Menu.
2. Comece a digitar Rendering e selecione Show Rendering.
3. No menu suspenso Emulate CSS Media, selecione print.

Conferir CSS usados e não usados com a guia "Cobertura"

A guia "Cobertura" mostra qual CSS uma página usa.

1. Pressione Command+Shift+P (Mac) ou Control+Shift+P (Windows, Linux, ChromeOS) enquanto as Ferramentas do desenvolvedor estão em foco para abrir o menu de comando.

2. Comece a digitar coverage.

   

3. Selecione Mostrar cobertura. A guia "Cobertura" vai aparecer.

   

4. Clique em Atualizar. A página é recarregada, e a guia Coverage mostra uma visão geral de quanto CSS (e JavaScript) é usado em cada arquivo carregado pelo navegador.

   

   O verde representa o CSS usado. O vermelho representa o CSS não usado.

5. Clique em um arquivo CSS para conferir um detalhamento linha por linha do CSS usado na visualização acima.

   

   Na captura de tela, as linhas 55 a 57 e 65 a 67 de devsite-google-blue.css não são usadas, enquanto as linhas 59 a 63 são usadas.

Forçar o modo de visualização de impressão

Consulte Forçar o DevTools no modo de visualização de impressão.

Copiar CSS

Em um único menu suspenso na guia Styles, é possível copiar regras, declarações, propriedades e valores do CSS separados.

Além disso, é possível copiar propriedades CSS na sintaxe JavaScript. Essa opção é útil se você estiver usando bibliotecas CSS-in-JS.

Para copiar CSS:

1. Selecione um elemento.
2. Na guia Elements > Styles, clique com o botão direito do mouse em uma propriedade CSS.

3. Selecione uma das seguintes opções no menu suspenso:

   • Copiar declaração. Copia a propriedade e o valor dela na sintaxe CSS: css property: value;
   • Copiar propriedade. Copia apenas o nome property.
   • Copiar valor. Copia apenas o value.
   • Copiar regra. Copia toda a regra CSS: css selector[, selector] { property: value; property: value; ... }
   • Copiar a declaração como JS. Copia a propriedade e o valor dela na sintaxe do JavaScript: js propertyInCamelCase: 'value'
   • Copiar todas as declarações. Copia todas as propriedades e os valores delas na regra CSS: css property: value; property: value; ...

   • Copiar todas as declarações como JS. Copia todas as propriedades e os valores delas na sintaxe JavaScript: ```js propertyInCamelCase: 'value', propertyInCamelCase: 'value', ...

   • Copie todas as mudanças de CSS. Copia as mudanças feitas na guia Estilo em todas as declarações.

   • Conferir o valor calculado. Vai para a guia Computed.

Mudar CSS

Esta seção lista todas as maneiras de mudar o CSS em Elementos > Estilos.

Também é possível:

• Modifique o CSS em todos os carregamentos de página.
• Salve o CSS modificado nas suas origens locais em um espaço de trabalho.

Adicionar uma declaração CSS a um elemento

Como a ordem das declarações afeta o estilo de um elemento, é possível adicionar declarações de diferentes maneiras:

• Adicione uma declaração inline. É equivalente a adicionar um atributo style ao HTML do elemento.
• Adicionar uma declaração a uma regra de estilo.

Qual fluxo de trabalho você deve usar? Na maioria dos cenários, é recomendável usar o fluxo de trabalho de declaração inline. As declarações inline têm maior especificidade do que as externas. Portanto, o fluxo de trabalho inline garante que as mudanças tenham efeito no elemento como esperado. Consulte Tipos de seletor para mais informações sobre especificidade.

Se você estiver depurando os estilos de um elemento e precisar testar especificamente o que acontece quando uma declaração é definida em lugares diferentes, use o outro fluxo de trabalho.

Adicionar uma declaração inline

Para adicionar uma declaração inline:

1. Selecione um elemento.
2. Na guia Styles, clique entre os colchetes da seção element.style. O cursor é focado, permitindo que você insira texto.
3. Digite o nome de uma propriedade e pressione Enter.

4. Insira um valor válido para essa propriedade e pressione Enter. Na árvore DOM, é possível ver que um atributo style foi adicionado ao elemento.

   

   Na captura de tela, as propriedades margin-top e background-color foram aplicadas ao elemento selecionado. Na árvore DOM, é possível ver as declarações refletidas no atributo style do elemento.

Adicionar uma declaração a uma regra de estilo

Para adicionar uma declaração a uma regra de estilo:

1. Selecione um elemento.
2. Na guia Styles, clique entre os colchetes da regra de estilo a que você quer adicionar a declaração. O cursor é focado, permitindo que você insira texto.
3. Digite o nome de uma propriedade e pressione Enter.
4. Insira um valor válido para essa propriedade e pressione Enter.

Na captura de tela, uma regra de estilo recebe a nova declaração border-bottom-style:groove.

Mudar o nome ou o valor de uma declaração

Clique duas vezes no nome ou valor de uma declaração para fazer alterações. Consulte Alterar valores enumeráveis com atalhos de teclado para saber como incrementar ou decrementar um valor rapidamente em 0, 1, 1, 10 ou 100 unidades.

Mudar valores enumeráveis com atalhos do teclado

Ao editar um valor enumerável de uma declaração, por exemplo, font-size, use os seguintes atalhos de teclado para incrementar o valor em uma quantidade fixa:

• Option+Up (Mac) ou Alt+Up (Windows, Linux) para incrementar em 0,1.
• Para cima para mudar o valor em 1 ou 0, 1 se o valor atual estiver entre -1 e 1.
• Shift+Up para incrementar em 10.
• Shift+Command+Up (Mac) ou Control+Shift+Page Up (Windows, Linux) para incrementar o valor em 100.

A decrementação também funciona. Basta substituir cada instância de Up mencionada anteriormente por Down.

Mudar valores de comprimento

Você pode usar o ponteiro para mudar qualquer propriedade com comprimento, como largura, altura, padding, margem ou borda.

Para mudar a unidade de comprimento:

1. Passe o cursor sobre o nome da unidade e observe que ele está sublinhado.

2. Clique no nome da unidade para selecionar uma opção no menu suspenso.

Para mudar o valor da duração:

1. Passe o cursor sobre o valor da unidade e observe que o ponteiro muda para uma seta horizontal de duas pontas.

2. Arraste na horizontal para aumentar ou diminuir o valor.

Para ajustar o valor em 10, segure Shift ao arrastar.

Adicionar uma classe a um elemento

Para adicionar uma classe a um elemento:

1. Selecione o elemento na árvore DOM.
2. Clique em .cls.
3. Digite o nome da turma na caixa Add New Class.
4. Pressione Enter.

Emular as preferências de tema claro e escuro e ativar o modo escuro automático

Para alternar o modo escuro automático ou emular a preferência do usuário por temas claros ou escuros:

1. Na guia Elements > Styles, clique em Toggle common rendering emulations.

2. Selecione uma das seguintes opções na lista suspensa:

   • prefers-color-scheme: light. Indica que o usuário prefere o tema claro.
   • prefers-color-scheme: dark. Indica que o usuário prefere o tema escuro.
   • Modo escuro automático. Mostra a página no modo escuro mesmo que você não tenha implementado esse modo. Além disso, define prefers-color-scheme como dark automaticamente.

Esse menu suspenso é um atalho para as opções Emular recurso de mídia CSS prefers-color-scheme e Ativar o modo escuro automático da guia Renderização.

Ativar ou desativar uma turma

Para ativar ou desativar uma classe em um elemento:

1. Selecione o elemento na árvore DOM.
2. Abra a seção Classes de elementos. Consulte Adicionar uma classe a um elemento. Abaixo da caixa Add New Class estão todas as classes que estão sendo aplicadas a esse elemento.
3. Alterne a caixa de seleção ao lado da classe que você quer ativar ou desativar.

Adicionar uma regra de estilo

Para adicionar uma nova regra de estilo:

1. Selecione um elemento.
2. Clique em Nova regra de estilo . As Ferramentas do desenvolvedor inserem uma nova regra abaixo da regra element.style.

Na captura de tela, as Ferramentas do desenvolvedor adicionam a regra de estilo h1.devsite-page-title depois de clicar em Nova regra de estilo.

Escolha a folha de estilo para adicionar uma regra

Ao adicionar uma nova regra de estilo, clique e mantenha pressionada Nova regra de estilo para escolher a folha de estilo em que a regra de estilo será adicionada.

Ativar ou desativar uma declaração

Para ativar ou desativar uma única declaração:

1. Selecione um elemento.
2. Na guia Estilo, passe o cursor sobre a regra que define a declaração. As caixas de seleção aparecem ao lado de cada declaração.
3. Marque ou desmarque a caixa de seleção ao lado da declaração. Quando você limpa uma declaração, as Ferramentas do desenvolvedor a trancam para indicar que ela não está mais ativa.

Na captura de tela, a propriedade color do elemento selecionado está desativada.

Editar os pseudoelementos ::view-transition durante uma animação

Consulte a seção correspondente em Animações.

Para mais informações, consulte Transições simples e suaves com a API View Transitions.

Alinhar itens da grade e o conteúdo deles com o editor de grade

Consulte a seção correspondente na grade de inspeção do CSS.

Mudar cores com o seletor de cores

Consulte Inspecionar e depurar cores em HD e não em HD com o seletor de cores.

Mudar o valor do ângulo com o relógio de ângulo

O Angle Clock (link em inglês) oferece uma GUI para alterar <angle>s em valores de propriedades CSS.

Para abrir o Relógio de ângulo:

1. Selecione um elemento com declaração de ângulo.

2. Na guia Styles, encontre a declaração transform ou background que você quer mudar. Clique na caixa Visualização de ângulo ao lado do valor do ângulo.

   

   Os pequenos relógios à esquerda de -5deg e 0.25turn são as visualizações de ângulo.

3. Clique na visualização para abrir o Relógio de ângulo.

   

4. Mude o valor do ângulo clicando no círculo Angle Clock ou role o mouse para aumentar / diminuir o valor do ângulo em 1.

5. Há mais atalhos de teclado para mudar o valor do ângulo. Saiba mais nos Atalhos do teclado do painel de estilos.

Mudar as sombras de caixa e de texto com o editor de sombras

O editor de sombra (link em inglês) oferece uma GUI para alterar as declarações de CSS text-shadow e box-shadow.

Para mudar as sombras com o Editor de sombras:

1. Selecione um elemento com uma declaração de sombra. Por exemplo, selecione o próximo elemento.

2. Na guia Estilo, encontre um ícone de sombra ao lado da declaração text-shadow ou box-shadow.

   

3. Clique no ícone de sombra para abrir o editor de sombra.

   

4. Mude as propriedades da sombra:

   • Tipo (somente para box-shadow). Escolha Saliente ou Recuo.
   • Deslocamentos X e Y. Arraste o ponto azul ou especifique valores.
   • Desfoque. Arraste o controle deslizante ou especifique um valor.
   • Spread (somente para box-shadow). Arraste o controle deslizante ou especifique um valor.

5. Observe as mudanças aplicadas ao elemento.

Editar animações e tempos de transição com o Editor de easing

O editor de transição fornece uma GUI para mudar os valores de transition-timing-function e animation-timing-function.

Para abrir o Editor de transição:

1. Selecione um elemento com uma declaração de função de temporização, como o elemento <body> nesta página.
2. Na guia Styles, encontre o ícone roxo ao lado das declarações transition-timing-function, animation-timing-function ou da propriedade abreviada transition.
3. Clique no ícone para abrir o Editor de transição:

Usar predefinições para ajustar os tempos

Para ajustar os tempos com um clique, use as predefinições no Easing Editor:

1. No Editor de transição, para definir um valor de palavra-chave, clique em um dos botões do seletor:
   • linear
   • ease-in-out
   • ease-in
   • ease-out

2. No interruptor de predefinições, clique nos botões ou para escolher uma das seguintes predefinições:

   • Predefinições lineares: elastic, bounce ou emphasized.
   • Predefinições de Cubic Bezier:

Configurar tempos personalizados

Para definir valores personalizados para funções de temporização, use os pontos de controle nas linhas:

• Para funções lineares, clique em qualquer lugar na linha para adicionar um ponto de controle e arraste-o. Clique duas vezes para remover o ponto.

  

• Para funções cúbicas de Bezier, arraste um dos pontos de controle.

  

Qualquer mudança aciona uma animação de bola na Visualização na parte de cima do editor.

(Experimental) Copiar mudanças de CSS

Com esse experimento ativado, a guia Styles destaca as mudanças de CSS em verde.

Para copiar uma única mudança de declaração de CSS, passe o cursor sobre a declaração destacada e clique no botão Copiar.

Para copiar todas as mudanças de CSS nas declarações de uma só vez, clique com o botão direito do mouse em qualquer declaração e selecione Copiar todas as mudanças de CSS.

Além disso, você pode monitorar as mudanças feitas na guia Mudanças.