XML DOM HTMLCollection-objekti

HTMLCollection-objekti

HTMLCollection on liittymä, joka edustaa HTML-elementtien kokoelmaa ja tarjoaa menetelmiä ja ominaisuuksia, joita voidaan käyttää listan selaamiseen.

HTML DOM -liittymän HTMLCollection on 'elävä'; jos perustiedosto muuttuu, nämä muutokset näkyvät välittömästi kaikissa HTMLCollection-objekteissa.

Jokainen seuraava kohde (ja niiden määrittämät ominaisuudet) palauttaa HTMLCollection:

  • Document (images, applets, links, forms, anchors)
  • form (elements)
  • map (areas)
  • select (options)
  • table (rows, tBodies)
  • tableSection (rows)
  • row (cells)

HTMLDocument -liittymän monet ominaisuudet ovat HTMLCollection-objekteja, ja ne tarjoavat helpon tavan saavuttaa dokumentin elementit, kuten lomakkeet, kuvat ja linkit.form.elements ja select.options ovat HTMLCollection-objekteja. HTMLCollection tarjoaa myös Table jokainen rivi ja TableRow yksittäisiä soluja helppona tavanomaisena.

On jo mainittu, että HTMLCollection-objekti on HTML-elementtien kokoelma, jota voidaan käyttää elementtien sijainnin tai niiden id-ominaisuuksien ja nimi-ominaisuuksien avulla elementtien hakemiseen. JavaScriptissä HTMLCollection-objekti käyttäytyy lukuvaaraisen taulukon tavoin, ja sitä voidaan käyttää JavaScriptin sulkeiden sisällä olevia numeroita tai nimiä indeksoimaan HTMLCollection-objektia ilman, että tarvitsee kutsua item() -menetelmäja namedItem() -menetelmä.

HTMLCollection-objekti on lukuvaarainen, eikä siihen voi lisätä uusia elementtejä, vaikka käytettäisiin JavaScript-taulukon syntaksia.

HTMLCollection-objekti ja NodeList-objektiHyvin samanlaiset, mutta ensimmäinen voi olla sekä nimellinen että numeroindeksinen.

HTMLCollection-objektin ominaisuudet

Ominaisuus Kuvaus
cssRules Lukuvaarallinen ominaisuus, joka palauttaa merkkijonon pituuden kokonaislukuna (eli elementtien määrä kokoelmassa).

HTMLCollection-objekti menetelmät

Metodi Kuvaus
item() Palauttaa kokoelmassa olevan elementin (solmun) määritetyssä sijainnissa.
namedItem() Palauttaa kokoelmassa olevan elementin (solmun), jolla on määritelty nimi- tai id-ominaisuus.

Esimerkki

var c = document.forms;		//Tämä on form-elementin HTMLCollection-objekti
var firstform = c[0];		//Voit käyttää sitä numeerisen taulukon tavoin
var lastform = c[c.length-1];	//length-ominaisuus palauttaa elementtien määrän
var address = c["address"];		//Voit käyttää sitä liittyvän taulukon tavoin
var address = c.address;		//JavaScript sallii tällaisen esitysmuodon

Liittyvät sivut

XML DOM -viittausoppikirja:HTMLDocument-objekti

XML DOM -viittausoppikirja:NodeList-objekti

Viittausoppikirja:HTML DOM -viittausoppikirja