13.6.1 Contenuto del modulo

Il modulo xml.dom contiene le seguenti funzioni:

registerDOMImplementation( name, factory): Registra la funzione factory con il nome name. La funzione di base deve restituire un oggetto che implementa l'interfaccia DOMImplementation. La funzione factory può restituire lo stesso oggetto ogni volta, o uno nuovo per ogni chiamata, come meglio appropriato per la specifica implementazione (per esempio se l'implementazione supporta alcune personalizzazioni).

getDOMImplementation( [name[, features]]): Restituisce un'implementazione DOM utilizzabile. Il parametro name può essere sia un ben conosciuto nome di modulo di una implementazione DOM che None. Se non viene impostato a None, importa il modulo corrispondente e restituisce un oggetto DOMImplementation se l'importazione avviene correttamente. Se nessun nome, name, viene indicato, e la variabile d'ambiente PYTHON_DOM è impostata, viene usata questa variabile per trovare l'implementazione.
Se il nome non viene indicato, questa esamina le implementazioni disponibili per trovarne una con le opzioni richieste impostate. Se nessuna implementazione può essere trovata, solleva un'eccezione ImportError. La lista features deve essere una sequenza di coppie (feature, version) che verranno passate al metodo hasFeature() sugli oggetti DOMImplementation disponibili.

Vengono indicate alcune utili costanti:

EMPTY_NAMESPACE: Il valore usato per indicare che nessuno spazio dei nomi è associato con un nodo nel DOM. Questo è tipicamente identificato come namespaceURI (NdT: URI dello spazio di nomi) di un nodo, o usato come parametro namespaceURI per un metodo di uno spazio dei nomi specifico. Nuovo nella versione 2.2.

XML_NAMESPACE: L'URI dello spazio dei nomi associato con il prefisso xml riservato, come definito in Lo spazio dei nomi in XML (sezione 4). Nuovo nella versione 2.2.

XMLNS_NAMESPACE: L'URI dello spazio dei nomi per la dichiarazione dello spazio di nomi, come definito in Modello di Oggetto di Documento (DOM) di livello 2 - specifiche fondamentali (sezione 1.1.8). Nuovo nella versione 2.2.

XHTML_NAMESPACE: L'URI dello spazio dei nomi XHTML come definito in XHTML 1.0: Linguaggio estensibile di Marcatura Ipertestuale (sexione 3.1.1). Nuovo nella versione 2.2.

In aggiunta, xml.dom contiene una classe Node di base e classi di eccezione DOM. La classe Node fornita da questo modulo non implementa nessuno dei metodi o degli attributi definiti dalle specifiche DOM; implementazioni DOM concrete devono fornirle autonomamente. La classe Node fornita come parte di questo modulo fornisce anche le costanti utilizzate per gli attributi nodeType sull'oggetto concreto Node; queste sono presenti all'interno della classe, diversamente che a livello di modulo, per conformarsi alle specifiche DOM.

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