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 Standard
# dom-audiotrack-label-dev

Browser-Kompatibilität

BCD tables only load in the browser