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.
srces el fichero ysubtitle, 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
<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.
| Prop | Tipo | Para qué sirve |
|---|---|---|
srcobligatoria | string | — |
titleobligatoria | string | Que se escucha. Obligatorio: nombra el reproductor y sus botones. |
className | string | Se une a las clases de la biblioteca, no las sustituye. |
duration | number | Duracion conocida de antemano, para no enseñar 0:00 hasta que cargue. |
subtitle | string | Quien 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:
