Seletor CSS

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Nesta página:

Existem várias áreas do aplicativo axe Auditor que fornecem um campo de Seletor . Siga este processo quando quiser especificar um determinado seletor CSS para ser testado como parte dos seguintes:

  • Componente Comum (Novo Caso de Teste > Adicionar Componente): Ao definir um componente comum no painel de Componentes Comuns ao criar um novo Caso de Teste.
  • Componente de Área da Página (Novo Caso de Teste > Adicionar Página > Escopo da Área da Página): Ao definir uma Área da Página no painel Adicionar Páginas ao criar um novo Caso de Teste.
  • Componente de Área da Página (Preparar Página para Teste Automatizado e Manual > Escopo da Área da Página): Ao definir uma Área da Página da "página em teste" na tela Preparar Página para Teste Automatizado e Manual acessada a partir da Visão Geral de Execução de Testes.

Introdução

Localizar e copiar um seletor geralmente envolve o uso das "ferramentas de desenvolvedor" que acompanham seu navegador web. Essas ferramentas têm diferentes nomes dependendo do tipo de navegador, e cada uma oferece atalhos de teclado para acessar as ferramentas e navegar dentro delas.

Referência de Atalhos de Teclado por Tipo de Navegador

No Mac: Geralmente, a tecla Cmd () pode ser substituída por [Ctrl] em um dispositivo OSX ou iOS.

Abrindo Ferramentas de Desenvolvedor (Exemplo do Firefox)

O exemplo a seguir descreve o uso das Ferramentas de Desenvolvedor do Mozilla Firefox. Para mais informações sobre o uso de atalhos de teclado com as Ferramentas de Desenvolvedor do Firefox, consulte Atalhos de Teclado do Desenvolvedor Mozilla.

Você pode abrir o Inspetor (uma das Ferramentas de Desenvolvedor que inicia todas elas) de uma das seguintes maneiras:

  • Sem um elemento selecionado: Escolha a **Inspetor** opção no menu **Desenvolvedor** **(Ctrl+Shift+I)**, ou na Barra de Menu do Firefox, selecione **Ferramentas > Desenvolvedor Web > Inspetor (Ctrl+Shift+C)**.
  • Com um elemento selecionado*: **Clique com o botão direito** em um elemento na página web e selecione **Inspecionar Elemento [(Q)]{.kbd}**.

