Linelayout"

From Documentation
 
(9 intermediate revisions by 2 users not shown)
Line 7: Line 7:
 
   
 
   
 
  {{ZK EE}}
 
  {{ZK EE}}
[Since 9.0.0]
+
{{versionSince| 9.0.0}}
  
 
= Employment/Purpose =
 
= Employment/Purpose =
  
<tt>Linelayout</tt> is a component for displaying chronological information in a flexible and easy way, it also support ListModel to hold data, Linelayout only accept one <tt>Lineitem</tt> as child.
+
<code>Linelayout</code> is a component for displaying chronological information in a flexible and easy way; in addition to static data it also support ListModel. Linelayout only accept <code>Lineitem</code> as its child.
  
A Linelayout is composed of three parts: first area, line area and last area. The first and last areas are the containers for the content, the line area contains the point.
+
A Linelayout is composed of three parts: first area, line area and last area. The first and last areas are the containers for the content, and the line area contains the line and the point.
  
 
= Browser Support =
 
= Browser Support =
*For IE, this component only supports 11+, it is based on [https://developer.mozilla.org/en-US/docs/Web/CSS/flex CSS Flexbox], please check browser compatibility before using it.
+
*This component is based on [https://developer.mozilla.org/en-US/docs/Web/CSS/flex CSS Flexbox] and is compatible with browsers that support CSS Flexbox such as IE11+, Chrome and Firefox. Please check browser compatibility before using it.
  
 
= Example =
 
= Example =
Line 40: Line 40:
 
= Properties =
 
= Properties =
 
== Orient ==
 
== Orient ==
Weather the linelayout display vertical or horizontal. The default value is "vertical".
+
Whether the linelayout displays vertically or horizontally. The default value is "vertical".
  
 
[[Image:Linelayout-3.png|800px|center]]
 
[[Image:Linelayout-3.png|800px|center]]
<source language="xml">
+
<source lang="xml">
 
   <linelayout orient="horizontal" lineStyle="background:rgba(0,0,0,0.5)" >
 
   <linelayout orient="horizontal" lineStyle="background:rgba(0,0,0,0.5)" >
 
     <lineitem>
 
     <lineitem>
Line 67: Line 67:
 
The CSS inline style for the line.
 
The CSS inline style for the line.
 
== FirstScale ==
 
== FirstScale ==
The scale of space occupied by the first area. The default value is 1, you can change the position of line by adjusting this property.
+
The scale of space occupied by the first area. The default value is 1, you can change the position of the line by adjusting this property.
For example, set firstScale 1 and lastScale 3 in a vertical linelayout will cause the position of line to be more left, since the space proportion become 1:3, and vice versa.
+
For example, set firstScale as 1 and lastScale as 3 in a vertical linelayout, the line will be rendered a quarter away from the left boundary since the space ratio becomes 1:3..
 +
 
 
== LastScale ==
 
== LastScale ==
 
The scale of space occupied by the last area, the default value is 1.
 
The scale of space occupied by the last area, the default value is 1.
Line 76: Line 77:
 
= 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 94: Line 95:
 
{{LastUpdated}}
 
{{LastUpdated}}
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-

Latest revision as of 03:58, 3 May 2022

Linelayout

  • Available for ZK:
  • http://www.zkoss.org/product/zkhttp://www.zkoss.org/whyzk/zkeeVersion ee.png

Since 9.0.0

Employment/Purpose

Linelayout is a component for displaying chronological information in a flexible and easy way; in addition to static data it also support ListModel. Linelayout only accept Lineitem as its child.

A Linelayout is composed of three parts: first area, line area and last area. The first and last areas are the containers for the content, and the line area contains the line and the point.

Browser Support

  • This component is based on CSS Flexbox and is compatible with browsers that support CSS Flexbox such as IE11+, Chrome and Firefox. Please check browser compatibility before using it.

Example

Linelayout-1.png
  <zscript>
    ListModel model = new ListModelList(new String[] {
        "2019-Q1",
        "2019-Q2",
        "2019-Q3",
        "2019-Q4"
    });
  </zscript>
  <linelayout model="${model}">
    <template name="model">
      <lineitem>
        <button label="${each}"></button>
      </lineitem>
    </template>
  </linelayout>

Properties

Orient

Whether the linelayout displays vertically or horizontally. The default value is "vertical".

Linelayout-3.png
  <linelayout orient="horizontal" lineStyle="background:rgba(0,0,0,0.5)" >
    <lineitem>
      <label>8 am</label>
      <button>good morning</button>
    </lineitem>
    <lineitem opposite="true" pointIconSclass="z-icon-plus-circle" pointStyle="background: #FF4051">
      <label>12 pm</label>
      <button>lunch time</button>
    </lineitem>
    <lineitem>
      <label>6 pm</label>
      <button>dinner time</button>
    </lineitem>
    <lineitem opposite="true">
      <label>10 pm</label>
      <button>good night</button>
    </lineitem>
  </linelayout>

LineStyle

The CSS inline style for the line.

FirstScale

The scale of space occupied by the first area. The default value is 1, you can change the position of the line by adjusting this property. For example, set firstScale as 1 and lastScale as 3 in a vertical linelayout, the line will be rendered a quarter away from the left boundary since the space ratio becomes 1:3..

LastScale

The scale of space occupied by the last area, the default value is 1.

Please refer to FirstScale.

Supported Events

Name
Event Type
None None


Supported Children

* Lineitem

Version History

Last Update : 2022/05/03


Version Date Content
9.0.0 Nov 2019 ZK-4377: Provide a Linelayout component



Last Update : 2022/05/03

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