Html"

From Documentation
m (Add size issue)
m ((via JWB))
 
(3 intermediate revisions by 3 users not shown)
Line 10: Line 10:
 
= Employment/Purpose =
 
= Employment/Purpose =
  
The simplest way is to use an XUL component called <tt>html </tt>to embed whatever HTML tags you want to send directly to the browser. To avoid ZK from interpreting the HTML tags, you usually enclose them with <tt><![CDATA[ </tt>and <tt>]]></tt>. In other words, they are not the child component. Rather, they are stored in the <tt>content </tt>property. Notice you can use EL expressions in it.
+
The simplest way is to use an XUL component called <code>html </code>to embed whatever HTML tags you want to send directly to the browser. To avoid ZK from interpreting the HTML tags, you usually enclose them with <code><![CDATA[ </code>and <code>]]></code>. In other words, they are not the child component. Rather, they are stored in the <code>content </code>property. Notice you can use EL expressions in it.
  
 
= Example =
 
= Example =
Line 25: Line 25:
 
</source>
 
</source>
  
where <tt>&lt;h4&gt;...&lt;/p&gt;</tt> will become the content of the <tt>html</tt> element (see also the <tt>getContent</tt> method of the <tt>org.zkoss.zul.Html</tt> class).
+
where <code>&lt;h4&gt;...&lt;/p&gt;</code> will become the content of the <code>html</code> element (see also the <code>getContent</code> method of the <code>org.zkoss.zul.Html</code> class).
  
The <tt>html</tt> component generates the HTML <tt>SPAN</tt> tag to enclose the content. In other words, it generates the following HTML tags when rendered to the browser.
+
The <code>html</code> component generates the HTML <code>SPAN</code> tag to enclose the content. In other words, it generates the following HTML tags when rendered to the browser.
  
 
<source lang="xml" >
 
<source lang="xml" >
Line 38: Line 38:
 
= Size issue =
 
= Size issue =
 
On Chrome, if <code><html></code>'s sibling use <code>vflex</code> to set hight flexibly, developer must override <code>.z-html</code> CSS like this:
 
On Chrome, if <code><html></code>'s sibling use <code>vflex</code> to set hight flexibly, developer must override <code>.z-html</code> CSS like this:
 +
<source lang="css">
 +
.z-html {
 +
display:block;
 +
}
 +
</source>
 +
or
 
<source lang="css">
 
<source lang="css">
 
.z-html {
 
.z-html {
 
display: inline-block;
 
display: inline-block;
/* display:block; */
 
 
}
 
}
 
</source>
 
</source>
Without this setting, <code>offsetHeight</code> of <code><html></code> will be zero, and sibling's hieght will be wrong.
+
Without this setting, <code>offsetHeight</code> of <code><html></code> will be zero, and sibling's height will be wrong.
  
 
=Supported Events=
 
=Supported Events=
  
{| border="1" | width="100%"
+
{| class='wikitable' | width="100%"
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
Line 63: Line 68:
 
=Use Cases=
 
=Use Cases=
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
Line 81: Line 86:
 
=Version History=
 
=Version History=
 
{{LastUpdated}}
 
{{LastUpdated}}
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-

Latest revision as of 10:40, 12 January 2022

Html

  • Demonstration: Html
  • Java API: Html
  • JavaScript API: Html
  • Style Guide: N/A

Employment/Purpose

The simplest way is to use an XUL component called html to embed whatever HTML tags you want to send directly to the browser. To avoid ZK from interpreting the HTML tags, you usually enclose them with <![CDATA[ and ]]>. In other words, they are not the child component. Rather, they are stored in the content property. Notice you can use EL expressions in it.

Example

ZKComRef Html.png

 <window id="win" title="Html Demo" border="normal">
     <html><![CDATA[
         <h4>Hi, ${win.title}</h4>
         <p>It is the content of the html component.</p>
     ]]></html>
 </window>

where <h4>...</p> will become the content of the html element (see also the getContent method of the org.zkoss.zul.Html class).

The html component generates the HTML SPAN tag to enclose the content. In other words, it generates the following HTML tags when rendered to the browser.

 <span id=”...”>
     <h4>Hi, Html Demo</h4>
     <p>It is the content of the html component.</p>
 </span>

Size issue

On Chrome, if <html>'s sibling use vflex to set hight flexibly, developer must override .z-html CSS like this:

.z-html {
	display:block;
}

or

.z-html {
	display: inline-block;
}

Without this setting, offsetHeight of <html> will be zero, and sibling's height will be wrong.

Supported Events

Name
Event Type
None None

Supported Children

*None

Use Cases

Version Description Example Location
3.6 Work with HTML tags: The Html component The Html component
3.6 herf attribute in Html component http://www.zkoss.org/forum/listComment/4745
3.6 Use Html component to escape HTML characters http://www.zkoss.org/forum/listComment/11118

Version History

Last Update : 2022/01/12


Version Date Content
     



Last Update : 2022/01/12

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