Copiando um Seletor de uma página

  1. Right-click na região desejada da página de teste, então selecione Inspect Element no menu para iniciar o Inspetor, assim você poderá selecionar um elemento na página (ou use o atalho de teclado Ctrl+Shift+I).
    Context menu showing Inspect Element option after right-clicking on the page under test
  2. Copie o seletor CSS que você deseja direcionar. Por exemplo, ao usar as Ferramentas para Desenvolvedores do Firefox, você pode right-click > Copy Unique Selector para o elemento atualmente selecionado na ferramenta Inspetor. Certifique-se de colar a referência completa do elemento formatada corretamente (por exemplo, para testar o id elemento de atributo para o valor 'main', você especificaria #main como o seletor).
    Firefox Developer Tools context menu showing Copy Unique Selector option

    Information - Selector Formatting Reference with Example:
    Para detalhes completos sobre seletores CSS formatados corretamente e referência completa de elementos, consulte documentação do Mozilla Developer sobre Seletor CSS ou Recomendação W3C de Selectors Level 3.

    • Selector: #id → O seletor #id estiliza o elemento com o ID especificado.
    • Example: #main → O ID especificado é main.
    • Example Reference: Seleciona o elemento com id="main".
    DevTools Inspect Element showing CSS selector for an element with id=main
  3. Cole o seletor que você copiou da área de transferência virtual no campo Selector .
    Quando você acessa os problemas resultantes encontrados para o componente ou área da página alvo, verá incluídos aqueles relacionados ao seletor CSS específico que você inseriu.
  4. Bug conhecido: Ao usar o Seletor CSS no navegador Chrome. Clique com o botão direito em Inspecionar, abra as ferramentas de desenvolvimento, na aba elementos, encontre o seletor CSS para clicar no alvo e, no elemento, copie > xpath ou elemento > copie > xpath completo sempre retorna este erro,\ 'Ocorreu um erro desconhecido. Se este caso de teste contém qualquer componente ou área de página, certifique-se de que todos os seletores são válidos'.
    Workaround: Encontre o ID para o Seletor CSS e use Copy > Copy Selector.

O que são Seletores?

**Resposta Rápida**: Eles são cadeias de texto que podem ser usadas para identificar um elemento ou grupo de elementos em uma página web.

**Resposta Ligeiramente Mais Longa e Técnica**: Seletores são padrões que correspondem a elementos em uma estrutura de árvore e podem ser usados para testar fragmentos específicos ou selecionar nós dentro de documentos HTML ou XML. A linguagem Cascading Style Sheet (CSS3) descreve a renderização de documentos HTML na tela ou em fala, e usa seletores para vincular propriedades de estilo a elementos em documentos HTML.

**Uso**: Avaliando a expressão em todos os elementos em uma subárvore, os seletores podem ser usados para:

  • Selecionar um conjunto de elementos
  • Selecionar um único elemento de um conjunto de elementos

**Estrutura**: Um seletor representa uma estrutura que pode ser usada como uma condição (como em uma regra CSS) que determina quais elementos um seletor corresponde em uma árvore de documentos ou como uma descrição simples do fragmento de HTML ou XML correspondente a essa estrutura.

Tipos: Os tipos de seletores incluem:

  • Universal: O nome qualificado de qualquer tipo de elemento (*) Por exemplo, para especificar o nome qualificado de qualquer elemento em inglês na árvore de documentos para qualquer namespace, insira:

    *[hreflang|=en]

  • Tipo: Um prefixo de componente de namespace opcional precedido ao nome de um elemento (|) Por exemplo, para representar um elemento de cabeçalho 2 na árvore de documentos, simplesmente insira:

    h2

  • Atributo: Representa um atributo de um elemento ([]) Por exemplo, para representar um elemento h3 que possui o atributo título, qualquer que seja seu valor, insira:

    h3[title]

  • Classe: Notação de ponto para representar o atributo de classe para o respectivo namespace (.) Por exemplo, para atribuir informação de estilo de cor verde a todos os elementos com a classe ="example", insira:

    .example { color: green } / todos os elementos com classe=example */

  • ID: Atributos declarados como do tipo ID identificam unicamente um elemento com um símbolo de número (#) Por exemplo, para representar um seletor de ID onde qualquer elemento cujo atributo de tipo ID seja "12345", insira:

    #12345

  • Pseudo-classes: Seleção de informações fora da árvore de documentos que não podem ser expressas com seletores simples (:) Por exemplo, para especificar um seletor que representa links com a classe externa que já foram visitados, insira:

    a.external:visited

  • Pseudo-elementos: Dois-pontos seguidos pelo nome de um pseudo-elemento permitem acesso ao conteúdo além da árvore de documentos atual, e apenas um por seletor é permitido (::)

    Por exemplo, para alterar as letras da primeira linha de cada elemento p para maiúsculas, insira:

    p::first-line { text-transform: uppercase }

  • Combinadores: Permitem a especificação de um caminho hierárquico para mostrar a ancestralidade, como elementos filho ou irmão ( ) ou (+)

    Por exemplo, para direcionar elementos em que são descendentes de elementos h1, insira:

    h1 em.

    É uma descrição correta e válida, mas parcial, do seguinte fragmento:

    <h1>Este <span class="myclass"> título é <em>muito>/em> importante</span></h1>

Sintaxe: A "gramática" básica dos seletores inclui o seguinte:

  • *: 0 ou mais (Nota: Como isso pode ser omitido quando implícito, não é usado com frequência.)
  • +: 1 ou mais
  • ?: 0 ou 1
  • |: separa alternativas
  • [ ]: agrupamento

Referência Compreensiva: Para mais informações, consulte o World Wide Web Consortium (W3C) - Selectors Level 3: https://drafts.csswg.org/selectors-3/

Tópicos Relacionados: