Saltar al contenido

Kbd

Representa una tecla o una combinación de teclado. Se renderiza como <kbd> con el estilo del sistema.

Auxiliares · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Atajos de teclado dentro de una frase

Abrir el buscador con ⌘ K, y cerrar con Esc.

html

Cuándo usarlo

  • Se documenta un atajo: ⌘K, Esc, Ctrl + B.
  • Se indica al usuario qué tecla apretar, en la interfaz o en la doc.

Cuándo no

  • Es código, no una tecla → inline-code.

Cómo usarlo

  • Una tecla por <kbd>, y la combinación se arma con varios.
  • Se respeta el nombre real de la tecla en cada plataforma.

Cómo no usarlo

  • No se usa de badge decorativo: significa “esto se aprieta”.

TaishoDS Core

No necesita JavaScript: es marcado y CSS.

Presentacional puro.

Sin build, desde el CDN: taisho.kbd.css, además de taisho.base.css. Con ese archivo alcanza.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Renderiza <kbd>, la semántica de una tecla o combinación.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.