View Javadoc

1   /*
2       Jameleon HtmlUnit plug-in - A plug-in that uses HtmlUnit to drive web sites
3       Copyright (C) 2006 Christian W. Hargraves (engrean@hotmail.com)
4       
5       This library is free software; you can redistribute it and/or
6       modify it under the terms of the GNU Lesser General Public
7       License as published by the Free Software Foundation; either
8       version 2.1 of the License, or (at your option) any later version.
9   
10      This library is distributed in the hope that it will be useful,
11      but WITHOUT ANY WARRANTY; without even the implied warranty of
12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13      Lesser General Public License for more details.
14  
15      You should have received a copy of the GNU Lesser General Public
16      License along with this library; if not, write to the Free Software
17      Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111AssertLevel.NO_FUNCTION07 USA
18  */
19  package net.sf.jameleon.plugin.htmlunit.tags;
20  
21  import net.sf.jameleon.plugin.htmlunit.HtmlUnitFunctionTag;
22  
23  /***
24   * A tag which clicks on an HTML element.
25   * <br/>
26   * To use XPath to click on a link defined as &lt;a href="/some/url/index.html"&gt;some link&lt;/a&gt;:
27   * <pre><source>
28   *     &lt;htmlunit-click
29   *            functionId="Click on a the 'some link' link"
30   *            xpath="//a[text()='some link']"/>
31   * </source></pre>
32   * To use XPath to click on a 'Search' button in the 3rd form:
33   * <pre><source>
34   *     &lt;htmlunit-click
35   *            functionId="Click on a the 'some link' link"
36   *            xpath="//form[2]/input[@type='submit' and value='Search']"/>
37   * </source></pre>
38   * @jameleon.function name="htmlunit-click" type="action"
39   */
40  public class HtmlUnitClickTag extends HtmlUnitFunctionTag{
41  
42      /***
43       * The xpath to locate the element to click on
44       * @jameleon.attribute
45       */
46      protected String xpath;
47  
48      public void testBlock(){
49          boolean actionOccured = false;
50          if (xpath != null) {
51              clickElementWithXPath(xpath);
52              actionOccured = true;
53          }
54          assertTrue("Nothing happened in the "+this.getElementName()+" tag", actionOccured);
55      }
56  
57  }