ZK Binding Tracker - A Chrome Extension"

From Documentation
Line 2: Line 2:
 
|author=Hawk Chen, Engineer, Potix Corporation
 
|author=Hawk Chen, Engineer, Potix Corporation
 
|date=Released: , 2013
 
|date=Released: , 2013
|version=MVVM Tracker 0.7.0
+
|version=ZK Binding Tracker 0.8.0
 
}}
 
}}
  
Line 11: Line 11:
 
When you interact with a ZUL page built in MVVM approach, ZK does lots of things behind the scenes according to binding expressions. If you want to know what it does in detail, you can turn on debugging information printing described in [[ZK_Developer%27s_Reference/MVVM/Configuration]]. But this configuration will print messages on the server's console, and it is system-wide, which means debugging information of all pages will be printed and it will be hard to read.  
 
When you interact with a ZUL page built in MVVM approach, ZK does lots of things behind the scenes according to binding expressions. If you want to know what it does in detail, you can turn on debugging information printing described in [[ZK_Developer%27s_Reference/MVVM/Configuration]]. But this configuration will print messages on the server's console, and it is system-wide, which means debugging information of all pages will be printed and it will be hard to read.  
  
Therefore, we present you a tool: '''ZK BindingTracker'''. It's a Chrome extension that can be installed on your Chrome browser. It can display the debugging information for the current ZUL page in pretty format. When you click on a logging text, it will also highlight the related UI components.
+
Therefore, we present you a tool: '''ZK BindingTracker'''. It's a Chrome extension that can be installed on your Chrome browser. It can display the debugging information for the current ZUL page in rich format.  
  
  
[[File:Binding tracker introduction.png | 800px]]
+
[[File:Binding tracker introduction.png | 800px | center]]
  
= Demo =
 
  
 +
= Features =
  
  
= Download & Configuration =
+
 
 +
= Install & Configuration =
  
 
The steps to use this tool are quite simple:
 
The steps to use this tool are quite simple:
  
# [Download MVVM Tracker]
+
1. [Download ZK Binding Tracker] and extract the downloaded file (zkbind-debugger-bin-0.8.0.zip)
# add ? jar into your project's class path
+
2. Copy debugger jar (<tt>/dist/lib/zkbind-debugger.jar</tt> in the zip file) to your <tt>WEB-INF/lib</tt> folder
 +
3. add following configurations to your web application's <tt>zk.xml</tt>
 +
<source lang='xml'>
 +
    <library-property>
 +
      <name>org.zkoss.bind.DebuggerFactory.enable</name>
 +
      <value>true</value>
 +
    </library-property>
 +
    <library-property>
 +
      <name>org.zkoss.bind.DebuggerFactory.class</name>
 +
      <value>org.zkoss.bind.addon.sys.debugger.ChromeExtensionDebuggerFactory</value>
 +
    </library-property>   
 +
</source>
 +
4. Install Chrome extension. In Chrome's menu [[File:Chrome_menu_icon.png]], select '''Tools''' > '''Extensions'''. Drag the extension file (<tt>/zkbind-tracker/chrome-extension.crx</tt> in the zip) to Chrome extension tab to install.
 +
5. After installation
 +
 
 +
Usage:
 +
# start your application.
 +
# use Chrome to visit a page with ZK MVVM binding.
 +
# Click the Bining Tracker Icon to open the extension.
  
  

Revision as of 09:19, 10 June 2013

DocumentationSmall Talks2013JuneZK Binding Tracker - A Chrome Extension
ZK Binding Tracker - A Chrome Extension

Author
Hawk Chen, Engineer, Potix Corporation
Date
Released: , 2013
Version
ZK Binding Tracker 0.8.0



Introduction

When you interact with a ZUL page built in MVVM approach, ZK does lots of things behind the scenes according to binding expressions. If you want to know what it does in detail, you can turn on debugging information printing described in ZK_Developer's_Reference/MVVM/Configuration. But this configuration will print messages on the server's console, and it is system-wide, which means debugging information of all pages will be printed and it will be hard to read.

Therefore, we present you a tool: ZK BindingTracker. It's a Chrome extension that can be installed on your Chrome browser. It can display the debugging information for the current ZUL page in rich format.


Binding tracker introduction.png


Features

Install & Configuration

The steps to use this tool are quite simple:

1. [Download ZK Binding Tracker] and extract the downloaded file (zkbind-debugger-bin-0.8.0.zip) 2. Copy debugger jar (/dist/lib/zkbind-debugger.jar in the zip file) to your WEB-INF/lib folder 3. add following configurations to your web application's zk.xml

     <library-property>
       <name>org.zkoss.bind.DebuggerFactory.enable</name>
       <value>true</value>
     </library-property>
     <library-property>
       <name>org.zkoss.bind.DebuggerFactory.class</name>
       <value>org.zkoss.bind.addon.sys.debugger.ChromeExtensionDebuggerFactory</value>
     </library-property>

4. Install Chrome extension. In Chrome's menu Chrome menu icon.png, select Tools > Extensions. Drag the extension file (/zkbind-tracker/chrome-extension.crx in the zip) to Chrome extension tab to install. 5. After installation

Usage:

  1. start your application.
  2. use Chrome to visit a page with ZK MVVM binding.
  3. Click the Bining Tracker Icon to open the extension.

Comments



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