Saltar al contenido
EspañolEnglish
Todos los componentes (204)

Reproductor de audio

Más · AudioPlayer

Qué es y cuándo usarlo

Notas de voz, un mensaje grabado, un audio corto: el audio con sus controles. Los controles son propios y no los del navegador, porque esos cambian de uno a otro y en varios no se llega con el teclado a la barra de posición.

Cuándo usarlo

  • La nota de voz de un pedido o de un ticket, el mensaje de un cliente, una locución corta.
  • src es el fichero y subtitle, la línea pequeña de debajo del título (quién habla, cuándo).
  • Con duration (en segundos) si se sabe de antemano: así no enseña «–:––» ni tiene la barra apagada hasta que llegan los metadatos.

Cuándo no

  • Vídeo: esto es solo audio.
  • Un sonido de aviso que suena solo, sin que nadie lo pida: no necesita reproductor.

Teclado: Tab pasa por el botón de reproducir, la barra de posición y el botón de velocidad. En la barra, las flechas avanzan y retroceden de segundo en segundo, Re Pág y Av Pág saltan una décima parte de la duración, e Inicio y Fin van al principio y al final. La velocidad da la vuelta: 1×, 1,25×, 1,5× y 2×.

Accesibilidad: title es obligatorio y nombra los controles: «Reproducir Nota de voz de Aitor» (o «Pausar…»), «Posición en Nota de voz de Aitor». La posición se anuncia en segundos, no como un porcentaje sin unidad. Si el audio no carga o el navegador no deja reproducir, se dice con palabras (role="alert") en vez de dejar un botón que no hace nada.

Aspecto fino: sin variables propias: se ajusta con las clases amset-audio, amset-audio--playing, amset-audio__track, amset-audio__thumb y amset-audio__speed.

Cómo se ve

Nota de voz de Aitor14 de octubre, 10:42 · sobre la entrega del pedido 1042

<AudioPlayer
  src="/notas/aitor-1042.mp3"
  title="Nota de voz de Aitor"
  subtitle="Sobre la entrega del pedido 1042"
  duration={3}
/>

Props

Se importa con import { AudioPlayer } from '@amset/ui'. Las obligatorias van marcadas.

PropTipoPara qué sirve
srcobligatoriastring—
titleobligatoriastringQue se escucha. Obligatorio: nombra el reproductor y sus botones.
classNamestringSe une a las clases de la biblioteca, no las sustituye.
durationnumberDuracion conocida de antemano, para no enseñar 0:00 hasta que cargue.
subtitlestringQuien habla, cuando: la linea pequeña de debajo.

Acepta además los atributos del elemento que pinta: className, style, data-*, aria-* y sus eventos.

En el banco de pruebas

Cada estado y cada variante, para tocarlos de uno en uno, en su ficha de ui.amset.tech: