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 Before Edge 79, this method returns an HTMLCollection, not a NodeList.
Firefox Full support 1IE Full support 5
Notes
Full support 5
Notes
Notes Returns an HTMLCollection, not a NodeList
Opera Full support 5Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

Vedi anche