KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

HTML-attribuut name — betekenis per element

Het attribuut `name` geeft een elementafhankelijke naam: een sleutel voor formuliergegevens, een naam voor een navigatiedoel, een naam voor een afbeeldingsmap, een `details`-groep, een slotnaam of een metadatanaam. Het is geen globaal attribuut en vervangt `id` niet.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

name="value"

name is geen globaal attribuut: de betekenis en beperkingen hangen af van het element. Het vervangt noch id, noch een voor gebruikers zichtbare toegankelijke label. In het bijzonder verwijst label[for] naar de id van een bedieningselement, niet naar de name ervan.

Bij formulierbesturingselementen levert name de naam die wordt gebruikt bij het verzenden en in de collectie form.elements. Een opgegeven waarde mag niet leeg zijn of gelijk zijn aan isindex. Herhaalde namen kunnen meerdere vermeldingen opleveren; een gedeelde naam groepeert ook radioknoppen die bij hetzelfde formulier en dezelfde boom horen. Een gewoon tekstveld zonder naam levert geen vermelding op. Een naam alleen garandeert geen verzending: uitgeschakelde besturingselementen en niet-aangevinkte selectievakjes worden bijvoorbeeld weggelaten. Vermijd namen van ingebouwde formuliereigenschappen, zoals submit: die kunnen zulke eigenschappen in de DOM overschaduwen.

Bij form maakt de naam zoeken via document.forms mogelijk; hij moet niet leeg en binnen die collectie uniek zijn. Bij iframe en, waar van toepassing, object benoemt hij het interne navigatiedoel wanneer dat wordt gemaakt, bijvoorbeeld voor gebruik met target. Het moet een geldige naam voor een navigeerbaar doel zijn. Bij map is het attribuut verplicht: de naam waarnaar usemap verwijst, moet niet leeg zijn, mag geen ASCII-witruimte bevatten en moet uniek zijn in de boom; een opgegeven id moet ermee overeenkomen.

Bij details maakt een gedeelde, niet-lege naam een groep binnen dezelfde boom: als één lid wordt geopend, sluiten de andere. Nest geen leden van dezelfde groep en geef niet meerdere leden de status open. Bedenk of gebruikers meerdere secties tegelijk moeten kunnen bekijken. Bij slot identificeert de naam een slot in een shadow tree en komt hij overeen met het slot-attribuut van een kind van de host; de naam mag een lege tekenreeks zijn.

Bij meta identificeert de naam het soort metagegevens, zoals description, terwijl content de waarde levert. Namen van metagegevens worden vergeleken zonder onderscheid tussen ASCII-hoofdletters en kleine letters. Combineer name niet met http-equiv, charset of itemprop op hetzelfde meta.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>name example</title>
<form id="profile" name="profileForm">
  <label>City <input id="city" name="city" value="Warsaw"></label>
  <input name="tag" value="html" type="hidden">
  <input name="tag" value="forms" type="hidden">
  <label>Ignored <input value="not submitted"></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById("profile");
  const pairs = [...new FormData(form).entries()];
  document.getElementById("result").textContent = JSON.stringify(pairs);
</script>
</html>

Resultaat

[["city","Warsaw"],["tag","html"],["tag","forms"]]

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