Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é tabindex?

    O atributo HTML tabindex controla a participação de elementos na navegação com Tab. Os valores zero e negativo combinam essa ordem com o foco por código.

    Também chamado de: atributo tabindex

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Foco e navegação com Tab

    O tabindex é um atributo do HTML (HyperText Markup Language) que permite tornar um elemento focalizável e definir sua participação na navegação sequencial, normalmente feita com Tab. O foco identifica o elemento que recebe os eventos de teclado. Poder receber foco por código e aparecer na sequência de Tab são comportamentos distintos.

    Com tabindex="0", o elemento participa da ordem do documento junto dos controles que já recebem foco. Um valor negativo, normalmente -1, o retira dessa sequência e permite direcionar o foco por JavaScript. Isso é útil para uma mensagem que precisa receber atenção após uma interação, mas não deve ser visitada a cada passagem de Tab.

    Levar o foco até uma mensagem de erro

    O exemplo didático parte de uma mensagem já inserida e visível no documento após uma validação malsucedida. O atributo permite que o parágrafo receba foco:

    <p id="erro-email" tabindex="-1">
    Informe um endereço de email válido.
    </p>

    Depois de exibir essa mensagem, o código da validação pode localizar o elemento e chamar seu método focus():

    const mensagem = document.getElementById('erro-email');
    mensagem?.focus();

    O foco é direcionado ao parágrafo quando ele existe e pode ser focalizado. O operador ?. evita a chamada quando a busca não encontra o elemento. O exemplo não valida o endereço nem cria a mensagem: ele mostra somente o direcionamento do foco. Você precisa executar essa parte no momento adequado da validação.

    Preservar a ordem dos controles

    Os valores positivos colocam elementos na sequência por ordem numérica, com prioridade sobre os de valor zero. A MDN recomenda usar apenas 0 e -1 e organizar o documento numa sequência lógica. Teste o percurso com Tab e Shift+Tab para conferir se o foco acompanha a ordem de leitura.

    Adicionar tabindex a uma div também não implementa as ações de um botão. Um button habilitado já oferece comportamento de teclado e semântica próprios. Use o elemento nativo para essa função e confira o foco visível durante a navegação.

    Dúvidas frequentes

    Perguntas frequentes sobre tabindex

    É necessário colocar tabindex em todos os botões?
    Um button visível e habilitado normalmente já participa da navegação pelo teclado. Adicionar tabindex com um valor negativo retira esse controle da sequência de Tab, portanto o atributo só deve ser usado para alterar o comportamento padrão.
    Por que evitar valores positivos?
    Eles têm prioridade sobre os elementos com valor zero. Ao numerar os controles, você cria uma ordem que pode divergir da leitura da página e fica mais difícil de manter quando a interface muda.
    Uma div com tabindex funciona como botão?
    O atributo permite receber foco, mas não fornece a semântica nem as ações de teclado de um botão. Use button para uma ação de botão e preserve seu comportamento nativo.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Na revisão de uma interface, você percorre o formulário pelo teclado e confere o destino do foco após uma falha de preenchimento.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano