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

Compatibilità con i browser

BCD tables only load in the browser

Vedi anche