Il metodo getElementsByName()
dell'oggetto Document
ritorna una raccolta di elementi NodeList
con un determinato name
nel documento.
Sintassi
var elements = document.getElementsByName(name);
- elements è una
NodeList
dinamica, il che significa che si aggiorna automaticamente man mano che nuovi elementi con lo stessoname
vengono aggiunti / rimossi dal documento. - name è il valore dell'attributo
name
degli elementi.
Esempio
<!DOCTYPE html>
<html lang="en">
<title>Example: using document.getElementsByName</title>
<input type="hidden" name="up">
<input type="hidden" name="down">
<script>
var up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // ritorna "INPUT"
</script>
</html>
Appunti
L'attributo name
può essere applicato solo nei documenti (X)HTML.
La raccolta NodeList
restituita contiene tutti gli elementi con il parametro name
dato, come <meta>
, <object>
, e persino elementi che non supportano affatto l'attributo name
.
Il metodo getElementsByName funziona in modo diverso in IE10 e versioni precedenti. Lì, getElementsByName()
restituisce anche gli elementi che hanno un attributo id
con il valore specificato. Fai attenzione a non usare la stessa stringa sia di un name
che di un id
.
Il metodo getElementsByName funziona in modo diverso in IE. Lì, getElementsByName()
non restituisce tutti gli elementi che potrebbero non avere un attributo name
(come <span>
).
Sia IE che Edge restituiscono una HTMLCollection
, non una NodeList
Specifiche
Specifica | Stato | Commento |
---|---|---|
HTML Living Standard The definition of 'Document.getElementsByName()' in that specification. |
Living Standard | |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'Document.getElementsByName()' in that specification. |
Obsolete | Definizione iniziale |
Compatibilità con i browser
BCD tables only load in the browser
Vedi anche
document.getElementById()
per restituire un riferimento a un elemento tramite il suoid
unicodocument.getElementsByTagName()
per restituire riferimenti ad elementi con lo stesso tagdocument.querySelector()
per restituire riferimenti a elementi tramite selettori CSS come'div.myclass'