Marcação de uma entrada
O kbd é um elemento do HTML (HyperText Markup Language) que identifica uma entrada a realizar, como uma tecla a acionar ou um comando a digitar. Sua função é registrar o significado daquele trecho dentro da explicação. Ele também pode representar outras formas de entrada, como um comando de voz.
O navegador costuma mostrar seu conteúdo em fonte monoespaçada. Você pode aplicar CSS (Cascading Style Sheets) para desenhar bordas e dar ao texto a aparência de uma tecla, mas esse estilo é uma escolha de apresentação. A marcação continua identificando uma entrada mesmo quando sua aparência muda.
Como representar uma combinação
Uma instrução para abrir um documento com Ctrl+O pode agrupar a combinação e identificar cada tecla. Este exemplo didático só se aplica quando a aplicação oferece esse atalho:
<p>Para abrir um documento, pressione <kbd><kbd>Ctrl</kbd> + <kbd>O</kbd></kbd>.</p>Ao renderizar esse trecho, o navegador mostra a frase com os nomes das teclas identificados por kbd. O elemento externo agrupa a combinação inteira e os dois elementos internos representam cada tecla. O sinal de mais indica que elas devem ser usadas em conjunto.
O trecho identifica a entrada descrita, mas a ação de abrir um documento exige um atalho implementado. Você precisa testar a combinação no ambiente utilizado pela aplicação, pois o navegador e o sistema operacional também possuem atalhos. A instrução da página deve corresponder à ação disponível naquele ambiente.
Entrada e saída no mesmo tutorial
Uma instrução de terminal pode marcar o comando digitado com kbd e uma mensagem retornada com samp. Esse segundo elemento identifica uma amostra de saída do programa. Escolher o elemento pela função do texto preserva essa diferença mesmo que os dois recebam uma fonte parecida.
Dúvidas frequentes
Perguntas frequentes sobre kbd
- O kbd serve somente para teclas físicas?
- Ele também pode marcar outras entradas, como um comando de voz. A especificação permite ainda combinar kbd e samp para representar a escolha de uma opção mostrada na tela.
- É obrigatório colocar um kbd dentro de outro?
- Você pode usar um elemento por tecla. Um kbd externo é uma opção para agrupar a entrada completa, com elementos internos identificando suas partes.
- Quando usar samp no lugar de kbd?
- Use kbd para a entrada a realizar e samp para uma amostra da saída do programa. Em uma instrução de terminal, o comando digitado e a mensagem retornada têm funções diferentes no documento.
Para continuar
Recursos relacionados
Documentação
MDN: elemento HTML kbd
Mostra a marcação de teclas individuais, o agrupamento de combinações e os estilos aplicados ao elemento.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Sessão técnica ao vivo para você revisar a marcação das instruções e conferir o comportamento descrito na aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao documentar os comandos da aplicação, você usa elementos semânticos para identificar o texto digitado e as combinações de teclas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.