mozilla
Vos résultats de recherche

    <audio>

    Ajouté dans HTML5

    Résumé

    L'élément HTML <audio> est utilisé pour ajouter un contenu sonore dans un document. Il peut contenir plusieurs sources audio introduites avec l'attribut src ou l'élément <source>. Le navigateur décidera lequel utiliser. Du contenu alternatif peut aussi être ajouté pour les navigateurs ne supportant pas cette fonctionnalité.

    L'API Web Audio peut être utilisée pour manipuler des flux audio avec du code JavaScript. Voir les pages sur l'API Web Audio pour plus d'informations sur ce sujet.

    Attributs

    Comme tous les autres éléments HTML, cet élément possède les attributs globaux.

    • none : cela indique que soit l'auteur pense que l'utilisateur n'aura pas besoin de cet élément soit que le serveur souhaite minimiser son traffic. En d'autres termes, cela indique que l'élément audio ne devrait pas être mis en cache.
    • metadata : cela indique que, bien que l'auteur pense que l'utilisateur n'aura pas besoin de l'élément audio, il est préférable de préparer les méta-données (comme la durée)
    • auto : cela indique que l'utilisateur a besoin de cet élément en priorité. Cela signifie que, si nécessaire, l'élément audio en entier sera téléchargé même si l'utilisateur pourra ne pas le lire.
    • "" (chaîne de caractères vide) : synonyme de auto
    autoplay
    Un attribut booléen. Si celui-ci est renseigné (même avec une valeur "false"), l'élément audio sera joué automatiquement dès qu'assez de données auront été chargées pour que la lecture ne soit pas interrompue.
    autobuffer Obsolète depuis Gecko 2.0
    Un attribut booléen. Si il est renseigné, l'élément audio sera automatiquement téléchargé (il n'est pas nécessaire qu'il soit joué automatiquement). Cela se poursuit jusqu'au remplissage du cache média ou si tout le fichier a été téléchargé. Cela ne devrait être utilisé que dans le cas où l'utilisateur pourra choisir de jouer ou non le son. Cet attribut a été retiré de Gecko 2.0 pour être remplacé par l'attribut preload.
    buffered
    Un attribut qui peut être lu pour connaître le nombre d'intervalles de temps du média qui ont été mis en tampon. Cet attribut contient un objet TimeRanges.
    controls
    Si l'attribut est présent, le navigateur offrira à l'utilisateur des contrôles pour qu'il puisse gérer la lecture, le volume, la navigation, et la pause ou la reprise de la lecture.
    loop
    Un attribut booléen. S'il est renseigné, la lecture du fichier se fera en boucle..
    mozCurrentSampleOffset
    Le décalage, en nombre d'échantillons, à partir du début du flux audio jusqu'au fragment lu actuellement.
    muted
    Un attribut booléen, indiquant si le son de l'élément audio doit être coupé. Sa valeur par défaut est false, indiquant que l'élément audio doit être joué.
    played
    Un objet TimeRanges indiquant tous les fragments de l'élément audio ayant été joués.
    preload
    Cet attribut énuméré permet de fournir au navigateur une indication lui permettant de savoir ce que l'auteur de la page pense de l'utilisation optimale de cet élément. Il peut prendre les valeurs suivantes :
    Si cet attribut n'est pas renseigné, la valeur par défaut sera celle du navigateur (chaque navigateur pouvant définir sa propre valeur). Les spécifications conseillent la valeur metadata comme valeur par défaut.
    Notes d'utilisation : L'attribut autoplay annulera cet attribut. Si le navigateur a besoin de jouer cet élément, il le téléchargera automatiquement. Renseigner les deux attributs autoplay et preload est autorisé par la spécification. Bien que le navigateur n'a pas, selon la spécification, à suivre la valeur de cet attribut. Il n'est qu'une simple indication.
    src
    L'URL du fichier audio à inclure. Cet attribut est sujet aux spécifications du CORS. Il est optionnel et il est possible d'utiliser l'élément <source> dans le bloc de cet élément pour définir les fichiers audio à intégrer.
    volume
    Le volume de la partie audio, fournie comme une valeur flottante comprise entre 0.0 (silencieux) et 1.0 (le volume le plus élevé).

    Les valeurs de décalages sont définies en nombres flottants, indiquant le nombres de secondes pour le décalage.

    Note : La définition de cette valeur de décalage n'a pas encore été finalisée dans la spécification HTML5 et est donc sujette à changements.

    Événements

    Un élément audio peut déclencher plusieurs événements.

    Exemples

    Utilisation simple

    <!-- Simple lecture audio -->
    <audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay>
      Votre navigateur ne supporte pas l'élément <code>audio</code>.
    </audio>
    
    <!-- Lecture Audio avec sous-titres -->
    <audio src="toto.ogg">
      <track kind="captions" src="toto.fr.vtt" srclang="fr" label="Français">
      <track kind="captions" src="toto.sv.vtt" srclang="sv" label="Svenska">
    </audio> 
    

    Utilisation de l'élément source

    <audio controls="controls">
      Votre navigateur ne supporte pas l'élément <code>audio</code>.
      <source src="toto.wav" type="audio/wav">
    </audio>
    

    Spécifications

    Spécification Statut Commentaires
    WHATWG HTML Living Standard
    La définition de '<audio>' dans cette spécification.
    Standard évolutif  
    HTML5
    La définition de '<audio>' dans cette spécification.
    Recommendation  

    Compatibilité des navigateurs

    Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Support simple 3.0 3.5 (1.9.1) 9.0 10.5 3.1
    Attribut autoplay 3.0 3.5 (1.9.1) 9.0 10.5 3.1
    Attribut buffered ? 4.0 (2.0) ? ? ?
    Attribut controls 3.0 3.5 (1.9.1) 9.0 10.5 3.1
    Attribut loop 3.0 11.0 (11.0) 9.0 10.5 3.1
    Attribut muted ? 11.0 (11.0) ? ? ?
    Propriété played ? 15.0 (15.0) ? ? ?
    Attribut preload 3.0 4.0 (2.0) 9.0 Supported under the older name autobuffer 3.1
    Attribut src 3.0 3.5 (1.9.1) 9.0 10.5 3.1
    Attribut volume          
    Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Support simple ? 1.0 (1.0) ? ? ?
    Attribut autoplay ? 1.0 (1.0) ? ? ?
    Attribut buffered ? 4.0 (2.0) ? ? ?
    Attribut controls ? 1.0 (1.0) ? ? ?
    Attribut loop ? 11.0 (11.0) ? ? ?
    Attribut muted ? 11.0 (11.0) ? ? ?
    Propriété played ? 15.0 (15.0) ? ? ?
    Attribut preload ? 4.0 (2.0) ? ? ?
    Attribut src ? 1.0 (1.0) ? ? ?
    Attribut volume          
    Note : Pour que l'audio fonctionne avec Gecko, le serveur doit servir le fichier avec le bon type MIME.

    Voir aussi

    Étiquettes et contributeurs liés au document

    Contributors to this page: tregagnon, WSH, SphinxKnight, msherefel, louuis
    Dernière mise à jour par : WSH,