---
title: HTMLCollection
slug: Web/API/HTMLCollection
tags:
  - API
  - DOM
  - HTML DOM
  - HTMLCollection
  - Interfaccia
  - Lista di elementi
  - Referenza
  - Referenza DOM
translation_of: Web/API/HTMLCollection
---
<p>{{APIRef("HTML DOM")}}</p>

<p>L'interfaccia <strong><code>HTMLCollection</code></strong> rappresenta una raccolta generica (array-like object simile agli <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/arguments">argomenti</a>) di elementi (nell'ordine del documento) e offre metodi e proprietà per la selezione dall'elenco.</p>

<div class="note"><strong>Note:</strong> Questa interfaccia è chiamata <code>HTMLCollection</code> per ragioni storiche (prima del DOM moderno, le raccolte che implementano questa interfaccia potevano avere solo elementi HTML come elementi).</div>

<p>Una <code>HTMLCollection</code> nell'HTML DOM è attiva; viene aggiornata automaticamente quando viene modificato il documento sottostante.</p>

<h2 id="Proprietà">Proprietà</h2>

<dl>
 <dt>{{domxref("HTMLCollection.length")}} {{readonlyInline}}</dt>
 <dd>Restituisce il numero di elementi nella raccolta.</dd>
</dl>

<h2 id="Metodi">Metodi</h2>

<dl>
 <dt>{{domxref("HTMLCollection.item()")}}</dt>
 <dd>Restituisce il nodo specifico al dato <code>index</code> a base zero nella lista. Restituisce <code>null</code> se <code>index</code> non è compreso nell'intervallo</dd>
 <dt>{{domxref("HTMLCollection.namedItem()")}}</dt>
 <dd>Restituisce il nodo specifico il cui ID o, come nome di fallback, corrisponde alla stringa specificata da <code>nome</code>. La corrispondenza per nome viene eseguita solo come ultima risorsa, solo in HTML, e solo se l'elemento di riferimento supporta l'attributo <code>name</code>. Restituisce <code>null</code> se nessun nodo corrisponde con il nome specificato.</dd>
</dl>

<h2 id="Utilizzo_in_JavaScript">Utilizzo in JavaScript</h2>

<p><code>HTMLCollection</code> espone anche i suoi membri direttamente come proprietà sia per nome che per indice. Gli ID HTML possono contenere <code>:</code> e <code>.</code> come caratteri validi, che richiederebbero l'uso della notazione della parentesi per l'accesso alla proprietà. Attualmente HTMLCollections non riconosce gli ID puramente numerici, il che causerebbe un conflitto con l'accesso in stile array, sebbene HTML5 li autorizzi.</p>

<p>Ad esempio, supponendo che esista un elemento <code>&lt;form&gt;</code> nel documento e il suo <code>id</code> sia <code>"myForm"</code>:</p>

<pre class="brush:js">var elem1, elem2;

// document.forms è una HTMLCollection

elem1 = document.forms[0];
elem2 = document.forms.item(0);

alert(elem1 === elem2); // ritorna: "true"

elem1 = document.forms.myForm;
elem2 = document.forms.namedItem("myForm");

alert(elem1 === elem2); // ritorna: "true"

elem1 = document.forms["named.item.with.periods"];</pre>

<h2 id="Specifications" name="Specifications">Specifiche</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specifica</th>
   <th scope="col">Stato</th>
   <th scope="col">Commento</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('DOM WHATWG', '#htmlcollection', 'HTMLCollection')}}</td>
   <td>{{ Spec2('DOM WHATWG') }}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 HTML', 'html.html#ID-75708506', 'HTMLCollection')}}</td>
   <td>{{ Spec2('DOM2 HTML') }}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('DOM1', 'level-one-html.html#ID-75708506', 'HTMLCollection')}}</td>
   <td>{{ Spec2('DOM1') }}</td>
   <td>Definizione iniziale.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilità_con_i_browser">Compatibilità con i browser</h2>



<p>{{Compat("api.HTMLCollection")}}</p>

<h2 id="Vedi_anche">Vedi anche</h2>

<ul>
 <li>{{domxref("NodeList")}}</li>
 <li>{{domxref("HTMLFormControlsCollection")}}, {{domxref("HTMLOptionsCollection")}}</li>
</ul>