ZTL Essentials/Introduction

{{ZTLEssentialsPageHeader}}

The ZTL language is XML based which describes the operation of a test case for the [http://seleniumhq.org/projects/remote-control/ Selenium  Remote Control (RC)].
For example,
<source lang="xml">
<test tags="button">
	<case id="Click">
		<server><!--
			<zk>
				<button id="btn" label="Click Me to Show a Message" onClick='alert("Hello!")'/>
			</zk>
		--></server>
		<client>
			click(btn);
			waitResponse();
			verifyTrue(jq("@window").exists());
		</client>
	</case>
</test>
</source>
The root tag of the ZTL file is ''test'' and encloses one or many ''case''(s) (similar to each method of the jUnit test case). The ''case'' can enclose one or many ''server'' and ''client'' tags. The content of the ''server'' is run on the ZK server, and the content of the ''client'' is run on the Selenium server(we called it ''client'').

In the above example, the content of the ''server'' creates a button (id=btn) which when clicked on will show a "Hello!" message. The content of the ''client'' uses ''btn'' which is an instance of [http://zk-ztl.googlecode.com/svn/trunk/javadoc/org/zkoss/ztl/Widget.html org.zkoss.ztl.Widget], to fire a ''Click'' event to the browser, and then waits for the response from ZK server. Once the response is received the code then checks whether ''@window'' exists or not by using the ''jq'' API which is implemented by the class [http://zk-ztl.googlecode.com/svn/trunk/javadoc/org/zkoss/ztl/JQuery.html org.zkoss.ztl.JQuery].

{{ZTLEssentialsPageFooter}}