audio_playlist Shortcode
El shortcode audio_playlist muestra el componente de lista de reproducción de audio.
Los atributos que aparecen a continuación coinciden con los controles actuales del Page Builder y con la salida pública. Utiliza la sintaxis sin procesar únicamente para contenido revisado que no pueda mantenerse mediante los controles visuales.
Shortcodes secundarios permitidos: audio_item.
Uso
[audio_playlist]
Content
[/audio_playlist]Atributos
| Atributo | Valor predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
color_scheme |
— | dark |
Selecciona la combinación de colores predeterminada para el reproductor. |
enable_bottom_controls |
yes |
yes |
Si está marcado, los controles del reproductor aparecerán fijados en el pie de página. |
hide_playlist |
— | yes |
Si está marcado, la lista de reproducción se ocultará y solo podrá reproducirse con los controles del pie de página. Disponible cuando enable_bottom_controls es yes. |
autoplay_playlist |
— | yes |
Solicita la reproducción al llegar; los navegadores pueden requerir un clic. Gana la primera lista de reproducción de reproducción automática que cumpla los requisitos. Requiere controles en el pie de página. |
autohide_playlist |
— | yes |
Oculta automáticamente los controles del pie de página hasta que se pase el cursor o se enfoque con el teclado; los visitantes móviles usan el botón de música. No oculta la lista de pistas de la página. Requiere controles en el pie de página. |
device_visibility |
— | Cadena, salvo que se indique lo contrario | Aplica la regla de visibilidad adaptable seleccionada. |
el_id |
— | ID HTML único válido | Introduce el ID del elemento (Nota: asegúrate de que sea único y válido según la especificación w3c). |
el_class |
— | Cadena, salvo que se indique lo contrario | Si deseas aplicar estilo a un elemento de contenido concreto de forma diferente, utiliza este campo para añadir un nombre de clase y después haz referencia a él en tu archivo css. |
Contenido incluido
El contenido entre las etiquetas de apertura y cierre se procesa como contenido de shortcode de WordPress. Mantén la estructura de elementos primarios/secundarios que muestra el constructor visual para que los componentes anidados reciban el contexto que esperan.
Personalizar la hoja de estilos
Los administradores pueden sustituir la hoja de estilos completa de la lista de reproducción de audio en Settings → POM Theme → Advanced → Custom CSS → Shortcode CSS assets → Audio playlist. Guardar publica una copia optimizada por sitio, pero no añade la hoja de estilos a las páginas que no contienen el shortcode. Revertir devuelve el controlador web-audio-playlist existente a la audio-playlist.min.css actual que suministra el tema. Los elementos de la lista de reproducción, el estado de reproducción, los controles fijos y el script web_audio_playlist existente permanecen sin cambios.
El reproductor recuerda el volumen, el silencio, la repetición, el modo aleatorio y una posición de pista coincidente cuando el almacenamiento del navegador está disponible. Solo pueden restaurarse las listas de reproducción y las pistas suministradas por la página actual. Con los controles del pie de página desactivados, las filas siguen admitiendo reproducir/pausar. Varias listas de reproducción comparten un mismo pie de página; Choose playlist en su panel de lista de reproducción también expone las listas ocultas. Las listas ocultas por dispositivo no se convierten en el reproductor activo.
Para el flujo de trabajo del editor nativo, consulta Build an Audio Playlist in Gutenberg. Las listas de reproducción heredadas y nativas pueden coexistir.
Se admite la caché de páginas HTML estática. El marcado de lista de reproducción almacenado en caché anterior conserva su configuración de reproducción automática y de fijado del pie de página; las listas de reproducción actuales utilizan sus propias opciones guardadas.
Verificación
Rellena audio_playlist con audio_item y confirma que cada elemento secundario siga siendo accesible en el orden previsto. Presta especial atención a color_scheme y enable_bottom_controls.