AudioTrack: label-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die schreibgeschützte AudioTrack-Eigenschaft label gibt eine Zeichenfolge zurück, die das menschenlesbare Label der Audio-Spur angibt, falls eines verfügbar ist; andernfalls wird eine leere Zeichenfolge zurückgegeben.

Wert

Eine Zeichenfolge, die das menschenlesbare Label der Spur angibt, wenn eines in den Spurdaten verfügbar ist. Andernfalls wird eine leere Zeichenfolge ("") zurückgegeben.

Zum Beispiel könnte eine Spur, deren kind "commentary" ist, ein label wie "Commentary with director Mark Markmarkimark and star Donna Donnalidon" haben.

Beispiele

Dieses Beispiel gibt ein Array von Spurarten und Labels zurück, die potenziell in einer Benutzeroberfläche zur Auswahl von Audiotracks für ein angegebenes Medienelement verwendet werden können. Die Liste ist so gefiltert, dass nur bestimmte Spurarten zugelassen werden.

js
function getTrackList(el) {
  const trackList = [];
  const wantedKinds = [
    "main",
    "alternative",
    "main-desc",
    "translation",
    "commentary",
  ];

  el.audioTracks.forEach((track) => {
    if (wantedKinds.includes(track.kind)) {
      trackList.push({
        id: track.id,
        kind: track.kind,
        label: track.label,
      });
    }
  });
  return trackList;
}

Das resultierende trackList enthält ein Array von Audiotracks, deren kind eines der in dem Array wantedKinds genannten ist, und jeder Eintrag bietet die id, kind und label der Spur.

Spezifikationen

Specification
HTML
# dom-audiotrack-label-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
label

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.