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 no aplicativo axe Auditor que fornecem um campo de Seletor . Siga este processo quando quiser especificar um seletor CSS específico 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 Testes Automatizados e Manuais > Escopo da Área da Página): Ao definir uma Área da Página da "página em teste" na tela Preparar Página para Testes Automatizados e Manuais acessada a partir da Visão Geral do Teste.

Introdução

Localizar e copiar um seletor normalmente envolve o uso das "ferramentas de desenvolvedor" que acompanham seu navegador web. Elas têm nomes diferentes 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

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

Abrindo as Ferramentas de Desenvolvedor (Exemplo do Firefox)

O exemplo a seguir mostra 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) das seguintes maneiras:

  • Sem um elemento selecionado: Escolha o **Inspetor** opção do **Desenvolvedor** menu (Ctrl+Shift+I), ou na barra de menus do Firefox, selecione **Ferramentas > Desenvolvedor Web > Inspetor (Ctrl+Shift+C)**.
  • Com um elemento selecionado*: **Clique com o botão direito** em um elemento de uma 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, em seguida selecione Inspect Element no menu para iniciar o Inspetor, assim você pode então selecionar um elemento na página (ou usar 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 de Desenvolvedor 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 devidamente formatada (por exemplo, para testar o id atributo de elemento para o valor 'principal', 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, veja a documentação de Seletor CSS Web da Mozilla Developer ou a Recomendação do W3C para Seletores Nível 3.

    • Selector: #id → O #id seletor 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 Selector campo.
    Ao acessar os problemas resultantes encontrados para o componente ou área da página alvo, você verá incluídos aqueles relacionados ao seletor CSS específico que você inseriu.
  4. Erro conhecido: Ao usar o Seletor CSS no Navegador Chrome. Clique direito para Inspecionar, Abra as ferramentas de desenvolvimento, na aba de elementos, encontre o seletor css para clicar e o elemento>copiar>xpath ou elemento>copiar>Xpath completo sempre retorna este erro,\ 'Ocorreu um erro desconhecido. Se este caso de teste contiver quaisquer componentes ou áreas 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 Um Pouco 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 utiliza 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 documento, ou como uma descrição plana do fragmento HTML ou XML correspondente a essa estrutura.

Tipos: Os tipos de seletor incluem:

  • Universal: O nome qualificado de qualquer tipo de elemento (*) Por exemplo, para especificar o nome qualificado de qualquer elemento da linguagem inglesa na árvore do documento para qualquer namespace, insira:

    *[hreflang|=en]

  • Tipo: Um prefixo de componente de namespace opcional adicionado a um nome de elemento (|) Por exemplo, para representar um elemento de cabeçalho 2 na árvore do documento, basta inserir:

    h2

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

    h3[title]

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

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

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

    #12345

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

    a.external:visited

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

    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 especificar um caminho hierárquico para mostrar a ascendência, como elementos filho ou elemento 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 frequentemente.)
  • +: 1 ou mais
  • ?: 0 ou 1
  • |: separa alternativas
  • [ ]: agrupamento

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

Tópicos Relacionados: