CKTIS / JavaScript
HTMLImageElement.alt — alternatieve tekst voor een afbeelding
HTMLImageElement.alt leest de tekstvervanging van een afbeelding en stelt die in. De eigenschap weerspiegelt het alt-attribuut; een lege tekenreeks en een ontbrekend attribuut betekenen niet hetzelfde.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
image.alt
image.alt = "Replacement text";HTMLImageElement.alt is een beschrijfbare DOMString-eigenschap die het alt-attribuut van een img-element weerspiegelt. Lezen geeft de waarde terug en een toewijzing werkt het attribuut bij. Als het attribuut ontbreekt, geeft lezen "" terug.
De tekst moet de betekenis van de afbeelding in de context vervangen, niet alleen het uiterlijk beschrijven. Gebruik voor een decoratieve afbeelding of een afbeelding die aangrenzende informatie herhaalt image.alt = "". Een ontbrekend attribuut is niet hetzelfde als een lege waarde. alt is geen tooltip zoals title.
Het voorbeeld maakt met hasAttribute("alt") onderscheid tussen een ontbrekend attribuut en een lege waarde, en laat de wijziging zien die via getAttribute("alt") zichtbaar is. Voer het uit in een browser: dit is een HTML DOM-interface, geen functie van de ECMAScript-taal. Dat Node 24 in de repository aanwezig is, bewijst niet dat deze interface beschikbaar is.
Voorbeelden
const image = document.createElement("img");
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));
image.alt = "Orange cat sleeping";
console.log(image.getAttribute("alt"));
image.alt = "";
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));Resultaat
["",false] Orange cat sleeping ["",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.