ZK Component Reference/Essential Components/Script

Script

• Demonstration: N/A
• Java API: Script
• JavaScript API: Script

Employment/Purpose

The script component is used to specify the script codes running at the browser. Notice that, unlike zscript, the script codes are running at the browser. They are usually written in JavaScript which is supported by the most of browsers. The simplest format is as follows.

Example

<syntax lang="xml" >

<zk>

<window id="win"> <button label="change color" onClick='Clients.evalJavaScript("myfunc()")' /> </window> <script type="text/javascript"> function myfunc() { jq("$win").css("backgroundColor", "blue"); }

</script>

</zk> </syntax>

Defer the evaluation

By default, the specified JavaScript code will be evaluated as soon as the page is loaded. There is an attribute called defer. By specifying true, the JavaScript code won't be evaluated until all widgets are created and bound to the DOM tree.

<syntax lang="xml"> <textbox id="inp"/> <script defer="true">

  this.$f("inp").setValue("initialized");

</script> </syntax>

The defer attribute can be used with a JavaScript file as shown below. Then, the JavaScript file will be loaded after all widgets are created and bound to the DOM tree.

<syntax lang="xml"> <script src="/js/foo.js" defer="true"/> </syntax>

Supported events

Name	Event Type
None	None

Supported Children

*NONE

Use cases

Version	Description	Example Location
5.0	Overview and Tutorial	http://docs.zkoss.org/wiki/Client_Side_Programming http://docs.zkoss.org/wiki/ZK5:_Client_Computing_with_ZUML

Version History

Version	Date	Content