Portalchildren"

From Documentation
m (Created page with 'init')
 
(19 intermediate revisions by 8 users not shown)
Line 1: Line 1:
init
+
{{ZKComponentReferencePageHeader}}
 +
 
 +
= Portalchildren =
 +
 
 +
*Demonstration: [http://www.zkoss.org/zkdemo/layout/portal_layout Portallayout]
 +
*Java API: <javadoc>org.zkoss.zkmax.zul.Portalchildren</javadoc>
 +
*JavaScript API: <javadoc directory="jsdoc">zkmax.layout.Portalchildren</javadoc>
 +
*Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Portallayout| Portallayout]]
 +
*{{ZK EE}}
 +
 
 +
= Employment/Purpose =
 +
 
 +
The column of [[ZK_Component_Reference/Layouts/Portallayout | Portallayout]]
 +
 
 +
Child of Portalchildren can only be [[ ZK_Component_Reference/Containers/Panel | Panel]]
 +
 
 +
= Example =
 +
 
 +
[[Image:ZKComRef_Portallayout_Example.PNG]]
 +
 
 +
 
 +
<source lang="xml" >
 +
<portallayout>
 +
<portalchildren width="50%">
 +
<panel height="150px" title="Yahoo">
 +
<panelchildren>
 +
<iframe width="100%" src="http://www.yahoo.com/"/>
 +
</panelchildren>
 +
</panel>
 +
<panel height="300px" title="Google">
 +
<panelchildren>
 +
<iframe width="100%" src="http://www.google.com/"/>
 +
</panelchildren>
 +
</panel>
 +
</portalchildren>
 +
<portalchildren width="50%">
 +
<panel height="150px" title="ZK">
 +
<panelchildren>
 +
<iframe width="100%" src="http://www.zkoss.org/"/>
 +
</panelchildren>
 +
</panel>
 +
</portalchildren>
 +
</portallayout>
 +
</source>
 +
 
 +
=Properties=
 +
==Title==
 +
[ Since 9.0.0 ]
 +
Sets the title of the portalchildren. If the title is not empty/null, frame design will be applied.
 +
 
 +
===Frame Design===
 +
PortalChildren now provides a frame design, making it extremely easy to create a Kanban-like layout for your application. To turn on the PortalChildren frame design, just specify the title attribute on the PortalChildren.
 +
 
 +
===Example===
 +
Each PortalChildren with title can be used as a Kanban board column to represent a process stage, and the panels inside each column represent tasks in the said stage. The number next to the PortalChildren title is a counter, indicating the total number of panels inside the said column.
 +
 
 +
If a panel has a panel title, users can drag and hold the panel title to move it to the appropriate column. If the panel does not have a panel title, you can drag the small dragging button at the top of the panel to move.
 +
 
 +
[[File:Kanban-1.png|800px|center]]
 +
 
 +
<source lang="xml" >
 +
<zk>
 +
  <style>
 +
    .z-panel {
 +
      width: 300px;
 +
    }
 +
  </style>
 +
  <portallayout>
 +
    <portalchildren title="TO-DO">
 +
      <panel title="Animation" border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
      <panel title="Illustration" border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
      <panel border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
      <panel title="Landing Page" border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
    </portalchildren>
 +
    <portalchildren title="IN-PROGRESS">
 +
      <panel title="Banner" border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
      <panel border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
    </portalchildren>
 +
      <portalchildren title="DONE" >
 +
      <panel title="Advertising" border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
      <panel border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
      <panel title="Interview" border="normal">
 +
        <panelchildren>......</panelchildren>
 +
      </panel>
 +
    </portalchildren>
 +
  </portallayout>
 +
</zk>
 +
</source>
 +
 
 +
==CounterVisible==
 +
[ Since 9.0.0 ]
 +
Sets whether the counter is visible. Meaningful only if frame design is applied.
 +
 
 +
 
 +
 
 +
=Supported Events=
 +
 
 +
{| border="1" | width="100%"
 +
! <center>Name</center>
 +
! <center>Event Type</center>
 +
|-
 +
| None
 +
| None
 +
 
 +
|}
 +
