Java Doc for Element.java in  » Ajax » zk » org » zkoss » idom » Java Source Code / Java DocumentationJava Source Code and Java Documentation

The content of an element is the first Binary or Text child of the element.

Note that there might be more than one child with the same path in an idom tree; this method simply picks the first one that matchs and returns its content.

It is not a "live" representation.

If prefix is empty, it searches for the "default" namespace in scope.

Unlike Element.setContent(String,Object) with null, the child element identified by path will be detached if it has no other child (but the content).

All existent Binary or Text children of this element are removed first.

Note that there might be more than one child with the same path in an idom tree; this method simply pick one that matchs and set its content (see Element.setContent(Object) ).

The content of an element is a special feature of iDOM. Like a Map, it is designed to let developers use names (in a path-like format) to access objects.

Note: if both includingDescendant and Element.isAttributeModificationAware are true, attributes' modified flags are cleaned.

The content of an element is the first Binary or Text child of the element. Each element can has zero or one content.

Note: Element.getText returns the catenation of all Text children, not just the first one. the content of this element; null if no such child
See Also:   Element.getContent(String)

Note that there might be more than one child with the same path in an idom tree; this method simply picks the first one that matchs and returns its content. To access certain one, you might use [n] to [@attr = value] specify which one to access.

To know whether the child element exists or conent is null, use Element.hasContent .

The content of an element is a special feature of iDOM. Like a Map, it is designed to let developers use names (in a path-like format) to access objects. See Element.setContent(String,Object) .

Like Unix path, the giving name could use '/' to catenate a series of child elements.

An empty path denotes this element itself. Leading, ending and consecutive '/' will be ignored.

Example:
Object o = element.getContent("abc/def");
String s = Objects.toString(element.getContent("ab/cd"));
element.setContent("t:ab/cd/f:ef", new Integer(10));

TODO: support [n] and [@attr = value]
Parameters:
  path - a path; e.g., "b", "a/b", "t:a/t:b"
See Also:   Element.getContent()

It is not a "live" representation. Also, it is read-only.

Note: Namespace.equals compares namespace's URI. However, the distinction here is the prefix, because it is mainly for getNamespace(prefix). the namespace declarations.

If prefix is empty, it searches for the "default" namespace in scope. Thus, to search for attribute's namespace, caller have to skip this one and use NO_NAMESPACE. (due XML, an attribute without prefix is NO_NAMESPACE)
Parameters:
  prefix - namespace prefix to look up; null for empty

Note: false is returned if it doesn't has any parent.

Unlike Element.setContent(String,Object) with null, the child element identified by path will be detached if it has no other child (but the content). So does its parent excluding this element. Thus, removeContent(path) could undo setContent(path, v). the previous content
See Also:   Element.setContent(String,Object)

All existent Binary or Text children of this element are removed first. If the object is a String, a Text item is created to hold it. Otherwise, a Binary item is created to hold it.

Non-Binary/Text children are preserved.

If obj is a Item or an array/collection of Item , this method will add them as child vertices rather than being the content. Moreever, if the first item of the array/collection is Item , it is assumed to be all valid component to being has valid vertices. If not, an exception is thrown.

Thus, getContent might not return the object being set by setContent.
Parameters:
  obj - the object to set; null is OK the previous content
See Also:   Element.getContent()

Note that there might be more than one child with the same path in an idom tree; this method simply pick one that matchs and set its content (see Element.setContent(Object) ).

The content of an element is a special feature of iDOM. Like a Map, it is designed to let developers use names (in a path-like format) to access objects. See Element.getContent(String) .

Like Unix path, the giving name could use '/' to catenate a series of child elements.

An empty path denotes this element itself. Leading, ending and consecutive '/' will be ignored.

If any element in the path is not found, it will be created automatically.
Parameters:
  path - a path; e.g., "b", "a/b", "t:a/t:b"
Parameters:
  obj - the object to set; null is acceptable the previous content
See Also:   Element.setContent(Object)
See Also:   Element.removeContent
See Also:   Element.hasContent

According W3C/DOM, unlike element, an attribute doesn't allow a namespace that has an URI but without a prefix.