KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

controlslist — native mediabediening kiezen

Het attribuut controlslist vertelt de browser welke opties moeten ontbreken in de native audio- en videobediening. De JavaScript-tegenhanger, HTMLMediaElement.controlsList, biedt een lijst met tokens. Ondersteuning hangt af van de browser.

Versie: WICG Controls List draft; index snapshot date recorded separately

Syntax

controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")

controlslist is een attribuut van audio- en video-elementen met door spaties gescheiden tokens. Het helpt de browser om zijn eigen mediabediening te kiezen. Het schakelt die bediening niet zelf in; daarvoor dient het aparte attribuut controls. Het stuurt ook geen knoppen aan van een speler die door de maker van de pagina is gebouwd.

Het token nodownload vraagt om de downloadoptie weg te laten, nofullscreen om de optie voor volledig scherm en noremoteplayback om de optie voor afspelen op een extern apparaat. Je kunt deze tokens combineren. Het zijn aanwijzingen voor de interface, geen bescherming van inhoud: de downloadoptie verbergen voorkomt niet dat het bestand wordt opgeslagen.

HTMLMediaElement.controlsList is de JavaScript-tegenhanger van het attribuut en geeft een DOMTokenList terug. De attribuutnaam is controlslist, terwijl de eigenschapsnaam controlsList is. Met de methoden add(), remove() en contains() kun je tokens beheren; als je de lijst wijzigt, wordt het attribuut bijgewerkt. De opgehaalde eigenschap biedt een object waarvan de inhoud kan worden aangepast.

De ondersteuning is beperkt. Controleer daarom of controlsList bestaat voordat je de API gebruikt en test de interface in de browsers waarop je je richt. Alleen de eigenschap detecteren bewijst niet dat elke aanwijzing het uiterlijk van de bediening verandert. Het voorbeeld hieronder controleert de synchronisatie tussen lijst en attribuut zonder media te laden.

Voorbeelden

(() => {
  const video = document.createElement("video");
  video.controls = true;
  video.setAttribute("controlslist", "nodownload");

  if (!("controlsList" in video)) {
    console.log("controlsList: unsupported");
    return;
  }

  video.controlsList.add("nofullscreen");
  console.log(video.getAttribute("controlslist"));
  console.log(video.controlsList.contains("nodownload"));
})();

Resultaat

nodownload nofullscreen
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen