Document.getElementsByName()

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 stesso name 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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getElementsByNameChrome Full support 1Edge Full support 12
Notes
Full support 12
Notes
Notes Returns an HTMLCollection, not a NodeList
Firefox Full support YesIE Full support Yes
Notes
Full support Yes
Notes
Notes Returns an HTMLCollection, not a NodeList
Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Vedi anche