New Features of ZK 9.0.0"

From Documentation
(Created page with "{{Template:Smalltalk_Author| |author=Hawk Chen, Engineer, Potix Corporation |date= Dec. 10, 2019 |version=ZK 9.0.0}} __TOC__ = Introduction = '''"Easy"''', '''"Ajax without J...")
 
m (correct highlight (via JWB))
 
(16 intermediate revisions by 2 users not shown)
Line 11: Line 11:
 
'''"Easy"''', '''"Ajax without Javascript"''' and '''"Rich Components"''' are the 3 top rated ZK values by the community since day one. ZK 9 carries on with the same drive and brings you 20+ new features and components such as Toast, Stepbar, Rangeslider, Drawer, Inputgroup, Anchornav, Linelayout,.. making the development even easier than ever.  
 
'''"Easy"''', '''"Ajax without Javascript"''' and '''"Rich Components"''' are the 3 top rated ZK values by the community since day one. ZK 9 carries on with the same drive and brings you 20+ new features and components such as Toast, Stepbar, Rangeslider, Drawer, Inputgroup, Anchornav, Linelayout,.. making the development even easier than ever.  
  
ZK 9 requires '''Java 8''' to compile, so please make sure you are with Java SE 8 or later versions. If you are coming from an older ZK version, remember to check out the [[#Upgrade Notes]] at the end of the page. For more information please refer to the [https://github.com/zkoss/zk/blob/master/zkdoc/release-note Release Notes].  
+
ZK 9 requires '''Java 8''' to compile, so please make sure you are with Java SE 8 or later versions. If you are coming from an older ZK version, remember to check out the [[#Upgrade Notes]] at the end of the page.
 +
 
 +
For more information please refer to the [https://www.zkoss.org/product/zk/releasenote/9.0.0 Release Notes].  
  
 
== Download ==
 
== Download ==
 
<br />
 
<br />
<div><div style="float: left;"><imagelink link="http://www.zkoss.org/download/zk?zk9" image="/_w/images/0/00/Download-zk-7.png" /></div>
+
<div style="float: left;"><imagelink link="http://www.zkoss.org/download/zk" image="/_w/images/0/00/Download-zk-7.png" /></div>
 
+
<div style="float: left"><imagelink link="http://www.zkoss.org/zkdemo/" image="/_w/images/6/68/Demo-zk-7.png" /></div>
 
<br />
 
<br />
 
<br />
 
<br />
Line 31: Line 33:
  
 
==Support JDK8 Date/Time API==
 
==Support JDK8 Date/Time API==
Datebox, Calendar, Timebox and Timepicker components now supports JDK 8 Date/Time API. Their constructors and setters now accept JDK 8 Date/Time and the getters can return JDK 8 Date/Time type. For example <tt>Datebox</tt> supports the following constructors:
+
Datebox, Calendar, Timebox and Timepicker components now supports JDK 8 Date/Time API. Their constructors and setters now accept JDK 8 Date/Time and the getters can return JDK 8 Date/Time type. For example <code>Datebox</code> supports the following constructors:
  
 
<source lang='java'>
 
<source lang='java'>
Line 45: Line 47:
  
 
{{ZK All}}
 
{{ZK All}}
ZK 9 implement hflex/vflex in a whole new way, a more performant way --  by [https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox CSS3 flexbox], which is supported by modern browsers natively. It's no need to execute javascript to calculate the size. This change should be transparent for developers.
+
ZK 9 implements hflex/vflex in a whole new, more performant way --  by [https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox CSS3 flexbox], which is supported by modern browsers natively. With this change, javascript size calculation is eliminated thus improving the client-side performance. This change should be transparent for developers.
 +
 
 +
However, if your application depends on the previous implementation, you can fall back by the property below in zk.xml:
 +
<source lang='xml'>
 +
<library-property>
 +
    <name>org.zkoss.zul.css.flex</name>
 +
    <value>true</value>
 +
</library-property>
 +
</source>
  
However if your application depends on the previous implementation, you can configure the <tt>org.zkoss.zul.css.flex</tt> library property to '''false''' to fall back to the previous implementation.
+
= [[ZK_Developer%27s_Reference/Integration/Miscellenous/Embedded_ZK_Application | Embed ZK App into An External App]]  =
 +
 
 +
{{ZK EE}}
 +
Instead of using iframe, since ZK 9, there is a new way to embed your ZK application into an external application such as a NodeJS or Python-based web page. Furthermore, by using ZK Client Binding in Javascript, we can also control ZK components in these external Apps.
 +
 
 +
With this feature we can now easily combine ZK with other front-end frameworks and leverage the best of both.
  
 
= New Input Components  =
 
= New Input Components  =
Line 90: Line 105:
  
 
=New Layout Components=
 
=New Layout Components=
==Linelayout==
+
==[[ZK_Component_Reference/Layouts/Linelayout|Linelayout]]==
 
{{ZK EE}}
 
{{ZK EE}}
 
Linelayout is useful for presenting events happening in different timelines. This component is offered in both vertical and horizontal orientation.  
 
Linelayout is useful for presenting events happening in different timelines. This component is offered in both vertical and horizontal orientation.  
Line 121: Line 136:
 
[[File: Loadingbar2.gif | center]]
 
[[File: Loadingbar2.gif | center]]
  
==[https://blog.zkoss.org/2019/08/08/toast-a-simple-feedback-that-draws-users-attention/ Toast]==
+
==[[ZK_Developer's_Reference/UI_Patterns/Useful_Java_Utilities#Toast|Toast]]==
 
{{ZK EE}}
 
{{ZK EE}}
 
Toast is a stackable notification that can be pinned on the screen.
 
Toast is a stackable notification that can be pinned on the screen.
Line 127: Line 142:
 
[[File:Toast.png | center]]
 
[[File:Toast.png | center]]
  
==Coachmark==
+
==[[ZK_Component_Reference/Supplementary/Coachmark|Coachmark]]==
 
{{ZK EE}}
 
{{ZK EE}}
 
You can use coachmark to guide users to focus on a specific component in the page. By using the "next" attribute, it leads to the next coachmark for guiding user to the next step. Coachmark (dialog) takes not only text but also ZK components.
 
You can use coachmark to guide users to focus on a specific component in the page. By using the "next" attribute, it leads to the next coachmark for guiding user to the next step. Coachmark (dialog) takes not only text but also ZK components.
Line 151: Line 166:
 
{{ZK All}}
 
{{ZK All}}
 
The underlying jQuery version is upgraded to '''1.12.4''' to include security fixes.
 
The underlying jQuery version is upgraded to '''1.12.4''' to include security fixes.
 
+
<br/>
 +
<br/>
 
<div style="height:70px; border-radius:5px;font-family: 'Didact Gothic', sans-serif; text-align:center; padding:5px; background-color: #0093f9;">
 
<div style="height:70px; border-radius:5px;font-family: 'Didact Gothic', sans-serif; text-align:center; padding:5px; background-color: #0093f9;">
 
<h1 style="margin: 5px;padding-bottom: 15px;border:2px dashed #F7EEEE;color:#fff;">Upgrade Notes</h1>
 
<h1 style="margin: 5px;padding-bottom: 15px;border:2px dashed #F7EEEE;color:#fff;">Upgrade Notes</h1>
Line 167: Line 183:
 
<br/>
 
<br/>
  
<div><div style="float: left;"><imagelink link="http://www.zkoss.org/download/zk?zk9" image="/_w/images/0/00/Download-zk-7.png" /></div>
+
<div><div style="float: left;"><imagelink link="http://www.zkoss.org/download/zk" image="/_w/images/0/00/Download-zk-7.png" /></div>
  
 
<br/>
 
<br/>
 
<br/>
 
<br/>
  
 
+
[[Category:New Features]]
 
{{Template:CommentedSmalltalk_Footer_new|
 
{{Template:CommentedSmalltalk_Footer_new|
 
|name=Potix Corporation
 
|name=Potix Corporation
 
}}
 
}}

Latest revision as of 04:41, 20 January 2022

DocumentationSmall Talks2019DecemberNew Features of ZK 9.0.0
New Features of ZK 9.0.0

Author
Hawk Chen, Engineer, Potix Corporation
Date
Dec. 10, 2019
Version
ZK 9.0.0


Introduction

"Easy", "Ajax without Javascript" and "Rich Components" are the 3 top rated ZK values by the community since day one. ZK 9 carries on with the same drive and brings you 20+ new features and components such as Toast, Stepbar, Rangeslider, Drawer, Inputgroup, Anchornav, Linelayout,.. making the development even easier than ever.

ZK 9 requires Java 8 to compile, so please make sure you are with Java SE 8 or later versions. If you are coming from an older ZK version, remember to check out the #Upgrade Notes at the end of the page.

For more information please refer to the Release Notes.

Download







Highlighted Features

Upgrade to JDK 8

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

ZK Now Requires Java SE 8 or later

The Java compiler source/target has been updated to Java 8, meaning the Java binary-compatible level is now Java 8 instead of Java 6. Please make sure to use Java 8 or later Java versions.

Support JDK8 Date/Time API

Datebox, Calendar, Timebox and Timepicker components now supports JDK 8 Date/Time API. Their constructors and setters now accept JDK 8 Date/Time and the getters can return JDK 8 Date/Time type. For example Datebox supports the following constructors:

org.zkoss.zul.Datebox#Datebox(java.util.Date)
org.zkoss.zul.Datebox#Datebox(java.time.LocalDate)
org.zkoss.zul.Datebox#Datebox(java.time.LocalDateTime)
org.zkoss.zul.Datebox#Datebox(java.time.LocalTime)
org.zkoss.zul.Datebox#Datebox(java.time.ZonedDateTime)

For details, please refer to javadoc: Datebox, Timebox, Calendar, Timepicker

Support CSS3 Flex

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

ZK 9 implements hflex/vflex in a whole new, more performant way -- by CSS3 flexbox, which is supported by modern browsers natively. With this change, javascript size calculation is eliminated thus improving the client-side performance. This change should be transparent for developers.

However, if your application depends on the previous implementation, you can fall back by the property below in zk.xml:

<library-property>
    <name>org.zkoss.zul.css.flex</name>
    <value>true</value>
</library-property>

Embed ZK App into An External App

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

Instead of using iframe, since ZK 9, there is a new way to embed your ZK application into an external application such as a NodeJS or Python-based web page. Furthermore, by using ZK Client Binding in Javascript, we can also control ZK components in these external Apps.

With this feature we can now easily combine ZK with other front-end frameworks and leverage the best of both.

New Input Components

Inputgroup

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

With the new ZK Inputgroup component, you can now prepend or append labels, buttons, checkboxes, or radios to your input components to create your custom input.

Inputgroup-small.png

Tristate checkbox

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

Since ZK 8.6 we were able to display a 3rd state -- the indeterminate state of a checkbox. In ZK 9 we are taking one step further allowing users to set the indeterminate state, in addition to the checked and unchecked states. Specify mold= "tristate" to enable the tri-state checkbox.

Rangeslider

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

An enhanced slider allowing users to choose a range between the specified upper bound and lower bound.

Rangeslider.png

Multislider

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

Multislider provides multiple handlers for specifying range and boundaries of multiple segments.

Multislider.png

Searchbox

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

Searchbox allows users to select one or more entries in a list; and also allows users to filter the list in order to find the target entry.

Searchbox.gif

Cascader

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

Cascader is a cascading input control used for multi-level input, such as an address input that allows users to drill-down and select Country > State > City.

Cascader.gif

New Navigation Components

Anchornav

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

Anchornav allows you to navigate to desired ZK components in a page and at the same time highlight the current navigation link based on the current scroll position.

Stepbar

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

Stepbar displays the progress in a workflow and allows you to dynamically add/remove steps.

Stepbar.png

New Layout Components

Linelayout

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

Linelayout is useful for presenting events happening in different timelines. This component is offered in both vertical and horizontal orientation.

Linelayout.png

Drawer

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

Drawer is a component that attaches to the four sides of your web page. Like a desk drawer it can be collapsed/closed to stay out of the view, or opened to display additional information contained in the Drawer.

Drawer.gif

Kanban

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

Portal Layout now provides PortalChildren title and frame design, making it extremely easy to create a Kanban-like layout for your application.

Kanban.png

More New Components

PDFViewer

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

With PDFViewer you can allow users to view PDF documents inside your ZK application without leaving the browser and going to an external application. PDFViewer comes with several controls like zoom in/out, rotate, and go-to-page.

Loading bar

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

A modern, lightweight loading animation for indicating the loading progress. It can be placed on the top of the page under the address bar, or, at the bottom of the browser. You can specify its value (progress in %), position (top/bottom) and whether you would like to display the indeterminate animation.
Loading progress:

Loadingbar.gif


Indeterminate:

Loadingbar2.gif

Toast

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

Toast is a stackable notification that can be pinned on the screen.

Toast.png

Coachmark

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

You can use coachmark to guide users to focus on a specific component in the page. By using the "next" attribute, it leads to the next coachmark for guiding user to the next step. Coachmark (dialog) takes not only text but also ZK components.

Coachmark.png



Enhancements

New ZK Less Engine

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

The zkless-engine-maven-plugin has been replaced by the zkless-engine npm module (github). It provides a command line interface (CLI) to significantly reduce the general theme build times and the development turn-around when customizing ZK themes (via incremental watch compiler and live reloading in the browser).

This CLI can invoked directly as and integrated into maven or gradle build, making the former - more limited and slower - maven plugin obsolete.

More details in the README

When upgrading a theme to ZK 9 you'll have to escape ZK specific syntax using the escape (e) function. (here the commit upgrading ZK's default styles)

Upgrade to jQuery 1.12.4

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

The underlying jQuery version is upgraded to 1.12.4 to include security fixes.

Upgrade Notes

Upgrade Tips

  • The Java binary-compatible level is Java 8 since ZK 9.
  • ZK Databinding 1 is moved to a legacy module "zkplus-legacy".
  • ZK DSP Library is moved to a new module "zweb-dsp".
  • SimpleLocalTimeConstraint is used by default instead of SimpleConstraint in Timebox and Timepicker.
  • It is advised to use Notification.show instead of Clients.showNotification, as the former follows single responsibility principle.
  • Custom Themes based on zkThemeTemplate need to merge the latest changes (see New ZK Less Engine).





Comments



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