Go to the latest version of this document.
search in docstrings

Search bar offers the following options:

- Term presence. The below example searches for documents that must contain “foo”, might contain “bar” and must not contain “baz”: `+foo bar -baz`
- Wildcards. The below example searches for documents with words beginning with “foo”: `foo*`
- Search in specific fields. The following search matches all objects in "twisted.mail" that matches “search”: `+qname:twisted.mail.* +search`

  Possible fields: 'name', 'qname' (fully qualified name), 'docstring', and 'kind'. Last two fields are only applicable if "search in docstrings" is enabled.

- Fuzzy matches. The following search matches all documents that have a word within 1 edit distance of “foo”: `foo~1`

Results provided by Lunr.js

# ``twisted`.`words`.`xish`.`domish`.`IElement``

interface documentation

`class IElement(Interface): (source)`

Known implementations: `twisted.words.xish.domish.Element`

View In Hierarchy

Interface to XML element nodes.

See `Element` for a detailed example of its general use.

Warning: this Interface is not yet complete!

Method | `addChild` | Adds a node as child of this element.
Method | `addContent` | Adds character data to this element.
Method | `addElement` | Create an element and add as child.
Method | `toXml` | Serializes object to a (partial) XML document
Attribute | `attributes` | Dictionary of element attributes
Attribute | `children` | List of child nodes
Attribute | `defaultUri` | Default namespace URI of child elements
Attribute | `localPrefixes` | Dictionary of local prefixes
Attribute | `name` | Element's local name
Attribute | `parent` | Reference to element's parent element
Attribute | `uri` | Element's namespace URI

def addChild(node): (source)

Adds a node as child of this element.

The `node` will be added to the list of childs of this element, and will have this element set as its parent when `node` provides `IElement`. If `node` is a `str` and the current last child is character data (`str`), the text from `node` is appended to the existing last child.

Parameters
node:`str` or object implementing `IElement` | the child node.

def addContent(text): (source)

Adds character data to this element.

If the current last child of this element is a string, the text will be appended to that string. Otherwise, the text will be added as a new child.

Parameters
text:`str` | The character data to be added to this element.

def addElement(name, defaultUri=None, content=None): (source)

Create an element and add as child.

The new element is added to this element as a child, and will have this element as its parent.

Parameters
name:`str` or `tuple` of (`str`, `str`) | element name. This can be either a `str` object that contains the local name, or a tuple of (uri, local_name) for a fully qualified name. In the former case, the namespace URI is inherited from this element.
defaultUri:`str` | default namespace URI for child elements. If `None`, this is inherited from this element.
content:`str` | text contained by the new element.
Returns
object providing `IElement` | the created element

def toXml(prefixes=None, closeElement=1, defaultUri='', prefixesInScope=None): (source)

Serializes object to a (partial) XML document

Parameters
prefixes:`dict` | dictionary that maps namespace URIs to suggested prefix names.
closeElement:`int` | flag that determines whether to include the closing tag of the element in the serialized string. A value of `0` only generates the element's start tag. A value of `1` yields a complete serialization.
defaultUri:`str` | Initial default namespace URI. This is most useful for partial rendering, where the logical parent element (of which the starttag was already serialized) declares a default namespace that should be inherited.
prefixesInScope:`list` | list of prefixes that are assumed to be declared by ancestors.
Returns
`str` | (partial) serialized XML

attributes = (source)

Dictionary of element attributes

children = (source)

List of child nodes

defaultUri = (source)

Default namespace URI of child elements

localPrefixes = (source)

Dictionary of local prefixes

name = (source)

Element's local name

parent = (source)

Reference to element's parent element

uri = (source)

Element's namespace URI