VideoTrack: 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 VideoTrack-Eigenschaft label gibt eine Zeichenfolge zurück, die die lesbare Bezeichnung des Videotracks angibt, falls eine vorhanden ist; ansonsten wird eine leere Zeichenfolge zurückgegeben.

Wert

Eine Zeichenfolge, die die lesbare Bezeichnung des Tracks angibt, falls diese in den Track-Metadaten verfügbar ist. Andernfalls wird eine leere Zeichenfolge ("") zurückgegeben.

Zum Beispiel könnte ein Track, dessen kind "sign" ist, ein label wie "A sign-language interpretation." haben.

Beispiele

Dieses Beispiel gibt ein Array von Track-Typen und Bezeichnungen zurück, das möglicherweise in einer Benutzeroberfläche verwendet wird, um Videotracks für ein bestimmtes Medienelement auszuwählen. Die Liste wird gefiltert, um nur bestimmte Track-Typen zuzulassen.

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

  el.videoTracks.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 Videotracks, deren kind zu denjenigen im Array wantedKinds gehört, wobei jeder Eintrag dieid, kind und label des Tracks bereitstellt.

Spezifikationen

Specification
HTML Standard
# dom-videotrack-label-dev

Browser-Kompatibilität

BCD tables only load in the browser