XML DOM namedItem()-menetelmä
Määrittely ja käyttö
namedItem()-menetelmä palauttaa solmun tai elementin, jolla on annettu nimi.
Eri dokumenttipyyhdyksillä menetelmän käyttäytyminen voi olla erilainen:
-
Jos dokumentti on HTML-dokumentti, tämä menetelmä tutkii ensin solmuja, joilla on täsmäävä id-ominaisuus annetulla nimellä, ja jos sellaista ei löydy, se tutkii solmuja, joilla on täsmäävä name-ominaisuus annetulla nimellä.
Kun haetaan HTML-dokumenttia, menetelmä ei ole kirjainkohtainen.
-
Jos dokumentti on XHTML-dokumentti, menetelmä tarkistaa vain solmut, joilla on vastaava nimi id-ominaisuudella.
Kun haetaan HTML-dokumenttia, menetelmä on kirjainkohtainen.
Syntaksi:
htmlcollectionObject.namedItem(nimi)
| Parametrit | Kuvaus |
|---|---|
| nimi | Haettavan solmun tai elementin nimi. |
Palautusarvo
Palauttaa elementin tai solmun, jolla on määritelty id- tai nimi-ominaisuus. Jos HTMLCollectionissa ei ole tällaista solmua, palauttaa null.
Kuvaus
JavaScriptissa käsitellään HTMLCollectionia liitetyntenä taulukkona ja hakee elementtejä käyttämällä taulukon kielioppia, ja nimiä []-suluissa, mikä tekee elementtien hakemisesta helpompaa.
Esimerkki
var c = document.forms; //Tämä on HTMLCollection-objekti var address = c.namedItem("address"); //etsi <form name="address"> var payment = c["payment"]; //Yksinkertaisempi kielioppi:etsi <form name="payment"> var login = c.login; //Tämä on myös voimassa:etsi <form name="login">
