GNU Info

(psgml-api.info)element

---

Next: attribute Prev: Types Up: Types

---

Enter node , (file) or (file)node

The element structure
=====================

 - Data type: element
     The basic data type representing the element structure is the
     Element (this happens to be a node in the parse tree).

Mapping buffer positions to elements
------------------------------------

 - Function: sgml-find-context-of pos
     Return the element current at buffer position POS.  If POS is in
     markup, `sgml-markup-type' will be a symbol identifying the markup
     type.  It will be `nil' if POS is outside markup.

 - Function: sgml-find-element-of pos
     Return the element containing the character at buffer position POS.

Functions operating on elements
-------------------------------

 - Function: sgml-element-name element
     Returns the name of the element.  (obsolete)

 - Function: sgml-element-gi element
     Return the general identifier (string) of ELEMENT.

 - Function: sgml-element-level element
     Returns the level of ELEMENT in the element structure.  The
     document element is level 1.

Structure
.........

 - Function: sgml-top-element
     Return the document element.

 - Function: sgml-off-top-p element
     True if ELEMENT is the pseudo element above the document element.

   These functions return other related elements, or possibly `nil'.

 - Function: sgml-element-content element
     First element in content of ELEMENT, or nil.

 - Function: sgml-element-next element
     Next sibling of ELEMENT.  To loop thru all sub elements of an
     element, `el', You could do like this:

          (let ((c (sgml-element-content el)))
             (while c
                  <<Do something with c>>
                  (setq c (sgml-element-next c))))

 - Function: sgml-element-parent element
     Parent of ELEMENT.

Tags
....

 - Function: sgml-element-stag-optional element
     Return true if the start-tag of ELEMENT is omissible.

 - Function: sgml-element-etag-optional element
     Return true if the end-tag of ELEMENT is omissible.

 - Function: sgml-element-stag-len element
     Return the length of the start-tag of ELEMENT.  If the start-tag
     has been omitted the length is 0.

 - Function: sgml-element-etag-len element
     Return the length of the end-tag of ELEMENT.  If the end-tag has
     been omitted the length is 0.

 - Function: sgml-element-net-enabled element
     Return true, if ELEMENT or some parent of the element has null end
     tag (NET) enabled.  Return `t', if it is ELEMENT that has NET
     enabled.

Positions
.........

   These functions relates an element to positions in the buffer.

 - Function: sgml-element-start element
     Position of start of ELEMENT.

 - Function: sgml-element-end element
     Position after ELEMENT.

 - Function: sgml-element-stag-end element
     Position after start-tag of ELEMENT.

 - Function: sgml-element-etag-start element
     Position before end-tag of ELEMENT.

Attributes
..........

 - Function: sgml-element-attlist element
     Return the attribute declaration list for ELEMENT.

 - Function: sgml-element-attribute-specification-list element
     Return the attribute specification list for ELEMENT.

 - Function: sgml-element-attval element attribute
     Return the value of the ATTRIBUTE in ELEMENT, string or nil.

Misc technical
..............

 - Function: sgml-element-data-p element
     True if ELEMENT can contain data characters.

 - Function: sgml-element-mixed element
     True if ELEMENT has mixed content.

 - Function: sgml-element-eltype element

 - Function: sgml-element-empty element
     True if ELEMENT is empty.

 - Function: sgml-element-excludes element

 - Function: sgml-element-includes element

 - Function: sgml-element-model element
     Declared content or content model of ELEMENT.

 - Function: sgml-element-context-string element
     Return string describing context of ELEMENT.