XHTML Components"

From Documentation
m
Line 8: Line 8:
 
* By implementing the <javadoc type="interface">org.zkoss.zk.ui.ext.RawId</javadoc> interface, the universal identifier, <mp>getUuid</mp>, is the same as the identifier <mp>getId</mp>.
 
* By implementing the <javadoc type="interface">org.zkoss.zk.ui.ext.RawId</javadoc> interface, the universal identifier, <mp>getUuid</mp>, is the same as the identifier <mp>getId</mp>.
 
* By implementing the <javadoc type="interface">org.zkoss.zk.ui.ext.DynamicAttributes</javadoc> interface, all XHTML components support arbitrary attributes. In other words, any attribute name is legal (as long as the targeted browser supports).
 
* By implementing the <javadoc type="interface">org.zkoss.zk.ui.ext.DynamicAttributes</javadoc> interface, all XHTML components support arbitrary attributes. In other words, any attribute name is legal (as long as the targeted browser supports).
−
 
−
===Encoding URLs===
 
−
 
−
A XHTML component generates attributes directly to native HTML tags. It means, unlike XUL, it doesn't prefix the servlet context path to attributes for specifying URL. For example, the following codes don't work (unless the servlet context is "").
 
−
 
−
<source lang="xml" >
 
−
<img href="/my/good.png"/>
 
−
</source>
 
−
 
−
Instead, you should use the <mp>encodeURL</mp> function in EL expressions as follows.
 
−
 
−
 
−
<source lang="xml" >
 
−
<?taglib uri="http://www.zkoss.org/dsp/web/core.dsp.tld" prefix="p"?>
 
−
...
 
−
<img href="${p:encodeURL('/my/good.png')}"/>
 
−
</source>
 
−
 
−
In Java, you should use the method, <javadoc method="encodeURL(java.lang.String)">org.zkoss.zk.ui.Execution</javadoc>.
 
−
 
−
 
−
<source lang="xml" >
 
−
<img id="another"/>
 
−
<zscript>
 
−
  another.setDynamicAttribute("href",
 
−
    Executions.getCurrent().encodeURL("/my/good.png"));
 
−
</zscript>
 
−
</source>
 
−
 
−
Notice that XUL components and all ZK features that accept a URL will invoke the <mp>encodeURL</mp> method automatically. The reason why we do not
 
−
handle XHTML components is that we do not know which attribute requires a URL.
 
  
 
=== Raw ===
 
=== Raw ===

Revision as of 02:55, 20 May 2010


DocumentationZK Component ReferenceXHTML Components
XHTML Components


All XHTML components are derived from AbstractTag.

An XHTML component is a thin wrapper that encapsulates a native HTML tag. It is different to a XUL component or other none-native component in several ways.

  • By implementing the RawId interface, the universal identifier, getUuid, is the same as the identifier getId.
  • By implementing the DynamicAttributes interface, all XHTML components support arbitrary attributes. In other words, any attribute name is legal (as long as the targeted browser supports).

Raw

A special component, Raw is used to represent any component that is not declared in the following section (i.e., not in lang.xml). In other words, if any unrecognized component name is found, an instance of Raw is created and a proper HTML tag will be generated accordingly. In other words, any component name is legal as long as the targeted browser supports. 

<marquee align="top">...</marquee>

is equivalent to 

new Raw().setDynamicAttribute("align", "top");



Last Update : 2010/05/20

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Component_Reference/XHTML_Components&oldid=2093"