Stepbar"

From Documentation
m ((via JWB))
 
(6 intermediate revisions by the same user not shown)
Line 14: Line 14:
 
= Example =
 
= Example =
  
[[File:Stepbar-example.png]]
+
[[File:stepbar-example.jpg | center]]
  
 
<source lang="xml" >
 
<source lang="xml" >
 
<zk>
 
<zk>
     <stepbar linear="false" activeIndex="2" width="600px">
+
     <stepbar activeIndex="1" width="600px">
         <step title="First Step" iconSclass="z-icon-home"/>
+
         <step title="First Step" />
         <step title="Second Step" complete="true" />
+
         <step title="Second Step" />
         <step title="Third Step" error="true" />
+
         <step title="Third Step"/>
 
     </stepbar>
 
     </stepbar>
 
</zk>
 
</zk>
Line 27: Line 27:
  
 
= Supported Browsers =
 
= Supported Browsers =
It is compatible with browsers that fully supports CSS flexbox model, like IE 11, Edge, Firefox, Opera, Chrome and Safari.
+
It is compatible with browsers that fully support CSS flexbox, like IE 11, Edge, Firefox, Opera, Chrome, and Safari.  
  
 
IE10 is not supported as it only partially supports flexbox.
 
IE10 is not supported as it only partially supports flexbox.
 +
[https://caniuse.com/flexbox Check flexbox browser support].
  
 
= Properties =
 
= Properties =
Line 49: Line 50:
  
 
== Model ==
 
== Model ==
The step model associated with this stepbar. (Learn [[ZK_Developer%27s_Reference/MVC/Model#Model-Driven_Rendering| Model-Driven Rendering]].)
+
The step model associated with this stepbar. (Learn [[ZK_Developer%27s_Reference/MVC/Model#Model-Driven_Rendering| Model-Driven Rendering]])
  
 
You can use <javadoc>org.zkoss.zkmax.zul.DefaultStepModel</javadoc>,   
 
You can use <javadoc>org.zkoss.zkmax.zul.DefaultStepModel</javadoc>,   
Line 56: Line 57:
  
 
== StepRenderer ==
 
== StepRenderer ==
The renderer used to render each step.
+
The renderer used to render each step.(Learn [[ZK_Developer%27s_Reference/MVC/Model#Model-Driven_Rendering| Model-Driven Rendering]])
  
Implement yourown <javadoc>org.zkoss.zkmax.zul.StepRenderer</javadoc> to handle how data renders to a Step object.
+
You can specify your own <javadoc>org.zkoss.zkmax.zul.StepRenderer</javadoc> at this attribute to renders a Step object with your data.
  
 
== WrappedLabels ==
 
== WrappedLabels ==
Line 71: Line 72:
  
 
= 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>
 
|-
 
|-
| <center><tt>onChange</tt></center>
+
| <center><code>onChange</code></center>
 
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.Event</javadoc>
 
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.Event</javadoc>
  
Line 89: Line 90:
 
= Use Cases =
 
= Use Cases =
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
Line 100: Line 101:
  
 
{{LastUpdated}}
 
{{LastUpdated}}
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-

Latest revision as of 14:09, 12 January 2022

Stepbar

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

Since 9.0.0

Employment/Purpose

Stepbar is a navigation component suitable for displaying the progress of a multi-step task.

Example

Stepbar-example.jpg
<zk>
    <stepbar activeIndex="1" width="600px">
        <step title="First Step" />
        <step title="Second Step" />
        <step title="Third Step"/>
    </stepbar>
</zk>

Supported Browsers

It is compatible with browsers that fully support CSS flexbox, like IE 11, Edge, Firefox, Opera, Chrome, and Safari.

IE10 is not supported as it only partially supports flexbox. Check flexbox browser support.

Properties

ActiveIndex

The index of the active step. (Default: 0)

ActiveStep

The active step object. (Default: first step)

Linear

Set whether the steps in this stepbar are displayed in order.

Non-linear means users can toggle the active steps easily by clicking on any step even if the step is not the next one in the sequence. In linear mode, they can only activate in order.

Stepbar-linear.gif

Model

The step model associated with this stepbar. (Learn Model-Driven Rendering)

You can use DefaultStepModel, wrap an existing ListModelList by DefaultStepModel's constructor, or implement StepModel.

StepRenderer

The renderer used to render each step.(Learn Model-Driven Rendering)

You can specify your own StepRenderer at this attribute to renders a Step object with your data.

WrappedLabels

Set whether the labels in children steps are wrapped. (Default: false)

true: Stepber-WrappedLabels.png

false: Stepbar-example.png

Supported Events

Name
Event Type
onChange
Event: Event

Represents an event caused by a user's selection changed at the client.

Supported Children

* Step

Use Cases

Version Description Example Location
     

Version History

Last Update : 2022/01/12


Version Date Content
9.0.0 November, 2019 ZK-4375: Provide a stepbar component



Last Update : 2022/01/12

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