Coachmark"

From Documentation
Line 2: Line 2:
  
 
= Coachmark =
 
= Coachmark =
 
+
{{versionSince| 9.0.0}}
 
*Java API: <javadoc>org.zkoss.zkmax.zul.Coachmark</javadoc>
 
*Java API: <javadoc>org.zkoss.zkmax.zul.Coachmark</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zkmax.nav.Coachmark</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zkmax.nav.Coachmark</javadoc>
 
{{ZK EE}}
 
{{ZK EE}}
[ since 9.0.0 ]
 
  
 
= Employment/Purpose =
 
= Employment/Purpose =

Revision as of 02:31, 22 December 2021

Coachmark

Since 9.0.0

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

Employment/Purpose

Coachmark is used to attract users' attention to the target component and display a dialog. Once a coachmark is opened, the background mask will be displayed and the target component will be highlighted.The content of coachmark should be as relevant as possible to the context. You can use more than one coachmarks to guide users to perform a series of operations in the desired order.

Example

Coachmark-2.png
<zk>
	<button id="button" label="Information"></button>
	<coachmark target="button" position="before_center">
		<label>Wellcome! click here for more information!</label>
		<button style="display: block;margin: 10px auto 0" label="got it!"></button>
	</coachmark>
</zk>


Supported Browsers

This component uses CSS keyframes. Browsers that support CSS keyframes (IE10+, Edge, Chrome, Firefox, Safari) are compatible with this feature.

Open / Close the Coachmark

Both visible attribute and open/close methods allow you to open or close the Coachmark.


Properties

Target

The target component that the Coachmark will point itself to.

Example

Coachmark-1.png
<zk>
	<button id="button" label="button"></button>
	<coachmark target="button">
		<label>Wellcome!</label>
	</coachmark>
</zk>

Position

The positions of a coachmark(default: after_center). Here are the available options:

start/before center end/after
top before_start before_center before_end
bottom after_start after_center after_end
left start_before start_center start_after
right end_before end_center end_after

Next

The next coachmark which will be opened when the onTargetClick event or the next() method is called.

Note: if you call next(Coachmark coachmark), it will use the specified coachmark instead of the predefined "next" coachmark.

Methods

public void next() : Closes the current coachmark and Opens the next one.

public void next(Coachmark coachmark) : Close the current coachmark and Opens the one you passed.(ignore the next coachmark you already set)

Supported Events

Name
Event Type
onOpen
Event: OpenEvent

Denotes that the user has opened or closed a component.

Note: unlike onClose, this event is only a notification. The client sends this event after the component is opened or closed.

onTargetClick
Event: MouseEvent

Represents an event caused by a user's click on a highlighted target component.

Supported Children

*ALL

Version History

Last Update : 2021/12/22


Version Date Content
9.0.0 Nov, 2019 ZK-4382: Provide a Coachmark component



Last Update : 2021/12/22

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