*Inherited Supported Events: [[ZK_Component_Reference/Base_Components/XulElement#Supported_Events | XulElement]]
 +
 
 +
=Supported Children=
 +
 
 +
*[[ZK_Component_Reference/Containers/Panel | Panel]]
 +
 
 +
=Use Cases=
 +
 
 +
{| border='1px' | width="100%"
 +
! Version !! Description !! Example Location
 +
|-
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 +
|}
 +
 
 +
=Version History=
 +
{{LastUpdated}}
 +
 
 +
{| border='1px' | width="100%"
 +
! Version !! Date !! Content
 +
|-
 +
| 9.0.0
 +
| Nov 2019
 +
| [https://tracker.zkoss.org/browse/ZK-4398 ZK-4398]: Provide PortalChildren title and frame design
 +
|}
 +
 
 +
{{ZKComponentReferencePageFooter}}

Revision as of 04:21, 19 November 2019

Portalchildren

Employment/Purpose

The column of Portallayout

Child of Portalchildren can only be Panel

Example

ZKComRef Portallayout Example.PNG


<portallayout>
	<portalchildren width="50%">
		<panel height="150px" title="Yahoo">
			<panelchildren>
				<iframe width="100%" src="http://www.yahoo.com/"/>
			</panelchildren>
		</panel>
		<panel height="300px" title="Google">
			<panelchildren>
				<iframe width="100%" src="http://www.google.com/"/>
			</panelchildren>
		</panel>
	</portalchildren>
	<portalchildren width="50%">
		<panel height="150px" title="ZK">
			<panelchildren>
				<iframe width="100%" src="http://www.zkoss.org/"/>
			</panelchildren>
		</panel>
	</portalchildren>
</portallayout>

Properties

Title

[ Since 9.0.0 ]

Sets the title of the portalchildren. If the title is not empty/null, frame design will be applied.

Frame Design

PortalChildren now provides a frame design, making it extremely easy to create a Kanban-like layout for your application. To turn on the PortalChildren frame design, just specify the title attribute on the PortalChildren.

Example

Each PortalChildren with title can be used as a Kanban board column to represent a process stage, and the panels inside each column represent tasks in the said stage. The number next to the PortalChildren title is a counter, indicating the total number of panels inside the said column.

If a panel has a panel title, users can drag and hold the panel title to move it to the appropriate column. If the panel does not have a panel title, you can drag the small dragging button at the top of the panel to move.

Kanban-1.png
<zk>
  <style>
    .z-panel {
      width: 300px;
    }
  </style>
   <portallayout>
     <portalchildren title="TO-DO">
       <panel title="Animation" border="normal">
         <panelchildren>......</panelchildren>
       </panel>
       <panel title="Illustration" border="normal">
         <panelchildren>......</panelchildren>
       </panel>
       <panel border="normal">
         <panelchildren>......</panelchildren>
       </panel>
       <panel title="Landing Page" border="normal">
         <panelchildren>......</panelchildren>
       </panel>
    </portalchildren>
     <portalchildren title="IN-PROGRESS">
       <panel title="Banner" border="normal">
         <panelchildren>......</panelchildren>
       </panel>
       <panel border="normal">
         <panelchildren>......</panelchildren>
       </panel>
     </portalchildren>
      <portalchildren title="DONE" >
       <panel title="Advertising" border="normal">
         <panelchildren>......</panelchildren>
       </panel>
       <panel border="normal">
         <panelchildren>......</panelchildren>
       </panel>
       <panel title="Interview" border="normal">
         <panelchildren>......</panelchildren>
       </panel>
     </portalchildren>
   </portallayout>
</zk>

CounterVisible

[ Since 9.0.0 ]

Sets whether the counter is visible. Meaningful only if frame design is applied.


Supported Events

Name
Event Type
None None

Supported Children

* Panel

Use Cases

Version Description Example Location
     

Version History

Last Update : 2019/11/19


Version Date Content
9.0.0 Nov 2019 ZK-4398: Provide PortalChildren title and frame design



Last Update : 2019/11/19

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