org.zkoss.zk.ui
Class HtmlNativeComponent

java.lang.Object
  org.zkoss.zk.ui.AbstractComponent
      org.zkoss.zk.ui.HtmlNativeComponent

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Component, DynamicPropertied, DynamicTag, Native, NonFellow, Scope, ComponentCtrl

Direct Known Subclasses:

XmlNativeComponent

public class HtmlNativeComponent
extends AbstractComponent
implements DynamicTag, Native

A comonent used to represent XML elements that are associated with the inline namespace (http://www.zkoss.org/2005/zk/inline).

It contains the content that shall be sent directly to client. It has three parts: prolog, children and epilog. The prolog (getPrologContent()) and epilog (getEpilogContent()) are both String.

When this component is renderred (redraw(java.io.Writer)), it generates the prolog first, the children and then the epilog.

Since:

3.0.0

Author:

tomyeh

See Also:

Serialized Form

Nested Class Summary

static class

HtmlNativeComponent.HtmlHelper The HTML helper.

Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent

AbstractComponent.Children

Nested classes/interfaces inherited from interface org.zkoss.zk.ui.ext.Native

Native.Helper

Field Summary

Fields inherited from class org.zkoss.zk.ui.AbstractComponent

_visible

Fields inherited from interface org.zkoss.zk.ui.Component

APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE

Constructor Summary

HtmlNativeComponent()
Contructs a HtmlNativeComponent component.

HtmlNativeComponent(java.lang.String tag)
Constructs a HtmlNativeComponent component with the specified tag name.

HtmlNativeComponent(java.lang.String tag, java.lang.String prolog, java.lang.String epilog)
Contructs a HtmlNativeComponent component with the specified prolog ad epilog.

Method Summary

void	addDeclaredNamespace(Namespace ns) Adds a declared namespace.
java.util.List	getDeclaredNamespaces() Returns a readonly list of the declared namespaces (Namespace), or empty if no declared namespace.
java.lang.Object	getDynamicProperty(java.lang.String name) Returns the property value of the specified name.
java.lang.String	getEpilogContent() Returns the epilog content.
Native.Helper	getHelper() Returns the helper to generate the output of the native components.
java.lang.String	getPrologContent() Returns the prolog content.
java.lang.String	getTag() Returns the tag name, or null if plain text.
boolean	hasDynamicProperty(java.lang.String name) Returns whether a dynamic property is defined.
boolean	hasTag(java.lang.String tag) Returns whether the specified tag is allowed.
void	redraw(java.io.Writer out) Redraws this component.
void	setDynamicProperty(java.lang.String name, java.lang.Object value) Sets a property with the specified name and value.
void	setEpilogContent(java.lang.String epilog) Sets the epilog content.
void	setId(java.lang.String id) Sets the ID.
void	setPrologContent(java.lang.String prolog) Sets the prolog content.
void	setTag(java.lang.String tag) Sets the tag name.
boolean	setVisible(boolean visible) Sets whether this component is visible.

Methods inherited from class org.zkoss.zk.ui.AbstractComponent

addAnnotation, addAnnotation, addEventHandler, addEventListener, addForward, addForward, addForward, addForward, addMoved, addSharedAnnotationMap, addSharedEventHandlerMap, appendAsapAttr, appendAsapAttr, appendChild, applyProperties, clone, containsVariable, detach, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttributes, getAttributes, getChildren, getCommand, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getExtraCtrl, getFellow, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getMoldURI, getNamespace, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getUuid, getVariable, hasFellow, insertBefore, invalidate, isAsapRequired, isChildable, isInvalidated, isListenerAvailable, isVisible, newChildren, newExtraCtrl, onChildAdded, onChildRemoved, onDrawNewChild, onPageAttached, onPageDetached, onWrongValue, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, response, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setComponentDefinition, setMold, setPage, setPageBefore, setParent, setVariable, smartUpdate, smartUpdate, smartUpdate, smartUpdateDeferred, smartUpdateValues, toString, unsetVariable

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

HtmlNativeComponent

public HtmlNativeComponent()

Contructs a HtmlNativeComponent component.

HtmlNativeComponent

public HtmlNativeComponent(java.lang.String tag)

Constructs a HtmlNativeComponent component with the specified tag name.

Parameters:

tag - the tag name. If null or empty, plain text is assumed.

HtmlNativeComponent

public HtmlNativeComponent(java.lang.String tag,
                           java.lang.String prolog,
                           java.lang.String epilog)

Contructs a HtmlNativeComponent component with the specified prolog ad epilog.

Method Detail

getTag

public java.lang.String getTag()

Returns the tag name, or null if plain text.

getDeclaredNamespaces

public java.util.List getDeclaredNamespaces()

Description copied from interface: Native

Returns a readonly list of the declared namespaces (Namespace), or empty if no declared namespace.

Specified by:

getDeclaredNamespaces in interface Native

addDeclaredNamespace

public void addDeclaredNamespace(Namespace ns)

Description copied from interface: Native

Adds a declared namespace. The added declared namespace will be generated to the output.

Specified by:

addDeclaredNamespace in interface Native

Parameters:

ns - the namespace (never null).

getPrologContent

public java.lang.String getPrologContent()

Description copied from interface: Native

Returns the prolog content. It is the content generated before the child components, if any.

Default: empty ("").

Specified by:

getPrologContent in interface Native

setPrologContent

public void setPrologContent(java.lang.String prolog)

Description copied from interface: Native

Sets the prolog content. It is the content generated before the child components, if any.

Specified by:

setPrologContent in interface Native

getEpilogContent

public java.lang.String getEpilogContent()

Description copied from interface: Native

Returns the epilog content. It is the content generated before the child components, if any.

Default: empty ("").

Specified by:

getEpilogContent in interface Native

setEpilogContent

public void setEpilogContent(java.lang.String epilog)

Description copied from interface: Native

Sets the epilog content. It is the content generated before the child components, if any.

Specified by:

setEpilogContent in interface Native

getHelper

public Native.Helper getHelper()

Description copied from interface: Native

Returns the helper to generate the output of the native components.

Specified by:

getHelper in interface Native

setId

public void setId(java.lang.String id)

Description copied from interface: Component

Sets the ID. The scope of uniqunes depends on whether this component is a root component. Refer to Component.getId() for more details.

When a component is constructed, an ID is generated automatically. Thus, calling this method only you need to identify a component.

Specified by:

setId in interface Component

Overrides:

setId in class AbstractComponent

Parameters:

id - the identifier. It cannot be empty. If null, it means the previous ID is removed (aka., reset) and an anonymous ID is assigned.

See Also:

Page

setVisible

public boolean setVisible(boolean visible)

Description copied from interface: Component

Sets whether this component is visible.

Specified by:

setVisible in interface Component

Overrides:

setVisible in class AbstractComponent

Returns:

the previous visibility

redraw

public void redraw(java.io.Writer out)
            throws java.io.IOException

Description copied from class: AbstractComponent

Redraws this component. This method implements the mold mechanism.

1. It first invokes AbstractComponent.getMoldURI() to retrieve the mold to redraw. The mold is either an URI (String) or a ComponentRenderer instance.
2. If URI, it invokes Execution.include(java.io.Writer, java.lang.String, java.util.Map, int) to generate the output.
3. If a ComponentRenderer instance, ComponentRenderer.render(org.zkoss.zk.ui.Component, java.io.Writer) is called to generate the output.

Specified by:

redraw in interface Component

Overrides:

redraw in class AbstractComponent

Throws:

java.io.IOException

setTag

public void setTag(java.lang.String tag)
            throws WrongValueException

Sets the tag name.

Specified by:

setTag in interface DynamicTag

Parameters:

tag - the tag name. If null or empty, plain text is assumed.

Throws:

WrongValueException

hasTag

public boolean hasTag(java.lang.String tag)

Description copied from interface: DynamicTag

Returns whether the specified tag is allowed.

Specified by:

hasTag in interface DynamicTag

hasDynamicProperty

public boolean hasDynamicProperty(java.lang.String name)

Description copied from interface: DynamicPropertied

Returns whether a dynamic property is defined.

Specified by:

hasDynamicProperty in interface DynamicPropertied

getDynamicProperty

public java.lang.Object getDynamicProperty(java.lang.String name)

Description copied from interface: DynamicPropertied

Returns the property value of the specified name.

Specified by:

getDynamicProperty in interface DynamicPropertied

setDynamicProperty

public void setDynamicProperty(java.lang.String name,
                               java.lang.Object value)
                        throws WrongValueException

Description copied from interface: DynamicPropertied

Sets a property with the specified name and value.

If a component supports only String-type values, it could use org.zkoss.lang.Objects.toString() to convert the value to a String instance.

Specified by:

setDynamicProperty in interface DynamicPropertied

Throws:

WrongValueException