13.6.2.3 Oggetti NodeList

Un NodeList rappresenta una sequenza di nodi. Nelle raccomandazioni di base del DOM, questi oggetti vengono usati in due modi: gli oggetti Element ne forniscono una come lista di nodi figli, ed i metodi di Node (getElementsByTagName() e getElementsByTagNameNS()) restituiscono oggetti con questa interfaccia per rappresentare i risultati dell'interrogazione.

Le raccomandazioni del DOM di livello 2 definiscono un metodo ed un attributo per questi oggetti:

item( i)
Restituisce l'ennesimo elemento i della sequenza, se ce n'è uno, altrimenti None. L'indice i non può essere minore di zero o più grande o uguale alla lunghezza della sequenza.

length
Il numero di nodi nella sequenza.

In aggiunta, l'interfaccia DOM di Python richiede che alcuni ulteriori elementi vengano forniti per consentire agli oggetti NodeList di essere usati come sequenze Python. Tutte le implementazioni NodeList devono includere il supporto per __len__() e __getitem__(); questo consente iterazioni sulla NodeList, durante istruzioni for ed il corretto supporto per la funzione built-in len().

Se un'implementazione DOM supporta modifiche del documento, l'implementazione NodeList deve anche supportare i metodi __setitem__() e __delitem__().

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.