--- /dev/null
+tests/selenium/config.test.php
+tests/selenium/TestSuite.html
+tests/selenium/static
--- /dev/null
+#!/usr/bin/php
+<?php
+
+ /**
+ * Build the test files for each servers in conf/config.inc.php according to the pg backend version.
+ */
+
+ require('./conf/config.inc.php');
+
+ $test_dir = './tests/selenium/';
+ $test_src_dir = "{$test_dir}/src/";
+ $test_static_dir = "{$test_dir}/static/";
+ $testsuite_file = "{$test_dir}/TestSuite.html";
+
+ if(isset($argv[1]) && ($argv[1] == 'clean')) {
+ echo "Cleaning...";
+ /* delete server directories */
+ foreach ($conf['servers'] as $server) {
+ $dir = "{$test_static_dir}/{$server['desc']}";
+ $dh = opendir($dir);
+ while($file = readdir($dh))
+ if (($file != '.') && ($file != '..')) unlink("{$dir}/{$file}");
+ rmdir($dir);
+ }
+ /* delete the TestSuite.html file */
+ @unlink($testsuite_file);
+ echo "done.\n";
+
+ exit;
+ }
+
+ // Include application functions
+ require('./tests/selenium/config.test.php');
+ define('ADODB_ERROR_HANDLER','');
+ require('./classes/database/Connection.php');
+ require('./lang/recoded/english.php');
+ require('./tests/selenium/testBuilder.class.php');
+
+ /* create the TestSuite.html file with its html header */
+ $fd = fopen($testsuite_file, 'w');
+ fprintf($fd, "<table border=\"1\">
+ <tr>
+ <th>Test suite for PPA</th>
+ </tr>\n");
+ fclose($fd);
+
+ if(!is_dir($test_static_dir))
+ mkdir($test_static_dir);
+
+ /* Loop on the servers given in the conf/config.inc.conf file */
+ foreach ($conf['servers'] as $server) {
+ /* connect to the server to get its version
+ * and test its feature along the tests */
+ $_c = new Connection($server['host'],
+ $server['port'],
+ $server['sslmode'],
+ $super_user[$server['desc']],
+ $super_pass[$server['desc']],
+ $server['defaultdb']
+ );
+
+ $_type = $data = null;
+ if (! $_c->conn->isConnected())
+ die ("Connexion to {$server['desc']} failed !\n");
+ else {
+ if (($_type = $_c->getDriver($platform)) === null) {
+ die( printf($lang['strpostgresqlversionnotsupported'], $postgresqlMinVer));
+ }
+ /* create the database handler we are going to use in the tests creator scripts */
+ include_once('./classes/database/' . $_type . '.php');
+ $data = new $_type($_c->conn);
+ $data->platform = $_c->platform;
+ }
+
+ fprintf(STDERR, "Connected to %s...\n", $server['desc']);
+
+ if (!is_dir("{$test_static_dir}/{$server['desc']}"))
+ mkdir("{$test_static_dir}/{$server['desc']}");
+
+ /* include the tests creator scripts here
+ * in the order you want them executed.
+ * Each script append itself to the TestSuite.html file.
+ **/
+ require("{$test_src_dir}/roles.php");
+ require("{$test_src_dir}/cleantests.php");
+ }
+
+ /* close the TestSuite.html file */
+ $fd = fopen($testsuite_file, 'a');
+ fprintf($fd, "</table>");
+ fclose($fd);
+
+ /* Tests ready to be runned on all your configured servers !!!! */
+?>
// Include application functions (no db conn)
$_no_db_connection = true;
include_once('./libraries/lib.inc.php');
-
+
$misc->printHeader();
$misc->printBody();
-
+
$misc->printTrail('root');
$misc->printTabs('root','intro');
?>
<li><a href="<?php echo $lang['strpgsqlhome_url'] ?>"><?php echo $lang['strpgsqlhome'] ?></a></li>
<li><a href="http://sourceforge.net/tracker/?group_id=37132&atid=418980"><?php echo $lang['strreportbug'] ?></a></li>
<li><a href="<?php echo $lang['strviewfaq_url'] ?>"><?php echo $lang['strviewfaq'] ?></a></li>
+ <li><a target="_top" href="tests/selenium/selenium-lib/core/TestRunner.html?test=..%2F..%2FTestSuite.html&resultsUrl=..%2FpostResults">Selenium tests</a></li>
</ul>
<?php
--- /dev/null
+<?php
+/* Set this variable to the root URL of the tested PPA */
+$webUrl = 'http://boox/~ioguix/ppa.git/phppgadmin';
+
+/* Associative array with the super user names for each configured server in your conf/config.inc.php :
+* $superuser = array(
+* the 'desc' part of the server in your conf/config.inc.php => the super user name,
+* ...
+* )
+* These profiles are only used to create the admin test role (or user) on each server.
+*/
+$super_user['7.3'] = $super_user['7.4'] = $super_user['8.0'] =
+$super_user['8.1'] = $super_user['8.2'] = $super_user['8.3'] = 'postgres';
+
+/* Associative array with the super user passwords for each configured server in your conf/config.inc.php :
+ * $superpass = array(
+ * the 'desc' part of the server in your conf/config.inc.php => the super user password,
+ * ...
+ * )
+ */
+$super_pass['7.3'] = $super_pass['7.4'] = $super_pass['8.0'] =
+$super_pass['8.1'] = $super_pass['8.2'] = $super_pass['8.3'] = 'pgpass';
+
+/* name and pass of the admin user to create for tests*/
+$admin_user = 'admin_user';
+$admin_user_pass = 'super';
+
+/* name and pass of the user to create for tests*/
+$user = 'ppa_tests_user';
+$user_pass = 'ppa_tests_user_pass';
+
+/* name of the database to create for tests */
+$testdb = 'ppatests_db';
+?>
\ No newline at end of file
--- /dev/null
+selenium.core.version=0.8.3
+selenium.core.revision=1879
\ No newline at end of file
--- /dev/null
+ Coding standards for Selenium Core Javascript code\r
+ --------------------------------------------------\r
+\r
+ Here is a set of conventions agreed by the active Selenium Core\r
+ developers at ThoughtWorks. Please stick to these guidelines when\r
+ working on the Selenium Core code-base.\r
+\r
+Whitespace: we use spaces, NOT TABS. Indent in 4-space increments.\r
+\r
+Braces: we place open-braces on the same line as the associated keyword,\r
+ for example:\r
+\r
+ if (command.isBreakpoint) {\r
+ this.pause();\r
+ } else {\r
+ window.setTimeout(this.resume.bind(this), delay);\r
+ }\r
+\r
+Encapsulation: we prefer to encapsulate functions and variables inside\r
+ objects, where possible.\r
+\r
+Variable declarations: declare variables (using "var") ... even if they're\r
+ "global".\r
+\r
+Class definitions: we're shifting to "prototype.js" style for\r
+ definition of classes, e.g.\r
+\r
+ var MyClass = Class.create();\r
+ Object.extend(MyClass.prototype, {\r
+ \r
+ initialize: function() {\r
+ // ... constructor code ...\r
+ },\r
+ \r
+ doStuff: function() {\r
+ // ... method body ...\r
+ }\r
+ \r
+ });\r
+\r
+'Private' functions/properties: we simulate "private" properties by\r
+ prepended the name with an underscore ("_"), e.g.\r
+\r
+ _resumeAfterDelay : function() {\r
+ // ...etc...\r
+ },\r
+\r
+Element addressing: use "$(id)" rather than\r
+ "document.getElementById('id')".\r
+\r
+Timeout functions: pass function objects to setTimeout(), rather than\r
+ strings, e.g.\r
+\r
+ window.setTimeout(this.resume.bind(this), delay);\r
--- /dev/null
+<html>\r
+ <head>\r
+ <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">\r
+ </head>\r
+<body>\r
+</body>\r
+</html>\r
--- /dev/null
+<html>\r
+ <head>\r
+ <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">\r
+ </head>\r
+<body>\r
+ <h3>selenium-rc initial page</h3>\r
+</body>\r
+</html>\r
--- /dev/null
+<html>\r
+\r
+<!--\r
+Copyright 2004 ThoughtWorks, Inc\r
+\r
+ Licensed under the Apache License, Version 2.0 (the "License");\r
+ you may not use this file except in compliance with the License.\r
+ You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+-->\r
+<HTA:APPLICATION ID="SeleniumHTARunner" APPLICATIONNAME="Selenium" >\r
+<head>\r
+<meta content="text/html; charset=ISO-8859-1"\r
+http-equiv="content-type">\r
+<title>Selenium Remote Control</title>\r
+<link rel="stylesheet" type="text/css" href="selenium.css" />\r
+<script type="text/javascript" src="scripts/xmlextras.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="lib/prototype.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="lib/cssQuery/cssQuery-p.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/htmlutils.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-browserdetect.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-browserbot.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/find_matching_child.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-api.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-commandhandlers.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-executionloop.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-remoterunner.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-logging.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/selenium-version.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="xpath/misc.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="xpath/dom.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="xpath/xpath.js"></script>\r
+<script language="JavaScript" type="text/javascript" src="scripts/user-extensions.js"></script>\r
+<script language="JavaScript" type="text/javascript">\r
+ function openDomViewer() {\r
+ var autFrame = document.getElementById('selenium_myiframe');\r
+ var autFrameDocument = getIframeDocument(autFrame);\r
+ var domViewer = window.open(getDocumentBase(document) + 'domviewer/domviewer.html');\r
+ domViewer.rootDocument = autFrameDocument;\r
+ return false;\r
+ }\r
+\r
+ function cleanUp() {\r
+ if (LOG != null) {\r
+ LOG.close();\r
+ }\r
+ }\r
+\r
+</script>\r
+</head>\r
+\r
+<body onLoad="setTimeout(function(){runSeleniumTest();},1000)" onUnload="cleanUp()">\r
+\r
+<table border="1" style="height: 100%;">\r
+ <tr>\r
+ <td width="50%" height="30%">\r
+ <table>\r
+ <tr>\r
+ <td>\r
+ <img src="selenium-logo.png">\r
+ </td>\r
+ <td>\r
+ <h1><a href="http://selenium.thoughtworks.com" >Selenium</a> Functional Testing for Web Apps</h1>\r
+ Open Source From <a href="http://www.thoughtworks.com">ThoughtWorks, Inc</a> and Friends\r
+ <form action="">\r
+ <br/>Slow Mode:<INPUT TYPE="CHECKBOX" NAME="FASTMODE" VALUE="YES" onmouseup="slowClicked()">\r
+\r
+ <iframe id="seleniumLoggingFrame" name="seleniumLoggingFrame" src="Blank.html" style="border: 0; height: 0; width: 0; "></iframe>\r
+ <fieldset>\r
+ <legend>Tools</legend>\r
+\r
+ <button type="button" id="domViewer1" onclick="openDomViewer();">\r
+ View DOM\r
+ </button>\r
+ <button type="button" onclick="LOG.show();">\r
+ Show Log\r
+ </button>\r
+ </fieldset>\r
+\r
+ </form>\r
+\r
+ </td>\r
+ </tr>\r
+ </table>\r
+ <form action="">\r
+ <label id="context" name="context"></label>\r
+ </form>\r
+ </td>\r
+ <td width="50%" height="30%">\r
+ <b>Last Four Test Commands:</b><br/>\r
+ <div id="commandList"></div>\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td colspan="2" height="70%">\r
+ <iframe name="selenium_myiframe" id="selenium_myiframe" src="Blank.html" height="100%" width="100%"></iframe>\r
+ </td>\r
+ </tr>\r
+</table>\r
+\r
+</body>\r
+</html>\r
+\r
--- /dev/null
+<html>\r
+\r
+<head>\r
+<title>Selenium Log Console</title>\r
+<link id="cssLink" rel="stylesheet" href="selenium.css" />\r
+<script src="scripts/htmlutils.js"></script>\r
+<script language="JavaScript">\r
+\r
+var disabled = true;\r
+\r
+function logOnLoad() {\r
+ var urlConfig = new URLConfiguration();\r
+ urlConfig.queryString = window.location.search.substr(1);\r
+ var startingThreshold = urlConfig._getQueryParameter("startingThreshold");\r
+ setThresholdLevel(startingThreshold);\r
+ var buttons = document.getElementsByTagName("input");\r
+ for (var i = 0; i < buttons.length; i++) {\r
+ addChangeListener(buttons[i]);\r
+ }\r
+}\r
+\r
+function enableButtons() {\r
+ var buttons = document.getElementsByTagName("input");\r
+ for (var i = 0; i < buttons.length; i++) {\r
+ buttons[i].disabled = false;\r
+ disabled = false;\r
+ }\r
+}\r
+\r
+function callBack() {}\r
+\r
+function changeHandler() {\r
+ callBack(getThresholdLevel());\r
+}\r
+\r
+function addChangeListener(element) {\r
+ if (window.addEventListener && !window.opera)\r
+ element.addEventListener("click", changeHandler, true);\r
+ else if (window.attachEvent)\r
+ element.attachEvent("onclick", changeHandler);\r
+}\r
+\r
+var logLevels = {\r
+ debug: 0,\r
+ info: 1,\r
+ warn: 2,\r
+ error: 3\r
+};\r
+\r
+function getThresholdLevel() {\r
+ var buttons = document.getElementById('logLevelChooser').level;\r
+ for (var i = 0; i < buttons.length; i++) {\r
+ if (buttons[i].checked) {\r
+ return buttons[i].value;\r
+ }\r
+ }\r
+}\r
+\r
+function setThresholdLevel(logLevel) {\r
+ var buttons = document.getElementById('logLevelChooser').level;\r
+ for (var i = 0; i < buttons.length; i++) {\r
+ if (buttons[i].value==logLevel) {\r
+ buttons[i].checked = true;\r
+ }\r
+ else {\r
+ buttons[i].checked = false;\r
+ }\r
+ }\r
+}\r
+\r
+function append(message, logLevel) {\r
+ var logLevelThreshold = getThresholdLevel();\r
+ if (logLevels[logLevel] < logLevels[logLevelThreshold]) {\r
+ return;\r
+ }\r
+ var log = document.getElementById('log');\r
+ var newEntry = document.createElement('li');\r
+ newEntry.className = logLevel;\r
+ newEntry.appendChild(document.createTextNode(message));\r
+ log.appendChild(newEntry);\r
+ if (newEntry.scrollIntoView) {\r
+ newEntry.scrollIntoView();\r
+ }\r
+}\r
+\r
+</script>\r
+</head>\r
+<body id="logging-console" onload="logOnLoad();">\r
+\r
+\r
+\r
+<div id="banner">\r
+ <form id="logLevelChooser">\r
+ <input id="level-error" type="radio" name="level" disabled='true'\r
+ value="error" /><label for="level-error">Error</label>\r
+ <input id="level-warn" type="radio" name="level" disabled='true'\r
+ value="warn" /><label for="level-warn">Warn</label>\r
+ <input id="level-info" type="radio" name="level" disabled='true'\r
+ value="info" /><label for="level-info">Info</label>\r
+ <input id="level-debug" type="radio" name="level" checked="yes" disabled='true'\r
+ value="debug" /><label for="level-debug">Debug</label>\r
+ </form>\r
+ <h1>Selenium Log Console</h1>\r
+</div>\r
+\r
+<ul id="log"></ul>\r
+\r
+</body>\r
+</html>\r
--- /dev/null
+<html>\r
+<!--\r
+Copyright 2004 ThoughtWorks, Inc\r
+\r
+ Licensed under the Apache License, Version 2.0 (the "License");\r
+ you may not use this file except in compliance with the License.\r
+ You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+-->\r
+\r
+<head>\r
+ <meta content="text/html; charset=ISO-8859-1"\r
+ http-equiv="content-type">\r
+ <title>Select a Test Suite</title>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-browserdetect.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/xmlextras.js"></script>\r
+ <script>\r
+\r
+ function load() {\r
+ if (browserVersion.isHTA) {\r
+ document.getElementById("save-div").style.display = "inline";\r
+ }\r
+ if (/thisIsSeleniumServer/.test(window.location.search)) {\r
+ document.getElementById("slowResources-div").style.display = "inline";\r
+ if (browserVersion.isHTA || browserVersion.isChrome) {\r
+ document.getElementById("test").value = "http://localhost:4444/selenium-server/tests/TestSuite.html";\r
+ }\r
+ }\r
+ }\r
+\r
+ function autoCheck() {\r
+ var auto = document.getElementById("auto");\r
+ var autoDiv = document.getElementById("auto-div");\r
+ if (auto.checked) {\r
+ autoDiv.style.display = "inline";\r
+ } else {\r
+ autoDiv.style.display = "none";\r
+ }\r
+ }\r
+\r
+ function slowCheck() {\r
+ var slowResourcesCheckbox = document.getElementById("slowResources");\r
+ var slowResources = slowResourcesCheckbox.checked ? true : false;\r
+ var xhr = XmlHttp.create();\r
+ var driverUrl = "http://localhost:4444/selenium-server/driver/?cmd=slowResources&1=" + slowResources;\r
+ xhr.open("GET", driverUrl, true);\r
+ xhr.send(null);\r
+ }\r
+\r
+ function saveCheck() {\r
+ var results = document.getElementById("results");\r
+ var check = document.getElementById("save").checked;\r
+ if (check) {\r
+ results.firstChild.nodeValue = "Results file ";\r
+ document.getElementById("resultsUrl").value = "results.html";\r
+ } else {\r
+ results.firstChild.nodeValue = "Results URL ";\r
+ document.getElementById("resultsUrl").value = "../postResults";\r
+ }\r
+ }\r
+\r
+ function go() {\r
+ if (!browserVersion.isHTA) return true;\r
+ var inputs = document.getElementsByTagName("input");\r
+ var queryString = "";\r
+ for (var i = 0; i < inputs.length; i++) {\r
+ var elem = inputs[i];\r
+ var name = elem.name;\r
+ var value = elem.value;\r
+ if (elem.type == "checkbox") {\r
+ value = elem.checked;\r
+ }\r
+ queryString += escape(name) + "=" + escape(value);\r
+ if (i < (inputs.length - 1)) {\r
+ queryString += "&";\r
+ }\r
+ }\r
+\r
+ window.parent.selenium = null;\r
+ window.parent.htmlTestRunner.controlPanel.queryString = queryString;\r
+ window.parent.htmlTestRunner.loadSuiteFrame();\r
+ return false;\r
+ }\r
+ </script>\r
+</head>\r
+\r
+<body onload="load()" style="font-size: x-small">\r
+<form id="prompt" target="_top" method="GET" onsubmit="return go();" action="TestRunner.html">\r
+\r
+ <p>\r
+ Test Suite:\r
+ <input id="test" name="test" size="30" value="../../TestSuite.html"/>\r
+ </p>\r
+\r
+ <p align="center"><input type="submit" value="Go"/></p>\r
+\r
+ <fieldset>\r
+ <legend>Options</legend>\r
+\r
+ <p>\r
+ <input id="multiWindow" type="checkbox" name="multiWindow" onclick="autoCheck();"/> <label\r
+ for="multiWindow">AUT in separate window</label>\r
+\r
+ <p>\r
+\r
+ <div id="slowResources-div" style="display: none">\r
+ <p>\r
+ <input id="slowResources" type="checkbox" name="slowResources" onclick="slowCheck();" /> <label for="slowResources">Slow down web server</label>\r
+ </p>\r
+ </div>\r
+\r
+ <p>\r
+ <input id="auto" type="checkbox" name="auto" onclick="autoCheck();"/> <label for="auto">Run\r
+ automatically</label>\r
+ </p>\r
+\r
+ <div id="auto-div" style="display: none">\r
+ <p>\r
+ <input id="close" type="checkbox" name="close"/> <label for="close">Close afterwards </label>\r
+ </p>\r
+\r
+ <div id="save-div" style="display: none">\r
+ <br/><label for="save">Save to file </label><input id="save" type="checkbox" name="save"\r
+ onclick="saveCheck();"/>\r
+ </div>\r
+\r
+ <p id="results">\r
+ Results URL:\r
+ <input id="resultsUrl" name="resultsUrl" value="../postResults"/>\r
+ </p>\r
+\r
+ </div>\r
+ </fieldset>\r
+\r
+\r
+</form>\r
+</body>\r
+</html>\r
--- /dev/null
+<!--\r
+Copyright 2005 ThoughtWorks, Inc\r
+\r
+ Licensed under the Apache License, Version 2.0 (the "License");\r
+ you may not use this file except in compliance with the License.\r
+ You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+-->\r
+\r
+<html>\r
+<link rel="stylesheet" type="text/css" href="selenium.css" />\r
+<body>\r
+<table width="100%">\r
+\r
+<tr>\r
+ <th>↑</th>\r
+ <th>↑</th>\r
+ <th>↑</th>\r
+</tr>\r
+<tr>\r
+ <th width="25%">Test Suite</th>\r
+ <th width="50%">Current Test</th>\r
+ <th width="25%">Control Panel</th>\r
+</tr>\r
+<tr><td> </td></tr>\r
+\r
+<tr>\r
+<td></td>\r
+<td class="selenium splash">\r
+\r
+<img src="selenium-logo.png" align="right">\r
+\r
+<h1>Selenium</h1>\r
+<h2>by <a href="http://www.thoughtworks.com">ThoughtWorks</a> and friends</h2>\r
+\r
+<p>\r
+For more information on Selenium, visit\r
+\r
+<pre>\r
+ <a href="http://selenium.openqa.org" target="_blank">http://selenium.openqa.org</a>\r
+</pre>\r
+\r
+</td>\r
+<tr>\r
+\r
+</table>\r
+</body>\r
+</html>\r
--- /dev/null
+<html>\r
+\r
+<head>\r
+ <HTA:APPLICATION ID="SeleniumHTARunner" APPLICATIONNAME="Selenium">\r
+ <!-- the previous line is only relevant if you rename this\r
+ file to "TestRunner.hta" -->\r
+\r
+ <!-- The copyright notice and other comments have been moved to after the HTA declaration,\r
+to work-around a bug in IE on Win2K whereby the HTA application doesn't function correctly -->\r
+ <!--\r
+ Copyright 2004 ThoughtWorks, Inc\r
+\r
+ Licensed under the Apache License, Version 2.0 (the "License");\r
+ you may not use this file except in compliance with the License.\r
+ You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+ -->\r
+ <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"/>\r
+\r
+ <title>Selenium Functional Test Runner</title>\r
+ <link rel="stylesheet" type="text/css" href="selenium.css"/>\r
+ <script type="text/javascript" src="scripts/narcissus-defs.js"></script>\r
+ <script type="text/javascript" src="scripts/narcissus-parse.js"></script>\r
+ <script type="text/javascript" src="scripts/narcissus-exec.js"></script>\r
+ <script type="text/javascript" src="scripts/xmlextras.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="lib/prototype.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/htmlutils.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="lib/scriptaculous/scriptaculous.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="lib/cssQuery/cssQuery-p.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-browserdetect.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-browserbot.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/find_matching_child.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-api.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-commandhandlers.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-executionloop.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-testrunner.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-logging.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-version.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="xpath/misc.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="xpath/dom.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="xpath/xpath.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/user-extensions.js"></script>\r
+ <script language="JavaScript" type="text/javascript">\r
+ function openDomViewer() {\r
+ var autFrame = document.getElementById('selenium_myiframe');\r
+ var autFrameDocument = new SeleniumFrame(autFrame).getDocument();\r
+ this.rootDocument = autFrameDocument;\r
+ var domViewer = window.open(getDocumentBase(document) + 'domviewer/domviewer.html');\r
+ return false;\r
+ }\r
+ </script>\r
+</head>\r
+\r
+<body onLoad="onSeleniumLoad();">\r
+<table class="layout">\r
+<form action="" name="controlPanel">\r
+\r
+<!-- Suite, Test, Control Panel -->\r
+\r
+<tr class="selenium">\r
+<td width="25%" height="30%">\r
+ <iframe name="testSuiteFrame" id="testSuiteFrame" src="./TestPrompt.html" application="yes"></iframe>\r
+</td>\r
+<td width="50%" height="30%">\r
+ <iframe name="testFrame" id="testFrame" application="yes"></iframe>\r
+</td>\r
+\r
+<td width="25%">\r
+ <table class="layout">\r
+ <tr class="selenium">\r
+ <th width="25%" height="1" class="header">\r
+ <h1><a href="http://selenium.thoughtworks.com" title="The Selenium Project">Selenium</a> TestRunner\r
+ </h1>\r
+ </th>\r
+ </tr>\r
+ <tr>\r
+ <td width="25%" height="30%" id="controlPanel">\r
+ <fieldset>\r
+ <legend>Execute Tests</legend>\r
+\r
+ <div id="imageButtonPanel">\r
+ <button type="button" id="runSuite" onClick="htmlTestRunner.startTestSuite();"\r
+ title="Run All tests" accesskey="a">\r
+ </button>\r
+ <button type="button" id="runSeleniumTest" onClick="htmlTestRunner.runSingleTest();"\r
+ title="Run the Selected test" accesskey="r">\r
+ </button>\r
+ <button type="button" id="pauseTest" disabled="disabled"\r
+ title="Pause/Continue" accesskey="p" class="cssPauseTest">\r
+ </button>\r
+ <button type="button" id="stepTest" disabled="disabled"\r
+ title="Step" accesskey="s">\r
+ </button>\r
+ </div>\r
+\r
+ <div style="float:left">Fast</div>\r
+ <div style="float:right">Slow</div>\r
+ <br/>\r
+ <div id="speedSlider">\r
+ <div id="speedTrack"> </div>\r
+ <div id="speedHandle"> </div>\r
+ </div>\r
+\r
+ <div class="executionOptions">\r
+ <input id="highlightOption" type="checkbox" name="highlightOption" value="0"/>\r
+ <label for="highlightOption">Highlight elements</label>\r
+ </div>\r
+\r
+ </fieldset>\r
+\r
+ <table id="stats" align="center">\r
+ <tr>\r
+ <td colspan="2" align="right">Elapsed:</td>\r
+ <td id="elapsedTime" colspan="2">00.00</td>\r
+ </tr>\r
+ <tr>\r
+ <th colspan="2">Tests</th>\r
+ <th colspan="2">Commands</th>\r
+ </tr>\r
+ <tr>\r
+ <td class="count" id="testRuns">0</td>\r
+ <td>run</td>\r
+ <td class="count" id="commandPasses">0</td>\r
+ <td>passed</td>\r
+ </tr>\r
+ <tr>\r
+ <td class="count" id="testFailures">0</td>\r
+ <td>failed</td>\r
+ <td class="count" id="commandFailures">0</td>\r
+ <td>failed</td>\r
+ </tr>\r
+ <tr>\r
+ <td colspan="2"></td>\r
+ <td class="count" id="commandErrors">0</td>\r
+ <td>incomplete</td>\r
+ </tr>\r
+ </table>\r
+\r
+ <fieldset>\r
+ <legend>Tools</legend>\r
+\r
+ <button type="button" id="domViewer1" onClick="openDomViewer();">\r
+ View DOM\r
+ </button>\r
+ <button type="button" onClick="LOG.show();">\r
+ Show Log\r
+ </button>\r
+\r
+ </fieldset>\r
+\r
+ </td>\r
+ </tr>\r
+ </table>\r
+</td>\r
+</tr>\r
+\r
+<!-- AUT -->\r
+\r
+<tr>\r
+ <td colspan="3" height="70%">\r
+ <iframe name="selenium_myiframe" id="selenium_myiframe" src="TestRunner-splash.html"></iframe>\r
+ </td>\r
+</tr>\r
+\r
+ </form>\r
+ </table>\r
+\r
+</body>\r
+</html>\r
--- /dev/null
+<html>\r
+\r
+<head>\r
+ <HTA:APPLICATION ID="SeleniumHTARunner" APPLICATIONNAME="Selenium">\r
+ <!-- the previous line is only relevant if you rename this\r
+ file to "TestRunner.hta" -->\r
+\r
+ <!-- The copyright notice and other comments have been moved to after the HTA declaration,\r
+to work-around a bug in IE on Win2K whereby the HTA application doesn't function correctly -->\r
+ <!--\r
+ Copyright 2004 ThoughtWorks, Inc\r
+\r
+ Licensed under the Apache License, Version 2.0 (the "License");\r
+ you may not use this file except in compliance with the License.\r
+ You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+ -->\r
+ <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"/>\r
+\r
+ <title>Selenium Functional Test Runner</title>\r
+ <link rel="stylesheet" type="text/css" href="selenium.css"/>\r
+ <script type="text/javascript" src="scripts/narcissus-defs.js"></script>\r
+ <script type="text/javascript" src="scripts/narcissus-parse.js"></script>\r
+ <script type="text/javascript" src="scripts/narcissus-exec.js"></script>\r
+ <script type="text/javascript" src="scripts/xmlextras.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="lib/prototype.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/htmlutils.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="lib/scriptaculous/scriptaculous.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="lib/cssQuery/cssQuery-p.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-browserdetect.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-browserbot.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/find_matching_child.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-api.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-commandhandlers.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-executionloop.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-testrunner.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-logging.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/selenium-version.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="xpath/misc.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="xpath/dom.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="xpath/xpath.js"></script>\r
+ <script language="JavaScript" type="text/javascript" src="scripts/user-extensions.js"></script>\r
+ <script language="JavaScript" type="text/javascript">\r
+ function openDomViewer() {\r
+ var autFrame = document.getElementById('selenium_myiframe');\r
+ var autFrameDocument = new SeleniumFrame(autFrame).getDocument();\r
+ this.rootDocument = autFrameDocument;\r
+ var domViewer = window.open(getDocumentBase(document) + 'domviewer/domviewer.html');\r
+ return false;\r
+ }\r
+ </script>\r
+</head>\r
+\r
+<body onLoad="onSeleniumLoad();">\r
+<table class="layout">\r
+<form action="" name="controlPanel">\r
+\r
+<!-- Suite, Test, Control Panel -->\r
+\r
+<tr class="selenium">\r
+<td width="25%" height="30%">\r
+ <iframe name="testSuiteFrame" id="testSuiteFrame" src="./TestPrompt.html" application="yes"></iframe>\r
+</td>\r
+<td width="50%" height="30%">\r
+ <iframe name="testFrame" id="testFrame" application="yes"></iframe>\r
+</td>\r
+\r
+<td width="25%">\r
+ <table class="layout">\r
+ <tr class="selenium">\r
+ <th width="25%" height="1" class="header">\r
+ <h1><a href="http://selenium.thoughtworks.com" title="The Selenium Project">Selenium</a> TestRunner\r
+ </h1>\r
+ </th>\r
+ </tr>\r
+ <tr>\r
+ <td width="25%" height="30%" id="controlPanel">\r
+ <fieldset>\r
+ <legend>Execute Tests</legend>\r
+\r
+ <div id="imageButtonPanel">\r
+ <button type="button" id="runSuite" onClick="htmlTestRunner.startTestSuite();"\r
+ title="Run All tests" accesskey="a">\r
+ </button>\r
+ <button type="button" id="runSeleniumTest" onClick="htmlTestRunner.runSingleTest();"\r
+ title="Run the Selected test" accesskey="r">\r
+ </button>\r
+ <button type="button" id="pauseTest" disabled="disabled"\r
+ title="Pause/Continue" accesskey="p" class="cssPauseTest">\r
+ </button>\r
+ <button type="button" id="stepTest" disabled="disabled"\r
+ title="Step" accesskey="s">\r
+ </button>\r
+ </div>\r
+\r
+ <div style="float:left">Fast</div>\r
+ <div style="float:right">Slow</div>\r
+ <br/>\r
+ <div id="speedSlider">\r
+ <div id="speedTrack"> </div>\r
+ <div id="speedHandle"> </div>\r
+ </div>\r
+\r
+ <div class="executionOptions">\r
+ <input id="highlightOption" type="checkbox" name="highlightOption" value="0"/>\r
+ <label for="highlightOption">Highlight elements</label>\r
+ </div>\r
+\r
+ </fieldset>\r
+\r
+ <table id="stats" align="center">\r
+ <tr>\r
+ <td colspan="2" align="right">Elapsed:</td>\r
+ <td id="elapsedTime" colspan="2">00.00</td>\r
+ </tr>\r
+ <tr>\r
+ <th colspan="2">Tests</th>\r
+ <th colspan="2">Commands</th>\r
+ </tr>\r
+ <tr>\r
+ <td class="count" id="testRuns">0</td>\r
+ <td>run</td>\r
+ <td class="count" id="commandPasses">0</td>\r
+ <td>passed</td>\r
+ </tr>\r
+ <tr>\r
+ <td class="count" id="testFailures">0</td>\r
+ <td>failed</td>\r
+ <td class="count" id="commandFailures">0</td>\r
+ <td>failed</td>\r
+ </tr>\r
+ <tr>\r
+ <td colspan="2"></td>\r
+ <td class="count" id="commandErrors">0</td>\r
+ <td>incomplete</td>\r
+ </tr>\r
+ </table>\r
+\r
+ <fieldset>\r
+ <legend>Tools</legend>\r
+\r
+ <button type="button" id="domViewer1" onClick="openDomViewer();">\r
+ View DOM\r
+ </button>\r
+ <button type="button" onClick="LOG.show();">\r
+ Show Log\r
+ </button>\r
+\r
+ </fieldset>\r
+\r
+ </td>\r
+ </tr>\r
+ </table>\r
+</td>\r
+</tr>\r
+\r
+<!-- AUT -->\r
+\r
+<tr>\r
+ <td colspan="3" height="70%">\r
+ <iframe name="selenium_myiframe" id="selenium_myiframe" src="TestRunner-splash.html"></iframe>\r
+ </td>\r
+</tr>\r
+\r
+ </form>\r
+ </table>\r
+\r
+</body>\r
+</html>\r
--- /dev/null
+/******************************************************************************\r
+* Defines default styles for site pages. *\r
+******************************************************************************/\r
+.hidden {\r
+ display: none;\r
+}\r
+\r
+img{\r
+ display: inline;\r
+ border: none;\r
+}\r
+\r
+.box{\r
+ background: #fcfcfc;\r
+ border: 1px solid #000;\r
+ border-color: blue;\r
+ color: #000000;\r
+ margin: 10px auto;\r
+ padding: 3px;\r
+ vertical-align: bottom;\r
+}\r
+a {\r
+ text-decoration: none;\r
+}\r
+\r
+body {\r
+ background-color: #ffffff;\r
+ color: #000000;\r
+ font-family: Arial, Helvetica, sans-serif;\r
+ font-size: 10pt;\r
+}\r
+\r
+h2 {\r
+ font-size: 140%;\r
+}\r
+\r
+h3 {\r
+ font-size: 120%;\r
+}\r
+\r
+h4 {\r
+ font-size: 100%;\r
+}\r
+\r
+pre {\r
+ font-family: Courier New, Courier, monospace;\r
+ font-size: 80%;\r
+}\r
+\r
+td, th {\r
+ font-family: Arial, Helvetica, sans-serif;\r
+ font-size: 10pt;\r
+ text-align: left;\r
+ vertical-align: top;\r
+}\r
+\r
+th {\r
+ font-weight: bold;\r
+ vertical-align: bottom;\r
+}\r
+\r
+ul {\r
+ list-style-type: square;\r
+}\r
+\r
+#demoBox {\r
+ border-color: #000000;\r
+ border-style: solid;\r
+ border-width: 1px;\r
+ padding: 8px;\r
+ width: 24em;\r
+}\r
+\r
+.footer {\r
+ margin-bottom: 0px;\r
+ text-align: center;\r
+}\r
+\r
+/* Boxed table styles */\r
+\r
+table.boxed {\r
+ border-spacing: 2px;\r
+ empty-cells: hide;\r
+}\r
+\r
+td.boxed, th.boxed, th.boxedHeader {\r
+ background-color: #ffffff;\r
+ border-color: #000000;\r
+ border-style: solid;\r
+ border-width: 1px;\r
+ color: #000000;\r
+ padding: 2px;\r
+ padding-left: 8px;\r
+ padding-right: 8px;\r
+}\r
+\r
+th.boxed {\r
+ background-color: #c0c0c0;\r
+}\r
+\r
+th.boxedHeader {\r
+ background-color: #808080;\r
+ color: #ffffff;\r
+}\r
+\r
+a.object {\r
+ color: #0000ff;\r
+}\r
+\r
+li {\r
+ white-space: nowrap;\r
+}\r
+\r
+ul {\r
+ list-style-type: square;\r
+ margin-left: 0px;\r
+ padding-left: 1em;\r
+}\r
+\r
+.boxlevel1{\r
+ background: #FFD700;\r
+}\r
+\r
+.boxlevel2{\r
+ background: #D2691E;\r
+}\r
+\r
+.boxlevel3{\r
+ background: #DCDCDC;\r
+}\r
+\r
+.boxlevel4{\r
+ background: #F5F5F5;\r
+}\r
+\r
+.boxlevel5{\r
+ background: #BEBEBE;\r
+}\r
+\r
+.boxlevel6{\r
+ background: #D3D3D3;\r
+}\r
+\r
+.boxlevel7{\r
+ background: #A9A9A9;\r
+}\r
+\r
+.boxlevel8{\r
+ background: #191970;\r
+}\r
+\r
+.boxlevel9{\r
+ background: #000080;\r
+}\r
+\r
+.boxlevel10{\r
+ background: #6495ED;\r
+}\r
+\r
+.boxlevel11{\r
+ background: #483D8B;\r
+}\r
+\r
+.boxlevel12{\r
+ background: #6A5ACD;\r
+}\r
+\r
+.boxlevel13{\r
+ background: #7B68EE;\r
+}\r
+\r
+.boxlevel14{\r
+ background: #8470FF;\r
+}\r
+\r
+.boxlevel15{\r
+ background: #0000CD;\r
+}\r
+\r
+.boxlevel16{\r
+ background: #4169E1;\r
+}\r
+\r
+.boxlevel17{\r
+ background: #0000FF;\r
+}\r
+\r
+.boxlevel18{\r
+ background: #1E90FF;\r
+}\r
+\r
+.boxlevel19{\r
+ background: #00BFFF;\r
+}\r
+\r
+.boxlevel20{\r
+ background: #87CEEB;\r
+}\r
+\r
+.boxlevel21{\r
+ background: #B0C4DE;\r
+}\r
+\r
+.boxlevel22{\r
+ background: #ADD8E6;\r
+}\r
+\r
+.boxlevel23{\r
+ background: #00CED1;\r
+}\r
+\r
+.boxlevel24{\r
+ background: #48D1CC;\r
+}\r
+\r
+.boxlevel25{\r
+ background: #40E0D0;\r
+}\r
+\r
+.boxlevel26{\r
+ background: #008B8B;\r
+}\r
+\r
+.boxlevel27{\r
+ background: #00FFFF;\r
+}\r
+\r
+.boxlevel28{\r
+ background: #E0FFFF;\r
+}\r
+\r
+.boxlevel29{\r
+ background: #5F9EA0;\r
+}\r
+\r
+.boxlevel30{\r
+ background: #66CDAA;\r
+}\r
+\r
+.boxlevel31{\r
+ background: #7FFFD4;\r
+}\r
+\r
+.boxlevel32{\r
+ background: #006400;\r
+}\r
+\r
+.boxlevel33{\r
+ background: #556B2F;\r
+}\r
+\r
+.boxlevel34{\r
+ background: #8FBC8F;\r
+}\r
+\r
+.boxlevel35{\r
+ background: #2E8B57;\r
+}\r
+\r
+.boxlevel36{\r
+ background: #3CB371;\r
+}\r
+\r
+.boxlevel37{\r
+ background: #20B2AA;\r
+}\r
+\r
+.boxlevel38{\r
+ background: #00FF7F;\r
+}\r
+\r
+.boxlevel39{\r
+ background: #7CFC00;\r
+}\r
+\r
+.boxlevel40{\r
+ background: #90EE90;\r
+}\r
+\r
+.boxlevel41{\r
+ background: #00FF00;\r
+}\r
+\r
+.boxlevel41{\r
+ background: #7FFF00;\r
+}\r
+\r
+.boxlevel42{\r
+ background: #00FA9A;\r
+}\r
+\r
+.boxlevel43{\r
+ background: #ADFF2F;\r
+}\r
+\r
+.boxlevel44{\r
+ background: #32CD32;\r
+}
\ No newline at end of file
--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
+\r
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
+ <head>\r
+ <title>DOM Viewer</title>\r
+ <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />\r
+ <link rel="stylesheet" type="text/css" href="domviewer.css"/>\r
+ <script type="text/javascript" src="selenium-domviewer.js"></script>\r
+ </head>\r
+ <body onload="loadDomViewer();">\r
+ <h3>DOM Viewer</h3>\r
+ <p> This page is generated using JavaScript. If you see this text, your \r
+ browser doesn't support JavaScript.</p>\r
+ </body>\r
+ \r
+</html>\r
--- /dev/null
+var HIDDEN="hidden";
+var LEVEL = "level";
+var PLUS_SRC="butplus.gif";
+var MIN_SRC="butmin.gif";
+var newRoot;
+var maxColumns=1;
+
+function loadDomViewer() {
+ // See if the rootDocument variable has been set on this window.
+ var rootDocument = window.rootDocument;
+
+ // If not look to the opener for an explicity rootDocument variable, otherwise, use the opener document
+ if (!rootDocument && window.opener) {
+ rootDocument = window.opener.rootDocument || window.opener.document;
+ }
+
+ if (rootDocument) {
+ document.body.innerHTML = displayDOM(rootDocument);
+ }
+ else {
+ document.body.innerHTML = "<b>Must specify rootDocument for window. This can be done by setting the rootDocument variable on this window, or on the opener window for a popup window.</b>";
+ }
+}
+
+
+function displayDOM(root){
+ var str = "";
+ str+="<table>";
+ str += treeTraversal(root,0);
+ // to make table columns work well.
+ str += "<tr>";
+ for (var i=0; i < maxColumns; i++) {
+ str+= "<td> </td>";
+ }
+ str += "</tr>";
+ str += "</table>";
+ return str;
+}
+
+function checkForChildren(element){
+ if(!element.hasChildNodes())
+ return false;
+
+ var nodes = element.childNodes;
+ var size = nodes.length;
+ var count=0;
+
+ for(var i=0; i< size; i++){
+ var node = nodes.item(i);
+ //if(node.toString()=="[object Text]"){
+ //this is equalent to the above
+ //but will work with more browsers
+ if(node.nodeType!=1){
+ count++;
+ }
+ }
+
+ if(count == size)
+ return false;
+ else
+ return true;
+}
+
+function treeTraversal(root, level){
+ var str = "";
+ var nodes= null;
+ var size = null;
+ //it is supposed to show the last node,
+ //but the last node is always nodeText type
+ //and we don't show it
+ if(!root.hasChildNodes())
+ return "";//displayNode(root,level,false);
+
+ nodes = root.childNodes;
+ size = nodes.length;
+
+ for(var i=0; i< size; i++){
+ var element = nodes.item(i);
+ //if the node is textNode, don't display
+ if(element.nodeType==1){
+ str+= displayNode(element,level,checkForChildren(element));
+ str+=treeTraversal(element, level+1);
+ }
+ }
+ return str;
+}
+
+function displayNode(element, level, isLink){
+ nodeContent = getNodeContent(element);
+ columns = Math.round((nodeContent.length / 12) + 0.5);
+ if (columns + level > maxColumns) {
+ maxColumns = columns + level;
+ }
+ var str ="<tr class='"+LEVEL+level+"'>";
+ for (var i=0; i < level; i++)
+ str+= "<td> </td>";
+ str+="<td colspan='"+ columns +"' class='box"+" boxlevel"+level+"' >";
+ if(isLink){
+ str+='<a onclick="hide(this);return false;" href="javascript:void();">';
+ str+='<img src="'+MIN_SRC+'" />';
+ }
+ str += nodeContent;
+ if(isLink)
+ str+="</a></td></tr>";
+ return str;
+}
+
+function getNodeContent(element) {
+
+ str = "";
+ id ="";
+ if (element.id != null && element.id != "") {
+ id = " ID(" + element.id +")";
+ }
+ name ="";
+ if (element.name != null && element.name != "") {
+ name = " NAME(" + element.name + ")";
+ }
+ value ="";
+ if (element.value != null && element.value != "") {
+ value = " VALUE(" + element.value + ")";
+ }
+ href ="";
+ if (element.href != null && element.href != "") {
+ href = " HREF(" + element.href + ")";
+ }
+ clazz = "";
+ if (element.className != null && element.className != "") {
+ clazz = " CLASS(" + element.className + ")";
+ }
+ src = "";
+ if (element.src != null && element.src != "") {
+ src = " SRC(" + element.src + ")";
+ }
+ alt = "";
+ if (element.alt != null && element.alt != "") {
+ alt = " ALT(" + element.alt + ")";
+ }
+ type = "";
+ if (element.type != null && element.type != "") {
+ type = " TYPE(" + element.type + ")";
+ }
+ text ="";
+ if (element.text != null && element.text != "" && element.text != "undefined") {
+ text = " #TEXT(" + trim(element.text) +")";
+ }
+ str+=" <b>"+ element.nodeName + id + alt + type + clazz + name + value + href + src + text + "</b>";
+ return str;
+
+}
+
+function trim(val) {
+ val2 = val.substring(0,40) + " ";
+ var spaceChr = String.fromCharCode(32);
+ var length = val2.length;
+ var retVal = "";
+ var ix = length -1;
+
+ while(ix > -1){
+ if(val2.charAt(ix) == spaceChr) {
+ } else {
+ retVal = val2.substring(0, ix +1);
+ break;
+ }
+ ix = ix-1;
+ }
+ if (val.length > 40) {
+ retVal += "...";
+ }
+ return retVal;
+}
+
+function hide(hlink){
+ var isHidden = false;
+ var image = hlink.firstChild;
+ if(image.src.toString().indexOf(MIN_SRC)!=-1){
+ image.src=PLUS_SRC;
+ isHidden=true;
+ }else{
+ image.src=MIN_SRC;
+ }
+ var rowObj= hlink.parentNode.parentNode;
+ var rowLevel = parseInt(rowObj.className.substring(LEVEL.length));
+
+ var sibling = rowObj.nextSibling;
+ var siblingLevel = sibling.className.substring(LEVEL.length);
+ if(siblingLevel.indexOf(HIDDEN)!=-1){
+ siblingLevel = siblingLevel.substring(0,siblingLevel.length - HIDDEN.length-1);
+ }
+ siblingLevel=parseInt(siblingLevel);
+ while(sibling!=null && rowLevel<siblingLevel){
+ if(isHidden){
+ sibling.className += " "+ HIDDEN;
+ }else if(!isHidden && sibling.className.indexOf(HIDDEN)!=-1){
+ var str = sibling.className;
+ sibling.className=str.substring(0, str.length - HIDDEN.length-1);
+ }
+ sibling = sibling.nextSibling;
+ siblingLevel = parseInt(sibling.className.substring(LEVEL.length));
+ }
+}
+
+function LOG(message) {
+ window.opener.LOG.warn(message);
+}
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+\r
+<apidoc>
+\r
+<top>Defines an object that runs Selenium commands.
+
+<h3><a name="locators"></a>Element Locators</h3>
+<p>
+Element Locators tell Selenium which HTML element a command refers to.
+The format of a locator is:</p>
+<blockquote>
+<em>locatorType</em><strong>=</strong><em>argument</em>
+</blockquote>
+
+<p>
+We support the following strategies for locating elements:
+</p>
+
+<ul>
+<li><strong>identifier</strong>=<em>id</em>:
+Select the element with the specified @id attribute. If no match is
+found, select the first element whose @name attribute is <em>id</em>.
+(This is normally the default; see below.)</li>
+<li><strong>id</strong>=<em>id</em>:
+Select the element with the specified @id attribute.</li>
+
+<li><strong>name</strong>=<em>name</em>:
+Select the first element with the specified @name attribute.
+<ul class="first last simple">
+<li>username</li>
+<li>name=username</li>
+</ul>
+
+<p>The name may optionally be followed by one or more <em>element-filters</em>, separated from the name by whitespace. If the <em>filterType</em> is not specified, <strong>value</strong> is assumed.</p>
+
+<ul class="first last simple">
+<li>name=flavour value=chocolate</li>
+</ul>
+</li>
+<li><strong>dom</strong>=<em>javascriptExpression</em>:
+
+Find an element by evaluating the specified string. This allows you to traverse the HTML Document Object
+Model using JavaScript. Note that you must not return a value in this string; simply make it the last expression in the block.
+<ul class="first last simple">
+<li>dom=document.forms['myForm'].myDropdown</li>
+<li>dom=document.images[56]</li>
+<li>dom=function foo() { return document.links[1]; }; foo();</li>
+</ul>
+
+</li>
+
+<li><strong>xpath</strong>=<em>xpathExpression</em>:
+Locate an element using an XPath expression.
+<ul class="first last simple">
+<li>xpath=//img[@alt='The image alt text']</li>
+<li>xpath=//table[@id='table1']//tr[4]/td[2]</li>
+<li>xpath=//a[contains(@href,'#id1')]</li>
+<li>xpath=//a[contains(@href,'#id1')]/@class</li>
+<li>xpath=(//table[@class='stylee'])//th[text()='theHeaderText']/../td</li>
+<li>xpath=//input[@name='name2' and @value='yes']</li>
+<li>xpath=//*[text()="right"]</li>
+
+</ul>
+</li>
+<li><strong>link</strong>=<em>textPattern</em>:
+Select the link (anchor) element which contains text matching the
+specified <em>pattern</em>.
+<ul class="first last simple">
+<li>link=The link text</li>
+</ul>
+
+</li>
+
+<li><strong>css</strong>=<em>cssSelectorSyntax</em>:
+Select the element using css selectors. Please refer to <a href="http://www.w3.org/TR/REC-CSS2/selector.html">CSS2 selectors</a>, <a href="http://www.w3.org/TR/2001/CR-css3-selectors-20011113/">CSS3 selectors</a> for more information. You can also check the TestCssLocators test in the selenium test suite for an example of usage, which is included in the downloaded selenium core package.
+<ul class="first last simple">
+<li>css=a[href="#id3"]</li>
+<li>css=span#firstChild + span</li>
+</ul>
+<p>Currently the css selector locator supports all css1, css2 and css3 selectors except namespace in css3, some pseudo classes(:nth-of-type, :nth-last-of-type, :first-of-type, :last-of-type, :only-of-type, :visited, :hover, :active, :focus, :indeterminate) and pseudo elements(::first-line, ::first-letter, ::selection, ::before, ::after). </p>
+</li>
+</ul>
+
+<p>
+Without an explicit locator prefix, Selenium uses the following default
+strategies:
+</p>
+
+<ul class="simple">
+<li><strong>dom</strong>, for locators starting with "document."</li>
+<li><strong>xpath</strong>, for locators starting with "//"</li>
+<li><strong>identifier</strong>, otherwise</li>
+</ul>
+
+<h3><a name="element-filters">Element Filters</a></h3>
+<blockquote>
+<p>Element filters can be used with a locator to refine a list of candidate elements. They are currently used only in the 'name' element-locator.</p>
+<p>Filters look much like locators, ie.</p>
+<blockquote>
+<em>filterType</em><strong>=</strong><em>argument</em></blockquote>
+
+<p>Supported element-filters are:</p>
+<p><strong>value=</strong><em>valuePattern</em></p>
+<blockquote>
+Matches elements based on their values. This is particularly useful for refining a list of similarly-named toggle-buttons.</blockquote>
+<p><strong>index=</strong><em>index</em></p>
+<blockquote>
+Selects a single element based on its position in the list (offset from zero).</blockquote>
+</blockquote>
+
+<h3><a name="patterns"></a>String-match Patterns</h3>
+
+<p>
+Various Pattern syntaxes are available for matching string values:
+</p>
+<ul>
+<li><strong>glob:</strong><em>pattern</em>:
+Match a string against a "glob" (aka "wildmat") pattern. "Glob" is a
+kind of limited regular-expression syntax typically used in command-line
+shells. In a glob pattern, "*" represents any sequence of characters, and "?"
+represents any single character. Glob patterns match against the entire
+string.</li>
+<li><strong>regexp:</strong><em>regexp</em>:
+Match a string using a regular-expression. The full power of JavaScript
+regular-expressions is available.</li>
+<li><strong>exact:</strong><em>string</em>:
+
+Match a string exactly, verbatim, without any of that fancy wildcard
+stuff.</li>
+</ul>
+<p>
+If no pattern prefix is specified, Selenium assumes that it's a "glob"
+pattern.
+</p></top>
+\r
+<function name="click">
+\r
+<param name="locator">an element locator</param>
+\r
+<comment>Clicks on a link, button, checkbox or radio button. If the click action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="doubleClick">
+\r
+<param name="locator">an element locator</param>
+\r
+<comment>Double clicks on a link, button, checkbox or radio button. If the double click action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="clickAt">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Clicks on a link, button, checkbox or radio button. If the click action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="doubleClickAt">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Doubleclicks on a link, button, checkbox or radio button. If the action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="fireEvent">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="eventName">the event name, e.g. "focus" or "blur"</param>
+\r
+<comment>Explicitly simulate an event, to trigger the corresponding "on<em>event</em>"
+handler.</comment>
+\r
+</function>
+\r
+<function name="keyPress">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="keySequence">Either be a string("\" followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: "w", "\119".</param>
+\r
+<comment>Simulates a user pressing and releasing a key.</comment>
+\r
+</function>
+\r
+<function name="shiftKeyDown">
+\r
+<comment>Press the shift key and hold it down until doShiftUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="shiftKeyUp">
+\r
+<comment>Release the shift key.</comment>
+\r
+</function>
+\r
+<function name="metaKeyDown">
+\r
+<comment>Press the meta key and hold it down until doMetaUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="metaKeyUp">
+\r
+<comment>Release the meta key.</comment>
+\r
+</function>
+\r
+<function name="altKeyDown">
+\r
+<comment>Press the alt key and hold it down until doAltUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="altKeyUp">
+\r
+<comment>Release the alt key.</comment>
+\r
+</function>
+\r
+<function name="controlKeyDown">
+\r
+<comment>Press the control key and hold it down until doControlUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="controlKeyUp">
+\r
+<comment>Release the control key.</comment>
+\r
+</function>
+\r
+<function name="keyDown">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="keySequence">Either be a string("\" followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: "w", "\119".</param>
+\r
+<comment>Simulates a user pressing a key (without releasing it yet).</comment>
+\r
+</function>
+\r
+<function name="keyUp">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="keySequence">Either be a string("\" followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: "w", "\119".</param>
+\r
+<comment>Simulates a user releasing a key.</comment>
+\r
+</function>
+\r
+<function name="mouseOver">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user hovering a mouse over the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseOut">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user moving the mouse pointer away from the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseDown">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseDownAt">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) at
+the specified location.</comment>
+\r
+</function>
+\r
+<function name="mouseUp">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates the event that occurs when the user releases the mouse button (i.e., stops
+holding the button down) on the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseUpAt">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Simulates the event that occurs when the user releases the mouse button (i.e., stops
+holding the button down) at the specified location.</comment>
+\r
+</function>
+\r
+<function name="mouseMove">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseMoveAt">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.</comment>
+\r
+</function>
+\r
+<function name="type">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="value">the value to type</param>
+\r
+<comment>Sets the value of an input field, as though you typed it in.
+
+<p>Can also be used to set the value of combo boxes, check boxes, etc. In these cases,
+value should be the value of the option selected, not the visible text.</p></comment>
+\r
+</function>
+\r
+<function name="typeKeys">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="value">the value to type</param>
+\r
+<comment>Simulates keystroke events on the specified element, as though you typed the value key-by-key.
+
+<p>This is a convenience method for calling keyDown, keyUp, keyPress for every character in the specified string;
+this is useful for dynamic UI widgets (like auto-completing combo boxes) that require explicit key events.</p>
+
+<p>Unlike the simple "type" command, which forces the specified value into the page directly, this command
+may or may not have any visible effect, even in cases where typing keys would normally have a visible effect.
+For example, if you use "typeKeys" on a form element, you may or may not see the results of what you typed in
+the field.</p>
+<p>In some cases, you may need to use the simple "type" command to set the value of the field and then the "typeKeys" command to
+send the keystroke events corresponding to what you just typed.</p></comment>
+\r
+</function>
+\r
+<function name="setSpeed">
+\r
+<param name="value">the number of milliseconds to pause after operation</param>
+\r
+<comment>Set execution speed (i.e., set the millisecond length of a delay which will follow each selenium operation). By default, there is no such delay, i.e.,
+the delay is 0 milliseconds.</comment>
+\r
+</function>
+\r
+<function name="getSpeed">
+\r
+<comment>Get execution speed (i.e., get the millisecond length of the delay following each selenium operation). By default, there is no such delay, i.e.,
+the delay is 0 milliseconds.
+
+See also setSpeed.</comment>
+\r
+</function>
+\r
+<function name="check">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Check a toggle-button (checkbox/radio)</comment>
+\r
+</function>
+\r
+<function name="uncheck">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Uncheck a toggle-button (checkbox/radio)</comment>
+\r
+</function>
+\r
+<function name="select">
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<param name="optionLocator">an option locator (a label by default)</param>
+\r
+<comment>Select an option from a drop-down using an option locator.
+
+<p>
+Option locators provide different ways of specifying options of an HTML
+Select element (e.g. for selecting a specific option, or for asserting
+that the selected option satisfies a specification). There are several
+forms of Select Option Locator.
+</p>
+<ul>
+<li><strong>label</strong>=<em>labelPattern</em>:
+matches options based on their labels, i.e. the visible text. (This
+is the default.)
+<ul class="first last simple">
+<li>label=regexp:^[Oo]ther</li>
+</ul>
+</li>
+<li><strong>value</strong>=<em>valuePattern</em>:
+matches options based on their values.
+<ul class="first last simple">
+<li>value=other</li>
+</ul>
+
+
+</li>
+<li><strong>id</strong>=<em>id</em>:
+
+matches options based on their ids.
+<ul class="first last simple">
+<li>id=option1</li>
+</ul>
+</li>
+<li><strong>index</strong>=<em>index</em>:
+matches an option based on its index (offset from zero).
+<ul class="first last simple">
+
+<li>index=2</li>
+</ul>
+</li>
+</ul>
+<p>
+If no option locator prefix is provided, the default behaviour is to match on <strong>label</strong>.
+</p></comment>
+\r
+</function>
+\r
+<function name="addSelection">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a multi-select box</param>
+\r
+<param name="optionLocator">an option locator (a label by default)</param>
+\r
+<comment>Add a selection to the set of selected options in a multi-select element using an option locator.
+
+@see #doSelect for details of option locators</comment>
+\r
+</function>
+\r
+<function name="removeSelection">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a multi-select box</param>
+\r
+<param name="optionLocator">an option locator (a label by default)</param>
+\r
+<comment>Remove a selection from the set of selected options in a multi-select element using an option locator.
+
+@see #doSelect for details of option locators</comment>
+\r
+</function>
+\r
+<function name="removeAllSelections">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a multi-select box</param>
+\r
+<comment>Unselects all of the selected options in a multi-select element.</comment>
+\r
+</function>
+\r
+<function name="submit">
+\r
+<param name="formLocator">an <a href="#locators">element locator</a> for the form you want to submit</param>
+\r
+<comment>Submit the specified form. This is particularly useful for forms without
+submit buttons, e.g. single-input "Search" forms.</comment>
+\r
+</function>
+\r
+<function name="open">
+\r
+<param name="url">the URL to open; may be relative or absolute</param>
+\r
+<comment>Opens an URL in the test frame. This accepts both relative and absolute
+URLs.
+
+The "open" command waits for the page to load before proceeding,
+ie. the "AndWait" suffix is implicit.
+
+<em>Note</em>: The URL must be on the same domain as the runner HTML
+due to security restrictions in the browser (Same Origin Policy). If you
+need to open an URL on another domain, use the Selenium Server to start a
+new browser session on that domain.</comment>
+\r
+</function>
+\r
+<function name="openWindow">
+\r
+<param name="url">the URL to open, which can be blank</param>
+\r
+<param name="windowID">the JavaScript window ID of the window to select</param>
+\r
+<comment>Opens a popup window (if a window with that ID isn't already open).
+After opening the window, you'll need to select it using the selectWindow
+command.
+
+<p>This command can also be a useful workaround for bug SEL-339. In some cases, Selenium will be unable to intercept a call to window.open (if the call occurs during or before the "onLoad" event, for example).
+In those cases, you can force Selenium to notice the open window's name by using the Selenium openWindow command, using
+an empty (blank) url, like this: openWindow("", "myFunnyWindow").</p></comment>
+\r
+</function>
+\r
+<function name="selectWindow">
+\r
+<param name="windowID">the JavaScript window ID of the window to select</param>
+\r
+<comment>Selects a popup window; once a popup window has been selected, all
+commands go to that window. To select the main window again, use null
+as the target.
+
+<p>Note that there is a big difference between a window's internal JavaScript "name" property
+and the "title" of a given window's document (which is normally what you actually see, as an end user,
+in the title bar of the window). The "name" is normally invisible to the end-user; it's the second
+parameter "windowName" passed to the JavaScript method window.open(url, windowName, windowFeatures, replaceFlag)
+(which selenium intercepts).</p>
+
+<p>Selenium has several strategies for finding the window object referred to by the "windowID" parameter.</p>
+
+<p>1.) if windowID is null, (or the string "null") then it is assumed the user is referring to the original window instantiated by the browser).</p>
+<p>2.) if the value of the "windowID" parameter is a JavaScript variable name in the current application window, then it is assumed
+that this variable contains the return value from a call to the JavaScript window.open() method.</p>
+<p>3.) Otherwise, selenium looks in a hash it maintains that maps string names to window "names".</p>
+<p>4.) If <i>that</i> fails, we'll try looping over all of the known windows to try to find the appropriate "title".
+Since "title" is not necessarily unique, this may have unexpected behavior.</p>
+
+<p>If you're having trouble figuring out what is the name of a window that you want to manipulate, look at the selenium log messages
+which identify the names of windows created via window.open (and therefore intercepted by selenium). You will see messages
+like the following for each window as it is opened:</p>
+
+<p><code>debug: window.open call intercepted; window ID (which you can use with selectWindow()) is "myNewWindow"</code></p>
+
+<p>In some cases, Selenium will be unable to intercept a call to window.open (if the call occurs during or before the "onLoad" event, for example).
+(This is bug SEL-339.) In those cases, you can force Selenium to notice the open window's name by using the Selenium openWindow command, using
+an empty (blank) url, like this: openWindow("", "myFunnyWindow").</p></comment>
+\r
+</function>
+\r
+<function name="selectFrame">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a frame or iframe</param>
+\r
+<comment>Selects a frame within the current window. (You may invoke this command
+multiple times to select nested frames.) To select the parent frame, use
+"relative=parent" as a locator; to select the top frame, use "relative=top".
+You can also select a frame by its 0-based index number; select the first frame with
+"index=0", or the third frame with "index=2".
+
+<p>You may also use a DOM expression to identify the frame you want directly,
+like this: <code>dom=frames["main"].frames["subframe"]</code></p></comment>
+\r
+</function>
+\r
+<function name="getWhetherThisFrameMatchFrameExpression">
+\r
+<return type="boolean">true if the new frame is this code's window</return>
+\r
+<param name="currentFrameString">starting frame</param>
+\r
+<param name="target">new frame (which might be relative to the current one)</param>
+\r
+<comment>Determine whether current/locator identify the frame containing this running code.
+
+<p>This is useful in proxy injection mode, where this code runs in every
+browser frame and window, and sometimes the selenium server needs to identify
+the "current" frame. In this case, when the test calls selectFrame, this
+routine is called for each frame to figure out which one has been selected.
+The selected frame will return true, while all others will return false.</p></comment>
+\r
+</function>
+\r
+<function name="getWhetherThisWindowMatchWindowExpression">
+\r
+<return type="boolean">true if the new window is this code's window</return>
+\r
+<param name="currentWindowString">starting window</param>
+\r
+<param name="target">new window (which might be relative to the current one, e.g., "_parent")</param>
+\r
+<comment>Determine whether currentWindowString plus target identify the window containing this running code.
+
+<p>This is useful in proxy injection mode, where this code runs in every
+browser frame and window, and sometimes the selenium server needs to identify
+the "current" window. In this case, when the test calls selectWindow, this
+routine is called for each window to figure out which one has been selected.
+The selected window will return true, while all others will return false.</p></comment>
+\r
+</function>
+\r
+<function name="waitForPopUp">
+\r
+<param name="windowID">the JavaScript window ID of the window that will appear</param>
+\r
+<param name="timeout">a timeout in milliseconds, after which the action will return with an error</param>
+\r
+<comment>Waits for a popup window to appear and load up.</comment>
+\r
+</function>
+\r
+<function name="chooseCancelOnNextConfirmation">
+\r
+<comment>By default, Selenium's overridden window.confirm() function will
+return true, as if the user had manually clicked OK; after running
+this command, the next call to confirm() will return false, as if
+the user had clicked Cancel. Selenium will then resume using the
+default behavior for future confirmations, automatically returning
+true (OK) unless/until you explicitly call this command for each
+confirmation.</comment>
+\r
+</function>
+\r
+<function name="chooseOkOnNextConfirmation">
+\r
+<comment>Undo the effect of calling chooseCancelOnNextConfirmation. Note
+that Selenium's overridden window.confirm() function will normally automatically
+return true, as if the user had manually clicked OK, so you shouldn't
+need to use this command unless for some reason you need to change
+your mind prior to the next confirmation. After any confirmation, Selenium will resume using the
+default behavior for future confirmations, automatically returning
+true (OK) unless/until you explicitly call chooseCancelOnNextConfirmation for each
+confirmation.</comment>
+\r
+</function>
+\r
+<function name="answerOnNextPrompt">
+\r
+<param name="answer">the answer to give in response to the prompt pop-up</param>
+\r
+<comment>Instructs Selenium to return the specified answer string in response to
+the next JavaScript prompt [window.prompt()].</comment>
+\r
+</function>
+\r
+<function name="goBack">
+\r
+<comment>Simulates the user clicking the "back" button on their browser.</comment>
+\r
+</function>
+\r
+<function name="refresh">
+\r
+<comment>Simulates the user clicking the "Refresh" button on their browser.</comment>
+\r
+</function>
+\r
+<function name="close">
+\r
+<comment>Simulates the user clicking the "close" button in the titlebar of a popup
+window or tab.</comment>
+\r
+</function>
+\r
+<function name="isAlertPresent">
+\r
+<return type="boolean">true if there is an alert</return>
+\r
+<comment>Has an alert occurred?
+
+<p>
+This function never throws an exception
+</p></comment>
+\r
+</function>
+\r
+<function name="isPromptPresent">
+\r
+<return type="boolean">true if there is a pending prompt</return>
+\r
+<comment>Has a prompt occurred?
+
+<p>
+This function never throws an exception
+</p></comment>
+\r
+</function>
+\r
+<function name="isConfirmationPresent">
+\r
+<return type="boolean">true if there is a pending confirmation</return>
+\r
+<comment>Has confirm() been called?
+
+<p>
+This function never throws an exception
+</p></comment>
+\r
+</function>
+\r
+<function name="getAlert">
+\r
+<return type="string">The message of the most recent JavaScript alert</return>
+\r
+<comment>Retrieves the message of a JavaScript alert generated during the previous action, or fail if there were no alerts.
+
+<p>Getting an alert has the same effect as manually clicking OK. If an
+alert is generated but you do not get/verify it, the next Selenium action
+will fail.</p>
+
+<p>NOTE: under Selenium, JavaScript alerts will NOT pop up a visible alert
+dialog.</p>
+
+<p>NOTE: Selenium does NOT support JavaScript alerts that are generated in a
+page's onload() event handler. In this case a visible dialog WILL be
+generated and Selenium will hang until someone manually clicks OK.</p></comment>
+\r
+</function>
+\r
+<function name="getConfirmation">
+\r
+<return type="string">the message of the most recent JavaScript confirmation dialog</return>
+\r
+<comment>Retrieves the message of a JavaScript confirmation dialog generated during
+the previous action.
+
+<p>
+By default, the confirm function will return true, having the same effect
+as manually clicking OK. This can be changed by prior execution of the
+chooseCancelOnNextConfirmation command. If an confirmation is generated
+but you do not get/verify it, the next Selenium action will fail.
+</p>
+
+<p>
+NOTE: under Selenium, JavaScript confirmations will NOT pop up a visible
+dialog.
+</p>
+
+<p>
+NOTE: Selenium does NOT support JavaScript confirmations that are
+generated in a page's onload() event handler. In this case a visible
+dialog WILL be generated and Selenium will hang until you manually click
+OK.
+</p></comment>
+\r
+</function>
+\r
+<function name="getPrompt">
+\r
+<return type="string">the message of the most recent JavaScript question prompt</return>
+\r
+<comment>Retrieves the message of a JavaScript question prompt dialog generated during
+the previous action.
+
+<p>Successful handling of the prompt requires prior execution of the
+answerOnNextPrompt command. If a prompt is generated but you
+do not get/verify it, the next Selenium action will fail.</p>
+
+<p>NOTE: under Selenium, JavaScript prompts will NOT pop up a visible
+dialog.</p>
+
+<p>NOTE: Selenium does NOT support JavaScript prompts that are generated in a
+page's onload() event handler. In this case a visible dialog WILL be
+generated and Selenium will hang until someone manually clicks OK.</p></comment>
+\r
+</function>
+\r
+<function name="getLocation">
+\r
+<return type="string">the absolute URL of the current page</return>
+\r
+<comment>Gets the absolute URL of the current page.</comment>
+\r
+</function>
+\r
+<function name="getTitle">
+\r
+<return type="string">the title of the current page</return>
+\r
+<comment>Gets the title of the current page.</comment>
+\r
+</function>
+\r
+<function name="getBodyText">
+\r
+<return type="string">the entire text of the page</return>
+\r
+<comment>Gets the entire text of the page.</comment>
+\r
+</function>
+\r
+<function name="getValue">
+\r
+<return type="string">the element value, or "on/off" for checkbox/radio elements</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Gets the (whitespace-trimmed) value of an input field (or anything else with a value parameter).
+For checkbox/radio elements, the value will be "on" or "off" depending on
+whether the element is checked or not.</comment>
+\r
+</function>
+\r
+<function name="getText">
+\r
+<return type="string">the text of the element</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Gets the text of an element. This works for any element that contains
+text. This command uses either the textContent (Mozilla-like browsers) or
+the innerText (IE-like browsers) of the element, which is the rendered
+text shown to the user.</comment>
+\r
+</function>
+\r
+<function name="highlight">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Briefly changes the backgroundColor of the specified element yellow. Useful for debugging.</comment>
+\r
+</function>
+\r
+<function name="getEval">
+\r
+<return type="string">the results of evaluating the snippet</return>
+\r
+<param name="script">the JavaScript snippet to run</param>
+\r
+<comment>Gets the result of evaluating the specified JavaScript snippet. The snippet may
+have multiple lines, but only the result of the last line will be returned.
+
+<p>Note that, by default, the snippet will run in the context of the "selenium"
+object itself, so <code>this</code> will refer to the Selenium object. Use <code>window</code> to
+refer to the window of your application, e.g. <code>window.document.getElementById('foo')</code></p>
+
+<p>If you need to use
+a locator to refer to a single element in your application page, you can
+use <code>this.browserbot.findElement("id=foo")</code> where "id=foo" is your locator.</p></comment>
+\r
+</function>
+\r
+<function name="isChecked">
+\r
+<return type="boolean">true if the checkbox is checked, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to a checkbox or radio button</param>
+\r
+<comment>Gets whether a toggle-button (checkbox/radio) is checked. Fails if the specified element doesn't exist or isn't a toggle-button.</comment>
+\r
+</function>
+\r
+<function name="getTable">
+\r
+<return type="string">the text from the specified cell</return>
+\r
+<param name="tableCellAddress">a cell address, e.g. "foo.1.4"</param>
+\r
+<comment>Gets the text from a cell of a table. The cellAddress syntax
+tableLocator.row.column, where row and column start at 0.</comment>
+\r
+</function>
+\r
+<function name="getSelectedLabels">
+\r
+<return type="string[]">an array of all selected option labels in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option labels (visible text) for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedLabel">
+\r
+<return type="string">the selected option label in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option label (visible text) for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedValues">
+\r
+<return type="string[]">an array of all selected option values in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option values (value attributes) for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedValue">
+\r
+<return type="string">the selected option value in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option value (value attribute) for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedIndexes">
+\r
+<return type="string[]">an array of all selected option indexes in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option indexes (option number, starting at 0) for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedIndex">
+\r
+<return type="string">the selected option index in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option index (option number, starting at 0) for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedIds">
+\r
+<return type="string[]">an array of all selected option IDs in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option element IDs for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedId">
+\r
+<return type="string">the selected option ID in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option element ID for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="isSomethingSelected">
+\r
+<return type="boolean">true if some option has been selected, false otherwise</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Determines whether some option in a drop-down menu is selected.</comment>
+\r
+</function>
+\r
+<function name="getSelectOptions">
+\r
+<return type="string[]">an array of all option labels in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option labels in the specified select drop-down.</comment>
+\r
+</function>
+\r
+<function name="getAttribute">
+\r
+<return type="string">the value of the specified attribute</return>
+\r
+<param name="attributeLocator">an element locator followed by an @ sign and then the name of the attribute, e.g. "foo@bar"</param>
+\r
+<comment>Gets the value of an element attribute.</comment>
+\r
+</function>
+\r
+<function name="isTextPresent">
+\r
+<return type="boolean">true if the pattern matches the text, false otherwise</return>
+\r
+<param name="pattern">a <a href="#patterns">pattern</a> to match with the text of the page</param>
+\r
+<comment>Verifies that the specified text pattern appears somewhere on the rendered page shown to the user.</comment>
+\r
+</function>
+\r
+<function name="isElementPresent">
+\r
+<return type="boolean">true if the element is present, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Verifies that the specified element is somewhere on the page.</comment>
+\r
+</function>
+\r
+<function name="isVisible">
+\r
+<return type="boolean">true if the specified element is visible, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Determines if the specified element is visible. An
+element can be rendered invisible by setting the CSS "visibility"
+property to "hidden", or the "display" property to "none", either for the
+element itself or one if its ancestors. This method will fail if
+the element is not present.</comment>
+\r
+</function>
+\r
+<function name="isEditable">
+\r
+<return type="boolean">true if the input element is editable, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Determines whether the specified input element is editable, ie hasn't been disabled.
+This method will fail if the specified element isn't an input element.</comment>
+\r
+</function>
+\r
+<function name="getAllButtons">
+\r
+<return type="string[]">the IDs of all buttons on the page</return>
+\r
+<comment>Returns the IDs of all buttons on the page.
+
+<p>If a given button has no ID, it will appear as "" in this array.</p></comment>
+\r
+</function>
+\r
+<function name="getAllLinks">
+\r
+<return type="string[]">the IDs of all links on the page</return>
+\r
+<comment>Returns the IDs of all links on the page.
+
+<p>If a given link has no ID, it will appear as "" in this array.</p></comment>
+\r
+</function>
+\r
+<function name="getAllFields">
+\r
+<return type="string[]">the IDs of all field on the page</return>
+\r
+<comment>Returns the IDs of all input fields on the page.
+
+<p>If a given field has no ID, it will appear as "" in this array.</p></comment>
+\r
+</function>
+\r
+<function name="getAttributeFromAllWindows">
+\r
+<return type="string[]">the set of values of this attribute from all known windows.</return>
+\r
+<param name="attributeName">name of an attribute on the windows</param>
+\r
+<comment>Returns every instance of some attribute from all known windows.</comment>
+\r
+</function>
+\r
+<function name="dragdrop">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="movementsString">offset in pixels from the current location to which the element should be moved, e.g., "+70,-300"</param>
+\r
+<comment>deprecated - use dragAndDrop instead</comment>
+\r
+</function>
+\r
+<function name="setMouseSpeed">
+\r
+<param name="pixels">the number of pixels between "mousemove" events</param>
+\r
+<comment>Configure the number of pixels between "mousemove" events during dragAndDrop commands (default=10).
+<p>Setting this value to 0 means that we'll send a "mousemove" event to every single pixel
+in between the start location and the end location; that can be very slow, and may
+cause some browsers to force the JavaScript to timeout.</p>
+
+<p>If the mouse speed is greater than the distance between the two dragged objects, we'll
+just send one "mousemove" at the start location and then one final one at the end location.</p></comment>
+\r
+</function>
+\r
+<function name="getMouseSpeed">
+\r
+<return type="number">the number of pixels between "mousemove" events during dragAndDrop commands (default=10)</return>
+\r
+<comment>Returns the number of pixels between "mousemove" events during dragAndDrop commands (default=10).</comment>
+\r
+</function>
+\r
+<function name="dragAndDrop">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="movementsString">offset in pixels from the current location to which the element should be moved, e.g., "+70,-300"</param>
+\r
+<comment>Drags an element a certain distance and then drops it</comment>
+\r
+</function>
+\r
+<function name="dragAndDropToObject">
+\r
+<param name="locatorOfObjectToBeDragged">an element to be dragged</param>
+\r
+<param name="locatorOfDragDestinationObject">an element whose location (i.e., whose center-most pixel) will be the point where locatorOfObjectToBeDragged is dropped</param>
+\r
+<comment>Drags an element and drops it on another element</comment>
+\r
+</function>
+\r
+<function name="windowFocus">
+\r
+<comment>Gives focus to the currently selected window</comment>
+\r
+</function>
+\r
+<function name="windowMaximize">
+\r
+<comment>Resize currently selected window to take up the entire screen</comment>
+\r
+</function>
+\r
+<function name="getAllWindowIds">
+\r
+<return type="string[]">the IDs of all windows that the browser knows about.</return>
+\r
+<comment>Returns the IDs of all windows that the browser knows about.</comment>
+\r
+</function>
+\r
+<function name="getAllWindowNames">
+\r
+<return type="string[]">the names of all windows that the browser knows about.</return>
+\r
+<comment>Returns the names of all windows that the browser knows about.</comment>
+\r
+</function>
+\r
+<function name="getAllWindowTitles">
+\r
+<return type="string[]">the titles of all windows that the browser knows about.</return>
+\r
+<comment>Returns the titles of all windows that the browser knows about.</comment>
+\r
+</function>
+\r
+<function name="getHtmlSource">
+\r
+<return type="string">the entire HTML source</return>
+\r
+<comment>Returns the entire HTML source between the opening and
+closing "html" tags.</comment>
+\r
+</function>
+\r
+<function name="setCursorPosition">
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an input element or textarea</param>
+\r
+<param name="position">the numerical position of the cursor in the field; position should be 0 to move the position to the beginning of the field. You can also set the cursor to -1 to move it to the end of the field.</param>
+\r
+<comment>Moves the text cursor to the specified position in the given input element or textarea.
+This method will fail if the specified element isn't an input element or textarea.</comment>
+\r
+</function>
+\r
+<function name="getElementIndex">
+\r
+<return type="number">of relative index of the element to its parent (starting from 0)</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<comment>Get the relative index of an element to its parent (starting from 0). The comment node and empty text node
+will be ignored.</comment>
+\r
+</function>
+\r
+<function name="isOrdered">
+\r
+<return type="boolean">true if element1 is the previous sibling of element2, false otherwise</return>
+\r
+<param name="locator1">an <a href="#locators">element locator</a> pointing to the first element</param>
+\r
+<param name="locator2">an <a href="#locators">element locator</a> pointing to the second element</param>
+\r
+<comment>Check if these two elements have same parent and are ordered siblings in the DOM. Two same elements will
+not be considered ordered.</comment>
+\r
+</function>
+\r
+<function name="getElementPositionLeft">
+\r
+<return type="number">of pixels from the edge of the frame.</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element OR an element itself</param>
+\r
+<comment>Retrieves the horizontal position of an element</comment>
+\r
+</function>
+\r
+<function name="getElementPositionTop">
+\r
+<return type="number">of pixels from the edge of the frame.</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element OR an element itself</param>
+\r
+<comment>Retrieves the vertical position of an element</comment>
+\r
+</function>
+\r
+<function name="getElementWidth">
+\r
+<return type="number">width of an element in pixels</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<comment>Retrieves the width of an element</comment>
+\r
+</function>
+\r
+<function name="getElementHeight">
+\r
+<return type="number">height of an element in pixels</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<comment>Retrieves the height of an element</comment>
+\r
+</function>
+\r
+<function name="getCursorPosition">
+\r
+<return type="number">the numerical position of the cursor in the field</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an input element or textarea</param>
+\r
+<comment>Retrieves the text cursor position in the given input element or textarea; beware, this may not work perfectly on all browsers.
+
+<p>Specifically, if the cursor/selection has been cleared by JavaScript, this command will tend to
+return the position of the last location of the cursor, even though the cursor is now gone from the page. This is filed as <a href="http://jira.openqa.org/browse/SEL-243">SEL-243</a>.</p>
+This method will fail if the specified element isn't an input element or textarea, or there is no cursor in the element.</comment>
+\r
+</function>
+\r
+<function name="getExpression">
+\r
+<return type="string">the value passed in</return>
+\r
+<param name="expression">the value to return</param>
+\r
+<comment>Returns the specified expression.
+
+<p>This is useful because of JavaScript preprocessing.
+It is used to generate commands like assertExpression and waitForExpression.</p></comment>
+\r
+</function>
+\r
+<function name="getXpathCount">
+\r
+<return type="number">the number of nodes that match the specified xpath</return>
+\r
+<param name="xpath">the xpath expression to evaluate. do NOT wrap this expression in a 'count()' function; we will do that for you.</param>
+\r
+<comment>Returns the number of nodes that match the specified xpath, eg. "//table" would give
+the number of tables.</comment>
+\r
+</function>
+\r
+<function name="assignId">
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<param name="identifier">a string to be used as the ID of the specified element</param>
+\r
+<comment>Temporarily sets the "id" attribute of the specified element, so you can locate it in the future
+using its ID rather than a slow/complicated XPath. This ID will disappear once the page is
+reloaded.</comment>
+\r
+</function>
+\r
+<function name="allowNativeXpath">
+\r
+<param name="allow">boolean, true means we'll prefer to use native XPath; false means we'll only use JS XPath</param>
+\r
+<comment>Specifies whether Selenium should use the native in-browser implementation
+of XPath (if any native version is available); if you pass "false" to
+this function, we will always use our pure-JavaScript xpath library.
+Using the pure-JS xpath library can improve the consistency of xpath
+element locators between different browser vendors, but the pure-JS
+version is much slower than the native implementations.</comment>
+\r
+</function>
+\r
+<function name="waitForCondition">
+\r
+<param name="script">the JavaScript snippet to run</param>
+\r
+<param name="timeout">a timeout in milliseconds, after which this command will return with an error</param>
+\r
+<comment>Runs the specified JavaScript snippet repeatedly until it evaluates to "true".
+The snippet may have multiple lines, but only the result of the last line
+will be considered.
+
+<p>Note that, by default, the snippet will be run in the runner's test window, not in the window
+of your application. To get the window of your application, you can use
+the JavaScript snippet <code>selenium.browserbot.getCurrentWindow()</code>, and then
+run your JavaScript in there</p></comment>
+\r
+</function>
+\r
+<function name="setTimeout">
+\r
+<param name="timeout">a timeout in milliseconds, after which the action will return with an error</param>
+\r
+<comment>Specifies the amount of time that Selenium will wait for actions to complete.
+
+<p>Actions that require waiting include "open" and the "waitFor*" actions.</p>
+The default timeout is 30 seconds.</comment>
+\r
+</function>
+\r
+<function name="waitForPageToLoad">
+\r
+<param name="timeout">a timeout in milliseconds, after which this command will return with an error</param>
+\r
+<comment>Waits for a new page to load.
+
+<p>You can use this command instead of the "AndWait" suffixes, "clickAndWait", "selectAndWait", "typeAndWait" etc.
+(which are only available in the JS API).</p>
+
+<p>Selenium constantly keeps track of new pages loading, and sets a "newPageLoaded"
+flag when it first notices a page load. Running any other Selenium command after
+turns the flag to false. Hence, if you want to wait for a page to load, you must
+wait immediately after a Selenium command that caused a page-load.</p></comment>
+\r
+</function>
+\r
+<function name="waitForFrameToLoad">
+\r
+<param name="frameAddress">FrameAddress from the server side</param>
+\r
+<param name="timeout">a timeout in milliseconds, after which this command will return with an error</param>
+\r
+<comment>Waits for a new frame to load.
+
+<p>Selenium constantly keeps track of new pages and frames loading,
+and sets a "newPageLoaded" flag when it first notices a page load.</p>
+
+See waitForPageToLoad for more information.</comment>
+\r
+</function>
+\r
+<function name="getCookie">
+\r
+<return type="string">all cookies of the current page under test</return>
+\r
+<comment>Return all cookies of the current page under test.</comment>
+\r
+</function>
+\r
+<function name="createCookie">
+\r
+<param name="nameValuePair">name and value of the cookie in a format "name=value"</param>
+\r
+<param name="optionsString">options for the cookie. Currently supported options include 'path' and 'max_age'. the optionsString's format is "path=/path/, max_age=60". The order of options are irrelevant, the unit of the value of 'max_age' is second.</param>
+\r
+<comment>Create a new cookie whose path and domain are same with those of current page
+under test, unless you specified a path for this cookie explicitly.</comment>
+\r
+</function>
+\r
+<function name="deleteCookie">
+\r
+<param name="name">the name of the cookie to be deleted</param>
+\r
+<param name="path">the path property of the cookie to be deleted</param>
+\r
+<comment>Delete a named cookie with specified path.</comment>
+\r
+</function>
+\r
+<function name="setBrowserLogLevel">
+\r
+<param name="logLevel">one of the following: "debug", "info", "warn", "error" or "off"</param>
+\r
+<comment>Sets the threshold for browser-side logging messages; log messages beneath this threshold will be discarded.
+Valid logLevel strings are: "debug", "info", "warn", "error" or "off".
+To see the browser logs, you need to
+either show the log window in GUI mode, or enable browser-side logging in Selenium RC.</comment>
+\r
+</function>
+\r
+<function name="runScript">
+\r
+<param name="script">the JavaScript snippet to run</param>
+\r
+<comment>Creates a new "script" tag in the body of the current test window, and
+adds the specified text into the body of the command. Scripts run in
+this way can often be debugged more easily than scripts executed using
+Selenium's "getEval" command. Beware that JS exceptions thrown in these script
+tags aren't managed by Selenium, so you should probably wrap your script
+in try/catch blocks if there is any chance that the script will throw
+an exception.</comment>
+\r
+</function>
+\r
+<function name="addLocationStrategy">
+\r
+<param name="strategyName">the name of the strategy to define; this should use only letters [a-zA-Z] with no spaces or other punctuation.</param>
+\r
+<param name="functionDefinition">a string defining the body of a function in JavaScript. For example: <code>return inDocument.getElementById(locator);</code></param>
+\r
+<comment>Defines a new function for Selenium to locate elements on the page.
+For example,
+if you define the strategy "foo", and someone runs click("foo=blah"), we'll
+run your function, passing you the string "blah", and click on the element
+that your function
+returns, or throw an "Element not found" error if your function returns null.
+
+We'll pass three arguments to your function:
+<ul>
+<li>locator: the string the user passed in</li>
+<li>inWindow: the currently selected window</li>
+<li>inDocument: the currently selected document</li>
+</ul>
+The function must return null if the element can't be found.</comment>
+\r
+</function>
+\r
+<function name="pause">
+\r
+<param name="waitTime">the amount of time to sleep (in milliseconds)</param>
+\r
+<comment>Wait for the specified amount of time (in milliseconds)</comment>
+\r
+</function>
+\r
+<function name="break">
+\r
+<comment>Halt the currently running test, and wait for the user to press the Continue button.
+This command is useful for debugging, but be careful when using it, because it will
+force automated tests to hang until a user intervenes manually.</comment>
+\r
+</function>
+\r
+<function name="store">
+\r
+<param name="expression">the value to store</param>
+\r
+<param name="variableName">the name of a <a href="#storedVars">variable</a> in which the result is to be stored.</param>
+\r
+<comment>This command is a synonym for storeExpression.</comment>
+\r
+</function>
+\r
+<function name="echo">
+\r
+<param name="message">the message to print</param>
+\r
+<comment>Prints the specified message into the third table cell in your Selenese tables.
+Useful for debugging.</comment>
+\r
+</function>
+\r
+<function name="assertSelected">
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<param name="optionLocator">an option locator, typically just an option label (e.g. "John Smith")</param>
+\r
+<comment>Verifies that the selected option of a drop-down satisfies the optionSpecifier. <i>Note that this command is deprecated; you should use assertSelectedLabel, assertSelectedValue, assertSelectedIndex, or assertSelectedId instead.</i>
+
+<p>See the select command for more information about option locators.</p></comment>
+\r
+</function>
+\r
+<function name="assertFailureOnNext">
+\r
+<param name="message">The failure message we should expect. This command will fail if the wrong failure message appears.</param>
+\r
+<comment>Tell Selenium to expect a failure on the next command execution.</comment>
+\r
+</function>
+\r
+<function name="assertErrorOnNext">
+\r
+<param name="message">The error message we should expect. This command will fail if the wrong error message appears.</param>
+\r
+<comment>Tell Selenium to expect an error on the next command execution.</comment>
+\r
+</function>
+\r
+</apidoc>\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+\r
+<apidoc>
+\r
+<top>Defines an object that runs Selenium commands.
+
+<h3><a name="locators"></a>Element Locators</h3>
+<p>
+Element Locators tell Selenium which HTML element a command refers to.
+The format of a locator is:</p>
+<blockquote>
+<em>locatorType</em><strong>=</strong><em>argument</em>
+</blockquote>
+
+<p>
+We support the following strategies for locating elements:
+</p>
+
+<ul>
+<li><strong>identifier</strong>=<em>id</em>:
+Select the element with the specified @id attribute. If no match is
+found, select the first element whose @name attribute is <em>id</em>.
+(This is normally the default; see below.)</li>
+<li><strong>id</strong>=<em>id</em>:
+Select the element with the specified @id attribute.</li>
+
+<li><strong>name</strong>=<em>name</em>:
+Select the first element with the specified @name attribute.
+<ul class="first last simple">
+<li>username</li>
+<li>name=username</li>
+</ul>
+
+<p>The name may optionally be followed by one or more <em>element-filters</em>, separated from the name by whitespace. If the <em>filterType</em> is not specified, <strong>value</strong> is assumed.</p>
+
+<ul class="first last simple">
+<li>name=flavour value=chocolate</li>
+</ul>
+</li>
+<li><strong>dom</strong>=<em>javascriptExpression</em>:
+
+Find an element by evaluating the specified string. This allows you to traverse the HTML Document Object
+Model using JavaScript. Note that you must not return a value in this string; simply make it the last expression in the block.
+<ul class="first last simple">
+<li>dom=document.forms['myForm'].myDropdown</li>
+<li>dom=document.images[56]</li>
+<li>dom=function foo() { return document.links[1]; }; foo();</li>
+</ul>
+
+</li>
+
+<li><strong>xpath</strong>=<em>xpathExpression</em>:
+Locate an element using an XPath expression.
+<ul class="first last simple">
+<li>xpath=//img[@alt='The image alt text']</li>
+<li>xpath=//table[@id='table1']//tr[4]/td[2]</li>
+<li>xpath=//a[contains(@href,'#id1')]</li>
+<li>xpath=//a[contains(@href,'#id1')]/@class</li>
+<li>xpath=(//table[@class='stylee'])//th[text()='theHeaderText']/../td</li>
+<li>xpath=//input[@name='name2' and @value='yes']</li>
+<li>xpath=//*[text()="right"]</li>
+
+</ul>
+</li>
+<li><strong>link</strong>=<em>textPattern</em>:
+Select the link (anchor) element which contains text matching the
+specified <em>pattern</em>.
+<ul class="first last simple">
+<li>link=The link text</li>
+</ul>
+
+</li>
+
+<li><strong>css</strong>=<em>cssSelectorSyntax</em>:
+Select the element using css selectors. Please refer to <a href="http://www.w3.org/TR/REC-CSS2/selector.html">CSS2 selectors</a>, <a href="http://www.w3.org/TR/2001/CR-css3-selectors-20011113/">CSS3 selectors</a> for more information. You can also check the TestCssLocators test in the selenium test suite for an example of usage, which is included in the downloaded selenium core package.
+<ul class="first last simple">
+<li>css=a[href="#id3"]</li>
+<li>css=span#firstChild + span</li>
+</ul>
+<p>Currently the css selector locator supports all css1, css2 and css3 selectors except namespace in css3, some pseudo classes(:nth-of-type, :nth-last-of-type, :first-of-type, :last-of-type, :only-of-type, :visited, :hover, :active, :focus, :indeterminate) and pseudo elements(::first-line, ::first-letter, ::selection, ::before, ::after). </p>
+</li>
+</ul>
+
+<p>
+Without an explicit locator prefix, Selenium uses the following default
+strategies:
+</p>
+
+<ul class="simple">
+<li><strong>dom</strong>, for locators starting with "document."</li>
+<li><strong>xpath</strong>, for locators starting with "//"</li>
+<li><strong>identifier</strong>, otherwise</li>
+</ul>
+
+<h3><a name="element-filters">Element Filters</a></h3>
+<blockquote>
+<p>Element filters can be used with a locator to refine a list of candidate elements. They are currently used only in the 'name' element-locator.</p>
+<p>Filters look much like locators, ie.</p>
+<blockquote>
+<em>filterType</em><strong>=</strong><em>argument</em></blockquote>
+
+<p>Supported element-filters are:</p>
+<p><strong>value=</strong><em>valuePattern</em></p>
+<blockquote>
+Matches elements based on their values. This is particularly useful for refining a list of similarly-named toggle-buttons.</blockquote>
+<p><strong>index=</strong><em>index</em></p>
+<blockquote>
+Selects a single element based on its position in the list (offset from zero).</blockquote>
+</blockquote>
+
+<h3><a name="patterns"></a>String-match Patterns</h3>
+
+<p>
+Various Pattern syntaxes are available for matching string values:
+</p>
+<ul>
+<li><strong>glob:</strong><em>pattern</em>:
+Match a string against a "glob" (aka "wildmat") pattern. "Glob" is a
+kind of limited regular-expression syntax typically used in command-line
+shells. In a glob pattern, "*" represents any sequence of characters, and "?"
+represents any single character. Glob patterns match against the entire
+string.</li>
+<li><strong>regexp:</strong><em>regexp</em>:
+Match a string using a regular-expression. The full power of JavaScript
+regular-expressions is available.</li>
+<li><strong>exact:</strong><em>string</em>:
+
+Match a string exactly, verbatim, without any of that fancy wildcard
+stuff.</li>
+</ul>
+<p>
+If no pattern prefix is specified, Selenium assumes that it's a "glob"
+pattern.
+</p></top>
+\r
+<function name="click">
+\r
+<param name="locator">an element locator</param>
+\r
+<comment>Clicks on a link, button, checkbox or radio button. If the click action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="doubleClick">
+\r
+<param name="locator">an element locator</param>
+\r
+<comment>Double clicks on a link, button, checkbox or radio button. If the double click action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="clickAt">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Clicks on a link, button, checkbox or radio button. If the click action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="doubleClickAt">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Doubleclicks on a link, button, checkbox or radio button. If the action
+causes a new page to load (like a link usually does), call
+waitForPageToLoad.</comment>
+\r
+</function>
+\r
+<function name="fireEvent">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="eventName">the event name, e.g. "focus" or "blur"</param>
+\r
+<comment>Explicitly simulate an event, to trigger the corresponding "on<em>event</em>"
+handler.</comment>
+\r
+</function>
+\r
+<function name="keyPress">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="keySequence">Either be a string("\" followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: "w", "\119".</param>
+\r
+<comment>Simulates a user pressing and releasing a key.</comment>
+\r
+</function>
+\r
+<function name="shiftKeyDown">
+\r
+<comment>Press the shift key and hold it down until doShiftUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="shiftKeyUp">
+\r
+<comment>Release the shift key.</comment>
+\r
+</function>
+\r
+<function name="metaKeyDown">
+\r
+<comment>Press the meta key and hold it down until doMetaUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="metaKeyUp">
+\r
+<comment>Release the meta key.</comment>
+\r
+</function>
+\r
+<function name="altKeyDown">
+\r
+<comment>Press the alt key and hold it down until doAltUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="altKeyUp">
+\r
+<comment>Release the alt key.</comment>
+\r
+</function>
+\r
+<function name="controlKeyDown">
+\r
+<comment>Press the control key and hold it down until doControlUp() is called or a new page is loaded.</comment>
+\r
+</function>
+\r
+<function name="controlKeyUp">
+\r
+<comment>Release the control key.</comment>
+\r
+</function>
+\r
+<function name="keyDown">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="keySequence">Either be a string("\" followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: "w", "\119".</param>
+\r
+<comment>Simulates a user pressing a key (without releasing it yet).</comment>
+\r
+</function>
+\r
+<function name="keyUp">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="keySequence">Either be a string("\" followed by the numeric keycode of the key to be pressed, normally the ASCII value of that key), or a single character. For example: "w", "\119".</param>
+\r
+<comment>Simulates a user releasing a key.</comment>
+\r
+</function>
+\r
+<function name="mouseOver">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user hovering a mouse over the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseOut">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user moving the mouse pointer away from the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseDown">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseDownAt">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) at
+the specified location.</comment>
+\r
+</function>
+\r
+<function name="mouseUp">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates the event that occurs when the user releases the mouse button (i.e., stops
+holding the button down) on the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseUpAt">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Simulates the event that occurs when the user releases the mouse button (i.e., stops
+holding the button down) at the specified location.</comment>
+\r
+</function>
+\r
+<function name="mouseMove">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.</comment>
+\r
+</function>
+\r
+<function name="mouseMoveAt">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="coordString">specifies the x,y position (i.e. - 10,20) of the mouse event relative to the element returned by the locator.</param>
+\r
+<comment>Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.</comment>
+\r
+</function>
+\r
+<function name="type">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="value">the value to type</param>
+\r
+<comment>Sets the value of an input field, as though you typed it in.
+
+<p>Can also be used to set the value of combo boxes, check boxes, etc. In these cases,
+value should be the value of the option selected, not the visible text.</p></comment>
+\r
+</function>
+\r
+<function name="typeKeys">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<param name="value">the value to type</param>
+\r
+<comment>Simulates keystroke events on the specified element, as though you typed the value key-by-key.
+
+<p>This is a convenience method for calling keyDown, keyUp, keyPress for every character in the specified string;
+this is useful for dynamic UI widgets (like auto-completing combo boxes) that require explicit key events.</p>
+
+<p>Unlike the simple "type" command, which forces the specified value into the page directly, this command
+may or may not have any visible effect, even in cases where typing keys would normally have a visible effect.
+For example, if you use "typeKeys" on a form element, you may or may not see the results of what you typed in
+the field.</p>
+<p>In some cases, you may need to use the simple "type" command to set the value of the field and then the "typeKeys" command to
+send the keystroke events corresponding to what you just typed.</p></comment>
+\r
+</function>
+\r
+<function name="setSpeed">
+\r
+<param name="value">the number of milliseconds to pause after operation</param>
+\r
+<comment>Set execution speed (i.e., set the millisecond length of a delay which will follow each selenium operation). By default, there is no such delay, i.e.,
+the delay is 0 milliseconds.</comment>
+\r
+</function>
+\r
+<function name="getSpeed">
+\r
+<comment>Get execution speed (i.e., get the millisecond length of the delay following each selenium operation). By default, there is no such delay, i.e.,
+the delay is 0 milliseconds.
+
+See also setSpeed.</comment>
+\r
+</function>
+\r
+<function name="check">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Check a toggle-button (checkbox/radio)</comment>
+\r
+</function>
+\r
+<function name="uncheck">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Uncheck a toggle-button (checkbox/radio)</comment>
+\r
+</function>
+\r
+<function name="select">
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<param name="optionLocator">an option locator (a label by default)</param>
+\r
+<comment>Select an option from a drop-down using an option locator.
+
+<p>
+Option locators provide different ways of specifying options of an HTML
+Select element (e.g. for selecting a specific option, or for asserting
+that the selected option satisfies a specification). There are several
+forms of Select Option Locator.
+</p>
+<ul>
+<li><strong>label</strong>=<em>labelPattern</em>:
+matches options based on their labels, i.e. the visible text. (This
+is the default.)
+<ul class="first last simple">
+<li>label=regexp:^[Oo]ther</li>
+</ul>
+</li>
+<li><strong>value</strong>=<em>valuePattern</em>:
+matches options based on their values.
+<ul class="first last simple">
+<li>value=other</li>
+</ul>
+
+
+</li>
+<li><strong>id</strong>=<em>id</em>:
+
+matches options based on their ids.
+<ul class="first last simple">
+<li>id=option1</li>
+</ul>
+</li>
+<li><strong>index</strong>=<em>index</em>:
+matches an option based on its index (offset from zero).
+<ul class="first last simple">
+
+<li>index=2</li>
+</ul>
+</li>
+</ul>
+<p>
+If no option locator prefix is provided, the default behaviour is to match on <strong>label</strong>.
+</p></comment>
+\r
+</function>
+\r
+<function name="addSelection">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a multi-select box</param>
+\r
+<param name="optionLocator">an option locator (a label by default)</param>
+\r
+<comment>Add a selection to the set of selected options in a multi-select element using an option locator.
+
+@see #doSelect for details of option locators</comment>
+\r
+</function>
+\r
+<function name="removeSelection">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a multi-select box</param>
+\r
+<param name="optionLocator">an option locator (a label by default)</param>
+\r
+<comment>Remove a selection from the set of selected options in a multi-select element using an option locator.
+
+@see #doSelect for details of option locators</comment>
+\r
+</function>
+\r
+<function name="removeAllSelections">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a multi-select box</param>
+\r
+<comment>Unselects all of the selected options in a multi-select element.</comment>
+\r
+</function>
+\r
+<function name="submit">
+\r
+<param name="formLocator">an <a href="#locators">element locator</a> for the form you want to submit</param>
+\r
+<comment>Submit the specified form. This is particularly useful for forms without
+submit buttons, e.g. single-input "Search" forms.</comment>
+\r
+</function>
+\r
+<function name="open">
+\r
+<param name="url">the URL to open; may be relative or absolute</param>
+\r
+<comment>Opens an URL in the test frame. This accepts both relative and absolute
+URLs.
+
+The "open" command waits for the page to load before proceeding,
+ie. the "AndWait" suffix is implicit.
+
+<em>Note</em>: The URL must be on the same domain as the runner HTML
+due to security restrictions in the browser (Same Origin Policy). If you
+need to open an URL on another domain, use the Selenium Server to start a
+new browser session on that domain.</comment>
+\r
+</function>
+\r
+<function name="openWindow">
+\r
+<param name="url">the URL to open, which can be blank</param>
+\r
+<param name="windowID">the JavaScript window ID of the window to select</param>
+\r
+<comment>Opens a popup window (if a window with that ID isn't already open).
+After opening the window, you'll need to select it using the selectWindow
+command.
+
+<p>This command can also be a useful workaround for bug SEL-339. In some cases, Selenium will be unable to intercept a call to window.open (if the call occurs during or before the "onLoad" event, for example).
+In those cases, you can force Selenium to notice the open window's name by using the Selenium openWindow command, using
+an empty (blank) url, like this: openWindow("", "myFunnyWindow").</p></comment>
+\r
+</function>
+\r
+<function name="selectWindow">
+\r
+<param name="windowID">the JavaScript window ID of the window to select</param>
+\r
+<comment>Selects a popup window; once a popup window has been selected, all
+commands go to that window. To select the main window again, use null
+as the target.
+
+<p>Note that there is a big difference between a window's internal JavaScript "name" property
+and the "title" of a given window's document (which is normally what you actually see, as an end user,
+in the title bar of the window). The "name" is normally invisible to the end-user; it's the second
+parameter "windowName" passed to the JavaScript method window.open(url, windowName, windowFeatures, replaceFlag)
+(which selenium intercepts).</p>
+
+<p>Selenium has several strategies for finding the window object referred to by the "windowID" parameter.</p>
+
+<p>1.) if windowID is null, (or the string "null") then it is assumed the user is referring to the original window instantiated by the browser).</p>
+<p>2.) if the value of the "windowID" parameter is a JavaScript variable name in the current application window, then it is assumed
+that this variable contains the return value from a call to the JavaScript window.open() method.</p>
+<p>3.) Otherwise, selenium looks in a hash it maintains that maps string names to window "names".</p>
+<p>4.) If <i>that</i> fails, we'll try looping over all of the known windows to try to find the appropriate "title".
+Since "title" is not necessarily unique, this may have unexpected behavior.</p>
+
+<p>If you're having trouble figuring out what is the name of a window that you want to manipulate, look at the selenium log messages
+which identify the names of windows created via window.open (and therefore intercepted by selenium). You will see messages
+like the following for each window as it is opened:</p>
+
+<p><code>debug: window.open call intercepted; window ID (which you can use with selectWindow()) is "myNewWindow"</code></p>
+
+<p>In some cases, Selenium will be unable to intercept a call to window.open (if the call occurs during or before the "onLoad" event, for example).
+(This is bug SEL-339.) In those cases, you can force Selenium to notice the open window's name by using the Selenium openWindow command, using
+an empty (blank) url, like this: openWindow("", "myFunnyWindow").</p></comment>
+\r
+</function>
+\r
+<function name="selectFrame">
+\r
+<param name="locator">an <a href="#locators">element locator</a> identifying a frame or iframe</param>
+\r
+<comment>Selects a frame within the current window. (You may invoke this command
+multiple times to select nested frames.) To select the parent frame, use
+"relative=parent" as a locator; to select the top frame, use "relative=top".
+You can also select a frame by its 0-based index number; select the first frame with
+"index=0", or the third frame with "index=2".
+
+<p>You may also use a DOM expression to identify the frame you want directly,
+like this: <code>dom=frames["main"].frames["subframe"]</code></p></comment>
+\r
+</function>
+\r
+<function name="getWhetherThisFrameMatchFrameExpression">
+\r
+<return type="boolean">true if the new frame is this code's window</return>
+\r
+<param name="currentFrameString">starting frame</param>
+\r
+<param name="target">new frame (which might be relative to the current one)</param>
+\r
+<comment>Determine whether current/locator identify the frame containing this running code.
+
+<p>This is useful in proxy injection mode, where this code runs in every
+browser frame and window, and sometimes the selenium server needs to identify
+the "current" frame. In this case, when the test calls selectFrame, this
+routine is called for each frame to figure out which one has been selected.
+The selected frame will return true, while all others will return false.</p></comment>
+\r
+</function>
+\r
+<function name="getWhetherThisWindowMatchWindowExpression">
+\r
+<return type="boolean">true if the new window is this code's window</return>
+\r
+<param name="currentWindowString">starting window</param>
+\r
+<param name="target">new window (which might be relative to the current one, e.g., "_parent")</param>
+\r
+<comment>Determine whether currentWindowString plus target identify the window containing this running code.
+
+<p>This is useful in proxy injection mode, where this code runs in every
+browser frame and window, and sometimes the selenium server needs to identify
+the "current" window. In this case, when the test calls selectWindow, this
+routine is called for each window to figure out which one has been selected.
+The selected window will return true, while all others will return false.</p></comment>
+\r
+</function>
+\r
+<function name="waitForPopUp">
+\r
+<param name="windowID">the JavaScript window ID of the window that will appear</param>
+\r
+<param name="timeout">a timeout in milliseconds, after which the action will return with an error</param>
+\r
+<comment>Waits for a popup window to appear and load up.</comment>
+\r
+</function>
+\r
+<function name="chooseCancelOnNextConfirmation">
+\r
+<comment>By default, Selenium's overridden window.confirm() function will
+return true, as if the user had manually clicked OK; after running
+this command, the next call to confirm() will return false, as if
+the user had clicked Cancel. Selenium will then resume using the
+default behavior for future confirmations, automatically returning
+true (OK) unless/until you explicitly call this command for each
+confirmation.</comment>
+\r
+</function>
+\r
+<function name="chooseOkOnNextConfirmation">
+\r
+<comment>Undo the effect of calling chooseCancelOnNextConfirmation. Note
+that Selenium's overridden window.confirm() function will normally automatically
+return true, as if the user had manually clicked OK, so you shouldn't
+need to use this command unless for some reason you need to change
+your mind prior to the next confirmation. After any confirmation, Selenium will resume using the
+default behavior for future confirmations, automatically returning
+true (OK) unless/until you explicitly call chooseCancelOnNextConfirmation for each
+confirmation.</comment>
+\r
+</function>
+\r
+<function name="answerOnNextPrompt">
+\r
+<param name="answer">the answer to give in response to the prompt pop-up</param>
+\r
+<comment>Instructs Selenium to return the specified answer string in response to
+the next JavaScript prompt [window.prompt()].</comment>
+\r
+</function>
+\r
+<function name="goBack">
+\r
+<comment>Simulates the user clicking the "back" button on their browser.</comment>
+\r
+</function>
+\r
+<function name="refresh">
+\r
+<comment>Simulates the user clicking the "Refresh" button on their browser.</comment>
+\r
+</function>
+\r
+<function name="close">
+\r
+<comment>Simulates the user clicking the "close" button in the titlebar of a popup
+window or tab.</comment>
+\r
+</function>
+\r
+<function name="isAlertPresent">
+\r
+<return type="boolean">true if there is an alert</return>
+\r
+<comment>Has an alert occurred?
+
+<p>
+This function never throws an exception
+</p></comment>
+\r
+</function>
+\r
+<function name="isPromptPresent">
+\r
+<return type="boolean">true if there is a pending prompt</return>
+\r
+<comment>Has a prompt occurred?
+
+<p>
+This function never throws an exception
+</p></comment>
+\r
+</function>
+\r
+<function name="isConfirmationPresent">
+\r
+<return type="boolean">true if there is a pending confirmation</return>
+\r
+<comment>Has confirm() been called?
+
+<p>
+This function never throws an exception
+</p></comment>
+\r
+</function>
+\r
+<function name="getAlert">
+\r
+<return type="string">The message of the most recent JavaScript alert</return>
+\r
+<comment>Retrieves the message of a JavaScript alert generated during the previous action, or fail if there were no alerts.
+
+<p>Getting an alert has the same effect as manually clicking OK. If an
+alert is generated but you do not get/verify it, the next Selenium action
+will fail.</p>
+
+<p>NOTE: under Selenium, JavaScript alerts will NOT pop up a visible alert
+dialog.</p>
+
+<p>NOTE: Selenium does NOT support JavaScript alerts that are generated in a
+page's onload() event handler. In this case a visible dialog WILL be
+generated and Selenium will hang until someone manually clicks OK.</p></comment>
+\r
+</function>
+\r
+<function name="getConfirmation">
+\r
+<return type="string">the message of the most recent JavaScript confirmation dialog</return>
+\r
+<comment>Retrieves the message of a JavaScript confirmation dialog generated during
+the previous action.
+
+<p>
+By default, the confirm function will return true, having the same effect
+as manually clicking OK. This can be changed by prior execution of the
+chooseCancelOnNextConfirmation command. If an confirmation is generated
+but you do not get/verify it, the next Selenium action will fail.
+</p>
+
+<p>
+NOTE: under Selenium, JavaScript confirmations will NOT pop up a visible
+dialog.
+</p>
+
+<p>
+NOTE: Selenium does NOT support JavaScript confirmations that are
+generated in a page's onload() event handler. In this case a visible
+dialog WILL be generated and Selenium will hang until you manually click
+OK.
+</p></comment>
+\r
+</function>
+\r
+<function name="getPrompt">
+\r
+<return type="string">the message of the most recent JavaScript question prompt</return>
+\r
+<comment>Retrieves the message of a JavaScript question prompt dialog generated during
+the previous action.
+
+<p>Successful handling of the prompt requires prior execution of the
+answerOnNextPrompt command. If a prompt is generated but you
+do not get/verify it, the next Selenium action will fail.</p>
+
+<p>NOTE: under Selenium, JavaScript prompts will NOT pop up a visible
+dialog.</p>
+
+<p>NOTE: Selenium does NOT support JavaScript prompts that are generated in a
+page's onload() event handler. In this case a visible dialog WILL be
+generated and Selenium will hang until someone manually clicks OK.</p></comment>
+\r
+</function>
+\r
+<function name="getLocation">
+\r
+<return type="string">the absolute URL of the current page</return>
+\r
+<comment>Gets the absolute URL of the current page.</comment>
+\r
+</function>
+\r
+<function name="getTitle">
+\r
+<return type="string">the title of the current page</return>
+\r
+<comment>Gets the title of the current page.</comment>
+\r
+</function>
+\r
+<function name="getBodyText">
+\r
+<return type="string">the entire text of the page</return>
+\r
+<comment>Gets the entire text of the page.</comment>
+\r
+</function>
+\r
+<function name="getValue">
+\r
+<return type="string">the element value, or "on/off" for checkbox/radio elements</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Gets the (whitespace-trimmed) value of an input field (or anything else with a value parameter).
+For checkbox/radio elements, the value will be "on" or "off" depending on
+whether the element is checked or not.</comment>
+\r
+</function>
+\r
+<function name="getText">
+\r
+<return type="string">the text of the element</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Gets the text of an element. This works for any element that contains
+text. This command uses either the textContent (Mozilla-like browsers) or
+the innerText (IE-like browsers) of the element, which is the rendered
+text shown to the user.</comment>
+\r
+</function>
+\r
+<function name="highlight">
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Briefly changes the backgroundColor of the specified element yellow. Useful for debugging.</comment>
+\r
+</function>
+\r
+<function name="getEval">
+\r
+<return type="string">the results of evaluating the snippet</return>
+\r
+<param name="script">the JavaScript snippet to run</param>
+\r
+<comment>Gets the result of evaluating the specified JavaScript snippet. The snippet may
+have multiple lines, but only the result of the last line will be returned.
+
+<p>Note that, by default, the snippet will run in the context of the "selenium"
+object itself, so <code>this</code> will refer to the Selenium object. Use <code>window</code> to
+refer to the window of your application, e.g. <code>window.document.getElementById('foo')</code></p>
+
+<p>If you need to use
+a locator to refer to a single element in your application page, you can
+use <code>this.browserbot.findElement("id=foo")</code> where "id=foo" is your locator.</p></comment>
+\r
+</function>
+\r
+<function name="isChecked">
+\r
+<return type="boolean">true if the checkbox is checked, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to a checkbox or radio button</param>
+\r
+<comment>Gets whether a toggle-button (checkbox/radio) is checked. Fails if the specified element doesn't exist or isn't a toggle-button.</comment>
+\r
+</function>
+\r
+<function name="getTable">
+\r
+<return type="string">the text from the specified cell</return>
+\r
+<param name="tableCellAddress">a cell address, e.g. "foo.1.4"</param>
+\r
+<comment>Gets the text from a cell of a table. The cellAddress syntax
+tableLocator.row.column, where row and column start at 0.</comment>
+\r
+</function>
+\r
+<function name="getSelectedLabels">
+\r
+<return type="string[]">an array of all selected option labels in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option labels (visible text) for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedLabel">
+\r
+<return type="string">the selected option label in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option label (visible text) for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedValues">
+\r
+<return type="string[]">an array of all selected option values in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option values (value attributes) for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedValue">
+\r
+<return type="string">the selected option value in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option value (value attribute) for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedIndexes">
+\r
+<return type="string[]">an array of all selected option indexes in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option indexes (option number, starting at 0) for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedIndex">
+\r
+<return type="string">the selected option index in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option index (option number, starting at 0) for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedIds">
+\r
+<return type="string[]">an array of all selected option IDs in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option element IDs for selected options in the specified select or multi-select element.</comment>
+\r
+</function>
+\r
+<function name="getSelectedId">
+\r
+<return type="string">the selected option ID in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets option element ID for selected option in the specified select element.</comment>
+\r
+</function>
+\r
+<function name="isSomethingSelected">
+\r
+<return type="boolean">true if some option has been selected, false otherwise</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Determines whether some option in a drop-down menu is selected.</comment>
+\r
+</function>
+\r
+<function name="getSelectOptions">
+\r
+<return type="string[]">an array of all option labels in the specified select drop-down</return>
+\r
+<param name="selectLocator">an <a href="#locators">element locator</a> identifying a drop-down menu</param>
+\r
+<comment>Gets all option labels in the specified select drop-down.</comment>
+\r
+</function>
+\r
+<function name="getAttribute">
+\r
+<return type="string">the value of the specified attribute</return>
+\r
+<param name="attributeLocator">an element locator followed by an @ sign and then the name of the attribute, e.g. "foo@bar"</param>
+\r
+<comment>Gets the value of an element attribute.</comment>
+\r
+</function>
+\r
+<function name="isTextPresent">
+\r
+<return type="boolean">true if the pattern matches the text, false otherwise</return>
+\r
+<param name="pattern">a <a href="#patterns">pattern</a> to match with the text of the page</param>
+\r
+<comment>Verifies that the specified text pattern appears somewhere on the rendered page shown to the user.</comment>
+\r
+</function>
+\r
+<function name="isElementPresent">
+\r
+<return type="boolean">true if the element is present, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Verifies that the specified element is somewhere on the page.</comment>
+\r
+</function>
+\r
+<function name="isVisible">
+\r
+<return type="boolean">true if the specified element is visible, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Determines if the specified element is visible. An
+element can be rendered invisible by setting the CSS "visibility"
+property to "hidden", or the "display" property to "none", either for the
+element itself or one if its ancestors. This method will fail if
+the element is not present.</comment>
+\r
+</function>
+\r
+<function name="isEditable">
+\r
+<return type="boolean">true if the input element is editable, false otherwise</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a></param>
+\r
+<comment>Determines whether the specified input element is editable, ie hasn't been disabled.
+This method will fail if the specified element isn't an input element.</comment>
+\r
+</function>
+\r
+<function name="getAllButtons">
+\r
+<return type="string[]">the IDs of all buttons on the page</return>
+\r
+<comment>Returns the IDs of all buttons on the page.
+
+<p>If a given button has no ID, it will appear as "" in this array.</p></comment>
+\r
+</function>
+\r
+<function name="getAllLinks">
+\r
+<return type="string[]">the IDs of all links on the page</return>
+\r
+<comment>Returns the IDs of all links on the page.
+
+<p>If a given link has no ID, it will appear as "" in this array.</p></comment>
+\r
+</function>
+\r
+<function name="getAllFields">
+\r
+<return type="string[]">the IDs of all field on the page</return>
+\r
+<comment>Returns the IDs of all input fields on the page.
+
+<p>If a given field has no ID, it will appear as "" in this array.</p></comment>
+\r
+</function>
+\r
+<function name="getAttributeFromAllWindows">
+\r
+<return type="string[]">the set of values of this attribute from all known windows.</return>
+\r
+<param name="attributeName">name of an attribute on the windows</param>
+\r
+<comment>Returns every instance of some attribute from all known windows.</comment>
+\r
+</function>
+\r
+<function name="dragdrop">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="movementsString">offset in pixels from the current location to which the element should be moved, e.g., "+70,-300"</param>
+\r
+<comment>deprecated - use dragAndDrop instead</comment>
+\r
+</function>
+\r
+<function name="setMouseSpeed">
+\r
+<param name="pixels">the number of pixels between "mousemove" events</param>
+\r
+<comment>Configure the number of pixels between "mousemove" events during dragAndDrop commands (default=10).
+<p>Setting this value to 0 means that we'll send a "mousemove" event to every single pixel
+in between the start location and the end location; that can be very slow, and may
+cause some browsers to force the JavaScript to timeout.</p>
+
+<p>If the mouse speed is greater than the distance between the two dragged objects, we'll
+just send one "mousemove" at the start location and then one final one at the end location.</p></comment>
+\r
+</function>
+\r
+<function name="getMouseSpeed">
+\r
+<return type="number">the number of pixels between "mousemove" events during dragAndDrop commands (default=10)</return>
+\r
+<comment>Returns the number of pixels between "mousemove" events during dragAndDrop commands (default=10).</comment>
+\r
+</function>
+\r
+<function name="dragAndDrop">
+\r
+<param name="locator">an element locator</param>
+\r
+<param name="movementsString">offset in pixels from the current location to which the element should be moved, e.g., "+70,-300"</param>
+\r
+<comment>Drags an element a certain distance and then drops it</comment>
+\r
+</function>
+\r
+<function name="dragAndDropToObject">
+\r
+<param name="locatorOfObjectToBeDragged">an element to be dragged</param>
+\r
+<param name="locatorOfDragDestinationObject">an element whose location (i.e., whose center-most pixel) will be the point where locatorOfObjectToBeDragged is dropped</param>
+\r
+<comment>Drags an element and drops it on another element</comment>
+\r
+</function>
+\r
+<function name="windowFocus">
+\r
+<comment>Gives focus to the currently selected window</comment>
+\r
+</function>
+\r
+<function name="windowMaximize">
+\r
+<comment>Resize currently selected window to take up the entire screen</comment>
+\r
+</function>
+\r
+<function name="getAllWindowIds">
+\r
+<return type="string[]">the IDs of all windows that the browser knows about.</return>
+\r
+<comment>Returns the IDs of all windows that the browser knows about.</comment>
+\r
+</function>
+\r
+<function name="getAllWindowNames">
+\r
+<return type="string[]">the names of all windows that the browser knows about.</return>
+\r
+<comment>Returns the names of all windows that the browser knows about.</comment>
+\r
+</function>
+\r
+<function name="getAllWindowTitles">
+\r
+<return type="string[]">the titles of all windows that the browser knows about.</return>
+\r
+<comment>Returns the titles of all windows that the browser knows about.</comment>
+\r
+</function>
+\r
+<function name="getHtmlSource">
+\r
+<return type="string">the entire HTML source</return>
+\r
+<comment>Returns the entire HTML source between the opening and
+closing "html" tags.</comment>
+\r
+</function>
+\r
+<function name="setCursorPosition">
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an input element or textarea</param>
+\r
+<param name="position">the numerical position of the cursor in the field; position should be 0 to move the position to the beginning of the field. You can also set the cursor to -1 to move it to the end of the field.</param>
+\r
+<comment>Moves the text cursor to the specified position in the given input element or textarea.
+This method will fail if the specified element isn't an input element or textarea.</comment>
+\r
+</function>
+\r
+<function name="getElementIndex">
+\r
+<return type="number">of relative index of the element to its parent (starting from 0)</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<comment>Get the relative index of an element to its parent (starting from 0). The comment node and empty text node
+will be ignored.</comment>
+\r
+</function>
+\r
+<function name="isOrdered">
+\r
+<return type="boolean">true if element1 is the previous sibling of element2, false otherwise</return>
+\r
+<param name="locator1">an <a href="#locators">element locator</a> pointing to the first element</param>
+\r
+<param name="locator2">an <a href="#locators">element locator</a> pointing to the second element</param>
+\r
+<comment>Check if these two elements have same parent and are ordered siblings in the DOM. Two same elements will
+not be considered ordered.</comment>
+\r
+</function>
+\r
+<function name="getElementPositionLeft">
+\r
+<return type="number">of pixels from the edge of the frame.</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element OR an element itself</param>
+\r
+<comment>Retrieves the horizontal position of an element</comment>
+\r
+</function>
+\r
+<function name="getElementPositionTop">
+\r
+<return type="number">of pixels from the edge of the frame.</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element OR an element itself</param>
+\r
+<comment>Retrieves the vertical position of an element</comment>
+\r
+</function>
+\r
+<function name="getElementWidth">
+\r
+<return type="number">width of an element in pixels</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<comment>Retrieves the width of an element</comment>
+\r
+</function>
+\r
+<function name="getElementHeight">
+\r
+<return type="number">height of an element in pixels</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<comment>Retrieves the height of an element</comment>
+\r
+</function>
+\r
+<function name="getCursorPosition">
+\r
+<return type="number">the numerical position of the cursor in the field</return>
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an input element or textarea</param>
+\r
+<comment>Retrieves the text cursor position in the given input element or textarea; beware, this may not work perfectly on all browsers.
+
+<p>Specifically, if the cursor/selection has been cleared by JavaScript, this command will tend to
+return the position of the last location of the cursor, even though the cursor is now gone from the page. This is filed as <a href="http://jira.openqa.org/browse/SEL-243">SEL-243</a>.</p>
+This method will fail if the specified element isn't an input element or textarea, or there is no cursor in the element.</comment>
+\r
+</function>
+\r
+<function name="getExpression">
+\r
+<return type="string">the value passed in</return>
+\r
+<param name="expression">the value to return</param>
+\r
+<comment>Returns the specified expression.
+
+<p>This is useful because of JavaScript preprocessing.
+It is used to generate commands like assertExpression and waitForExpression.</p></comment>
+\r
+</function>
+\r
+<function name="getXpathCount">
+\r
+<return type="number">the number of nodes that match the specified xpath</return>
+\r
+<param name="xpath">the xpath expression to evaluate. do NOT wrap this expression in a 'count()' function; we will do that for you.</param>
+\r
+<comment>Returns the number of nodes that match the specified xpath, eg. "//table" would give
+the number of tables.</comment>
+\r
+</function>
+\r
+<function name="assignId">
+\r
+<param name="locator">an <a href="#locators">element locator</a> pointing to an element</param>
+\r
+<param name="identifier">a string to be used as the ID of the specified element</param>
+\r
+<comment>Temporarily sets the "id" attribute of the specified element, so you can locate it in the future
+using its ID rather than a slow/complicated XPath. This ID will disappear once the page is
+reloaded.</comment>
+\r
+</function>
+\r
+<function name="allowNativeXpath">
+\r
+<param name="allow">boolean, true means we'll prefer to use native XPath; false means we'll only use JS XPath</param>
+\r
+<comment>Specifies whether Selenium should use the native in-browser implementation
+of XPath (if any native version is available); if you pass "false" to
+this function, we will always use our pure-JavaScript xpath library.
+Using the pure-JS xpath library can improve the consistency of xpath
+element locators between different browser vendors, but the pure-JS
+version is much slower than the native implementations.</comment>
+\r
+</function>
+\r
+<function name="waitForCondition">
+\r
+<param name="script">the JavaScript snippet to run</param>
+\r
+<param name="timeout">a timeout in milliseconds, after which this command will return with an error</param>
+\r
+<comment>Runs the specified JavaScript snippet repeatedly until it evaluates to "true".
+The snippet may have multiple lines, but only the result of the last line
+will be considered.
+
+<p>Note that, by default, the snippet will be run in the runner's test window, not in the window
+of your application. To get the window of your application, you can use
+the JavaScript snippet <code>selenium.browserbot.getCurrentWindow()</code>, and then
+run your JavaScript in there</p></comment>
+\r
+</function>
+\r
+<function name="setTimeout">
+\r
+<param name="timeout">a timeout in milliseconds, after which the action will return with an error</param>
+\r
+<comment>Specifies the amount of time that Selenium will wait for actions to complete.
+
+<p>Actions that require waiting include "open" and the "waitFor*" actions.</p>
+The default timeout is 30 seconds.</comment>
+\r
+</function>
+\r
+<function name="waitForPageToLoad">
+\r
+<param name="timeout">a timeout in milliseconds, after which this command will return with an error</param>
+\r
+<comment>Waits for a new page to load.
+
+<p>You can use this command instead of the "AndWait" suffixes, "clickAndWait", "selectAndWait", "typeAndWait" etc.
+(which are only available in the JS API).</p>
+
+<p>Selenium constantly keeps track of new pages loading, and sets a "newPageLoaded"
+flag when it first notices a page load. Running any other Selenium command after
+turns the flag to false. Hence, if you want to wait for a page to load, you must
+wait immediately after a Selenium command that caused a page-load.</p></comment>
+\r
+</function>
+\r
+<function name="waitForFrameToLoad">
+\r
+<param name="frameAddress">FrameAddress from the server side</param>
+\r
+<param name="timeout">a timeout in milliseconds, after which this command will return with an error</param>
+\r
+<comment>Waits for a new frame to load.
+
+<p>Selenium constantly keeps track of new pages and frames loading,
+and sets a "newPageLoaded" flag when it first notices a page load.</p>
+
+See waitForPageToLoad for more information.</comment>
+\r
+</function>
+\r
+<function name="getCookie">
+\r
+<return type="string">all cookies of the current page under test</return>
+\r
+<comment>Return all cookies of the current page under test.</comment>
+\r
+</function>
+\r
+<function name="createCookie">
+\r
+<param name="nameValuePair">name and value of the cookie in a format "name=value"</param>
+\r
+<param name="optionsString">options for the cookie. Currently supported options include 'path' and 'max_age'. the optionsString's format is "path=/path/, max_age=60". The order of options are irrelevant, the unit of the value of 'max_age' is second.</param>
+\r
+<comment>Create a new cookie whose path and domain are same with those of current page
+under test, unless you specified a path for this cookie explicitly.</comment>
+\r
+</function>
+\r
+<function name="deleteCookie">
+\r
+<param name="name">the name of the cookie to be deleted</param>
+\r
+<param name="path">the path property of the cookie to be deleted</param>
+\r
+<comment>Delete a named cookie with specified path.</comment>
+\r
+</function>
+\r
+<function name="setBrowserLogLevel">
+\r
+<param name="logLevel">one of the following: "debug", "info", "warn", "error" or "off"</param>
+\r
+<comment>Sets the threshold for browser-side logging messages; log messages beneath this threshold will be discarded.
+Valid logLevel strings are: "debug", "info", "warn", "error" or "off".
+To see the browser logs, you need to
+either show the log window in GUI mode, or enable browser-side logging in Selenium RC.</comment>
+\r
+</function>
+\r
+<function name="runScript">
+\r
+<param name="script">the JavaScript snippet to run</param>
+\r
+<comment>Creates a new "script" tag in the body of the current test window, and
+adds the specified text into the body of the command. Scripts run in
+this way can often be debugged more easily than scripts executed using
+Selenium's "getEval" command. Beware that JS exceptions thrown in these script
+tags aren't managed by Selenium, so you should probably wrap your script
+in try/catch blocks if there is any chance that the script will throw
+an exception.</comment>
+\r
+</function>
+\r
+<function name="addLocationStrategy">
+\r
+<param name="strategyName">the name of the strategy to define; this should use only letters [a-zA-Z] with no spaces or other punctuation.</param>
+\r
+<param name="functionDefinition">a string defining the body of a function in JavaScript. For example: <code>return inDocument.getElementById(locator);</code></param>
+\r
+<comment>Defines a new function for Selenium to locate elements on the page.
+For example,
+if you define the strategy "foo", and someone runs click("foo=blah"), we'll
+run your function, passing you the string "blah", and click on the element
+that your function
+returns, or throw an "Element not found" error if your function returns null.
+
+We'll pass three arguments to your function:
+<ul>
+<li>locator: the string the user passed in</li>
+<li>inWindow: the currently selected window</li>
+<li>inDocument: the currently selected document</li>
+</ul>
+The function must return null if the element can't be found.</comment>
+\r
+</function>
+\r
+<function name="setContext">
+\r
+<param name="context">the message to be sent to the browser</param>
+\r
+<comment>Writes a message to the status bar and adds a note to the browser-side
+log.</comment>
+\r
+</function>
+\r
+<function name="captureScreenshot">
+\r
+<param name="filename">the absolute path to the file to be written, e.g. "c:\blah\screenshot.png"</param>
+\r
+<comment>Captures a PNG screenshot to the specified file.</comment>
+\r
+</function>
+\r
+</apidoc>\r
--- /dev/null
+/*\r
+ cssQuery, version 2.0.2 (2005-08-19)\r
+ Copyright: 2004-2005, Dean Edwards (http://dean.edwards.name/)\r
+ License: http://creativecommons.org/licenses/LGPL/2.1/\r
+*/\r
+eval(function(p,a,c,k,e,d){e=function(c){return(c<a?'':e(parseInt(c/a)))+((c=c%a)>35?String.fromCharCode(c+29):c.toString(36))};if(!''.replace(/^/,String)){while(c--)d[e(c)]=k[c]||e(c);k=[function(e){return d[e]}];e=function(){return'\\w+'};c=1};while(c--)if(k[c])p=p.replace(new RegExp('\\b'+e(c)+'\\b','g'),k[c]);return p}('7 x=6(){7 1D="2.0.2";7 C=/\\s*,\\s*/;7 x=6(s,A){33{7 m=[];7 u=1z.32.2c&&!A;7 b=(A)?(A.31==22)?A:[A]:[1g];7 1E=18(s).1l(C),i;9(i=0;i<1E.y;i++){s=1y(1E[i]);8(U&&s.Z(0,3).2b("")==" *#"){s=s.Z(2);A=24([],b,s[1])}1A A=b;7 j=0,t,f,a,c="";H(j<s.y){t=s[j++];f=s[j++];c+=t+f;a="";8(s[j]=="("){H(s[j++]!=")")a+=s[j];a=a.Z(0,-1);c+="("+a+")"}A=(u&&V[c])?V[c]:21(A,t,f,a);8(u)V[c]=A}m=m.30(A)}2a x.2d;5 m}2Z(e){x.2d=e;5[]}};x.1Z=6(){5"6 x() {\\n [1D "+1D+"]\\n}"};7 V={};x.2c=L;x.2Y=6(s){8(s){s=1y(s).2b("");2a V[s]}1A V={}};7 29={};7 19=L;x.15=6(n,s){8(19)1i("s="+1U(s));29[n]=12 s()};x.2X=6(c){5 c?1i(c):o};7 D={};7 h={};7 q={P:/\\[([\\w-]+(\\|[\\w-]+)?)\\s*(\\W?=)?\\s*([^\\]]*)\\]/};7 T=[];D[" "]=6(r,f,t,n){7 e,i,j;9(i=0;i<f.y;i++){7 s=X(f[i],t,n);9(j=0;(e=s[j]);j++){8(M(e)&&14(e,n))r.z(e)}}};D["#"]=6(r,f,i){7 e,j;9(j=0;(e=f[j]);j++)8(e.B==i)r.z(e)};D["."]=6(r,f,c){c=12 1t("(^|\\\\s)"+c+"(\\\\s|$)");7 e,i;9(i=0;(e=f[i]);i++)8(c.l(e.1V))r.z(e)};D[":"]=6(r,f,p,a){7 t=h[p],e,i;8(t)9(i=0;(e=f[i]);i++)8(t(e,a))r.z(e)};h["2W"]=6(e){7 d=Q(e);8(d.1C)9(7 i=0;i<d.1C.y;i++){8(d.1C[i]==e)5 K}};h["2V"]=6(e){};7 M=6(e){5(e&&e.1c==1&&e.1f!="!")?e:23};7 16=6(e){H(e&&(e=e.2U)&&!M(e))28;5 e};7 G=6(e){H(e&&(e=e.2T)&&!M(e))28;5 e};7 1r=6(e){5 M(e.27)||G(e.27)};7 1P=6(e){5 M(e.26)||16(e.26)};7 1o=6(e){7 c=[];e=1r(e);H(e){c.z(e);e=G(e)}5 c};7 U=K;7 1h=6(e){7 d=Q(e);5(2S d.25=="2R")?/\\.1J$/i.l(d.2Q):2P(d.25=="2O 2N")};7 Q=6(e){5 e.2M||e.1g};7 X=6(e,t){5(t=="*"&&e.1B)?e.1B:e.X(t)};7 17=6(e,t,n){8(t=="*")5 M(e);8(!14(e,n))5 L;8(!1h(e))t=t.2L();5 e.1f==t};7 14=6(e,n){5!n||(n=="*")||(e.2K==n)};7 1e=6(e){5 e.1G};6 24(r,f,B){7 m,i,j;9(i=0;i<f.y;i++){8(m=f[i].1B.2J(B)){8(m.B==B)r.z(m);1A 8(m.y!=23){9(j=0;j<m.y;j++){8(m[j].B==B)r.z(m[j])}}}}5 r};8(![].z)22.2I.z=6(){9(7 i=0;i<1z.y;i++){o[o.y]=1z[i]}5 o.y};7 N=/\\|/;6 21(A,t,f,a){8(N.l(f)){f=f.1l(N);a=f[0];f=f[1]}7 r=[];8(D[t]){D[t](r,A,f,a)}5 r};7 S=/^[^\\s>+~]/;7 20=/[\\s#.:>+~()@]|[^\\s#.:>+~()@]+/g;6 1y(s){8(S.l(s))s=" "+s;5 s.P(20)||[]};7 W=/\\s*([\\s>+~(),]|^|$)\\s*/g;7 I=/([\\s>+~,]|[^(]\\+|^)([#.:@])/g;7 18=6(s){5 s.O(W,"$1").O(I,"$1*$2")};7 1u={1Z:6(){5"\'"},P:/^(\'[^\']*\')|("[^"]*")$/,l:6(s){5 o.P.l(s)},1S:6(s){5 o.l(s)?s:o+s+o},1Y:6(s){5 o.l(s)?s.Z(1,-1):s}};7 1s=6(t){5 1u.1Y(t)};7 E=/([\\/()[\\]?{}|*+-])/g;6 R(s){5 s.O(E,"\\\\$1")};x.15("1j-2H",6(){D[">"]=6(r,f,t,n){7 e,i,j;9(i=0;i<f.y;i++){7 s=1o(f[i]);9(j=0;(e=s[j]);j++)8(17(e,t,n))r.z(e)}};D["+"]=6(r,f,t,n){9(7 i=0;i<f.y;i++){7 e=G(f[i]);8(e&&17(e,t,n))r.z(e)}};D["@"]=6(r,f,a){7 t=T[a].l;7 e,i;9(i=0;(e=f[i]);i++)8(t(e))r.z(e)};h["2G-10"]=6(e){5!16(e)};h["1x"]=6(e,c){c=12 1t("^"+c,"i");H(e&&!e.13("1x"))e=e.1n;5 e&&c.l(e.13("1x"))};q.1X=/\\\\:/g;q.1w="@";q.J={};q.O=6(m,a,n,c,v){7 k=o.1w+m;8(!T[k]){a=o.1W(a,c||"",v||"");T[k]=a;T.z(a)}5 T[k].B};q.1Q=6(s){s=s.O(o.1X,"|");7 m;H(m=s.P(o.P)){7 r=o.O(m[0],m[1],m[2],m[3],m[4]);s=s.O(o.P,r)}5 s};q.1W=6(p,t,v){7 a={};a.B=o.1w+T.y;a.2F=p;t=o.J[t];t=t?t(o.13(p),1s(v)):L;a.l=12 2E("e","5 "+t);5 a};q.13=6(n){1d(n.2D()){F"B":5"e.B";F"2C":5"e.1V";F"9":5"e.2B";F"1T":8(U){5"1U((e.2A.P(/1T=\\\\1v?([^\\\\s\\\\1v]*)\\\\1v?/)||[])[1]||\'\')"}}5"e.13(\'"+n.O(N,":")+"\')"};q.J[""]=6(a){5 a};q.J["="]=6(a,v){5 a+"=="+1u.1S(v)};q.J["~="]=6(a,v){5"/(^| )"+R(v)+"( |$)/.l("+a+")"};q.J["|="]=6(a,v){5"/^"+R(v)+"(-|$)/.l("+a+")"};7 1R=18;18=6(s){5 1R(q.1Q(s))}});x.15("1j-2z",6(){D["~"]=6(r,f,t,n){7 e,i;9(i=0;(e=f[i]);i++){H(e=G(e)){8(17(e,t,n))r.z(e)}}};h["2y"]=6(e,t){t=12 1t(R(1s(t)));5 t.l(1e(e))};h["2x"]=6(e){5 e==Q(e).1H};h["2w"]=6(e){7 n,i;9(i=0;(n=e.1F[i]);i++){8(M(n)||n.1c==3)5 L}5 K};h["1N-10"]=6(e){5!G(e)};h["2v-10"]=6(e){e=e.1n;5 1r(e)==1P(e)};h["2u"]=6(e,s){7 n=x(s,Q(e));9(7 i=0;i<n.y;i++){8(n[i]==e)5 L}5 K};h["1O-10"]=6(e,a){5 1p(e,a,16)};h["1O-1N-10"]=6(e,a){5 1p(e,a,G)};h["2t"]=6(e){5 e.B==2s.2r.Z(1)};h["1M"]=6(e){5 e.1M};h["2q"]=6(e){5 e.1q===L};h["1q"]=6(e){5 e.1q};h["1L"]=6(e){5 e.1L};q.J["^="]=6(a,v){5"/^"+R(v)+"/.l("+a+")"};q.J["$="]=6(a,v){5"/"+R(v)+"$/.l("+a+")"};q.J["*="]=6(a,v){5"/"+R(v)+"/.l("+a+")"};6 1p(e,a,t){1d(a){F"n":5 K;F"2p":a="2n";1a;F"2o":a="2n+1"}7 1m=1o(e.1n);6 1k(i){7 i=(t==G)?1m.y-i:i-1;5 1m[i]==e};8(!Y(a))5 1k(a);a=a.1l("n");7 m=1K(a[0]);7 s=1K(a[1]);8((Y(m)||m==1)&&s==0)5 K;8(m==0&&!Y(s))5 1k(s);8(Y(s))s=0;7 c=1;H(e=t(e))c++;8(Y(m)||m==1)5(t==G)?(c<=s):(s>=c);5(c%m)==s}});x.15("1j-2m",6(){U=1i("L;/*@2l@8(@\\2k)U=K@2j@*/");8(!U){X=6(e,t,n){5 n?e.2i("*",t):e.X(t)};14=6(e,n){5!n||(n=="*")||(e.2h==n)};1h=1g.1I?6(e){5/1J/i.l(Q(e).1I)}:6(e){5 Q(e).1H.1f!="2g"};1e=6(e){5 e.2f||e.1G||1b(e)};6 1b(e){7 t="",n,i;9(i=0;(n=e.1F[i]);i++){1d(n.1c){F 11:F 1:t+=1b(n);1a;F 3:t+=n.2e;1a}}5 t}}});19=K;5 x}();',62,190,'|||||return|function|var|if|for||||||||pseudoClasses||||test|||this||AttributeSelector|||||||cssQuery|length|push|fr|id||selectors||case|nextElementSibling|while||tests|true|false|thisElement||replace|match|getDocument|regEscape||attributeSelectors|isMSIE|cache||getElementsByTagName|isNaN|slice|child||new|getAttribute|compareNamespace|addModule|previousElementSibling|compareTagName|parseSelector|loaded|break|_0|nodeType|switch|getTextContent|tagName|document|isXML|eval|css|_1|split|ch|parentNode|childElements|nthChild|disabled|firstElementChild|getText|RegExp|Quote|x22|PREFIX|lang|_2|arguments|else|all|links|version|se|childNodes|innerText|documentElement|contentType|xml|parseInt|indeterminate|checked|last|nth|lastElementChild|parse|_3|add|href|String|className|create|NS_IE|remove|toString|ST|select|Array|null|_4|mimeType|lastChild|firstChild|continue|modules|delete|join|caching|error|nodeValue|textContent|HTML|prefix|getElementsByTagNameNS|end|x5fwin32|cc_on|standard||odd|even|enabled|hash|location|target|not|only|empty|root|contains|level3|outerHTML|htmlFor|class|toLowerCase|Function|name|first|level2|prototype|item|scopeName|toUpperCase|ownerDocument|Document|XML|Boolean|URL|unknown|typeof|nextSibling|previousSibling|visited|link|valueOf|clearCache|catch|concat|constructor|callee|try'.split('|'),0,{}))\r
--- /dev/null
+/*\r
+ cssQuery, version 2.0.2 (2005-08-19)\r
+ Copyright: 2004-2005, Dean Edwards (http://dean.edwards.name/)\r
+ License: http://creativecommons.org/licenses/LGPL/2.1/\r
+*/\r
+\r
+cssQuery.addModule("css-level2", function() {\r
+\r
+// -----------------------------------------------------------------------\r
+// selectors\r
+// -----------------------------------------------------------------------\r
+\r
+// child selector\r
+selectors[">"] = function($results, $from, $tagName, $namespace) {\r
+ var $element, i, j;\r
+ for (i = 0; i < $from.length; i++) {\r
+ var $subset = childElements($from[i]);\r
+ for (j = 0; ($element = $subset[j]); j++)\r
+ if (compareTagName($element, $tagName, $namespace))\r
+ $results.push($element);\r
+ }\r
+};\r
+\r
+// sibling selector\r
+selectors["+"] = function($results, $from, $tagName, $namespace) {\r
+ for (var i = 0; i < $from.length; i++) {\r
+ var $element = nextElementSibling($from[i]);\r
+ if ($element && compareTagName($element, $tagName, $namespace))\r
+ $results.push($element);\r
+ }\r
+};\r
+\r
+// attribute selector\r
+selectors["@"] = function($results, $from, $attributeSelectorID) {\r
+ var $test = attributeSelectors[$attributeSelectorID].test;\r
+ var $element, i;\r
+ for (i = 0; ($element = $from[i]); i++)\r
+ if ($test($element)) $results.push($element);\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// pseudo-classes\r
+// -----------------------------------------------------------------------\r
+\r
+pseudoClasses["first-child"] = function($element) {\r
+ return !previousElementSibling($element);\r
+};\r
+\r
+pseudoClasses["lang"] = function($element, $code) {\r
+ $code = new RegExp("^" + $code, "i");\r
+ while ($element && !$element.getAttribute("lang")) $element = $element.parentNode;\r
+ return $element && $code.test($element.getAttribute("lang"));\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// attribute selectors\r
+// -----------------------------------------------------------------------\r
+\r
+// constants\r
+AttributeSelector.NS_IE = /\\:/g;\r
+AttributeSelector.PREFIX = "@";\r
+// properties\r
+AttributeSelector.tests = {};\r
+// methods\r
+AttributeSelector.replace = function($match, $attribute, $namespace, $compare, $value) {\r
+ var $key = this.PREFIX + $match;\r
+ if (!attributeSelectors[$key]) {\r
+ $attribute = this.create($attribute, $compare || "", $value || "");\r
+ // store the selector\r
+ attributeSelectors[$key] = $attribute;\r
+ attributeSelectors.push($attribute);\r
+ }\r
+ return attributeSelectors[$key].id;\r
+};\r
+AttributeSelector.parse = function($selector) {\r
+ $selector = $selector.replace(this.NS_IE, "|");\r
+ var $match;\r
+ while ($match = $selector.match(this.match)) {\r
+ var $replace = this.replace($match[0], $match[1], $match[2], $match[3], $match[4]);\r
+ $selector = $selector.replace(this.match, $replace);\r
+ }\r
+ return $selector;\r
+};\r
+AttributeSelector.create = function($propertyName, $test, $value) {\r
+ var $attributeSelector = {};\r
+ $attributeSelector.id = this.PREFIX + attributeSelectors.length;\r
+ $attributeSelector.name = $propertyName;\r
+ $test = this.tests[$test];\r
+ $test = $test ? $test(this.getAttribute($propertyName), getText($value)) : false;\r
+ $attributeSelector.test = new Function("e", "return " + $test);\r
+ return $attributeSelector;\r
+};\r
+AttributeSelector.getAttribute = function($name) {\r
+ switch ($name.toLowerCase()) {\r
+ case "id":\r
+ return "e.id";\r
+ case "class":\r
+ return "e.className";\r
+ case "for":\r
+ return "e.htmlFor";\r
+ case "href":\r
+ if (isMSIE) {\r
+ // IE always returns the full path not the fragment in the href attribute\r
+ // so we RegExp it out of outerHTML. Opera does the same thing but there\r
+ // is no way to get the original attribute.\r
+ return "String((e.outerHTML.match(/href=\\x22?([^\\s\\x22]*)\\x22?/)||[])[1]||'')";\r
+ }\r
+ }\r
+ return "e.getAttribute('" + $name.replace($NAMESPACE, ":") + "')";\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// attribute selector tests\r
+// -----------------------------------------------------------------------\r
+\r
+AttributeSelector.tests[""] = function($attribute) {\r
+ return $attribute;\r
+};\r
+\r
+AttributeSelector.tests["="] = function($attribute, $value) {\r
+ return $attribute + "==" + Quote.add($value);\r
+};\r
+\r
+AttributeSelector.tests["~="] = function($attribute, $value) {\r
+ return "/(^| )" + regEscape($value) + "( |$)/.test(" + $attribute + ")";\r
+};\r
+\r
+AttributeSelector.tests["|="] = function($attribute, $value) {\r
+ return "/^" + regEscape($value) + "(-|$)/.test(" + $attribute + ")";\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// parsing\r
+// -----------------------------------------------------------------------\r
+\r
+// override parseSelector to parse out attribute selectors\r
+var _parseSelector = parseSelector;\r
+parseSelector = function($selector) {\r
+ return _parseSelector(AttributeSelector.parse($selector));\r
+};\r
+\r
+}); // addModule\r
--- /dev/null
+/*\r
+ cssQuery, version 2.0.2 (2005-08-19)\r
+ Copyright: 2004-2005, Dean Edwards (http://dean.edwards.name/)\r
+ License: http://creativecommons.org/licenses/LGPL/2.1/\r
+*/\r
+\r
+/* Thanks to Bill Edney */\r
+\r
+cssQuery.addModule("css-level3", function() {\r
+\r
+// -----------------------------------------------------------------------\r
+// selectors\r
+// -----------------------------------------------------------------------\r
+\r
+// indirect sibling selector\r
+selectors["~"] = function($results, $from, $tagName, $namespace) {\r
+ var $element, i;\r
+ for (i = 0; ($element = $from[i]); i++) {\r
+ while ($element = nextElementSibling($element)) {\r
+ if (compareTagName($element, $tagName, $namespace))\r
+ $results.push($element);\r
+ }\r
+ }\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// pseudo-classes\r
+// -----------------------------------------------------------------------\r
+\r
+// I'm hoping these pseudo-classes are pretty readable. Let me know if\r
+// any need explanation.\r
+\r
+pseudoClasses["contains"] = function($element, $text) {\r
+ $text = new RegExp(regEscape(getText($text)));\r
+ return $text.test(getTextContent($element));\r
+};\r
+\r
+pseudoClasses["root"] = function($element) {\r
+ return $element == getDocument($element).documentElement;\r
+};\r
+\r
+pseudoClasses["empty"] = function($element) {\r
+ var $node, i;\r
+ for (i = 0; ($node = $element.childNodes[i]); i++) {\r
+ if (thisElement($node) || $node.nodeType == 3) return false;\r
+ }\r
+ return true;\r
+};\r
+\r
+pseudoClasses["last-child"] = function($element) {\r
+ return !nextElementSibling($element);\r
+};\r
+\r
+pseudoClasses["only-child"] = function($element) {\r
+ $element = $element.parentNode;\r
+ return firstElementChild($element) == lastElementChild($element);\r
+};\r
+\r
+pseudoClasses["not"] = function($element, $selector) {\r
+ var $negated = cssQuery($selector, getDocument($element));\r
+ for (var i = 0; i < $negated.length; i++) {\r
+ if ($negated[i] == $element) return false;\r
+ }\r
+ return true;\r
+};\r
+\r
+pseudoClasses["nth-child"] = function($element, $arguments) {\r
+ return nthChild($element, $arguments, previousElementSibling);\r
+};\r
+\r
+pseudoClasses["nth-last-child"] = function($element, $arguments) {\r
+ return nthChild($element, $arguments, nextElementSibling);\r
+};\r
+\r
+pseudoClasses["target"] = function($element) {\r
+ return $element.id == location.hash.slice(1);\r
+};\r
+\r
+// UI element states\r
+\r
+pseudoClasses["checked"] = function($element) {\r
+ return $element.checked;\r
+};\r
+\r
+pseudoClasses["enabled"] = function($element) {\r
+ return $element.disabled === false;\r
+};\r
+\r
+pseudoClasses["disabled"] = function($element) {\r
+ return $element.disabled;\r
+};\r
+\r
+pseudoClasses["indeterminate"] = function($element) {\r
+ return $element.indeterminate;\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// attribute selector tests\r
+// -----------------------------------------------------------------------\r
+\r
+AttributeSelector.tests["^="] = function($attribute, $value) {\r
+ return "/^" + regEscape($value) + "/.test(" + $attribute + ")";\r
+};\r
+\r
+AttributeSelector.tests["$="] = function($attribute, $value) {\r
+ return "/" + regEscape($value) + "$/.test(" + $attribute + ")";\r
+};\r
+\r
+AttributeSelector.tests["*="] = function($attribute, $value) {\r
+ return "/" + regEscape($value) + "/.test(" + $attribute + ")";\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// nth child support (Bill Edney)\r
+// -----------------------------------------------------------------------\r
+\r
+function nthChild($element, $arguments, $traverse) {\r
+ switch ($arguments) {\r
+ case "n": return true;\r
+ case "even": $arguments = "2n"; break;\r
+ case "odd": $arguments = "2n+1";\r
+ }\r
+\r
+ var $$children = childElements($element.parentNode);\r
+ function _checkIndex($index) {\r
+ var $index = ($traverse == nextElementSibling) ? $$children.length - $index : $index - 1;\r
+ return $$children[$index] == $element;\r
+ };\r
+\r
+ // it was just a number (no "n")\r
+ if (!isNaN($arguments)) return _checkIndex($arguments);\r
+\r
+ $arguments = $arguments.split("n");\r
+ var $multiplier = parseInt($arguments[0]);\r
+ var $step = parseInt($arguments[1]);\r
+\r
+ if ((isNaN($multiplier) || $multiplier == 1) && $step == 0) return true;\r
+ if ($multiplier == 0 && !isNaN($step)) return _checkIndex($step);\r
+ if (isNaN($step)) $step = 0;\r
+\r
+ var $count = 1;\r
+ while ($element = $traverse($element)) $count++;\r
+\r
+ if (isNaN($multiplier) || $multiplier == 1)\r
+ return ($traverse == nextElementSibling) ? ($count <= $step) : ($step >= $count);\r
+\r
+ return ($count % $multiplier) == $step;\r
+};\r
+\r
+}); // addModule\r
--- /dev/null
+/*\r
+ cssQuery, version 2.0.2 (2005-08-19)\r
+ Copyright: 2004-2005, Dean Edwards (http://dean.edwards.name/)\r
+ License: http://creativecommons.org/licenses/LGPL/2.1/\r
+*/\r
+\r
+cssQuery.addModule("css-standard", function() { // override IE optimisation\r
+\r
+// cssQuery was originally written as the CSS engine for IE7. It is\r
+// optimised (in terms of size not speed) for IE so this module is\r
+// provided separately to provide cross-browser support.\r
+\r
+// -----------------------------------------------------------------------\r
+// browser compatibility\r
+// -----------------------------------------------------------------------\r
+\r
+// sniff for Win32 Explorer\r
+isMSIE = eval("false;/*@cc_on@if(@\x5fwin32)isMSIE=true@end@*/");\r
+\r
+if (!isMSIE) {\r
+ getElementsByTagName = function($element, $tagName, $namespace) {\r
+ return $namespace ? $element.getElementsByTagNameNS("*", $tagName) :\r
+ $element.getElementsByTagName($tagName);\r
+ };\r
+\r
+ compareNamespace = function($element, $namespace) {\r
+ return !$namespace || ($namespace == "*") || ($element.prefix == $namespace);\r
+ };\r
+\r
+ isXML = document.contentType ? function($element) {\r
+ return /xml/i.test(getDocument($element).contentType);\r
+ } : function($element) {\r
+ return getDocument($element).documentElement.tagName != "HTML";\r
+ };\r
+\r
+ getTextContent = function($element) {\r
+ // mozilla || opera || other\r
+ return $element.textContent || $element.innerText || _getTextContent($element);\r
+ };\r
+\r
+ function _getTextContent($element) {\r
+ var $textContent = "", $node, i;\r
+ for (i = 0; ($node = $element.childNodes[i]); i++) {\r
+ switch ($node.nodeType) {\r
+ case 11: // document fragment\r
+ case 1: $textContent += _getTextContent($node); break;\r
+ case 3: $textContent += $node.nodeValue; break;\r
+ }\r
+ }\r
+ return $textContent;\r
+ };\r
+}\r
+}); // addModule\r
--- /dev/null
+/*\r
+ cssQuery, version 2.0.2 (2005-08-19)\r
+ Copyright: 2004-2005, Dean Edwards (http://dean.edwards.name/)\r
+ License: http://creativecommons.org/licenses/LGPL/2.1/\r
+*/\r
+\r
+// the following functions allow querying of the DOM using CSS selectors\r
+var cssQuery = function() {\r
+var version = "2.0.2";\r
+\r
+// -----------------------------------------------------------------------\r
+// main query function\r
+// -----------------------------------------------------------------------\r
+\r
+var $COMMA = /\s*,\s*/;\r
+var cssQuery = function($selector, $$from) {\r
+try {\r
+ var $match = [];\r
+ var $useCache = arguments.callee.caching && !$$from;\r
+ var $base = ($$from) ? ($$from.constructor == Array) ? $$from : [$$from] : [document];\r
+ // process comma separated selectors\r
+ var $$selectors = parseSelector($selector).split($COMMA), i;\r
+ for (i = 0; i < $$selectors.length; i++) {\r
+ // convert the selector to a stream\r
+ $selector = _toStream($$selectors[i]);\r
+ // faster chop if it starts with id (MSIE only)\r
+ if (isMSIE && $selector.slice(0, 3).join("") == " *#") {\r
+ $selector = $selector.slice(2);\r
+ $$from = _msie_selectById([], $base, $selector[1]);\r
+ } else $$from = $base;\r
+ // process the stream\r
+ var j = 0, $token, $filter, $arguments, $cacheSelector = "";\r
+ while (j < $selector.length) {\r
+ $token = $selector[j++];\r
+ $filter = $selector[j++];\r
+ $cacheSelector += $token + $filter;\r
+ // some pseudo-classes allow arguments to be passed\r
+ // e.g. nth-child(even)\r
+ $arguments = "";\r
+ if ($selector[j] == "(") {\r
+ while ($selector[j++] != ")" && j < $selector.length) {\r
+ $arguments += $selector[j];\r
+ }\r
+ $arguments = $arguments.slice(0, -1);\r
+ $cacheSelector += "(" + $arguments + ")";\r
+ }\r
+ // process a token/filter pair use cached results if possible\r
+ $$from = ($useCache && cache[$cacheSelector]) ?\r
+ cache[$cacheSelector] : select($$from, $token, $filter, $arguments);\r
+ if ($useCache) cache[$cacheSelector] = $$from;\r
+ }\r
+ $match = $match.concat($$from);\r
+ }\r
+ delete cssQuery.error;\r
+ return $match;\r
+} catch ($error) {\r
+ cssQuery.error = $error;\r
+ return [];\r
+}};\r
+\r
+// -----------------------------------------------------------------------\r
+// public interface\r
+// -----------------------------------------------------------------------\r
+\r
+cssQuery.toString = function() {\r
+ return "function cssQuery() {\n [version " + version + "]\n}";\r
+};\r
+\r
+// caching\r
+var cache = {};\r
+cssQuery.caching = false;\r
+cssQuery.clearCache = function($selector) {\r
+ if ($selector) {\r
+ $selector = _toStream($selector).join("");\r
+ delete cache[$selector];\r
+ } else cache = {};\r
+};\r
+\r
+// allow extensions\r
+var modules = {};\r
+var loaded = false;\r
+cssQuery.addModule = function($name, $script) {\r
+ if (loaded) eval("$script=" + String($script));\r
+ modules[$name] = new $script();;\r
+};\r
+\r
+// hackery\r
+cssQuery.valueOf = function($code) {\r
+ return $code ? eval($code) : this;\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// declarations\r
+// -----------------------------------------------------------------------\r
+\r
+var selectors = {};\r
+var pseudoClasses = {};\r
+// a safari bug means that these have to be declared here\r
+var AttributeSelector = {match: /\[([\w-]+(\|[\w-]+)?)\s*(\W?=)?\s*([^\]]*)\]/};\r
+var attributeSelectors = [];\r
+\r
+// -----------------------------------------------------------------------\r
+// selectors\r
+// -----------------------------------------------------------------------\r
+\r
+// descendant selector\r
+selectors[" "] = function($results, $from, $tagName, $namespace) {\r
+ // loop through current selection\r
+ var $element, i, j;\r
+ for (i = 0; i < $from.length; i++) {\r
+ // get descendants\r
+ var $subset = getElementsByTagName($from[i], $tagName, $namespace);\r
+ // loop through descendants and add to results selection\r
+ for (j = 0; ($element = $subset[j]); j++) {\r
+ if (thisElement($element) && compareNamespace($element, $namespace))\r
+ $results.push($element);\r
+ }\r
+ }\r
+};\r
+\r
+// ID selector\r
+selectors["#"] = function($results, $from, $id) {\r
+ // loop through current selection and check ID\r
+ var $element, j;\r
+ for (j = 0; ($element = $from[j]); j++) if ($element.id == $id) $results.push($element);\r
+};\r
+\r
+// class selector\r
+selectors["."] = function($results, $from, $className) {\r
+ // create a RegExp version of the class\r
+ $className = new RegExp("(^|\\s)" + $className + "(\\s|$)");\r
+ // loop through current selection and check class\r
+ var $element, i;\r
+ for (i = 0; ($element = $from[i]); i++)\r
+ if ($className.test($element.className)) $results.push($element);\r
+};\r
+\r
+// pseudo-class selector\r
+selectors[":"] = function($results, $from, $pseudoClass, $arguments) {\r
+ // retrieve the cssQuery pseudo-class function\r
+ var $test = pseudoClasses[$pseudoClass], $element, i;\r
+ // loop through current selection and apply pseudo-class filter\r
+ if ($test) for (i = 0; ($element = $from[i]); i++)\r
+ // if the cssQuery pseudo-class function returns "true" add the element\r
+ if ($test($element, $arguments)) $results.push($element);\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// pseudo-classes\r
+// -----------------------------------------------------------------------\r
+\r
+pseudoClasses["link"] = function($element) {\r
+ var $document = getDocument($element);\r
+ if ($document.links) for (var i = 0; i < $document.links.length; i++) {\r
+ if ($document.links[i] == $element) return true;\r
+ }\r
+};\r
+\r
+pseudoClasses["visited"] = function($element) {\r
+ // can't do this without jiggery-pokery\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// DOM traversal\r
+// -----------------------------------------------------------------------\r
+\r
+// IE5/6 includes comments (LOL) in it's elements collections.\r
+// so we have to check for this. the test is tagName != "!". LOL (again).\r
+var thisElement = function($element) {\r
+ return ($element && $element.nodeType == 1 && $element.tagName != "!") ? $element : null;\r
+};\r
+\r
+// return the previous element to the supplied element\r
+// previousSibling is not good enough as it might return a text or comment node\r
+var previousElementSibling = function($element) {\r
+ while ($element && ($element = $element.previousSibling) && !thisElement($element)) continue;\r
+ return $element;\r
+};\r
+\r
+// return the next element to the supplied element\r
+var nextElementSibling = function($element) {\r
+ while ($element && ($element = $element.nextSibling) && !thisElement($element)) continue;\r
+ return $element;\r
+};\r
+\r
+// return the first child ELEMENT of an element\r
+// NOT the first child node (though they may be the same thing)\r
+var firstElementChild = function($element) {\r
+ return thisElement($element.firstChild) || nextElementSibling($element.firstChild);\r
+};\r
+\r
+var lastElementChild = function($element) {\r
+ return thisElement($element.lastChild) || previousElementSibling($element.lastChild);\r
+};\r
+\r
+// return child elements of an element (not child nodes)\r
+var childElements = function($element) {\r
+ var $childElements = [];\r
+ $element = firstElementChild($element);\r
+ while ($element) {\r
+ $childElements.push($element);\r
+ $element = nextElementSibling($element);\r
+ }\r
+ return $childElements;\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// browser compatibility\r
+// -----------------------------------------------------------------------\r
+\r
+// all of the functions in this section can be overwritten. the default\r
+// configuration is for IE. The functions below reflect this. standard\r
+// methods are included in a separate module. It would probably be better\r
+// the other way round of course but this makes it easier to keep IE7 trim.\r
+\r
+var isMSIE = true;\r
+\r
+var isXML = function($element) {\r
+ var $document = getDocument($element);\r
+ return (typeof $document.mimeType == "unknown") ?\r
+ /\.xml$/i.test($document.URL) :\r
+ Boolean($document.mimeType == "XML Document");\r
+};\r
+\r
+// return the element's containing document\r
+var getDocument = function($element) {\r
+ return $element.ownerDocument || $element.document;\r
+};\r
+\r
+var getElementsByTagName = function($element, $tagName) {\r
+ return ($tagName == "*" && $element.all) ? $element.all : $element.getElementsByTagName($tagName);\r
+};\r
+\r
+var compareTagName = function($element, $tagName, $namespace) {\r
+ if ($tagName == "*") return thisElement($element);\r
+ if (!compareNamespace($element, $namespace)) return false;\r
+ if (!isXML($element)) $tagName = $tagName.toUpperCase();\r
+ return $element.tagName == $tagName;\r
+};\r
+\r
+var compareNamespace = function($element, $namespace) {\r
+ return !$namespace || ($namespace == "*") || ($element.scopeName == $namespace);\r
+};\r
+\r
+var getTextContent = function($element) {\r
+ return $element.innerText;\r
+};\r
+\r
+function _msie_selectById($results, $from, id) {\r
+ var $match, i, j;\r
+ for (i = 0; i < $from.length; i++) {\r
+ if ($match = $from[i].all.item(id)) {\r
+ if ($match.id == id) $results.push($match);\r
+ else if ($match.length != null) {\r
+ for (j = 0; j < $match.length; j++) {\r
+ if ($match[j].id == id) $results.push($match[j]);\r
+ }\r
+ }\r
+ }\r
+ }\r
+ return $results;\r
+};\r
+\r
+// for IE5.0\r
+if (![].push) Array.prototype.push = function() {\r
+ for (var i = 0; i < arguments.length; i++) {\r
+ this[this.length] = arguments[i];\r
+ }\r
+ return this.length;\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// query support\r
+// -----------------------------------------------------------------------\r
+\r
+// select a set of matching elements.\r
+// "from" is an array of elements.\r
+// "token" is a character representing the type of filter\r
+// e.g. ">" means child selector\r
+// "filter" represents the tag name, id or class name that is being selected\r
+// the function returns an array of matching elements\r
+var $NAMESPACE = /\|/;\r
+function select($$from, $token, $filter, $arguments) {\r
+ if ($NAMESPACE.test($filter)) {\r
+ $filter = $filter.split($NAMESPACE);\r
+ $arguments = $filter[0];\r
+ $filter = $filter[1];\r
+ }\r
+ var $results = [];\r
+ if (selectors[$token]) {\r
+ selectors[$token]($results, $$from, $filter, $arguments);\r
+ }\r
+ return $results;\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// parsing\r
+// -----------------------------------------------------------------------\r
+\r
+// convert css selectors to a stream of tokens and filters\r
+// it's not a real stream. it's just an array of strings.\r
+var $STANDARD_SELECT = /^[^\s>+~]/;\r
+var $$STREAM = /[\s#.:>+~()@]|[^\s#.:>+~()@]+/g;\r
+function _toStream($selector) {\r
+ if ($STANDARD_SELECT.test($selector)) $selector = " " + $selector;\r
+ return $selector.match($$STREAM) || [];\r
+};\r
+\r
+var $WHITESPACE = /\s*([\s>+~(),]|^|$)\s*/g;\r
+var $IMPLIED_ALL = /([\s>+~,]|[^(]\+|^)([#.:@])/g;\r
+var parseSelector = function($selector) {\r
+ return $selector\r
+ // trim whitespace\r
+ .replace($WHITESPACE, "$1")\r
+ // e.g. ".class1" --> "*.class1"\r
+ .replace($IMPLIED_ALL, "$1*$2");\r
+};\r
+\r
+var Quote = {\r
+ toString: function() {return "'"},\r
+ match: /^('[^']*')|("[^"]*")$/,\r
+ test: function($string) {\r
+ return this.match.test($string);\r
+ },\r
+ add: function($string) {\r
+ return this.test($string) ? $string : this + $string + this;\r
+ },\r
+ remove: function($string) {\r
+ return this.test($string) ? $string.slice(1, -1) : $string;\r
+ }\r
+};\r
+\r
+var getText = function($text) {\r
+ return Quote.remove($text);\r
+};\r
+\r
+var $ESCAPE = /([\/()[\]?{}|*+-])/g;\r
+function regEscape($string) {\r
+ return $string.replace($ESCAPE, "\\$1");\r
+};\r
+\r
+// -----------------------------------------------------------------------\r
+// modules\r
+// -----------------------------------------------------------------------\r
+\r
+// -------- >> insert modules here for packaging << -------- \\\r
+\r
+loaded = true;\r
+\r
+// -----------------------------------------------------------------------\r
+// return the query function\r
+// -----------------------------------------------------------------------\r
+\r
+return cssQuery;\r
+\r
+}(); // cssQuery\r
--- /dev/null
+/* Prototype JavaScript framework, version 1.5.0_rc0
+ *
+ * Prototype is freely distributable under the terms of an MIT-style license.
+ * For details, see the Prototype web site: http://prototype.conio.net/
+ *
+/*--------------------------------------------------------------------------*/
+
+var Prototype = {
+ Version: '1.5.0_rc0',
+ ScriptFragment: '(?:<script.*?>)((\n|\r|.)*?)(?:<\/script>)',
+
+ emptyFunction: function() {},
+ K: function(x) {return x}
+}
+
+var Class = {
+ create: function() {
+ return function() {
+ this.initialize.apply(this, arguments);
+ }
+ }
+}
+
+var Abstract = new Object();
+
+Object.extend = function(destination, source) {
+ for (var property in source) {
+ destination[property] = source[property];
+ }
+ return destination;
+}
+
+Object.inspect = function(object) {
+ try {
+ if (object == undefined) return 'undefined';
+ if (object == null) return 'null';
+ return object.inspect ? object.inspect() : object.toString();
+ } catch (e) {
+ if (e instanceof RangeError) return '...';
+ throw e;
+ }
+}
+
+Function.prototype.bind = function() {
+ var __method = this, args = $A(arguments), object = args.shift();
+ return function() {
+ return __method.apply(object, args.concat($A(arguments)));
+ }
+}
+
+Function.prototype.bindAsEventListener = function(object) {
+ var __method = this;
+ return function(event) {
+ return __method.call(object, event || window.event);
+ }
+}
+
+Object.extend(Number.prototype, {
+ toColorPart: function() {
+ var digits = this.toString(16);
+ if (this < 16) return '0' + digits;
+ return digits;
+ },
+
+ succ: function() {
+ return this + 1;
+ },
+
+ times: function(iterator) {
+ $R(0, this, true).each(iterator);
+ return this;
+ }
+});
+
+var Try = {
+ these: function() {
+ var returnValue;
+
+ for (var i = 0; i < arguments.length; i++) {
+ var lambda = arguments[i];
+ try {
+ returnValue = lambda();
+ break;
+ } catch (e) {}
+ }
+
+ return returnValue;
+ }
+}
+
+/*--------------------------------------------------------------------------*/
+
+var PeriodicalExecuter = Class.create();
+PeriodicalExecuter.prototype = {
+ initialize: function(callback, frequency) {
+ this.callback = callback;
+ this.frequency = frequency;
+ this.currentlyExecuting = false;
+
+ this.registerCallback();
+ },
+
+ registerCallback: function() {
+ setInterval(this.onTimerEvent.bind(this), this.frequency * 1000);
+ },
+
+ onTimerEvent: function() {
+ if (!this.currentlyExecuting) {
+ try {
+ this.currentlyExecuting = true;
+ this.callback();
+ } finally {
+ this.currentlyExecuting = false;
+ }
+ }
+ }
+}
+Object.extend(String.prototype, {
+ gsub: function(pattern, replacement) {
+ var result = '', source = this, match;
+ replacement = arguments.callee.prepareReplacement(replacement);
+
+ while (source.length > 0) {
+ if (match = source.match(pattern)) {
+ result += source.slice(0, match.index);
+ result += (replacement(match) || '').toString();
+ source = source.slice(match.index + match[0].length);
+ } else {
+ result += source, source = '';
+ }
+ }
+ return result;
+ },
+
+ sub: function(pattern, replacement, count) {
+ replacement = this.gsub.prepareReplacement(replacement);
+ count = count === undefined ? 1 : count;
+
+ return this.gsub(pattern, function(match) {
+ if (--count < 0) return match[0];
+ return replacement(match);
+ });
+ },
+
+ scan: function(pattern, iterator) {
+ this.gsub(pattern, iterator);
+ return this;
+ },
+
+ truncate: function(length, truncation) {
+ length = length || 30;
+ truncation = truncation === undefined ? '...' : truncation;
+ return this.length > length ?
+ this.slice(0, length - truncation.length) + truncation : this;
+ },
+
+ strip: function() {
+ return this.replace(/^\s+/, '').replace(/\s+$/, '');
+ },
+
+ stripTags: function() {
+ return this.replace(/<\/?[^>]+>/gi, '');
+ },
+
+ stripScripts: function() {
+ return this.replace(new RegExp(Prototype.ScriptFragment, 'img'), '');
+ },
+
+ extractScripts: function() {
+ var matchAll = new RegExp(Prototype.ScriptFragment, 'img');
+ var matchOne = new RegExp(Prototype.ScriptFragment, 'im');
+ return (this.match(matchAll) || []).map(function(scriptTag) {
+ return (scriptTag.match(matchOne) || ['', ''])[1];
+ });
+ },
+
+ evalScripts: function() {
+ return this.extractScripts().map(function(script) { return eval(script) });
+ },
+
+ escapeHTML: function() {
+ var div = document.createElement('div');
+ var text = document.createTextNode(this);
+ div.appendChild(text);
+ return div.innerHTML;
+ },
+
+ unescapeHTML: function() {
+ var div = document.createElement('div');
+ div.innerHTML = this.stripTags();
+ return div.childNodes[0] ? div.childNodes[0].nodeValue : '';
+ },
+
+ toQueryParams: function() {
+ var pairs = this.match(/^\??(.*)$/)[1].split('&');
+ return pairs.inject({}, function(params, pairString) {
+ var pair = pairString.split('=');
+ params[pair[0]] = pair[1];
+ return params;
+ });
+ },
+
+ toArray: function() {
+ return this.split('');
+ },
+
+ camelize: function() {
+ var oStringList = this.split('-');
+ if (oStringList.length == 1) return oStringList[0];
+
+ var camelizedString = this.indexOf('-') == 0
+ ? oStringList[0].charAt(0).toUpperCase() + oStringList[0].substring(1)
+ : oStringList[0];
+
+ for (var i = 1, len = oStringList.length; i < len; i++) {
+ var s = oStringList[i];
+ camelizedString += s.charAt(0).toUpperCase() + s.substring(1);
+ }
+
+ return camelizedString;
+ },
+
+ inspect: function() {
+ return "'" + this.replace(/\\/g, '\\\\').replace(/'/g, '\\\'') + "'";
+ }
+});
+
+String.prototype.gsub.prepareReplacement = function(replacement) {
+ if (typeof replacement == 'function') return replacement;
+ var template = new Template(replacement);
+ return function(match) { return template.evaluate(match) };
+}
+
+String.prototype.parseQuery = String.prototype.toQueryParams;
+
+var Template = Class.create();
+Template.Pattern = /(^|.|\r|\n)(#\{(.*?)\})/;
+Template.prototype = {
+ initialize: function(template, pattern) {
+ this.template = template.toString();
+ this.pattern = pattern || Template.Pattern;
+ },
+
+ evaluate: function(object) {
+ return this.template.gsub(this.pattern, function(match) {
+ var before = match[1];
+ if (before == '\\') return match[2];
+ return before + (object[match[3]] || '').toString();
+ });
+ }
+}
+
+var $break = new Object();
+var $continue = new Object();
+
+var Enumerable = {
+ each: function(iterator) {
+ var index = 0;
+ try {
+ this._each(function(value) {
+ try {
+ iterator(value, index++);
+ } catch (e) {
+ if (e != $continue) throw e;
+ }
+ });
+ } catch (e) {
+ if (e != $break) throw e;
+ }
+ },
+
+ all: function(iterator) {
+ var result = true;
+ this.each(function(value, index) {
+ result = result && !!(iterator || Prototype.K)(value, index);
+ if (!result) throw $break;
+ });
+ return result;
+ },
+
+ any: function(iterator) {
+ var result = true;
+ this.each(function(value, index) {
+ if (result = !!(iterator || Prototype.K)(value, index))
+ throw $break;
+ });
+ return result;
+ },
+
+ collect: function(iterator) {
+ var results = [];
+ this.each(function(value, index) {
+ results.push(iterator(value, index));
+ });
+ return results;
+ },
+
+ detect: function (iterator) {
+ var result;
+ this.each(function(value, index) {
+ if (iterator(value, index)) {
+ result = value;
+ throw $break;
+ }
+ });
+ return result;
+ },
+
+ findAll: function(iterator) {
+ var results = [];
+ this.each(function(value, index) {
+ if (iterator(value, index))
+ results.push(value);
+ });
+ return results;
+ },
+
+ grep: function(pattern, iterator) {
+ var results = [];
+ this.each(function(value, index) {
+ var stringValue = value.toString();
+ if (stringValue.match(pattern))
+ results.push((iterator || Prototype.K)(value, index));
+ })
+ return results;
+ },
+
+ include: function(object) {
+ var found = false;
+ this.each(function(value) {
+ if (value == object) {
+ found = true;
+ throw $break;
+ }
+ });
+ return found;
+ },
+
+ inject: function(memo, iterator) {
+ this.each(function(value, index) {
+ memo = iterator(memo, value, index);
+ });
+ return memo;
+ },
+
+ invoke: function(method) {
+ var args = $A(arguments).slice(1);
+ return this.collect(function(value) {
+ return value[method].apply(value, args);
+ });
+ },
+
+ max: function(iterator) {
+ var result;
+ this.each(function(value, index) {
+ value = (iterator || Prototype.K)(value, index);
+ if (result == undefined || value >= result)
+ result = value;
+ });
+ return result;
+ },
+
+ min: function(iterator) {
+ var result;
+ this.each(function(value, index) {
+ value = (iterator || Prototype.K)(value, index);
+ if (result == undefined || value < result)
+ result = value;
+ });
+ return result;
+ },
+
+ partition: function(iterator) {
+ var trues = [], falses = [];
+ this.each(function(value, index) {
+ ((iterator || Prototype.K)(value, index) ?
+ trues : falses).push(value);
+ });
+ return [trues, falses];
+ },
+
+ pluck: function(property) {
+ var results = [];
+ this.each(function(value, index) {
+ results.push(value[property]);
+ });
+ return results;
+ },
+
+ reject: function(iterator) {
+ var results = [];
+ this.each(function(value, index) {
+ if (!iterator(value, index))
+ results.push(value);
+ });
+ return results;
+ },
+
+ sortBy: function(iterator) {
+ return this.collect(function(value, index) {
+ return {value: value, criteria: iterator(value, index)};
+ }).sort(function(left, right) {
+ var a = left.criteria, b = right.criteria;
+ return a < b ? -1 : a > b ? 1 : 0;
+ }).pluck('value');
+ },
+
+ toArray: function() {
+ return this.collect(Prototype.K);
+ },
+
+ zip: function() {
+ var iterator = Prototype.K, args = $A(arguments);
+ if (typeof args.last() == 'function')
+ iterator = args.pop();
+
+ var collections = [this].concat(args).map($A);
+ return this.map(function(value, index) {
+ return iterator(collections.pluck(index));
+ });
+ },
+
+ inspect: function() {
+ return '#<Enumerable:' + this.toArray().inspect() + '>';
+ }
+}
+
+Object.extend(Enumerable, {
+ map: Enumerable.collect,
+ find: Enumerable.detect,
+ select: Enumerable.findAll,
+ member: Enumerable.include,
+ entries: Enumerable.toArray
+});
+var $A = Array.from = function(iterable) {
+ if (!iterable) return [];
+ if (iterable.toArray) {
+ return iterable.toArray();
+ } else {
+ var results = [];
+ for (var i = 0; i < iterable.length; i++)
+ results.push(iterable[i]);
+ return results;
+ }
+}
+
+Object.extend(Array.prototype, Enumerable);
+
+if (!Array.prototype._reverse)
+ Array.prototype._reverse = Array.prototype.reverse;
+
+Object.extend(Array.prototype, {
+ _each: function(iterator) {
+ for (var i = 0; i < this.length; i++)
+ iterator(this[i]);
+ },
+
+ clear: function() {
+ this.length = 0;
+ return this;
+ },
+
+ first: function() {
+ return this[0];
+ },
+
+ last: function() {
+ return this[this.length - 1];
+ },
+
+ compact: function() {
+ return this.select(function(value) {
+ return value != undefined || value != null;
+ });
+ },
+
+ flatten: function() {
+ return this.inject([], function(array, value) {
+ return array.concat(value && value.constructor == Array ?
+ value.flatten() : [value]);
+ });
+ },
+
+ without: function() {
+ var values = $A(arguments);
+ return this.select(function(value) {
+ return !values.include(value);
+ });
+ },
+
+ indexOf: function(object) {
+ for (var i = 0; i < this.length; i++)
+ if (this[i] == object) return i;
+ return -1;
+ },
+
+ reverse: function(inline) {
+ return (inline !== false ? this : this.toArray())._reverse();
+ },
+
+ inspect: function() {
+ return '[' + this.map(Object.inspect).join(', ') + ']';
+ }
+});
+var Hash = {
+ _each: function(iterator) {
+ for (var key in this) {
+ var value = this[key];
+ if (typeof value == 'function') continue;
+
+ var pair = [key, value];
+ pair.key = key;
+ pair.value = value;
+ iterator(pair);
+ }
+ },
+
+ keys: function() {
+ return this.pluck('key');
+ },
+
+ values: function() {
+ return this.pluck('value');
+ },
+
+ merge: function(hash) {
+ return $H(hash).inject($H(this), function(mergedHash, pair) {
+ mergedHash[pair.key] = pair.value;
+ return mergedHash;
+ });
+ },
+
+ toQueryString: function() {
+ return this.map(function(pair) {
+ return pair.map(encodeURIComponent).join('=');
+ }).join('&');
+ },
+
+ inspect: function() {
+ return '#<Hash:{' + this.map(function(pair) {
+ return pair.map(Object.inspect).join(': ');
+ }).join(', ') + '}>';
+ }
+}
+
+function $H(object) {
+ var hash = Object.extend({}, object || {});
+ Object.extend(hash, Enumerable);
+ Object.extend(hash, Hash);
+ return hash;
+}
+ObjectRange = Class.create();
+Object.extend(ObjectRange.prototype, Enumerable);
+Object.extend(ObjectRange.prototype, {
+ initialize: function(start, end, exclusive) {
+ this.start = start;
+ this.end = end;
+ this.exclusive = exclusive;
+ },
+
+ _each: function(iterator) {
+ var value = this.start;
+ do {
+ iterator(value);
+ value = value.succ();
+ } while (this.include(value));
+ },
+
+ include: function(value) {
+ if (value < this.start)
+ return false;
+ if (this.exclusive)
+ return value < this.end;
+ return value <= this.end;
+ }
+});
+
+var $R = function(start, end, exclusive) {
+ return new ObjectRange(start, end, exclusive);
+}
+
+var Ajax = {
+ getTransport: function() {
+ return Try.these(
+ function() {return new XMLHttpRequest()},
+ function() {return new ActiveXObject('Msxml2.XMLHTTP')},
+ function() {return new ActiveXObject('Microsoft.XMLHTTP')}
+ ) || false;
+ },
+
+ activeRequestCount: 0
+}
+
+Ajax.Responders = {
+ responders: [],
+
+ _each: function(iterator) {
+ this.responders._each(iterator);
+ },
+
+ register: function(responderToAdd) {
+ if (!this.include(responderToAdd))
+ this.responders.push(responderToAdd);
+ },
+
+ unregister: function(responderToRemove) {
+ this.responders = this.responders.without(responderToRemove);
+ },
+
+ dispatch: function(callback, request, transport, json) {
+ this.each(function(responder) {
+ if (responder[callback] && typeof responder[callback] == 'function') {
+ try {
+ responder[callback].apply(responder, [request, transport, json]);
+ } catch (e) {}
+ }
+ });
+ }
+};
+
+Object.extend(Ajax.Responders, Enumerable);
+
+Ajax.Responders.register({
+ onCreate: function() {
+ Ajax.activeRequestCount++;
+ },
+
+ onComplete: function() {
+ Ajax.activeRequestCount--;
+ }
+});
+
+Ajax.Base = function() {};
+Ajax.Base.prototype = {
+ setOptions: function(options) {
+ this.options = {
+ method: 'post',
+ asynchronous: true,
+ contentType: 'application/x-www-form-urlencoded',
+ parameters: ''
+ }
+ Object.extend(this.options, options || {});
+ },
+
+ responseIsSuccess: function() {
+ return this.transport.status == undefined
+ || this.transport.status == 0
+ || (this.transport.status >= 200 && this.transport.status < 300);
+ },
+
+ responseIsFailure: function() {
+ return !this.responseIsSuccess();
+ }
+}
+
+Ajax.Request = Class.create();
+Ajax.Request.Events =
+ ['Uninitialized', 'Loading', 'Loaded', 'Interactive', 'Complete'];
+
+Ajax.Request.prototype = Object.extend(new Ajax.Base(), {
+ initialize: function(url, options) {
+ this.transport = Ajax.getTransport();
+ this.setOptions(options);
+ this.request(url);
+ },
+
+ request: function(url) {
+ var parameters = this.options.parameters || '';
+ if (parameters.length > 0) parameters += '&_=';
+
+ try {
+ this.url = url;
+ if (this.options.method == 'get' && parameters.length > 0)
+ this.url += (this.url.match(/\?/) ? '&' : '?') + parameters;
+
+ Ajax.Responders.dispatch('onCreate', this, this.transport);
+
+ this.transport.open(this.options.method, this.url,
+ this.options.asynchronous);
+
+ if (this.options.asynchronous) {
+ this.transport.onreadystatechange = this.onStateChange.bind(this);
+ setTimeout((function() {this.respondToReadyState(1)}).bind(this), 10);
+ }
+
+ this.setRequestHeaders();
+
+ var body = this.options.postBody ? this.options.postBody : parameters;
+ this.transport.send(this.options.method == 'post' ? body : null);
+
+ } catch (e) {
+ this.dispatchException(e);
+ }
+ },
+
+ setRequestHeaders: function() {
+ var requestHeaders =
+ ['X-Requested-With', 'XMLHttpRequest',
+ 'X-Prototype-Version', Prototype.Version,
+ 'Accept', 'text/javascript, text/html, application/xml, text/xml, */*'];
+
+ if (this.options.method == 'post') {
+ requestHeaders.push('Content-type', this.options.contentType);
+
+ /* Force "Connection: close" for Mozilla browsers to work around
+ * a bug where XMLHttpReqeuest sends an incorrect Content-length
+ * header. See Mozilla Bugzilla #246651.
+ */
+ if (this.transport.overrideMimeType)
+ requestHeaders.push('Connection', 'close');
+ }
+
+ if (this.options.requestHeaders)
+ requestHeaders.push.apply(requestHeaders, this.options.requestHeaders);
+
+ for (var i = 0; i < requestHeaders.length; i += 2)
+ this.transport.setRequestHeader(requestHeaders[i], requestHeaders[i+1]);
+ },
+
+ onStateChange: function() {
+ var readyState = this.transport.readyState;
+ if (readyState != 1)
+ this.respondToReadyState(this.transport.readyState);
+ },
+
+ header: function(name) {
+ try {
+ return this.transport.getResponseHeader(name);
+ } catch (e) {}
+ },
+
+ evalJSON: function() {
+ try {
+ return eval('(' + this.header('X-JSON') + ')');
+ } catch (e) {}
+ },
+
+ evalResponse: function() {
+ try {
+ return eval(this.transport.responseText);
+ } catch (e) {
+ this.dispatchException(e);
+ }
+ },
+
+ respondToReadyState: function(readyState) {
+ var event = Ajax.Request.Events[readyState];
+ var transport = this.transport, json = this.evalJSON();
+
+ if (event == 'Complete') {
+ try {
+ (this.options['on' + this.transport.status]
+ || this.options['on' + (this.responseIsSuccess() ? 'Success' : 'Failure')]
+ || Prototype.emptyFunction)(transport, json);
+ } catch (e) {
+ this.dispatchException(e);
+ }
+
+ if ((this.header('Content-type') || '').match(/^text\/javascript/i))
+ this.evalResponse();
+ }
+
+ try {
+ (this.options['on' + event] || Prototype.emptyFunction)(transport, json);
+ Ajax.Responders.dispatch('on' + event, this, transport, json);
+ } catch (e) {
+ this.dispatchException(e);
+ }
+
+ /* Avoid memory leak in MSIE: clean up the oncomplete event handler */
+ if (event == 'Complete')
+ this.transport.onreadystatechange = Prototype.emptyFunction;
+ },
+
+ dispatchException: function(exception) {
+ (this.options.onException || Prototype.emptyFunction)(this, exception);
+ Ajax.Responders.dispatch('onException', this, exception);
+ }
+});
+
+Ajax.Updater = Class.create();
+
+Object.extend(Object.extend(Ajax.Updater.prototype, Ajax.Request.prototype), {
+ initialize: function(container, url, options) {
+ this.containers = {
+ success: container.success ? $(container.success) : $(container),
+ failure: container.failure ? $(container.failure) :
+ (container.success ? null : $(container))
+ }
+
+ this.transport = Ajax.getTransport();
+ this.setOptions(options);
+
+ var onComplete = this.options.onComplete || Prototype.emptyFunction;
+ this.options.onComplete = (function(transport, object) {
+ this.updateContent();
+ onComplete(transport, object);
+ }).bind(this);
+
+ this.request(url);
+ },
+
+ updateContent: function() {
+ var receiver = this.responseIsSuccess() ?
+ this.containers.success : this.containers.failure;
+ var response = this.transport.responseText;
+
+ if (!this.options.evalScripts)
+ response = response.stripScripts();
+
+ if (receiver) {
+ if (this.options.insertion) {
+ new this.options.insertion(receiver, response);
+ } else {
+ Element.update(receiver, response);
+ }
+ }
+
+ if (this.responseIsSuccess()) {
+ if (this.onComplete)
+ setTimeout(this.onComplete.bind(this), 10);
+ }
+ }
+});
+
+Ajax.PeriodicalUpdater = Class.create();
+Ajax.PeriodicalUpdater.prototype = Object.extend(new Ajax.Base(), {
+ initialize: function(container, url, options) {
+ this.setOptions(options);
+ this.onComplete = this.options.onComplete;
+
+ this.frequency = (this.options.frequency || 2);
+ this.decay = (this.options.decay || 1);
+
+ this.updater = {};
+ this.container = container;
+ this.url = url;
+
+ this.start();
+ },
+
+ start: function() {
+ this.options.onComplete = this.updateComplete.bind(this);
+ this.onTimerEvent();
+ },
+
+ stop: function() {
+ this.updater.onComplete = undefined;
+ clearTimeout(this.timer);
+ (this.onComplete || Prototype.emptyFunction).apply(this, arguments);
+ },
+
+ updateComplete: function(request) {
+ if (this.options.decay) {
+ this.decay = (request.responseText == this.lastText ?
+ this.decay * this.options.decay : 1);
+
+ this.lastText = request.responseText;
+ }
+ this.timer = setTimeout(this.onTimerEvent.bind(this),
+ this.decay * this.frequency * 1000);
+ },
+
+ onTimerEvent: function() {
+ this.updater = new Ajax.Updater(this.container, this.url, this.options);
+ }
+});
+function $() {
+ var results = [], element;
+ for (var i = 0; i < arguments.length; i++) {
+ element = arguments[i];
+ if (typeof element == 'string')
+ element = document.getElementById(element);
+ results.push(Element.extend(element));
+ }
+ return results.length < 2 ? results[0] : results;
+}
+
+document.getElementsByClassName = function(className, parentElement) {
+ var children = ($(parentElement) || document.body).getElementsByTagName('*');
+ return $A(children).inject([], function(elements, child) {
+ if (child.className.match(new RegExp("(^|\\s)" + className + "(\\s|$)")))
+ elements.push(Element.extend(child));
+ return elements;
+ });
+}
+
+/*--------------------------------------------------------------------------*/
+
+if (!window.Element)
+ var Element = new Object();
+
+Element.extend = function(element) {
+ if (!element) return;
+ if (_nativeExtensions) return element;
+
+ if (!element._extended && element.tagName && element != window) {
+ var methods = Element.Methods, cache = Element.extend.cache;
+ for (property in methods) {
+ var value = methods[property];
+ if (typeof value == 'function')
+ element[property] = cache.findOrStore(value);
+ }
+ }
+
+ element._extended = true;
+ return element;
+}
+
+Element.extend.cache = {
+ findOrStore: function(value) {
+ return this[value] = this[value] || function() {
+ return value.apply(null, [this].concat($A(arguments)));
+ }
+ }
+}
+
+Element.Methods = {
+ visible: function(element) {
+ return $(element).style.display != 'none';
+ },
+
+ toggle: function() {
+ for (var i = 0; i < arguments.length; i++) {
+ var element = $(arguments[i]);
+ Element[Element.visible(element) ? 'hide' : 'show'](element);
+ }
+ },
+
+ hide: function() {
+ for (var i = 0; i < arguments.length; i++) {
+ var element = $(arguments[i]);
+ element.style.display = 'none';
+ }
+ },
+
+ show: function() {
+ for (var i = 0; i < arguments.length; i++) {
+ var element = $(arguments[i]);
+ element.style.display = '';
+ }
+ },
+
+ remove: function(element) {
+ element = $(element);
+ element.parentNode.removeChild(element);
+ },
+
+ update: function(element, html) {
+ $(element).innerHTML = html.stripScripts();
+ setTimeout(function() {html.evalScripts()}, 10);
+ },
+
+ replace: function(element, html) {
+ element = $(element);
+ if (element.outerHTML) {
+ element.outerHTML = html.stripScripts();
+ } else {
+ var range = element.ownerDocument.createRange();
+ range.selectNodeContents(element);
+ element.parentNode.replaceChild(
+ range.createContextualFragment(html.stripScripts()), element);
+ }
+ setTimeout(function() {html.evalScripts()}, 10);
+ },
+
+ getHeight: function(element) {
+ element = $(element);
+ return element.offsetHeight;
+ },
+
+ classNames: function(element) {
+ return new Element.ClassNames(element);
+ },
+
+ hasClassName: function(element, className) {
+ if (!(element = $(element))) return;
+ return Element.classNames(element).include(className);
+ },
+
+ addClassName: function(element, className) {
+ if (!(element = $(element))) return;
+ return Element.classNames(element).add(className);
+ },
+
+ removeClassName: function(element, className) {
+ if (!(element = $(element))) return;
+ return Element.classNames(element).remove(className);
+ },
+
+ // removes whitespace-only text node children
+ cleanWhitespace: function(element) {
+ element = $(element);
+ for (var i = 0; i < element.childNodes.length; i++) {
+ var node = element.childNodes[i];
+ if (node.nodeType == 3 && !/\S/.test(node.nodeValue))
+ Element.remove(node);
+ }
+ },
+
+ empty: function(element) {
+ return $(element).innerHTML.match(/^\s*$/);
+ },
+
+ childOf: function(element, ancestor) {
+ element = $(element), ancestor = $(ancestor);
+ while (element = element.parentNode)
+ if (element == ancestor) return true;
+ return false;
+ },
+
+ scrollTo: function(element) {
+ element = $(element);
+ var x = element.x ? element.x : element.offsetLeft,
+ y = element.y ? element.y : element.offsetTop;
+ window.scrollTo(x, y);
+ },
+
+ getStyle: function(element, style) {
+ element = $(element);
+ var value = element.style[style.camelize()];
+ if (!value) {
+ if (document.defaultView && document.defaultView.getComputedStyle) {
+ var css = document.defaultView.getComputedStyle(element, null);
+ value = css ? css.getPropertyValue(style) : null;
+ } else if (element.currentStyle) {
+ value = element.currentStyle[style.camelize()];
+ }
+ }
+
+ if (window.opera && ['left', 'top', 'right', 'bottom'].include(style))
+ if (Element.getStyle(element, 'position') == 'static') value = 'auto';
+
+ return value == 'auto' ? null : value;
+ },
+
+ setStyle: function(element, style) {
+ element = $(element);
+ for (var name in style)
+ element.style[name.camelize()] = style[name];
+ },
+
+ getDimensions: function(element) {
+ element = $(element);
+ if (Element.getStyle(element, 'display') != 'none')
+ return {width: element.offsetWidth, height: element.offsetHeight};
+
+ // All *Width and *Height properties give 0 on elements with display none,
+ // so enable the element temporarily
+ var els = element.style;
+ var originalVisibility = els.visibility;
+ var originalPosition = els.position;
+ els.visibility = 'hidden';
+ els.position = 'absolute';
+ els.display = '';
+ var originalWidth = element.clientWidth;
+ var originalHeight = element.clientHeight;
+ els.display = 'none';
+ els.position = originalPosition;
+ els.visibility = originalVisibility;
+ return {width: originalWidth, height: originalHeight};
+ },
+
+ makePositioned: function(element) {
+ element = $(element);
+ var pos = Element.getStyle(element, 'position');
+ if (pos == 'static' || !pos) {
+ element._madePositioned = true;
+ element.style.position = 'relative';
+ // Opera returns the offset relative to the positioning context, when an
+ // element is position relative but top and left have not been defined
+ if (window.opera) {
+ element.style.top = 0;
+ element.style.left = 0;
+ }
+ }
+ },
+
+ undoPositioned: function(element) {
+ element = $(element);
+ if (element._madePositioned) {
+ element._madePositioned = undefined;
+ element.style.position =
+ element.style.top =
+ element.style.left =
+ element.style.bottom =
+ element.style.right = '';
+ }
+ },
+
+ makeClipping: function(element) {
+ element = $(element);
+ if (element._overflow) return;
+ element._overflow = element.style.overflow;
+ if ((Element.getStyle(element, 'overflow') || 'visible') != 'hidden')
+ element.style.overflow = 'hidden';
+ },
+
+ undoClipping: function(element) {
+ element = $(element);
+ if (element._overflow) return;
+ element.style.overflow = element._overflow;
+ element._overflow = undefined;
+ }
+}
+
+Object.extend(Element, Element.Methods);
+
+var _nativeExtensions = false;
+
+if(!HTMLElement && /Konqueror|Safari|KHTML/.test(navigator.userAgent)) {
+ var HTMLElement = {}
+ HTMLElement.prototype = document.createElement('div').__proto__;
+}
+
+Element.addMethods = function(methods) {
+ Object.extend(Element.Methods, methods || {});
+
+ if(typeof HTMLElement != 'undefined') {
+ var methods = Element.Methods, cache = Element.extend.cache;
+ for (property in methods) {
+ var value = methods[property];
+ if (typeof value == 'function')
+ HTMLElement.prototype[property] = cache.findOrStore(value);
+ }
+ _nativeExtensions = true;
+ }
+}
+
+Element.addMethods();
+
+var Toggle = new Object();
+Toggle.display = Element.toggle;
+
+/*--------------------------------------------------------------------------*/
+
+Abstract.Insertion = function(adjacency) {
+ this.adjacency = adjacency;
+}
+
+Abstract.Insertion.prototype = {
+ initialize: function(element, content) {
+ this.element = $(element);
+ this.content = content.stripScripts();
+
+ if (this.adjacency && this.element.insertAdjacentHTML) {
+ try {
+ this.element.insertAdjacentHTML(this.adjacency, this.content);
+ } catch (e) {
+ var tagName = this.element.tagName.toLowerCase();
+ if (tagName == 'tbody' || tagName == 'tr') {
+ this.insertContent(this.contentFromAnonymousTable());
+ } else {
+ throw e;
+ }
+ }
+ } else {
+ this.range = this.element.ownerDocument.createRange();
+ if (this.initializeRange) this.initializeRange();
+ this.insertContent([this.range.createContextualFragment(this.content)]);
+ }
+
+ setTimeout(function() {content.evalScripts()}, 10);
+ },
+
+ contentFromAnonymousTable: function() {
+ var div = document.createElement('div');
+ div.innerHTML = '<table><tbody>' + this.content + '</tbody></table>';
+ return $A(div.childNodes[0].childNodes[0].childNodes);
+ }
+}
+
+var Insertion = new Object();
+
+Insertion.Before = Class.create();
+Insertion.Before.prototype = Object.extend(new Abstract.Insertion('beforeBegin'), {
+ initializeRange: function() {
+ this.range.setStartBefore(this.element);
+ },
+
+ insertContent: function(fragments) {
+ fragments.each((function(fragment) {
+ this.element.parentNode.insertBefore(fragment, this.element);
+ }).bind(this));
+ }
+});
+
+Insertion.Top = Class.create();
+Insertion.Top.prototype = Object.extend(new Abstract.Insertion('afterBegin'), {
+ initializeRange: function() {
+ this.range.selectNodeContents(this.element);
+ this.range.collapse(true);
+ },
+
+ insertContent: function(fragments) {
+ fragments.reverse(false).each((function(fragment) {
+ this.element.insertBefore(fragment, this.element.firstChild);
+ }).bind(this));
+ }
+});
+
+Insertion.Bottom = Class.create();
+Insertion.Bottom.prototype = Object.extend(new Abstract.Insertion('beforeEnd'), {
+ initializeRange: function() {
+ this.range.selectNodeContents(this.element);
+ this.range.collapse(this.element);
+ },
+
+ insertContent: function(fragments) {
+ fragments.each((function(fragment) {
+ this.element.appendChild(fragment);
+ }).bind(this));
+ }
+});
+
+Insertion.After = Class.create();
+Insertion.After.prototype = Object.extend(new Abstract.Insertion('afterEnd'), {
+ initializeRange: function() {
+ this.range.setStartAfter(this.element);
+ },
+
+ insertContent: function(fragments) {
+ fragments.each((function(fragment) {
+ this.element.parentNode.insertBefore(fragment,
+ this.element.nextSibling);
+ }).bind(this));
+ }
+});
+
+/*--------------------------------------------------------------------------*/
+
+Element.ClassNames = Class.create();
+Element.ClassNames.prototype = {
+ initialize: function(element) {
+ this.element = $(element);
+ },
+
+ _each: function(iterator) {
+ this.element.className.split(/\s+/).select(function(name) {
+ return name.length > 0;
+ })._each(iterator);
+ },
+
+ set: function(className) {
+ this.element.className = className;
+ },
+
+ add: function(classNameToAdd) {
+ if (this.include(classNameToAdd)) return;
+ this.set(this.toArray().concat(classNameToAdd).join(' '));
+ },
+
+ remove: function(classNameToRemove) {
+ if (!this.include(classNameToRemove)) return;
+ this.set(this.select(function(className) {
+ return className != classNameToRemove;
+ }).join(' '));
+ },
+
+ toString: function() {
+ return this.toArray().join(' ');
+ }
+}
+
+Object.extend(Element.ClassNames.prototype, Enumerable);
+var Selector = Class.create();
+Selector.prototype = {
+ initialize: function(expression) {
+ this.params = {classNames: []};
+ this.expression = expression.toString().strip();
+ this.parseExpression();
+ this.compileMatcher();
+ },
+
+ parseExpression: function() {
+ function abort(message) { throw 'Parse error in selector: ' + message; }
+
+ if (this.expression == '') abort('empty expression');
+
+ var params = this.params, expr = this.expression, match, modifier, clause, rest;
+ while (match = expr.match(/^(.*)\[([a-z0-9_:-]+?)(?:([~\|!]?=)(?:"([^"]*)"|([^\]\s]*)))?\]$/i)) {
+ params.attributes = params.attributes || [];
+ params.attributes.push({name: match[2], operator: match[3], value: match[4] || match[5] || ''});
+ expr = match[1];
+ }
+
+ if (expr == '*') return this.params.wildcard = true;
+
+ while (match = expr.match(/^([^a-z0-9_-])?([a-z0-9_-]+)(.*)/i)) {
+ modifier = match[1], clause = match[2], rest = match[3];
+ switch (modifier) {
+ case '#': params.id = clause; break;
+ case '.': params.classNames.push(clause); break;
+ case '':
+ case undefined: params.tagName = clause.toUpperCase(); break;
+ default: abort(expr.inspect());
+ }
+ expr = rest;
+ }
+
+ if (expr.length > 0) abort(expr.inspect());
+ },
+
+ buildMatchExpression: function() {
+ var params = this.params, conditions = [], clause;
+
+ if (params.wildcard)
+ conditions.push('true');
+ if (clause = params.id)
+ conditions.push('element.id == ' + clause.inspect());
+ if (clause = params.tagName)
+ conditions.push('element.tagName.toUpperCase() == ' + clause.inspect());
+ if ((clause = params.classNames).length > 0)
+ for (var i = 0; i < clause.length; i++)
+ conditions.push('Element.hasClassName(element, ' + clause[i].inspect() + ')');
+ if (clause = params.attributes) {
+ clause.each(function(attribute) {
+ var value = 'element.getAttribute(' + attribute.name.inspect() + ')';
+ var splitValueBy = function(delimiter) {
+ return value + ' && ' + value + '.split(' + delimiter.inspect() + ')';
+ }
+
+ switch (attribute.operator) {
+ case '=': conditions.push(value + ' == ' + attribute.value.inspect()); break;
+ case '~=': conditions.push(splitValueBy(' ') + '.include(' + attribute.value.inspect() + ')'); break;
+ case '|=': conditions.push(
+ splitValueBy('-') + '.first().toUpperCase() == ' + attribute.value.toUpperCase().inspect()
+ ); break;
+ case '!=': conditions.push(value + ' != ' + attribute.value.inspect()); break;
+ case '':
+ case undefined: conditions.push(value + ' != null'); break;
+ default: throw 'Unknown operator ' + attribute.operator + ' in selector';
+ }
+ });
+ }
+
+ return conditions.join(' && ');
+ },
+
+ compileMatcher: function() {
+ this.match = new Function('element', 'if (!element.tagName) return false; \n' +
+ 'return ' + this.buildMatchExpression());
+ },
+
+ findElements: function(scope) {
+ var element;
+
+ if (element = $(this.params.id))
+ if (this.match(element))
+ if (!scope || Element.childOf(element, scope))
+ return [element];
+
+ scope = (scope || document).getElementsByTagName(this.params.tagName || '*');
+
+ var results = [];
+ for (var i = 0; i < scope.length; i++)
+ if (this.match(element = scope[i]))
+ results.push(Element.extend(element));
+
+ return results;
+ },
+
+ toString: function() {
+ return this.expression;
+ }
+}
+
+function $$() {
+ return $A(arguments).map(function(expression) {
+ return expression.strip().split(/\s+/).inject([null], function(results, expr) {
+ var selector = new Selector(expr);
+ return results.map(selector.findElements.bind(selector)).flatten();
+ });
+ }).flatten();
+}
+var Field = {
+ clear: function() {
+ for (var i = 0; i < arguments.length; i++)
+ $(arguments[i]).value = '';
+ },
+
+ focus: function(element) {
+ $(element).focus();
+ },
+
+ present: function() {
+ for (var i = 0; i < arguments.length; i++)
+ if ($(arguments[i]).value == '') return false;
+ return true;
+ },
+
+ select: function(element) {
+ $(element).select();
+ },
+
+ activate: function(element) {
+ element = $(element);
+ element.focus();
+ if (element.select)
+ element.select();
+ }
+}
+
+/*--------------------------------------------------------------------------*/
+
+var Form = {
+ serialize: function(form) {
+ var elements = Form.getElements($(form));
+ var queryComponents = new Array();
+
+ for (var i = 0; i < elements.length; i++) {
+ var queryComponent = Form.Element.serialize(elements[i]);
+ if (queryComponent)
+ queryComponents.push(queryComponent);
+ }
+
+ return queryComponents.join('&');
+ },
+
+ getElements: function(form) {
+ form = $(form);
+ var elements = new Array();
+
+ for (var tagName in Form.Element.Serializers) {
+ var tagElements = form.getElementsByTagName(tagName);
+ for (var j = 0; j < tagElements.length; j++)
+ elements.push(tagElements[j]);
+ }
+ return elements;
+ },
+
+ getInputs: function(form, typeName, name) {
+ form = $(form);
+ var inputs = form.getElementsByTagName('input');
+
+ if (!typeName && !name)
+ return inputs;
+
+ var matchingInputs = new Array();
+ for (var i = 0; i < inputs.length; i++) {
+ var input = inputs[i];
+ if ((typeName && input.type != typeName) ||
+ (name && input.name != name))
+ continue;
+ matchingInputs.push(input);
+ }
+
+ return matchingInputs;
+ },
+
+ disable: function(form) {
+ var elements = Form.getElements(form);
+ for (var i = 0; i < elements.length; i++) {
+ var element = elements[i];
+ element.blur();
+ element.disabled = 'true';
+ }
+ },
+
+ enable: function(form) {
+ var elements = Form.getElements(form);
+ for (var i = 0; i < elements.length; i++) {
+ var element = elements[i];
+ element.disabled = '';
+ }
+ },
+
+ findFirstElement: function(form) {
+ return Form.getElements(form).find(function(element) {
+ return element.type != 'hidden' && !element.disabled &&
+ ['input', 'select', 'textarea'].include(element.tagName.toLowerCase());
+ });
+ },
+
+ focusFirstElement: function(form) {
+ Field.activate(Form.findFirstElement(form));
+ },
+
+ reset: function(form) {
+ $(form).reset();
+ }
+}
+
+Form.Element = {
+ serialize: function(element) {
+ element = $(element);
+ var method = element.tagName.toLowerCase();
+ var parameter = Form.Element.Serializers[method](element);
+
+ if (parameter) {
+ var key = encodeURIComponent(parameter[0]);
+ if (key.length == 0) return;
+
+ if (parameter[1].constructor != Array)
+ parameter[1] = [parameter[1]];
+
+ return parameter[1].map(function(value) {
+ return key + '=' + encodeURIComponent(value);
+ }).join('&');
+ }
+ },
+
+ getValue: function(element) {
+ element = $(element);
+ var method = element.tagName.toLowerCase();
+ var parameter = Form.Element.Serializers[method](element);
+
+ if (parameter)
+ return parameter[1];
+ }
+}
+
+Form.Element.Serializers = {
+ input: function(element) {
+ switch (element.type.toLowerCase()) {
+ case 'submit':
+ case 'hidden':
+ case 'password':
+ case 'text':
+ return Form.Element.Serializers.textarea(element);
+ case 'checkbox':
+ case 'radio':
+ return Form.Element.Serializers.inputSelector(element);
+ }
+ return false;
+ },
+
+ inputSelector: function(element) {
+ if (element.checked)
+ return [element.name, element.value];
+ },
+
+ textarea: function(element) {
+ return [element.name, element.value];
+ },
+
+ select: function(element) {
+ return Form.Element.Serializers[element.type == 'select-one' ?
+ 'selectOne' : 'selectMany'](element);
+ },
+
+ selectOne: function(element) {
+ var value = '', opt, index = element.selectedIndex;
+ if (index >= 0) {
+ opt = element.options[index];
+ value = opt.value || opt.text;
+ }
+ return [element.name, value];
+ },
+
+ selectMany: function(element) {
+ var value = [];
+ for (var i = 0; i < element.length; i++) {
+ var opt = element.options[i];
+ if (opt.selected)
+ value.push(opt.value || opt.text);
+ }
+ return [element.name, value];
+ }
+}
+
+/*--------------------------------------------------------------------------*/
+
+var $F = Form.Element.getValue;
+
+/*--------------------------------------------------------------------------*/
+
+Abstract.TimedObserver = function() {}
+Abstract.TimedObserver.prototype = {
+ initialize: function(element, frequency, callback) {
+ this.frequency = frequency;
+ this.element = $(element);
+ this.callback = callback;
+
+ this.lastValue = this.getValue();
+ this.registerCallback();
+ },
+
+ registerCallback: function() {
+ setInterval(this.onTimerEvent.bind(this), this.frequency * 1000);
+ },
+
+ onTimerEvent: function() {
+ var value = this.getValue();
+ if (this.lastValue != value) {
+ this.callback(this.element, value);
+ this.lastValue = value;
+ }
+ }
+}
+
+Form.Element.Observer = Class.create();
+Form.Element.Observer.prototype = Object.extend(new Abstract.TimedObserver(), {
+ getValue: function() {
+ return Form.Element.getValue(this.element);
+ }
+});
+
+Form.Observer = Class.create();
+Form.Observer.prototype = Object.extend(new Abstract.TimedObserver(), {
+ getValue: function() {
+ return Form.serialize(this.element);
+ }
+});
+
+/*--------------------------------------------------------------------------*/
+
+Abstract.EventObserver = function() {}
+Abstract.EventObserver.prototype = {
+ initialize: function(element, callback) {
+ this.element = $(element);
+ this.callback = callback;
+
+ this.lastValue = this.getValue();
+ if (this.element.tagName.toLowerCase() == 'form')
+ this.registerFormCallbacks();
+ else
+ this.registerCallback(this.element);
+ },
+
+ onElementEvent: function() {
+ var value = this.getValue();
+ if (this.lastValue != value) {
+ this.callback(this.element, value);
+ this.lastValue = value;
+ }
+ },
+
+ registerFormCallbacks: function() {
+ var elements = Form.getElements(this.element);
+ for (var i = 0; i < elements.length; i++)
+ this.registerCallback(elements[i]);
+ },
+
+ registerCallback: function(element) {
+ if (element.type) {
+ switch (element.type.toLowerCase()) {
+ case 'checkbox':
+ case 'radio':
+ Event.observe(element, 'click', this.onElementEvent.bind(this));
+ break;
+ case 'password':
+ case 'text':
+ case 'textarea':
+ case 'select-one':
+ case 'select-multiple':
+ Event.observe(element, 'change', this.onElementEvent.bind(this));
+ break;
+ }
+ }
+ }
+}
+
+Form.Element.EventObserver = Class.create();
+Form.Element.EventObserver.prototype = Object.extend(new Abstract.EventObserver(), {
+ getValue: function() {
+ return Form.Element.getValue(this.element);
+ }
+});
+
+Form.EventObserver = Class.create();
+Form.EventObserver.prototype = Object.extend(new Abstract.EventObserver(), {
+ getValue: function() {
+ return Form.serialize(this.element);
+ }
+});
+if (!window.Event) {
+ var Event = new Object();
+}
+
+Object.extend(Event, {
+ KEY_BACKSPACE: 8,
+ KEY_TAB: 9,
+ KEY_RETURN: 13,
+ KEY_ESC: 27,
+ KEY_LEFT: 37,
+ KEY_UP: 38,
+ KEY_RIGHT: 39,
+ KEY_DOWN: 40,
+ KEY_DELETE: 46,
+
+ element: function(event) {
+ return event.target || event.srcElement;
+ },
+
+ isLeftClick: function(event) {
+ return (((event.which) && (event.which == 1)) ||
+ ((event.button) && (event.button == 1)));
+ },
+
+ pointerX: function(event) {
+ return event.pageX || (event.clientX +
+ (document.documentElement.scrollLeft || document.body.scrollLeft));
+ },
+
+ pointerY: function(event) {
+ return event.pageY || (event.clientY +
+ (document.documentElement.scrollTop || document.body.scrollTop));
+ },
+
+ stop: function(event) {
+ if (event.preventDefault) {
+ event.preventDefault();
+ event.stopPropagation();
+ } else {
+ event.returnValue = false;
+ event.cancelBubble = true;
+ }
+ },
+
+ // find the first node with the given tagName, starting from the
+ // node the event was triggered on; traverses the DOM upwards
+ findElement: function(event, tagName) {
+ var element = Event.element(event);
+ while (element.parentNode && (!element.tagName ||
+ (element.tagName.toUpperCase() != tagName.toUpperCase())))
+ element = element.parentNode;
+ return element;
+ },
+
+ observers: false,
+
+ _observeAndCache: function(element, name, observer, useCapture) {
+ if (!this.observers) this.observers = [];
+ if (element.addEventListener) {
+ this.observers.push([element, name, observer, useCapture]);
+ element.addEventListener(name, observer, useCapture);
+ } else if (element.attachEvent) {
+ this.observers.push([element, name, observer, useCapture]);
+ element.attachEvent('on' + name, observer);
+ }
+ },
+
+ unloadCache: function() {
+ if (!Event.observers) return;
+ for (var i = 0; i < Event.observers.length; i++) {
+ Event.stopObserving.apply(this, Event.observers[i]);
+ Event.observers[i][0] = null;
+ }
+ Event.observers = false;
+ },
+
+ observe: function(element, name, observer, useCapture) {
+ var element = $(element);
+ useCapture = useCapture || false;
+
+ if (name == 'keypress' &&
+ (navigator.appVersion.match(/Konqueror|Safari|KHTML/)
+ || element.attachEvent))
+ name = 'keydown';
+
+ this._observeAndCache(element, name, observer, useCapture);
+ },
+
+ stopObserving: function(element, name, observer, useCapture) {
+ var element = $(element);
+ useCapture = useCapture || false;
+
+ if (name == 'keypress' &&
+ (navigator.appVersion.match(/Konqueror|Safari|KHTML/)
+ || element.detachEvent))
+ name = 'keydown';
+
+ if (element.removeEventListener) {
+ element.removeEventListener(name, observer, useCapture);
+ } else if (element.detachEvent) {
+ element.detachEvent('on' + name, observer);
+ }
+ }
+});
+
+/* prevent memory leaks in IE */
+if (navigator.appVersion.match(/\bMSIE\b/))
+ Event.observe(window, 'unload', Event.unloadCache, false);
+var Position = {
+ // set to true if needed, warning: firefox performance problems
+ // NOT neeeded for page scrolling, only if draggable contained in
+ // scrollable elements
+ includeScrollOffsets: false,
+
+ // must be called before calling withinIncludingScrolloffset, every time the
+ // page is scrolled
+ prepare: function() {
+ this.deltaX = window.pageXOffset
+ || document.documentElement.scrollLeft
+ || document.body.scrollLeft
+ || 0;
+ this.deltaY = window.pageYOffset
+ || document.documentElement.scrollTop
+ || document.body.scrollTop
+ || 0;
+ },
+
+ realOffset: function(element) {
+ var valueT = 0, valueL = 0;
+ do {
+ valueT += element.scrollTop || 0;
+ valueL += element.scrollLeft || 0;
+ element = element.parentNode;
+ } while (element);
+ return [valueL, valueT];
+ },
+
+ cumulativeOffset: function(element) {
+ var valueT = 0, valueL = 0;
+ do {
+ valueT += element.offsetTop || 0;
+ valueL += element.offsetLeft || 0;
+ element = element.offsetParent;
+ } while (element);
+ return [valueL, valueT];
+ },
+
+ positionedOffset: function(element) {
+ var valueT = 0, valueL = 0;
+ do {
+ valueT += element.offsetTop || 0;
+ valueL += element.offsetLeft || 0;
+ element = element.offsetParent;
+ if (element) {
+ p = Element.getStyle(element, 'position');
+ if (p == 'relative' || p == 'absolute') break;
+ }
+ } while (element);
+ return [valueL, valueT];
+ },
+
+ offsetParent: function(element) {
+ if (element.offsetParent) return element.offsetParent;
+ if (element == document.body) return element;
+
+ while ((element = element.parentNode) && element != document.body)
+ if (Element.getStyle(element, 'position') != 'static')
+ return element;
+
+ return document.body;
+ },
+
+ // caches x/y coordinate pair to use with overlap
+ within: function(element, x, y) {
+ if (this.includeScrollOffsets)
+ return this.withinIncludingScrolloffsets(element, x, y);
+ this.xcomp = x;
+ this.ycomp = y;
+ this.offset = this.cumulativeOffset(element);
+
+ return (y >= this.offset[1] &&
+ y < this.offset[1] + element.offsetHeight &&
+ x >= this.offset[0] &&
+ x < this.offset[0] + element.offsetWidth);
+ },
+
+ withinIncludingScrolloffsets: function(element, x, y) {
+ var offsetcache = this.realOffset(element);
+
+ this.xcomp = x + offsetcache[0] - this.deltaX;
+ this.ycomp = y + offsetcache[1] - this.deltaY;
+ this.offset = this.cumulativeOffset(element);
+
+ return (this.ycomp >= this.offset[1] &&
+ this.ycomp < this.offset[1] + element.offsetHeight &&
+ this.xcomp >= this.offset[0] &&
+ this.xcomp < this.offset[0] + element.offsetWidth);
+ },
+
+ // within must be called directly before
+ overlap: function(mode, element) {
+ if (!mode) return 0;
+ if (mode == 'vertical')
+ return ((this.offset[1] + element.offsetHeight) - this.ycomp) /
+ element.offsetHeight;
+ if (mode == 'horizontal')
+ return ((this.offset[0] + element.offsetWidth) - this.xcomp) /
+ element.offsetWidth;
+ },
+
+ clone: function(source, target) {
+ source = $(source);
+ target = $(target);
+ target.style.position = 'absolute';
+ var offsets = this.cumulativeOffset(source);
+ target.style.top = offsets[1] + 'px';
+ target.style.left = offsets[0] + 'px';
+ target.style.width = source.offsetWidth + 'px';
+ target.style.height = source.offsetHeight + 'px';
+ },
+
+ page: function(forElement) {
+ var valueT = 0, valueL = 0;
+
+ var element = forElement;
+ do {
+ valueT += element.offsetTop || 0;
+ valueL += element.offsetLeft || 0;
+
+ // Safari fix
+ if (element.offsetParent==document.body)
+ if (Element.getStyle(element,'position')=='absolute') break;
+
+ } while (element = element.offsetParent);
+
+ element = forElement;
+ do {
+ valueT -= element.scrollTop || 0;
+ valueL -= element.scrollLeft || 0;
+ } while (element = element.parentNode);
+
+ return [valueL, valueT];
+ },
+
+ clone: function(source, target) {
+ var options = Object.extend({
+ setLeft: true,
+ setTop: true,
+ setWidth: true,
+ setHeight: true,
+ offsetTop: 0,
+ offsetLeft: 0
+ }, arguments[2] || {})
+
+ // find page position of source
+ source = $(source);
+ var p = Position.page(source);
+
+ // find coordinate system to use
+ target = $(target);
+ var delta = [0, 0];
+ var parent = null;
+ // delta [0,0] will do fine with position: fixed elements,
+ // position:absolute needs offsetParent deltas
+ if (Element.getStyle(target,'position') == 'absolute') {
+ parent = Position.offsetParent(target);
+ delta = Position.page(parent);
+ }
+
+ // correct by body offsets (fixes Safari)
+ if (parent == document.body) {
+ delta[0] -= document.body.offsetLeft;
+ delta[1] -= document.body.offsetTop;
+ }
+
+ // set position
+ if(options.setLeft) target.style.left = (p[0] - delta[0] + options.offsetLeft) + 'px';
+ if(options.setTop) target.style.top = (p[1] - delta[1] + options.offsetTop) + 'px';
+ if(options.setWidth) target.style.width = source.offsetWidth + 'px';
+ if(options.setHeight) target.style.height = source.offsetHeight + 'px';
+ },
+
+ absolutize: function(element) {
+ element = $(element);
+ if (element.style.position == 'absolute') return;
+ Position.prepare();
+
+ var offsets = Position.positionedOffset(element);
+ var top = offsets[1];
+ var left = offsets[0];
+ var width = element.clientWidth;
+ var height = element.clientHeight;
+
+ element._originalLeft = left - parseFloat(element.style.left || 0);
+ element._originalTop = top - parseFloat(element.style.top || 0);
+ element._originalWidth = element.style.width;
+ element._originalHeight = element.style.height;
+
+ element.style.position = 'absolute';
+ element.style.top = top + 'px';;
+ element.style.left = left + 'px';;
+ element.style.width = width + 'px';;
+ element.style.height = height + 'px';;
+ },
+
+ relativize: function(element) {
+ element = $(element);
+ if (element.style.position == 'relative') return;
+ Position.prepare();
+
+ element.style.position = 'relative';
+ var top = parseFloat(element.style.top || 0) - (element._originalTop || 0);
+ var left = parseFloat(element.style.left || 0) - (element._originalLeft || 0);
+
+ element.style.top = top + 'px';
+ element.style.left = left + 'px';
+ element.style.height = element._originalHeight;
+ element.style.width = element._originalWidth;
+ }
+}
+
+// Safari returns margins on body which is incorrect if the child is absolutely
+// positioned. For performance reasons, redefine Position.cumulativeOffset for
+// KHTML/WebKit only.
+if (/Konqueror|Safari|KHTML/.test(navigator.userAgent)) {
+ Position.cumulativeOffset = function(element) {
+ var valueT = 0, valueL = 0;
+ do {
+ valueT += element.offsetTop || 0;
+ valueL += element.offsetLeft || 0;
+ if (element.offsetParent == document.body)
+ if (Element.getStyle(element, 'position') == 'absolute') break;
+
+ element = element.offsetParent;
+ } while (element);
+
+ return [valueL, valueT];
+ }
+}
\ No newline at end of file
--- /dev/null
+// Copyright (c) 2005 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
+//
+// See scriptaculous.js for full license.
+
+var Builder = {
+ NODEMAP: {
+ AREA: 'map',
+ CAPTION: 'table',
+ COL: 'table',
+ COLGROUP: 'table',
+ LEGEND: 'fieldset',
+ OPTGROUP: 'select',
+ OPTION: 'select',
+ PARAM: 'object',
+ TBODY: 'table',
+ TD: 'table',
+ TFOOT: 'table',
+ TH: 'table',
+ THEAD: 'table',
+ TR: 'table'
+ },
+ // note: For Firefox < 1.5, OPTION and OPTGROUP tags are currently broken,
+ // due to a Firefox bug
+ node: function(elementName) {
+ elementName = elementName.toUpperCase();
+
+ // try innerHTML approach
+ var parentTag = this.NODEMAP[elementName] || 'div';
+ var parentElement = document.createElement(parentTag);
+ try { // prevent IE "feature": http://dev.rubyonrails.org/ticket/2707
+ parentElement.innerHTML = "<" + elementName + "></" + elementName + ">";
+ } catch(e) {}
+ var element = parentElement.firstChild || null;
+
+ // see if browser added wrapping tags
+ if(element && (element.tagName != elementName))
+ element = element.getElementsByTagName(elementName)[0];
+
+ // fallback to createElement approach
+ if(!element) element = document.createElement(elementName);
+
+ // abort if nothing could be created
+ if(!element) return;
+
+ // attributes (or text)
+ if(arguments[1])
+ if(this._isStringOrNumber(arguments[1]) ||
+ (arguments[1] instanceof Array)) {
+ this._children(element, arguments[1]);
+ } else {
+ var attrs = this._attributes(arguments[1]);
+ if(attrs.length) {
+ try { // prevent IE "feature": http://dev.rubyonrails.org/ticket/2707
+ parentElement.innerHTML = "<" +elementName + " " +
+ attrs + "></" + elementName + ">";
+ } catch(e) {}
+ element = parentElement.firstChild || null;
+ // workaround firefox 1.0.X bug
+ if(!element) {
+ element = document.createElement(elementName);
+ for(attr in arguments[1])
+ element[attr == 'class' ? 'className' : attr] = arguments[1][attr];
+ }
+ if(element.tagName != elementName)
+ element = parentElement.getElementsByTagName(elementName)[0];
+ }
+ }
+
+ // text, or array of children
+ if(arguments[2])
+ this._children(element, arguments[2]);
+
+ return element;
+ },
+ _text: function(text) {
+ return document.createTextNode(text);
+ },
+ _attributes: function(attributes) {
+ var attrs = [];
+ for(attribute in attributes)
+ attrs.push((attribute=='className' ? 'class' : attribute) +
+ '="' + attributes[attribute].toString().escapeHTML() + '"');
+ return attrs.join(" ");
+ },
+ _children: function(element, children) {
+ if(typeof children=='object') { // array can hold nodes and text
+ children.flatten().each( function(e) {
+ if(typeof e=='object')
+ element.appendChild(e)
+ else
+ if(Builder._isStringOrNumber(e))
+ element.appendChild(Builder._text(e));
+ });
+ } else
+ if(Builder._isStringOrNumber(children))
+ element.appendChild(Builder._text(children));
+ },
+ _isStringOrNumber: function(param) {
+ return(typeof param=='string' || typeof param=='number');
+ }
+}
\ No newline at end of file
--- /dev/null
+// Copyright (c) 2005 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
+// (c) 2005 Ivan Krstic (http://blogs.law.harvard.edu/ivan)
+// (c) 2005 Jon Tirsen (http://www.tirsen.com)
+// Contributors:
+// Richard Livsey
+// Rahul Bhargava
+// Rob Wills
+//
+// See scriptaculous.js for full license.
+
+// Autocompleter.Base handles all the autocompletion functionality
+// that's independent of the data source for autocompletion. This
+// includes drawing the autocompletion menu, observing keyboard
+// and mouse events, and similar.
+//
+// Specific autocompleters need to provide, at the very least,
+// a getUpdatedChoices function that will be invoked every time
+// the text inside the monitored textbox changes. This method
+// should get the text for which to provide autocompletion by
+// invoking this.getToken(), NOT by directly accessing
+// this.element.value. This is to allow incremental tokenized
+// autocompletion. Specific auto-completion logic (AJAX, etc)
+// belongs in getUpdatedChoices.
+//
+// Tokenized incremental autocompletion is enabled automatically
+// when an autocompleter is instantiated with the 'tokens' option
+// in the options parameter, e.g.:
+// new Ajax.Autocompleter('id','upd', '/url/', { tokens: ',' });
+// will incrementally autocomplete with a comma as the token.
+// Additionally, ',' in the above example can be replaced with
+// a token array, e.g. { tokens: [',', '\n'] } which
+// enables autocompletion on multiple tokens. This is most
+// useful when one of the tokens is \n (a newline), as it
+// allows smart autocompletion after linebreaks.
+
+var Autocompleter = {}
+Autocompleter.Base = function() {};
+Autocompleter.Base.prototype = {
+ baseInitialize: function(element, update, options) {
+ this.element = $(element);
+ this.update = $(update);
+ this.hasFocus = false;
+ this.changed = false;
+ this.active = false;
+ this.index = 0;
+ this.entryCount = 0;
+
+ if (this.setOptions)
+ this.setOptions(options);
+ else
+ this.options = options || {};
+
+ this.options.paramName = this.options.paramName || this.element.name;
+ this.options.tokens = this.options.tokens || [];
+ this.options.frequency = this.options.frequency || 0.4;
+ this.options.minChars = this.options.minChars || 1;
+ this.options.onShow = this.options.onShow ||
+ function(element, update){
+ if(!update.style.position || update.style.position=='absolute') {
+ update.style.position = 'absolute';
+ Position.clone(element, update, {setHeight: false, offsetTop: element.offsetHeight});
+ }
+ Effect.Appear(update,{duration:0.15});
+ };
+ this.options.onHide = this.options.onHide ||
+ function(element, update){ new Effect.Fade(update,{duration:0.15}) };
+
+ if (typeof(this.options.tokens) == 'string')
+ this.options.tokens = new Array(this.options.tokens);
+
+ this.observer = null;
+
+ this.element.setAttribute('autocomplete','off');
+
+ Element.hide(this.update);
+
+ Event.observe(this.element, "blur", this.onBlur.bindAsEventListener(this));
+ Event.observe(this.element, "keypress", this.onKeyPress.bindAsEventListener(this));
+ },
+
+ show: function() {
+ if(Element.getStyle(this.update, 'display')=='none') this.options.onShow(this.element, this.update);
+ if(!this.iefix &&
+ (navigator.appVersion.indexOf('MSIE')>0) &&
+ (navigator.userAgent.indexOf('Opera')<0) &&
+ (Element.getStyle(this.update, 'position')=='absolute')) {
+ new Insertion.After(this.update,
+ '<iframe id="' + this.update.id + '_iefix" '+
+ 'style="display:none;position:absolute;filter:progid:DXImageTransform.Microsoft.Alpha(opacity=0);" ' +
+ 'src="javascript:false;" frameborder="0" scrolling="no"></iframe>');
+ this.iefix = $(this.update.id+'_iefix');
+ }
+ if(this.iefix) setTimeout(this.fixIEOverlapping.bind(this), 50);
+ },
+
+ fixIEOverlapping: function() {
+ Position.clone(this.update, this.iefix);
+ this.iefix.style.zIndex = 1;
+ this.update.style.zIndex = 2;
+ Element.show(this.iefix);
+ },
+
+ hide: function() {
+ this.stopIndicator();
+ if(Element.getStyle(this.update, 'display')!='none') this.options.onHide(this.element, this.update);
+ if(this.iefix) Element.hide(this.iefix);
+ },
+
+ startIndicator: function() {
+ if(this.options.indicator) Element.show(this.options.indicator);
+ },
+
+ stopIndicator: function() {
+ if(this.options.indicator) Element.hide(this.options.indicator);
+ },
+
+ onKeyPress: function(event) {
+ if(this.active)
+ switch(event.keyCode) {
+ case Event.KEY_TAB:
+ case Event.KEY_RETURN:
+ this.selectEntry();
+ Event.stop(event);
+ case Event.KEY_ESC:
+ this.hide();
+ this.active = false;
+ Event.stop(event);
+ return;
+ case Event.KEY_LEFT:
+ case Event.KEY_RIGHT:
+ return;
+ case Event.KEY_UP:
+ this.markPrevious();
+ this.render();
+ if(navigator.appVersion.indexOf('AppleWebKit')>0) Event.stop(event);
+ return;
+ case Event.KEY_DOWN:
+ this.markNext();
+ this.render();
+ if(navigator.appVersion.indexOf('AppleWebKit')>0) Event.stop(event);
+ return;
+ }
+ else
+ if(event.keyCode==Event.KEY_TAB || event.keyCode==Event.KEY_RETURN ||
+ (navigator.appVersion.indexOf('AppleWebKit') > 0 && event.keyCode == 0)) return;
+
+ this.changed = true;
+ this.hasFocus = true;
+
+ if(this.observer) clearTimeout(this.observer);
+ this.observer =
+ setTimeout(this.onObserverEvent.bind(this), this.options.frequency*1000);
+ },
+
+ activate: function() {
+ this.changed = false;
+ this.hasFocus = true;
+ this.getUpdatedChoices();
+ },
+
+ onHover: function(event) {
+ var element = Event.findElement(event, 'LI');
+ if(this.index != element.autocompleteIndex)
+ {
+ this.index = element.autocompleteIndex;
+ this.render();
+ }
+ Event.stop(event);
+ },
+
+ onClick: function(event) {
+ var element = Event.findElement(event, 'LI');
+ this.index = element.autocompleteIndex;
+ this.selectEntry();
+ this.hide();
+ },
+
+ onBlur: function(event) {
+ // needed to make click events working
+ setTimeout(this.hide.bind(this), 250);
+ this.hasFocus = false;
+ this.active = false;
+ },
+
+ render: function() {
+ if(this.entryCount > 0) {
+ for (var i = 0; i < this.entryCount; i++)
+ this.index==i ?
+ Element.addClassName(this.getEntry(i),"selected") :
+ Element.removeClassName(this.getEntry(i),"selected");
+
+ if(this.hasFocus) {
+ this.show();
+ this.active = true;
+ }
+ } else {
+ this.active = false;
+ this.hide();
+ }
+ },
+
+ markPrevious: function() {
+ if(this.index > 0) this.index--
+ else this.index = this.entryCount-1;
+ },
+
+ markNext: function() {
+ if(this.index < this.entryCount-1) this.index++
+ else this.index = 0;
+ },
+
+ getEntry: function(index) {
+ return this.update.firstChild.childNodes[index];
+ },
+
+ getCurrentEntry: function() {
+ return this.getEntry(this.index);
+ },
+
+ selectEntry: function() {
+ this.active = false;
+ this.updateElement(this.getCurrentEntry());
+ },
+
+ updateElement: function(selectedElement) {
+ if (this.options.updateElement) {
+ this.options.updateElement(selectedElement);
+ return;
+ }
+ var value = '';
+ if (this.options.select) {
+ var nodes = document.getElementsByClassName(this.options.select, selectedElement) || [];
+ if(nodes.length>0) value = Element.collectTextNodes(nodes[0], this.options.select);
+ } else
+ value = Element.collectTextNodesIgnoreClass(selectedElement, 'informal');
+
+ var lastTokenPos = this.findLastToken();
+ if (lastTokenPos != -1) {
+ var newValue = this.element.value.substr(0, lastTokenPos + 1);
+ var whitespace = this.element.value.substr(lastTokenPos + 1).match(/^\s+/);
+ if (whitespace)
+ newValue += whitespace[0];
+ this.element.value = newValue + value;
+ } else {
+ this.element.value = value;
+ }
+ this.element.focus();
+
+ if (this.options.afterUpdateElement)
+ this.options.afterUpdateElement(this.element, selectedElement);
+ },
+
+ updateChoices: function(choices) {
+ if(!this.changed && this.hasFocus) {
+ this.update.innerHTML = choices;
+ Element.cleanWhitespace(this.update);
+ Element.cleanWhitespace(this.update.firstChild);
+
+ if(this.update.firstChild && this.update.firstChild.childNodes) {
+ this.entryCount =
+ this.update.firstChild.childNodes.length;
+ for (var i = 0; i < this.entryCount; i++) {
+ var entry = this.getEntry(i);
+ entry.autocompleteIndex = i;
+ this.addObservers(entry);
+ }
+ } else {
+ this.entryCount = 0;
+ }
+
+ this.stopIndicator();
+
+ this.index = 0;
+ this.render();
+ }
+ },
+
+ addObservers: function(element) {
+ Event.observe(element, "mouseover", this.onHover.bindAsEventListener(this));
+ Event.observe(element, "click", this.onClick.bindAsEventListener(this));
+ },
+
+ onObserverEvent: function() {
+ this.changed = false;
+ if(this.getToken().length>=this.options.minChars) {
+ this.startIndicator();
+ this.getUpdatedChoices();
+ } else {
+ this.active = false;
+ this.hide();
+ }
+ },
+
+ getToken: function() {
+ var tokenPos = this.findLastToken();
+ if (tokenPos != -1)
+ var ret = this.element.value.substr(tokenPos + 1).replace(/^\s+/,'').replace(/\s+$/,'');
+ else
+ var ret = this.element.value;
+
+ return /\n/.test(ret) ? '' : ret;
+ },
+
+ findLastToken: function() {
+ var lastTokenPos = -1;
+
+ for (var i=0; i<this.options.tokens.length; i++) {
+ var thisTokenPos = this.element.value.lastIndexOf(this.options.tokens[i]);
+ if (thisTokenPos > lastTokenPos)
+ lastTokenPos = thisTokenPos;
+ }
+ return lastTokenPos;
+ }
+}
+
+Ajax.Autocompleter = Class.create();
+Object.extend(Object.extend(Ajax.Autocompleter.prototype, Autocompleter.Base.prototype), {
+ initialize: function(element, update, url, options) {
+ this.baseInitialize(element, update, options);
+ this.options.asynchronous = true;
+ this.options.onComplete = this.onComplete.bind(this);
+ this.options.defaultParams = this.options.parameters || null;
+ this.url = url;
+ },
+
+ getUpdatedChoices: function() {
+ entry = encodeURIComponent(this.options.paramName) + '=' +
+ encodeURIComponent(this.getToken());
+
+ this.options.parameters = this.options.callback ?
+ this.options.callback(this.element, entry) : entry;
+
+ if(this.options.defaultParams)
+ this.options.parameters += '&' + this.options.defaultParams;
+
+ new Ajax.Request(this.url, this.options);
+ },
+
+ onComplete: function(request) {
+ this.updateChoices(request.responseText);
+ }
+
+});
+
+// The local array autocompleter. Used when you'd prefer to
+// inject an array of autocompletion options into the page, rather
+// than sending out Ajax queries, which can be quite slow sometimes.
+//
+// The constructor takes four parameters. The first two are, as usual,
+// the id of the monitored textbox, and id of the autocompletion menu.
+// The third is the array you want to autocomplete from, and the fourth
+// is the options block.
+//
+// Extra local autocompletion options:
+// - choices - How many autocompletion choices to offer
+//
+// - partialSearch - If false, the autocompleter will match entered
+// text only at the beginning of strings in the
+// autocomplete array. Defaults to true, which will
+// match text at the beginning of any *word* in the
+// strings in the autocomplete array. If you want to
+// search anywhere in the string, additionally set
+// the option fullSearch to true (default: off).
+//
+// - fullSsearch - Search anywhere in autocomplete array strings.
+//
+// - partialChars - How many characters to enter before triggering
+// a partial match (unlike minChars, which defines
+// how many characters are required to do any match
+// at all). Defaults to 2.
+//
+// - ignoreCase - Whether to ignore case when autocompleting.
+// Defaults to true.
+//
+// It's possible to pass in a custom function as the 'selector'
+// option, if you prefer to write your own autocompletion logic.
+// In that case, the other options above will not apply unless
+// you support them.
+
+Autocompleter.Local = Class.create();
+Autocompleter.Local.prototype = Object.extend(new Autocompleter.Base(), {
+ initialize: function(element, update, array, options) {
+ this.baseInitialize(element, update, options);
+ this.options.array = array;
+ },
+
+ getUpdatedChoices: function() {
+ this.updateChoices(this.options.selector(this));
+ },
+
+ setOptions: function(options) {
+ this.options = Object.extend({
+ choices: 10,
+ partialSearch: true,
+ partialChars: 2,
+ ignoreCase: true,
+ fullSearch: false,
+ selector: function(instance) {
+ var ret = []; // Beginning matches
+ var partial = []; // Inside matches
+ var entry = instance.getToken();
+ var count = 0;
+
+ for (var i = 0; i < instance.options.array.length &&
+ ret.length < instance.options.choices ; i++) {
+
+ var elem = instance.options.array[i];
+ var foundPos = instance.options.ignoreCase ?
+ elem.toLowerCase().indexOf(entry.toLowerCase()) :
+ elem.indexOf(entry);
+
+ while (foundPos != -1) {
+ if (foundPos == 0 && elem.length != entry.length) {
+ ret.push("<li><strong>" + elem.substr(0, entry.length) + "</strong>" +
+ elem.substr(entry.length) + "</li>");
+ break;
+ } else if (entry.length >= instance.options.partialChars &&
+ instance.options.partialSearch && foundPos != -1) {
+ if (instance.options.fullSearch || /\s/.test(elem.substr(foundPos-1,1))) {
+ partial.push("<li>" + elem.substr(0, foundPos) + "<strong>" +
+ elem.substr(foundPos, entry.length) + "</strong>" + elem.substr(
+ foundPos + entry.length) + "</li>");
+ break;
+ }
+ }
+
+ foundPos = instance.options.ignoreCase ?
+ elem.toLowerCase().indexOf(entry.toLowerCase(), foundPos + 1) :
+ elem.indexOf(entry, foundPos + 1);
+
+ }
+ }
+ if (partial.length)
+ ret = ret.concat(partial.slice(0, instance.options.choices - ret.length))
+ return "<ul>" + ret.join('') + "</ul>";
+ }
+ }, options || {});
+ }
+});
+
+// AJAX in-place editor
+//
+// see documentation on http://wiki.script.aculo.us/scriptaculous/show/Ajax.InPlaceEditor
+
+// Use this if you notice weird scrolling problems on some browsers,
+// the DOM might be a bit confused when this gets called so do this
+// waits 1 ms (with setTimeout) until it does the activation
+Field.scrollFreeActivate = function(field) {
+ setTimeout(function() {
+ Field.activate(field);
+ }, 1);
+}
+
+Ajax.InPlaceEditor = Class.create();
+Ajax.InPlaceEditor.defaultHighlightColor = "#FFFF99";
+Ajax.InPlaceEditor.prototype = {
+ initialize: function(element, url, options) {
+ this.url = url;
+ this.element = $(element);
+
+ this.options = Object.extend({
+ okButton: true,
+ okText: "ok",
+ cancelLink: true,
+ cancelText: "cancel",
+ savingText: "Saving...",
+ clickToEditText: "Click to edit",
+ okText: "ok",
+ rows: 1,
+ onComplete: function(transport, element) {
+ new Effect.Highlight(element, {startcolor: this.options.highlightcolor});
+ },
+ onFailure: function(transport) {
+ alert("Error communicating with the server: " + transport.responseText.stripTags());
+ },
+ callback: function(form) {
+ return Form.serialize(form);
+ },
+ handleLineBreaks: true,
+ loadingText: 'Loading...',
+ savingClassName: 'inplaceeditor-saving',
+ loadingClassName: 'inplaceeditor-loading',
+ formClassName: 'inplaceeditor-form',
+ highlightcolor: Ajax.InPlaceEditor.defaultHighlightColor,
+ highlightendcolor: "#FFFFFF",
+ externalControl: null,
+ submitOnBlur: false,
+ ajaxOptions: {},
+ evalScripts: false
+ }, options || {});
+
+ if(!this.options.formId && this.element.id) {
+ this.options.formId = this.element.id + "-inplaceeditor";
+ if ($(this.options.formId)) {
+ // there's already a form with that name, don't specify an id
+ this.options.formId = null;
+ }
+ }
+
+ if (this.options.externalControl) {
+ this.options.externalControl = $(this.options.externalControl);
+ }
+
+ this.originalBackground = Element.getStyle(this.element, 'background-color');
+ if (!this.originalBackground) {
+ this.originalBackground = "transparent";
+ }
+
+ this.element.title = this.options.clickToEditText;
+
+ this.onclickListener = this.enterEditMode.bindAsEventListener(this);
+ this.mouseoverListener = this.enterHover.bindAsEventListener(this);
+ this.mouseoutListener = this.leaveHover.bindAsEventListener(this);
+ Event.observe(this.element, 'click', this.onclickListener);
+ Event.observe(this.element, 'mouseover', this.mouseoverListener);
+ Event.observe(this.element, 'mouseout', this.mouseoutListener);
+ if (this.options.externalControl) {
+ Event.observe(this.options.externalControl, 'click', this.onclickListener);
+ Event.observe(this.options.externalControl, 'mouseover', this.mouseoverListener);
+ Event.observe(this.options.externalControl, 'mouseout', this.mouseoutListener);
+ }
+ },
+ enterEditMode: function(evt) {
+ if (this.saving) return;
+ if (this.editing) return;
+ this.editing = true;
+ this.onEnterEditMode();
+ if (this.options.externalControl) {
+ Element.hide(this.options.externalControl);
+ }
+ Element.hide(this.element);
+ this.createForm();
+ this.element.parentNode.insertBefore(this.form, this.element);
+ Field.scrollFreeActivate(this.editField);
+ // stop the event to avoid a page refresh in Safari
+ if (evt) {
+ Event.stop(evt);
+ }
+ return false;
+ },
+ createForm: function() {
+ this.form = document.createElement("form");
+ this.form.id = this.options.formId;
+ Element.addClassName(this.form, this.options.formClassName)
+ this.form.onsubmit = this.onSubmit.bind(this);
+
+ this.createEditField();
+
+ if (this.options.textarea) {
+ var br = document.createElement("br");
+ this.form.appendChild(br);
+ }
+
+ if (this.options.okButton) {
+ okButton = document.createElement("input");
+ okButton.type = "submit";
+ okButton.value = this.options.okText;
+ okButton.className = 'editor_ok_button';
+ this.form.appendChild(okButton);
+ }
+
+ if (this.options.cancelLink) {
+ cancelLink = document.createElement("a");
+ cancelLink.href = "#";
+ cancelLink.appendChild(document.createTextNode(this.options.cancelText));
+ cancelLink.onclick = this.onclickCancel.bind(this);
+ cancelLink.className = 'editor_cancel';
+ this.form.appendChild(cancelLink);
+ }
+ },
+ hasHTMLLineBreaks: function(string) {
+ if (!this.options.handleLineBreaks) return false;
+ return string.match(/<br/i) || string.match(/<p>/i);
+ },
+ convertHTMLLineBreaks: function(string) {
+ return string.replace(/<br>/gi, "\n").replace(/<br\/>/gi, "\n").replace(/<\/p>/gi, "\n").replace(/<p>/gi, "");
+ },
+ createEditField: function() {
+ var text;
+ if(this.options.loadTextURL) {
+ text = this.options.loadingText;
+ } else {
+ text = this.getText();
+ }
+
+ var obj = this;
+
+ if (this.options.rows == 1 && !this.hasHTMLLineBreaks(text)) {
+ this.options.textarea = false;
+ var textField = document.createElement("input");
+ textField.obj = this;
+ textField.type = "text";
+ textField.name = "value";
+ textField.value = text;
+ textField.style.backgroundColor = this.options.highlightcolor;
+ textField.className = 'editor_field';
+ var size = this.options.size || this.options.cols || 0;
+ if (size != 0) textField.size = size;
+ if (this.options.submitOnBlur)
+ textField.onblur = this.onSubmit.bind(this);
+ this.editField = textField;
+ } else {
+ this.options.textarea = true;
+ var textArea = document.createElement("textarea");
+ textArea.obj = this;
+ textArea.name = "value";
+ textArea.value = this.convertHTMLLineBreaks(text);
+ textArea.rows = this.options.rows;
+ textArea.cols = this.options.cols || 40;
+ textArea.className = 'editor_field';
+ if (this.options.submitOnBlur)
+ textArea.onblur = this.onSubmit.bind(this);
+ this.editField = textArea;
+ }
+
+ if(this.options.loadTextURL) {
+ this.loadExternalText();
+ }
+ this.form.appendChild(this.editField);
+ },
+ getText: function() {
+ return this.element.innerHTML;
+ },
+ loadExternalText: function() {
+ Element.addClassName(this.form, this.options.loadingClassName);
+ this.editField.disabled = true;
+ new Ajax.Request(
+ this.options.loadTextURL,
+ Object.extend({
+ asynchronous: true,
+ onComplete: this.onLoadedExternalText.bind(this)
+ }, this.options.ajaxOptions)
+ );
+ },
+ onLoadedExternalText: function(transport) {
+ Element.removeClassName(this.form, this.options.loadingClassName);
+ this.editField.disabled = false;
+ this.editField.value = transport.responseText.stripTags();
+ },
+ onclickCancel: function() {
+ this.onComplete();
+ this.leaveEditMode();
+ return false;
+ },
+ onFailure: function(transport) {
+ this.options.onFailure(transport);
+ if (this.oldInnerHTML) {
+ this.element.innerHTML = this.oldInnerHTML;
+ this.oldInnerHTML = null;
+ }
+ return false;
+ },
+ onSubmit: function() {
+ // onLoading resets these so we need to save them away for the Ajax call
+ var form = this.form;
+ var value = this.editField.value;
+
+ // do this first, sometimes the ajax call returns before we get a chance to switch on Saving...
+ // which means this will actually switch on Saving... *after* we've left edit mode causing Saving...
+ // to be displayed indefinitely
+ this.onLoading();
+
+ if (this.options.evalScripts) {
+ new Ajax.Request(
+ this.url, Object.extend({
+ parameters: this.options.callback(form, value),
+ onComplete: this.onComplete.bind(this),
+ onFailure: this.onFailure.bind(this),
+ asynchronous:true,
+ evalScripts:true
+ }, this.options.ajaxOptions));
+ } else {
+ new Ajax.Updater(
+ { success: this.element,
+ // don't update on failure (this could be an option)
+ failure: null },
+ this.url, Object.extend({
+ parameters: this.options.callback(form, value),
+ onComplete: this.onComplete.bind(this),
+ onFailure: this.onFailure.bind(this)
+ }, this.options.ajaxOptions));
+ }
+ // stop the event to avoid a page refresh in Safari
+ if (arguments.length > 1) {
+ Event.stop(arguments[0]);
+ }
+ return false;
+ },
+ onLoading: function() {
+ this.saving = true;
+ this.removeForm();
+ this.leaveHover();
+ this.showSaving();
+ },
+ showSaving: function() {
+ this.oldInnerHTML = this.element.innerHTML;
+ this.element.innerHTML = this.options.savingText;
+ Element.addClassName(this.element, this.options.savingClassName);
+ this.element.style.backgroundColor = this.originalBackground;
+ Element.show(this.element);
+ },
+ removeForm: function() {
+ if(this.form) {
+ if (this.form.parentNode) Element.remove(this.form);
+ this.form = null;
+ }
+ },
+ enterHover: function() {
+ if (this.saving) return;
+ this.element.style.backgroundColor = this.options.highlightcolor;
+ if (this.effect) {
+ this.effect.cancel();
+ }
+ Element.addClassName(this.element, this.options.hoverClassName)
+ },
+ leaveHover: function() {
+ if (this.options.backgroundColor) {
+ this.element.style.backgroundColor = this.oldBackground;
+ }
+ Element.removeClassName(this.element, this.options.hoverClassName)
+ if (this.saving) return;
+ this.effect = new Effect.Highlight(this.element, {
+ startcolor: this.options.highlightcolor,
+ endcolor: this.options.highlightendcolor,
+ restorecolor: this.originalBackground
+ });
+ },
+ leaveEditMode: function() {
+ Element.removeClassName(this.element, this.options.savingClassName);
+ this.removeForm();
+ this.leaveHover();
+ this.element.style.backgroundColor = this.originalBackground;
+ Element.show(this.element);
+ if (this.options.externalControl) {
+ Element.show(this.options.externalControl);
+ }
+ this.editing = false;
+ this.saving = false;
+ this.oldInnerHTML = null;
+ this.onLeaveEditMode();
+ },
+ onComplete: function(transport) {
+ this.leaveEditMode();
+ this.options.onComplete.bind(this)(transport, this.element);
+ },
+ onEnterEditMode: function() {},
+ onLeaveEditMode: function() {},
+ dispose: function() {
+ if (this.oldInnerHTML) {
+ this.element.innerHTML = this.oldInnerHTML;
+ }
+ this.leaveEditMode();
+ Event.stopObserving(this.element, 'click', this.onclickListener);
+ Event.stopObserving(this.element, 'mouseover', this.mouseoverListener);
+ Event.stopObserving(this.element, 'mouseout', this.mouseoutListener);
+ if (this.options.externalControl) {
+ Event.stopObserving(this.options.externalControl, 'click', this.onclickListener);
+ Event.stopObserving(this.options.externalControl, 'mouseover', this.mouseoverListener);
+ Event.stopObserving(this.options.externalControl, 'mouseout', this.mouseoutListener);
+ }
+ }
+};
+
+Ajax.InPlaceCollectionEditor = Class.create();
+Object.extend(Ajax.InPlaceCollectionEditor.prototype, Ajax.InPlaceEditor.prototype);
+Object.extend(Ajax.InPlaceCollectionEditor.prototype, {
+ createEditField: function() {
+ if (!this.cached_selectTag) {
+ var selectTag = document.createElement("select");
+ var collection = this.options.collection || [];
+ var optionTag;
+ collection.each(function(e,i) {
+ optionTag = document.createElement("option");
+ optionTag.value = (e instanceof Array) ? e[0] : e;
+ if(this.options.value==optionTag.value) optionTag.selected = true;
+ optionTag.appendChild(document.createTextNode((e instanceof Array) ? e[1] : e));
+ selectTag.appendChild(optionTag);
+ }.bind(this));
+ this.cached_selectTag = selectTag;
+ }
+
+ this.editField = this.cached_selectTag;
+ if(this.options.loadTextURL) this.loadExternalText();
+ this.form.appendChild(this.editField);
+ this.options.callback = function(form, value) {
+ return "value=" + encodeURIComponent(value);
+ }
+ }
+});
+
+// Delayed observer, like Form.Element.Observer,
+// but waits for delay after last key input
+// Ideal for live-search fields
+
+Form.Element.DelayedObserver = Class.create();
+Form.Element.DelayedObserver.prototype = {
+ initialize: function(element, delay, callback) {
+ this.delay = delay || 0.5;
+ this.element = $(element);
+ this.callback = callback;
+ this.timer = null;
+ this.lastValue = $F(this.element);
+ Event.observe(this.element,'keyup',this.delayedListener.bindAsEventListener(this));
+ },
+ delayedListener: function(event) {
+ if(this.lastValue == $F(this.element)) return;
+ if(this.timer) clearTimeout(this.timer);
+ this.timer = setTimeout(this.onTimerEvent.bind(this), this.delay * 1000);
+ this.lastValue = $F(this.element);
+ },
+ onTimerEvent: function() {
+ this.timer = null;
+ this.callback(this.element, $F(this.element));
+ }
+};
--- /dev/null
+// Copyright (c) 2005 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
+// (c) 2005 Sammi Williams (http://www.oriontransfer.co.nz,
[email protected])
+//
+// See scriptaculous.js for full license.
+
+/*--------------------------------------------------------------------------*/
+
+var Droppables = {
+ drops: [],
+
+ remove: function(element) {
+ this.drops = this.drops.reject(function(d) { return d.element==$(element) });
+ },
+
+ add: function(element) {
+ element = $(element);
+ var options = Object.extend({
+ greedy: true,
+ hoverclass: null,
+ tree: false
+ }, arguments[1] || {});
+
+ // cache containers
+ if(options.containment) {
+ options._containers = [];
+ var containment = options.containment;
+ if((typeof containment == 'object') &&
+ (containment.constructor == Array)) {
+ containment.each( function(c) { options._containers.push($(c)) });
+ } else {
+ options._containers.push($(containment));
+ }
+ }
+
+ if(options.accept) options.accept = [options.accept].flatten();
+
+ Element.makePositioned(element); // fix IE
+ options.element = element;
+
+ this.drops.push(options);
+ },
+
+ findDeepestChild: function(drops) {
+ deepest = drops[0];
+
+ for (i = 1; i < drops.length; ++i)
+ if (Element.isParent(drops[i].element, deepest.element))
+ deepest = drops[i];
+
+ return deepest;
+ },
+
+ isContained: function(element, drop) {
+ var containmentNode;
+ if(drop.tree) {
+ containmentNode = element.treeNode;
+ } else {
+ containmentNode = element.parentNode;
+ }
+ return drop._containers.detect(function(c) { return containmentNode == c });
+ },
+
+ isAffected: function(point, element, drop) {
+ return (
+ (drop.element!=element) &&
+ ((!drop._containers) ||
+ this.isContained(element, drop)) &&
+ ((!drop.accept) ||
+ (Element.classNames(element).detect(
+ function(v) { return drop.accept.include(v) } ) )) &&
+ Position.within(drop.element, point[0], point[1]) );
+ },
+
+ deactivate: function(drop) {
+ if(drop.hoverclass)
+ Element.removeClassName(drop.element, drop.hoverclass);
+ this.last_active = null;
+ },
+
+ activate: function(drop) {
+ if(drop.hoverclass)
+ Element.addClassName(drop.element, drop.hoverclass);
+ this.last_active = drop;
+ },
+
+ show: function(point, element) {
+ if(!this.drops.length) return;
+ var affected = [];
+
+ if(this.last_active) this.deactivate(this.last_active);
+ this.drops.each( function(drop) {
+ if(Droppables.isAffected(point, element, drop))
+ affected.push(drop);
+ });
+
+ if(affected.length>0) {
+ drop = Droppables.findDeepestChild(affected);
+ Position.within(drop.element, point[0], point[1]);
+ if(drop.onHover)
+ drop.onHover(element, drop.element, Position.overlap(drop.overlap, drop.element));
+
+ Droppables.activate(drop);
+ }
+ },
+
+ fire: function(event, element) {
+ if(!this.last_active) return;
+ Position.prepare();
+
+ if (this.isAffected([Event.pointerX(event), Event.pointerY(event)], element, this.last_active))
+ if (this.last_active.onDrop)
+ this.last_active.onDrop(element, this.last_active.element, event);
+ },
+
+ reset: function() {
+ if(this.last_active)
+ this.deactivate(this.last_active);
+ }
+}
+
+var Draggables = {
+ drags: [],
+ observers: [],
+
+ register: function(draggable) {
+ if(this.drags.length == 0) {
+ this.eventMouseUp = this.endDrag.bindAsEventListener(this);
+ this.eventMouseMove = this.updateDrag.bindAsEventListener(this);
+ this.eventKeypress = this.keyPress.bindAsEventListener(this);
+
+ Event.observe(document, "mouseup", this.eventMouseUp);
+ Event.observe(document, "mousemove", this.eventMouseMove);
+ Event.observe(document, "keypress", this.eventKeypress);
+ }
+ this.drags.push(draggable);
+ },
+
+ unregister: function(draggable) {
+ this.drags = this.drags.reject(function(d) { return d==draggable });
+ if(this.drags.length == 0) {
+ Event.stopObserving(document, "mouseup", this.eventMouseUp);
+ Event.stopObserving(document, "mousemove", this.eventMouseMove);
+ Event.stopObserving(document, "keypress", this.eventKeypress);
+ }
+ },
+
+ activate: function(draggable) {
+ window.focus(); // allows keypress events if window isn't currently focused, fails for Safari
+ this.activeDraggable = draggable;
+ },
+
+ deactivate: function() {
+ this.activeDraggable = null;
+ },
+
+ updateDrag: function(event) {
+ if(!this.activeDraggable) return;
+ var pointer = [Event.pointerX(event), Event.pointerY(event)];
+ // Mozilla-based browsers fire successive mousemove events with
+ // the same coordinates, prevent needless redrawing (moz bug?)
+ if(this._lastPointer && (this._lastPointer.inspect() == pointer.inspect())) return;
+ this._lastPointer = pointer;
+ this.activeDraggable.updateDrag(event, pointer);
+ },
+
+ endDrag: function(event) {
+ if(!this.activeDraggable) return;
+ this._lastPointer = null;
+ this.activeDraggable.endDrag(event);
+ this.activeDraggable = null;
+ },
+
+ keyPress: function(event) {
+ if(this.activeDraggable)
+ this.activeDraggable.keyPress(event);
+ },
+
+ addObserver: function(observer) {
+ this.observers.push(observer);
+ this._cacheObserverCallbacks();
+ },
+
+ removeObserver: function(element) { // element instead of observer fixes mem leaks
+ this.observers = this.observers.reject( function(o) { return o.element==element });
+ this._cacheObserverCallbacks();
+ },
+
+ notify: function(eventName, draggable, event) { // 'onStart', 'onEnd', 'onDrag'
+ if(this[eventName+'Count'] > 0)
+ this.observers.each( function(o) {
+ if(o[eventName]) o[eventName](eventName, draggable, event);
+ });
+ },
+
+ _cacheObserverCallbacks: function() {
+ ['onStart','onEnd','onDrag'].each( function(eventName) {
+ Draggables[eventName+'Count'] = Draggables.observers.select(
+ function(o) { return o[eventName]; }
+ ).length;
+ });
+ }
+}
+
+/*--------------------------------------------------------------------------*/
+
+var Draggable = Class.create();
+Draggable.prototype = {
+ initialize: function(element) {
+ var options = Object.extend({
+ handle: false,
+ starteffect: function(element) {
+ element._opacity = Element.getOpacity(element);
+ new Effect.Opacity(element, {duration:0.2, from:element._opacity, to:0.7});
+ },
+ reverteffect: function(element, top_offset, left_offset) {
+ var dur = Math.sqrt(Math.abs(top_offset^2)+Math.abs(left_offset^2))*0.02;
+ element._revert = new Effect.Move(element, { x: -left_offset, y: -top_offset, duration: dur});
+ },
+ endeffect: function(element) {
+ var toOpacity = typeof element._opacity == 'number' ? element._opacity : 1.0
+ new Effect.Opacity(element, {duration:0.2, from:0.7, to:toOpacity});
+ },
+ zindex: 1000,
+ revert: false,
+ scroll: false,
+ scrollSensitivity: 20,
+ scrollSpeed: 15,
+ snap: false // false, or xy or [x,y] or function(x,y){ return [x,y] }
+ }, arguments[1] || {});
+
+ this.element = $(element);
+
+ if(options.handle && (typeof options.handle == 'string')) {
+ var h = Element.childrenWithClassName(this.element, options.handle, true);
+ if(h.length>0) this.handle = h[0];
+ }
+ if(!this.handle) this.handle = $(options.handle);
+ if(!this.handle) this.handle = this.element;
+
+ if(options.scroll && !options.scroll.scrollTo && !options.scroll.outerHTML)
+ options.scroll = $(options.scroll);
+
+ Element.makePositioned(this.element); // fix IE
+
+ this.delta = this.currentDelta();
+ this.options = options;
+ this.dragging = false;
+
+ this.eventMouseDown = this.initDrag.bindAsEventListener(this);
+ Event.observe(this.handle, "mousedown", this.eventMouseDown);
+
+ Draggables.register(this);
+ },
+
+ destroy: function() {
+ Event.stopObserving(this.handle, "mousedown", this.eventMouseDown);
+ Draggables.unregister(this);
+ },
+
+ currentDelta: function() {
+ return([
+ parseInt(Element.getStyle(this.element,'left') || '0'),
+ parseInt(Element.getStyle(this.element,'top') || '0')]);
+ },
+
+ initDrag: function(event) {
+ if(Event.isLeftClick(event)) {
+ // abort on form elements, fixes a Firefox issue
+ var src = Event.element(event);
+ if(src.tagName && (
+ src.tagName=='INPUT' ||
+ src.tagName=='SELECT' ||
+ src.tagName=='OPTION' ||
+ src.tagName=='BUTTON' ||
+ src.tagName=='TEXTAREA')) return;
+
+ if(this.element._revert) {
+ this.element._revert.cancel();
+ this.element._revert = null;
+ }
+
+ var pointer = [Event.pointerX(event), Event.pointerY(event)];
+ var pos = Position.cumulativeOffset(this.element);
+ this.offset = [0,1].map( function(i) { return (pointer[i] - pos[i]) });
+
+ Draggables.activate(this);
+ Event.stop(event);
+ }
+ },
+
+ startDrag: function(event) {
+ this.dragging = true;
+
+ if(this.options.zindex) {
+ this.originalZ = parseInt(Element.getStyle(this.element,'z-index') || 0);
+ this.element.style.zIndex = this.options.zindex;
+ }
+
+ if(this.options.ghosting) {
+ this._clone = this.element.cloneNode(true);
+ Position.absolutize(this.element);
+ this.element.parentNode.insertBefore(this._clone, this.element);
+ }
+
+ if(this.options.scroll) {
+ if (this.options.scroll == window) {
+ var where = this._getWindowScroll(this.options.scroll);
+ this.originalScrollLeft = where.left;
+ this.originalScrollTop = where.top;
+ } else {
+ this.originalScrollLeft = this.options.scroll.scrollLeft;
+ this.originalScrollTop = this.options.scroll.scrollTop;
+ }
+ }
+
+ Draggables.notify('onStart', this, event);
+ if(this.options.starteffect) this.options.starteffect(this.element);
+ },
+
+ updateDrag: function(event, pointer) {
+ if(!this.dragging) this.startDrag(event);
+ Position.prepare();
+ Droppables.show(pointer, this.element);
+ Draggables.notify('onDrag', this, event);
+ this.draw(pointer);
+ if(this.options.change) this.options.change(this);
+
+ if(this.options.scroll) {
+ this.stopScrolling();
+
+ var p;
+ if (this.options.scroll == window) {
+ with(this._getWindowScroll(this.options.scroll)) { p = [ left, top, left+width, top+height ]; }
+ } else {
+ p = Position.page(this.options.scroll);
+ p[0] += this.options.scroll.scrollLeft;
+ p[1] += this.options.scroll.scrollTop;
+ p.push(p[0]+this.options.scroll.offsetWidth);
+ p.push(p[1]+this.options.scroll.offsetHeight);
+ }
+ var speed = [0,0];
+ if(pointer[0] < (p[0]+this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[0]+this.options.scrollSensitivity);
+ if(pointer[1] < (p[1]+this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[1]+this.options.scrollSensitivity);
+ if(pointer[0] > (p[2]-this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[2]-this.options.scrollSensitivity);
+ if(pointer[1] > (p[3]-this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[3]-this.options.scrollSensitivity);
+ this.startScrolling(speed);
+ }
+
+ // fix AppleWebKit rendering
+ if(navigator.appVersion.indexOf('AppleWebKit')>0) window.scrollBy(0,0);
+
+ Event.stop(event);
+ },
+
+ finishDrag: function(event, success) {
+ this.dragging = false;
+
+ if(this.options.ghosting) {
+ Position.relativize(this.element);
+ Element.remove(this._clone);
+ this._clone = null;
+ }
+
+ if(success) Droppables.fire(event, this.element);
+ Draggables.notify('onEnd', this, event);
+
+ var revert = this.options.revert;
+ if(revert && typeof revert == 'function') revert = revert(this.element);
+
+ var d = this.currentDelta();
+ if(revert && this.options.reverteffect) {
+ this.options.reverteffect(this.element,
+ d[1]-this.delta[1], d[0]-this.delta[0]);
+ } else {
+ this.delta = d;
+ }
+
+ if(this.options.zindex)
+ this.element.style.zIndex = this.originalZ;
+
+ if(this.options.endeffect)
+ this.options.endeffect(this.element);
+
+ Draggables.deactivate(this);
+ Droppables.reset();
+ },
+
+ keyPress: function(event) {
+ if(event.keyCode!=Event.KEY_ESC) return;
+ this.finishDrag(event, false);
+ Event.stop(event);
+ },
+
+ endDrag: function(event) {
+ if(!this.dragging) return;
+ this.stopScrolling();
+ this.finishDrag(event, true);
+ Event.stop(event);
+ },
+
+ draw: function(point) {
+ var pos = Position.cumulativeOffset(this.element);
+ var d = this.currentDelta();
+ pos[0] -= d[0]; pos[1] -= d[1];
+
+ if(this.options.scroll && (this.options.scroll != window)) {
+ pos[0] -= this.options.scroll.scrollLeft-this.originalScrollLeft;
+ pos[1] -= this.options.scroll.scrollTop-this.originalScrollTop;
+ }
+
+ var p = [0,1].map(function(i){
+ return (point[i]-pos[i]-this.offset[i])
+ }.bind(this));
+
+ if(this.options.snap) {
+ if(typeof this.options.snap == 'function') {
+ p = this.options.snap(p[0],p[1],this);
+ } else {
+ if(this.options.snap instanceof Array) {
+ p = p.map( function(v, i) {
+ return Math.round(v/this.options.snap[i])*this.options.snap[i] }.bind(this))
+ } else {
+ p = p.map( function(v) {
+ return Math.round(v/this.options.snap)*this.options.snap }.bind(this))
+ }
+ }}
+
+ var style = this.element.style;
+ if((!this.options.constraint) || (this.options.constraint=='horizontal'))
+ style.left = p[0] + "px";
+ if((!this.options.constraint) || (this.options.constraint=='vertical'))
+ style.top = p[1] + "px";
+ if(style.visibility=="hidden") style.visibility = ""; // fix gecko rendering
+ },
+
+ stopScrolling: function() {
+ if(this.scrollInterval) {
+ clearInterval(this.scrollInterval);
+ this.scrollInterval = null;
+ Draggables._lastScrollPointer = null;
+ }
+ },
+
+ startScrolling: function(speed) {
+ this.scrollSpeed = [speed[0]*this.options.scrollSpeed,speed[1]*this.options.scrollSpeed];
+ this.lastScrolled = new Date();
+ this.scrollInterval = setInterval(this.scroll.bind(this), 10);
+ },
+
+ scroll: function() {
+ var current = new Date();
+ var delta = current - this.lastScrolled;
+ this.lastScrolled = current;
+ if(this.options.scroll == window) {
+ with (this._getWindowScroll(this.options.scroll)) {
+ if (this.scrollSpeed[0] || this.scrollSpeed[1]) {
+ var d = delta / 1000;
+ this.options.scroll.scrollTo( left + d*this.scrollSpeed[0], top + d*this.scrollSpeed[1] );
+ }
+ }
+ } else {
+ this.options.scroll.scrollLeft += this.scrollSpeed[0] * delta / 1000;
+ this.options.scroll.scrollTop += this.scrollSpeed[1] * delta / 1000;
+ }
+
+ Position.prepare();
+ Droppables.show(Draggables._lastPointer, this.element);
+ Draggables.notify('onDrag', this);
+ Draggables._lastScrollPointer = Draggables._lastScrollPointer || $A(Draggables._lastPointer);
+ Draggables._lastScrollPointer[0] += this.scrollSpeed[0] * delta / 1000;
+ Draggables._lastScrollPointer[1] += this.scrollSpeed[1] * delta / 1000;
+ if (Draggables._lastScrollPointer[0] < 0)
+ Draggables._lastScrollPointer[0] = 0;
+ if (Draggables._lastScrollPointer[1] < 0)
+ Draggables._lastScrollPointer[1] = 0;
+ this.draw(Draggables._lastScrollPointer);
+
+ if(this.options.change) this.options.change(this);
+ },
+
+ _getWindowScroll: function(w) {
+ var T, L, W, H;
+ with (w.document) {
+ if (w.document.documentElement && documentElement.scrollTop) {
+ T = documentElement.scrollTop;
+ L = documentElement.scrollLeft;
+ } else if (w.document.body) {
+ T = body.scrollTop;
+ L = body.scrollLeft;
+ }
+ if (w.innerWidth) {
+ W = w.innerWidth;
+ H = w.innerHeight;
+ } else if (w.document.documentElement && documentElement.clientWidth) {
+ W = documentElement.clientWidth;
+ H = documentElement.clientHeight;
+ } else {
+ W = body.offsetWidth;
+ H = body.offsetHeight
+ }
+ }
+ return { top: T, left: L, width: W, height: H };
+ }
+}
+
+/*--------------------------------------------------------------------------*/
+
+var SortableObserver = Class.create();
+SortableObserver.prototype = {
+ initialize: function(element, observer) {
+ this.element = $(element);
+ this.observer = observer;
+ this.lastValue = Sortable.serialize(this.element);
+ },
+
+ onStart: function() {
+ this.lastValue = Sortable.serialize(this.element);
+ },
+
+ onEnd: function() {
+ Sortable.unmark();
+ if(this.lastValue != Sortable.serialize(this.element))
+ this.observer(this.element)
+ }
+}
+
+var Sortable = {
+ sortables: {},
+
+ _findRootElement: function(element) {
+ while (element.tagName != "BODY") {
+ if(element.id && Sortable.sortables[element.id]) return element;
+ element = element.parentNode;
+ }
+ },
+
+ options: function(element) {
+ element = Sortable._findRootElement($(element));
+ if(!element) return;
+ return Sortable.sortables[element.id];
+ },
+
+ destroy: function(element){
+ var s = Sortable.options(element);
+
+ if(s) {
+ Draggables.removeObserver(s.element);
+ s.droppables.each(function(d){ Droppables.remove(d) });
+ s.draggables.invoke('destroy');
+
+ delete Sortable.sortables[s.element.id];
+ }
+ },
+
+ create: function(element) {
+ element = $(element);
+ var options = Object.extend({
+ element: element,
+ tag: 'li', // assumes li children, override with tag: 'tagname'
+ dropOnEmpty: false,
+ tree: false,
+ treeTag: 'ul',
+ overlap: 'vertical', // one of 'vertical', 'horizontal'
+ constraint: 'vertical', // one of 'vertical', 'horizontal', false
+ containment: element, // also takes array of elements (or id's); or false
+ handle: false, // or a CSS class
+ only: false,
+ hoverclass: null,
+ ghosting: false,
+ scroll: false,
+ scrollSensitivity: 20,
+ scrollSpeed: 15,
+ format: /^[^_]*_(.*)$/,
+ onChange: Prototype.emptyFunction,
+ onUpdate: Prototype.emptyFunction
+ }, arguments[1] || {});
+
+ // clear any old sortable with same element
+ this.destroy(element);
+
+ // build options for the draggables
+ var options_for_draggable = {
+ revert: true,
+ scroll: options.scroll,
+ scrollSpeed: options.scrollSpeed,
+ scrollSensitivity: options.scrollSensitivity,
+ ghosting: options.ghosting,
+ constraint: options.constraint,
+ handle: options.handle };
+
+ if(options.starteffect)
+ options_for_draggable.starteffect = options.starteffect;
+
+ if(options.reverteffect)
+ options_for_draggable.reverteffect = options.reverteffect;
+ else
+ if(options.ghosting) options_for_draggable.reverteffect = function(element) {
+ element.style.top = 0;
+ element.style.left = 0;
+ };
+
+ if(options.endeffect)
+ options_for_draggable.endeffect = options.endeffect;
+
+ if(options.zindex)
+ options_for_draggable.zindex = options.zindex;
+
+ // build options for the droppables
+ var options_for_droppable = {
+ overlap: options.overlap,
+ containment: options.containment,
+ tree: options.tree,
+ hoverclass: options.hoverclass,
+ onHover: Sortable.onHover
+ //greedy: !options.dropOnEmpty
+ }
+
+ var options_for_tree = {
+ onHover: Sortable.onEmptyHover,
+ overlap: options.overlap,
+ containment: options.containment,
+ hoverclass: options.hoverclass
+ }
+
+ // fix for gecko engine
+ Element.cleanWhitespace(element);
+
+ options.draggables = [];
+ options.droppables = [];
+
+ // drop on empty handling
+ if(options.dropOnEmpty || options.tree) {
+ Droppables.add(element, options_for_tree);
+ options.droppables.push(element);
+ }
+
+ (this.findElements(element, options) || []).each( function(e) {
+ // handles are per-draggable
+ var handle = options.handle ?
+ Element.childrenWithClassName(e, options.handle)[0] : e;
+ options.draggables.push(
+ new Draggable(e, Object.extend(options_for_draggable, { handle: handle })));
+ Droppables.add(e, options_for_droppable);
+ if(options.tree) e.treeNode = element;
+ options.droppables.push(e);
+ });
+
+ if(options.tree) {
+ (Sortable.findTreeElements(element, options) || []).each( function(e) {
+ Droppables.add(e, options_for_tree);
+ e.treeNode = element;
+ options.droppables.push(e);
+ });
+ }
+
+ // keep reference
+ this.sortables[element.id] = options;
+
+ // for onupdate
+ Draggables.addObserver(new SortableObserver(element, options.onUpdate));
+
+ },
+
+ // return all suitable-for-sortable elements in a guaranteed order
+ findElements: function(element, options) {
+ return Element.findChildren(
+ element, options.only, options.tree ? true : false, options.tag);
+ },
+
+ findTreeElements: function(element, options) {
+ return Element.findChildren(
+ element, options.only, options.tree ? true : false, options.treeTag);
+ },
+
+ onHover: function(element, dropon, overlap) {
+ if(Element.isParent(dropon, element)) return;
+
+ if(overlap > .33 && overlap < .66 && Sortable.options(dropon).tree) {
+ return;
+ } else if(overlap>0.5) {
+ Sortable.mark(dropon, 'before');
+ if(dropon.previousSibling != element) {
+ var oldParentNode = element.parentNode;
+ element.style.visibility = "hidden"; // fix gecko rendering
+ dropon.parentNode.insertBefore(element, dropon);
+ if(dropon.parentNode!=oldParentNode)
+ Sortable.options(oldParentNode).onChange(element);
+ Sortable.options(dropon.parentNode).onChange(element);
+ }
+ } else {
+ Sortable.mark(dropon, 'after');
+ var nextElement = dropon.nextSibling || null;
+ if(nextElement != element) {
+ var oldParentNode = element.parentNode;
+ element.style.visibility = "hidden"; // fix gecko rendering
+ dropon.parentNode.insertBefore(element, nextElement);
+ if(dropon.parentNode!=oldParentNode)
+ Sortable.options(oldParentNode).onChange(element);
+ Sortable.options(dropon.parentNode).onChange(element);
+ }
+ }
+ },
+
+ onEmptyHover: function(element, dropon, overlap) {
+ var oldParentNode = element.parentNode;
+ var droponOptions = Sortable.options(dropon);
+
+ if(!Element.isParent(dropon, element)) {
+ var index;
+
+ var children = Sortable.findElements(dropon, {tag: droponOptions.tag});
+ var child = null;
+
+ if(children) {
+ var offset = Element.offsetSize(dropon, droponOptions.overlap) * (1.0 - overlap);
+
+ for (index = 0; index < children.length; index += 1) {
+ if (offset - Element.offsetSize (children[index], droponOptions.overlap) >= 0) {
+ offset -= Element.offsetSize (children[index], droponOptions.overlap);
+ } else if (offset - (Element.offsetSize (children[index], droponOptions.overlap) / 2) >= 0) {
+ child = index + 1 < children.length ? children[index + 1] : null;
+ break;
+ } else {
+ child = children[index];
+ break;
+ }
+ }
+ }
+
+ dropon.insertBefore(element, child);
+
+ Sortable.options(oldParentNode).onChange(element);
+ droponOptions.onChange(element);
+ }
+ },
+
+ unmark: function() {
+ if(Sortable._marker) Element.hide(Sortable._marker);
+ },
+
+ mark: function(dropon, position) {
+ // mark on ghosting only
+ var sortable = Sortable.options(dropon.parentNode);
+ if(sortable && !sortable.ghosting) return;
+
+ if(!Sortable._marker) {
+ Sortable._marker = $('dropmarker') || document.createElement('DIV');
+ Element.hide(Sortable._marker);
+ Element.addClassName(Sortable._marker, 'dropmarker');
+ Sortable._marker.style.position = 'absolute';
+ document.getElementsByTagName("body").item(0).appendChild(Sortable._marker);
+ }
+ var offsets = Position.cumulativeOffset(dropon);
+ Sortable._marker.style.left = offsets[0] + 'px';
+ Sortable._marker.style.top = offsets[1] + 'px';
+
+ if(position=='after')
+ if(sortable.overlap == 'horizontal')
+ Sortable._marker.style.left = (offsets[0]+dropon.clientWidth) + 'px';
+ else
+ Sortable._marker.style.top = (offsets[1]+dropon.clientHeight) + 'px';
+
+ Element.show(Sortable._marker);
+ },
+
+ _tree: function(element, options, parent) {
+ var children = Sortable.findElements(element, options) || [];
+
+ for (var i = 0; i < children.length; ++i) {
+ var match = children[i].id.match(options.format);
+
+ if (!match) continue;
+
+ var child = {
+ id: encodeURIComponent(match ? match[1] : null),
+ element: element,
+ parent: parent,
+ children: new Array,
+ position: parent.children.length,
+ container: Sortable._findChildrenElement(children[i], options.treeTag.toUpperCase())
+ }
+
+ /* Get the element containing the children and recurse over it */
+ if (child.container)
+ this._tree(child.container, options, child)
+
+ parent.children.push (child);
+ }
+
+ return parent;
+ },
+
+ /* Finds the first element of the given tag type within a parent element.
+ Used for finding the first LI[ST] within a L[IST]I[TEM].*/
+ _findChildrenElement: function (element, containerTag) {
+ if (element && element.hasChildNodes)
+ for (var i = 0; i < element.childNodes.length; ++i)
+ if (element.childNodes[i].tagName == containerTag)
+ return element.childNodes[i];
+
+ return null;
+ },
+
+ tree: function(element) {
+ element = $(element);
+ var sortableOptions = this.options(element);
+ var options = Object.extend({
+ tag: sortableOptions.tag,
+ treeTag: sortableOptions.treeTag,
+ only: sortableOptions.only,
+ name: element.id,
+ format: sortableOptions.format
+ }, arguments[1] || {});
+
+ var root = {
+ id: null,
+ parent: null,
+ children: new Array,
+ container: element,
+ position: 0
+ }
+
+ return Sortable._tree (element, options, root);
+ },
+
+ /* Construct a [i] index for a particular node */
+ _constructIndex: function(node) {
+ var index = '';
+ do {
+ if (node.id) index = '[' + node.position + ']' + index;
+ } while ((node = node.parent) != null);
+ return index;
+ },
+
+ sequence: function(element) {
+ element = $(element);
+ var options = Object.extend(this.options(element), arguments[1] || {});
+
+ return $(this.findElements(element, options) || []).map( function(item) {
+ return item.id.match(options.format) ? item.id.match(options.format)[1] : '';
+ });
+ },
+
+ setSequence: function(element, new_sequence) {
+ element = $(element);
+ var options = Object.extend(this.options(element), arguments[2] || {});
+
+ var nodeMap = {};
+ this.findElements(element, options).each( function(n) {
+ if (n.id.match(options.format))
+ nodeMap[n.id.match(options.format)[1]] = [n, n.parentNode];
+ n.parentNode.removeChild(n);
+ });
+
+ new_sequence.each(function(ident) {
+ var n = nodeMap[ident];
+ if (n) {
+ n[1].appendChild(n[0]);
+ delete nodeMap[ident];
+ }
+ });
+ },
+
+ serialize: function(element) {
+ element = $(element);
+ var options = Object.extend(Sortable.options(element), arguments[1] || {});
+ var name = encodeURIComponent(
+ (arguments[1] && arguments[1].name) ? arguments[1].name : element.id);
+
+ if (options.tree) {
+ return Sortable.tree(element, arguments[1]).children.map( function (item) {
+ return [name + Sortable._constructIndex(item) + "=" +
+ encodeURIComponent(item.id)].concat(item.children.map(arguments.callee));
+ }).flatten().join('&');
+ } else {
+ return Sortable.sequence(element, arguments[1]).map( function(item) {
+ return name + "[]=" + encodeURIComponent(item);
+ }).join('&');
+ }
+ }
+}
+
+/* Returns true if child is contained within element */
+Element.isParent = function(child, element) {
+ if (!child.parentNode || child == element) return false;
+
+ if (child.parentNode == element) return true;
+
+ return Element.isParent(child.parentNode, element);
+}
+
+Element.findChildren = function(element, only, recursive, tagName) {
+ if(!element.hasChildNodes()) return null;
+ tagName = tagName.toUpperCase();
+ if(only) only = [only].flatten();
+ var elements = [];
+ $A(element.childNodes).each( function(e) {
+ if(e.tagName && e.tagName.toUpperCase()==tagName &&
+ (!only || (Element.classNames(e).detect(function(v) { return only.include(v) }))))
+ elements.push(e);
+ if(recursive) {
+ var grandchildren = Element.findChildren(e, only, recursive, tagName);
+ if(grandchildren) elements.push(grandchildren);
+ }
+ });
+
+ return (elements.length>0 ? elements.flatten() : []);
+}
+
+Element.offsetSize = function (element, type) {
+ if (type == 'vertical' || type == 'height')
+ return element.offsetHeight;
+ else
+ return element.offsetWidth;
+}
\ No newline at end of file
--- /dev/null
+// Copyright (c) 2005 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
+// Contributors:
+// Justin Palmer (http://encytemedia.com/)
+// Mark Pilgrim (http://diveintomark.org/)
+// Martin Bialasinki
+//
+// See scriptaculous.js for full license.
+
+// converts rgb() and #xxx to #xxxxxx format,
+// returns self (or first argument) if not convertable
+String.prototype.parseColor = function() {
+ var color = '#';
+ if(this.slice(0,4) == 'rgb(') {
+ var cols = this.slice(4,this.length-1).split(',');
+ var i=0; do { color += parseInt(cols[i]).toColorPart() } while (++i<3);
+ } else {
+ if(this.slice(0,1) == '#') {
+ if(this.length==4) for(var i=1;i<4;i++) color += (this.charAt(i) + this.charAt(i)).toLowerCase();
+ if(this.length==7) color = this.toLowerCase();
+ }
+ }
+ return(color.length==7 ? color : (arguments[0] || this));
+}
+
+/*--------------------------------------------------------------------------*/
+
+Element.collectTextNodes = function(element) {
+ return $A($(element).childNodes).collect( function(node) {
+ return (node.nodeType==3 ? node.nodeValue :
+ (node.hasChildNodes() ? Element.collectTextNodes(node) : ''));
+ }).flatten().join('');
+}
+
+Element.collectTextNodesIgnoreClass = function(element, className) {
+ return $A($(element).childNodes).collect( function(node) {
+ return (node.nodeType==3 ? node.nodeValue :
+ ((node.hasChildNodes() && !Element.hasClassName(node,className)) ?
+ Element.collectTextNodesIgnoreClass(node, className) : ''));
+ }).flatten().join('');
+}
+
+Element.setContentZoom = function(element, percent) {
+ element = $(element);
+ Element.setStyle(element, {fontSize: (percent/100) + 'em'});
+ if(navigator.appVersion.indexOf('AppleWebKit')>0) window.scrollBy(0,0);
+}
+
+Element.getOpacity = function(element){
+ var opacity;
+ if (opacity = Element.getStyle(element, 'opacity'))
+ return parseFloat(opacity);
+ if (opacity = (Element.getStyle(element, 'filter') || '').match(/alpha\(opacity=(.*)\)/))
+ if(opacity[1]) return parseFloat(opacity[1]) / 100;
+ return 1.0;
+}
+
+Element.setOpacity = function(element, value){
+ element= $(element);
+ if (value == 1){
+ Element.setStyle(element, { opacity:
+ (/Gecko/.test(navigator.userAgent) && !/Konqueror|Safari|KHTML/.test(navigator.userAgent)) ?
+ 0.999999 : null });
+ if(/MSIE/.test(navigator.userAgent))
+ Element.setStyle(element, {filter: Element.getStyle(element,'filter').replace(/alpha\([^\)]*\)/gi,'')});
+ } else {
+ if(value < 0.00001) value = 0;
+ Element.setStyle(element, {opacity: value});
+ if(/MSIE/.test(navigator.userAgent))
+ Element.setStyle(element,
+ { filter: Element.getStyle(element,'filter').replace(/alpha\([^\)]*\)/gi,'') +
+ 'alpha(opacity='+value*100+')' });
+ }
+}
+
+Element.getInlineOpacity = function(element){
+ return $(element).style.opacity || '';
+}
+
+Element.childrenWithClassName = function(element, className, findFirst) {
+ var classNameRegExp = new RegExp("(^|\\s)" + className + "(\\s|$)");
+ var results = $A($(element).getElementsByTagName('*'))[findFirst ? 'detect' : 'select']( function(c) {
+ return (c.className && c.className.match(classNameRegExp));
+ });
+ if(!results) results = [];
+ return results;
+}
+
+Element.forceRerendering = function(element) {
+ try {
+ element = $(element);
+ var n = document.createTextNode(' ');
+ element.appendChild(n);
+ element.removeChild(n);
+ } catch(e) { }
+};
+
+/*--------------------------------------------------------------------------*/
+
+Array.prototype.call = function() {
+ var args = arguments;
+ this.each(function(f){ f.apply(this, args) });
+}
+
+/*--------------------------------------------------------------------------*/
+
+var Effect = {
+ tagifyText: function(element) {
+ var tagifyStyle = 'position:relative';
+ if(/MSIE/.test(navigator.userAgent)) tagifyStyle += ';zoom:1';
+ element = $(element);
+ $A(element.childNodes).each( function(child) {
+ if(child.nodeType==3) {
+ child.nodeValue.toArray().each( function(character) {
+ element.insertBefore(
+ Builder.node('span',{style: tagifyStyle},
+ character == ' ' ? String.fromCharCode(160) : character),
+ child);
+ });
+ Element.remove(child);
+ }
+ });
+ },
+ multiple: function(element, effect) {
+ var elements;
+ if(((typeof element == 'object') ||
+ (typeof element == 'function')) &&
+ (element.length))
+ elements = element;
+ else
+ elements = $(element).childNodes;
+
+ var options = Object.extend({
+ speed: 0.1,
+ delay: 0.0
+ }, arguments[2] || {});
+ var masterDelay = options.delay;
+
+ $A(elements).each( function(element, index) {
+ new effect(element, Object.extend(options, { delay: index * options.speed + masterDelay }));
+ });
+ },
+ PAIRS: {
+ 'slide': ['SlideDown','SlideUp'],
+ 'blind': ['BlindDown','BlindUp'],
+ 'appear': ['Appear','Fade']
+ },
+ toggle: function(element, effect) {
+ element = $(element);
+ effect = (effect || 'appear').toLowerCase();
+ var options = Object.extend({
+ queue: { position:'end', scope:(element.id || 'global'), limit: 1 }
+ }, arguments[2] || {});
+ Effect[element.visible() ?
+ Effect.PAIRS[effect][1] : Effect.PAIRS[effect][0]](element, options);
+ }
+};
+
+var Effect2 = Effect; // deprecated
+
+/* ------------- transitions ------------- */
+
+Effect.Transitions = {}
+
+Effect.Transitions.linear = function(pos) {
+ return pos;
+}
+Effect.Transitions.sinoidal = function(pos) {
+ return (-Math.cos(pos*Math.PI)/2) + 0.5;
+}
+Effect.Transitions.reverse = function(pos) {
+ return 1-pos;
+}
+Effect.Transitions.flicker = function(pos) {
+ return ((-Math.cos(pos*Math.PI)/4) + 0.75) + Math.random()/4;
+}
+Effect.Transitions.wobble = function(pos) {
+ return (-Math.cos(pos*Math.PI*(9*pos))/2) + 0.5;
+}
+Effect.Transitions.pulse = function(pos) {
+ return (Math.floor(pos*10) % 2 == 0 ?
+ (pos*10-Math.floor(pos*10)) : 1-(pos*10-Math.floor(pos*10)));
+}
+Effect.Transitions.none = function(pos) {
+ return 0;
+}
+Effect.Transitions.full = function(pos) {
+ return 1;
+}
+
+/* ------------- core effects ------------- */
+
+Effect.ScopedQueue = Class.create();
+Object.extend(Object.extend(Effect.ScopedQueue.prototype, Enumerable), {
+ initialize: function() {
+ this.effects = [];
+ this.interval = null;
+ },
+ _each: function(iterator) {
+ this.effects._each(iterator);
+ },
+ add: function(effect) {
+ var timestamp = new Date().getTime();
+
+ var position = (typeof effect.options.queue == 'string') ?
+ effect.options.queue : effect.options.queue.position;
+
+ switch(position) {
+ case 'front':
+ // move unstarted effects after this effect
+ this.effects.findAll(function(e){ return e.state=='idle' }).each( function(e) {
+ e.startOn += effect.finishOn;
+ e.finishOn += effect.finishOn;
+ });
+ break;
+ case 'end':
+ // start effect after last queued effect has finished
+ timestamp = this.effects.pluck('finishOn').max() || timestamp;
+ break;
+ }
+
+ effect.startOn += timestamp;
+ effect.finishOn += timestamp;
+
+ if(!effect.options.queue.limit || (this.effects.length < effect.options.queue.limit))
+ this.effects.push(effect);
+
+ if(!this.interval)
+ this.interval = setInterval(this.loop.bind(this), 40);
+ },
+ remove: function(effect) {
+ this.effects = this.effects.reject(function(e) { return e==effect });
+ if(this.effects.length == 0) {
+ clearInterval(this.interval);
+ this.interval = null;
+ }
+ },
+ loop: function() {
+ var timePos = new Date().getTime();
+ this.effects.invoke('loop', timePos);
+ }
+});
+
+Effect.Queues = {
+ instances: $H(),
+ get: function(queueName) {
+ if(typeof queueName != 'string') return queueName;
+
+ if(!this.instances[queueName])
+ this.instances[queueName] = new Effect.ScopedQueue();
+
+ return this.instances[queueName];
+ }
+}
+Effect.Queue = Effect.Queues.get('global');
+
+Effect.DefaultOptions = {
+ transition: Effect.Transitions.sinoidal,
+ duration: 1.0, // seconds
+ fps: 25.0, // max. 25fps due to Effect.Queue implementation
+ sync: false, // true for combining
+ from: 0.0,
+ to: 1.0,
+ delay: 0.0,
+ queue: 'parallel'
+}
+
+Effect.Base = function() {};
+Effect.Base.prototype = {
+ position: null,
+ start: function(options) {
+ this.options = Object.extend(Object.extend({},Effect.DefaultOptions), options || {});
+ this.currentFrame = 0;
+ this.state = 'idle';
+ this.startOn = this.options.delay*1000;
+ this.finishOn = this.startOn + (this.options.duration*1000);
+ this.event('beforeStart');
+ if(!this.options.sync)
+ Effect.Queues.get(typeof this.options.queue == 'string' ?
+ 'global' : this.options.queue.scope).add(this);
+ },
+ loop: function(timePos) {
+ if(timePos >= this.startOn) {
+ if(timePos >= this.finishOn) {
+ this.render(1.0);
+ this.cancel();
+ this.event('beforeFinish');
+ if(this.finish) this.finish();
+ this.event('afterFinish');
+ return;
+ }
+ var pos = (timePos - this.startOn) / (this.finishOn - this.startOn);
+ var frame = Math.round(pos * this.options.fps * this.options.duration);
+ if(frame > this.currentFrame) {
+ this.render(pos);
+ this.currentFrame = frame;
+ }
+ }
+ },
+ render: function(pos) {
+ if(this.state == 'idle') {
+ this.state = 'running';
+ this.event('beforeSetup');
+ if(this.setup) this.setup();
+ this.event('afterSetup');
+ }
+ if(this.state == 'running') {
+ if(this.options.transition) pos = this.options.transition(pos);
+ pos *= (this.options.to-this.options.from);
+ pos += this.options.from;
+ this.position = pos;
+ this.event('beforeUpdate');
+ if(this.update) this.update(pos);
+ this.event('afterUpdate');
+ }
+ },
+ cancel: function() {
+ if(!this.options.sync)
+ Effect.Queues.get(typeof this.options.queue == 'string' ?
+ 'global' : this.options.queue.scope).remove(this);
+ this.state = 'finished';
+ },
+ event: function(eventName) {
+ if(this.options[eventName + 'Internal']) this.options[eventName + 'Internal'](this);
+ if(this.options[eventName]) this.options[eventName](this);
+ },
+ inspect: function() {
+ return '#<Effect:' + $H(this).inspect() + ',options:' + $H(this.options).inspect() + '>';
+ }
+}
+
+Effect.Parallel = Class.create();
+Object.extend(Object.extend(Effect.Parallel.prototype, Effect.Base.prototype), {
+ initialize: function(effects) {
+ this.effects = effects || [];
+ this.start(arguments[1]);
+ },
+ update: function(position) {
+ this.effects.invoke('render', position);
+ },
+ finish: function(position) {
+ this.effects.each( function(effect) {
+ effect.render(1.0);
+ effect.cancel();
+ effect.event('beforeFinish');
+ if(effect.finish) effect.finish(position);
+ effect.event('afterFinish');
+ });
+ }
+});
+
+Effect.Opacity = Class.create();
+Object.extend(Object.extend(Effect.Opacity.prototype, Effect.Base.prototype), {
+ initialize: function(element) {
+ this.element = $(element);
+ // make this work on IE on elements without 'layout'
+ if(/MSIE/.test(navigator.userAgent) && (!this.element.hasLayout))
+ this.element.setStyle({zoom: 1});
+ var options = Object.extend({
+ from: this.element.getOpacity() || 0.0,
+ to: 1.0
+ }, arguments[1] || {});
+ this.start(options);
+ },
+ update: function(position) {
+ this.element.setOpacity(position);
+ }
+});
+
+Effect.Move = Class.create();
+Object.extend(Object.extend(Effect.Move.prototype, Effect.Base.prototype), {
+ initialize: function(element) {
+ this.element = $(element);
+ var options = Object.extend({
+ x: 0,
+ y: 0,
+ mode: 'relative'
+ }, arguments[1] || {});
+ this.start(options);
+ },
+ setup: function() {
+ // Bug in Opera: Opera returns the "real" position of a static element or
+ // relative element that does not have top/left explicitly set.
+ // ==> Always set top and left for position relative elements in your stylesheets
+ // (to 0 if you do not need them)
+ this.element.makePositioned();
+ this.originalLeft = parseFloat(this.element.getStyle('left') || '0');
+ this.originalTop = parseFloat(this.element.getStyle('top') || '0');
+ if(this.options.mode == 'absolute') {
+ // absolute movement, so we need to calc deltaX and deltaY
+ this.options.x = this.options.x - this.originalLeft;
+ this.options.y = this.options.y - this.originalTop;
+ }
+ },
+ update: function(position) {
+ this.element.setStyle({
+ left: this.options.x * position + this.originalLeft + 'px',
+ top: this.options.y * position + this.originalTop + 'px'
+ });
+ }
+});
+
+// for backwards compatibility
+Effect.MoveBy = function(element, toTop, toLeft) {
+ return new Effect.Move(element,
+ Object.extend({ x: toLeft, y: toTop }, arguments[3] || {}));
+};
+
+Effect.Scale = Class.create();
+Object.extend(Object.extend(Effect.Scale.prototype, Effect.Base.prototype), {
+ initialize: function(element, percent) {
+ this.element = $(element)
+ var options = Object.extend({
+ scaleX: true,
+ scaleY: true,
+ scaleContent: true,
+ scaleFromCenter: false,
+ scaleMode: 'box', // 'box' or 'contents' or {} with provided values
+ scaleFrom: 100.0,
+ scaleTo: percent
+ }, arguments[2] || {});
+ this.start(options);
+ },
+ setup: function() {
+ this.restoreAfterFinish = this.options.restoreAfterFinish || false;
+ this.elementPositioning = this.element.getStyle('position');
+
+ this.originalStyle = {};
+ ['top','left','width','height','fontSize'].each( function(k) {
+ this.originalStyle[k] = this.element.style[k];
+ }.bind(this));
+
+ this.originalTop = this.element.offsetTop;
+ this.originalLeft = this.element.offsetLeft;
+
+ var fontSize = this.element.getStyle('font-size') || '100%';
+ ['em','px','%'].each( function(fontSizeType) {
+ if(fontSize.indexOf(fontSizeType)>0) {
+ this.fontSize = parseFloat(fontSize);
+ this.fontSizeType = fontSizeType;
+ }
+ }.bind(this));
+
+ this.factor = (this.options.scaleTo - this.options.scaleFrom)/100;
+
+ this.dims = null;
+ if(this.options.scaleMode=='box')
+ this.dims = [this.element.offsetHeight, this.element.offsetWidth];
+ if(/^content/.test(this.options.scaleMode))
+ this.dims = [this.element.scrollHeight, this.element.scrollWidth];
+ if(!this.dims)
+ this.dims = [this.options.scaleMode.originalHeight,
+ this.options.scaleMode.originalWidth];
+ },
+ update: function(position) {
+ var currentScale = (this.options.scaleFrom/100.0) + (this.factor * position);
+ if(this.options.scaleContent && this.fontSize)
+ this.element.setStyle({fontSize: this.fontSize * currentScale + this.fontSizeType });
+ this.setDimensions(this.dims[0] * currentScale, this.dims[1] * currentScale);
+ },
+ finish: function(position) {
+ if (this.restoreAfterFinish) this.element.setStyle(this.originalStyle);
+ },
+ setDimensions: function(height, width) {
+ var d = {};
+ if(this.options.scaleX) d.width = width + 'px';
+ if(this.options.scaleY) d.height = height + 'px';
+ if(this.options.scaleFromCenter) {
+ var topd = (height - this.dims[0])/2;
+ var leftd = (width - this.dims[1])/2;
+ if(this.elementPositioning == 'absolute') {
+ if(this.options.scaleY) d.top = this.originalTop-topd + 'px';
+ if(this.options.scaleX) d.left = this.originalLeft-leftd + 'px';
+ } else {
+ if(this.options.scaleY) d.top = -topd + 'px';
+ if(this.options.scaleX) d.left = -leftd + 'px';
+ }
+ }
+ this.element.setStyle(d);
+ }
+});
+
+Effect.Highlight = Class.create();
+Object.extend(Object.extend(Effect.Highlight.prototype, Effect.Base.prototype), {
+ initialize: function(element) {
+ this.element = $(element);
+ var options = Object.extend({ startcolor: '#ffff99' }, arguments[1] || {});
+ this.start(options);
+ },
+ setup: function() {
+ // Prevent executing on elements not in the layout flow
+ if(this.element.getStyle('display')=='none') { this.cancel(); return; }
+ // Disable background image during the effect
+ this.oldStyle = {
+ backgroundImage: this.element.getStyle('background-image') };
+ this.element.setStyle({backgroundImage: 'none'});
+ if(!this.options.endcolor)
+ this.options.endcolor = this.element.getStyle('background-color').parseColor('#ffffff');
+ if(!this.options.restorecolor)
+ this.options.restorecolor = this.element.getStyle('background-color');
+ // init color calculations
+ this._base = $R(0,2).map(function(i){ return parseInt(this.options.startcolor.slice(i*2+1,i*2+3),16) }.bind(this));
+ this._delta = $R(0,2).map(function(i){ return parseInt(this.options.endcolor.slice(i*2+1,i*2+3),16)-this._base[i] }.bind(this));
+ },
+ update: function(position) {
+ this.element.setStyle({backgroundColor: $R(0,2).inject('#',function(m,v,i){
+ return m+(Math.round(this._base[i]+(this._delta[i]*position)).toColorPart()); }.bind(this)) });
+ },
+ finish: function() {
+ this.element.setStyle(Object.extend(this.oldStyle, {
+ backgroundColor: this.options.restorecolor
+ }));
+ }
+});
+
+Effect.ScrollTo = Class.create();
+Object.extend(Object.extend(Effect.ScrollTo.prototype, Effect.Base.prototype), {
+ initialize: function(element) {
+ this.element = $(element);
+ this.start(arguments[1] || {});
+ },
+ setup: function() {
+ Position.prepare();
+ var offsets = Position.cumulativeOffset(this.element);
+ if(this.options.offset) offsets[1] += this.options.offset;
+ var max = window.innerHeight ?
+ window.height - window.innerHeight :
+ document.body.scrollHeight -
+ (document.documentElement.clientHeight ?
+ document.documentElement.clientHeight : document.body.clientHeight);
+ this.scrollStart = Position.deltaY;
+ this.delta = (offsets[1] > max ? max : offsets[1]) - this.scrollStart;
+ },
+ update: function(position) {
+ Position.prepare();
+ window.scrollTo(Position.deltaX,
+ this.scrollStart + (position*this.delta));
+ }
+});
+
+/* ------------- combination effects ------------- */
+
+Effect.Fade = function(element) {
+ element = $(element);
+ var oldOpacity = element.getInlineOpacity();
+ var options = Object.extend({
+ from: element.getOpacity() || 1.0,
+ to: 0.0,
+ afterFinishInternal: function(effect) {
+ if(effect.options.to!=0) return;
+ effect.element.hide();
+ effect.element.setStyle({opacity: oldOpacity});
+ }}, arguments[1] || {});
+ return new Effect.Opacity(element,options);
+}
+
+Effect.Appear = function(element) {
+ element = $(element);
+ var options = Object.extend({
+ from: (element.getStyle('display') == 'none' ? 0.0 : element.getOpacity() || 0.0),
+ to: 1.0,
+ // force Safari to render floated elements properly
+ afterFinishInternal: function(effect) {
+ effect.element.forceRerendering();
+ },
+ beforeSetup: function(effect) {
+ effect.element.setOpacity(effect.options.from);
+ effect.element.show();
+ }}, arguments[1] || {});
+ return new Effect.Opacity(element,options);
+}
+
+Effect.Puff = function(element) {
+ element = $(element);
+ var oldStyle = { opacity: element.getInlineOpacity(), position: element.getStyle('position') };
+ return new Effect.Parallel(
+ [ new Effect.Scale(element, 200,
+ { sync: true, scaleFromCenter: true, scaleContent: true, restoreAfterFinish: true }),
+ new Effect.Opacity(element, { sync: true, to: 0.0 } ) ],
+ Object.extend({ duration: 1.0,
+ beforeSetupInternal: function(effect) {
+ effect.effects[0].element.setStyle({position: 'absolute'}); },
+ afterFinishInternal: function(effect) {
+ effect.effects[0].element.hide();
+ effect.effects[0].element.setStyle(oldStyle); }
+ }, arguments[1] || {})
+ );
+}
+
+Effect.BlindUp = function(element) {
+ element = $(element);
+ element.makeClipping();
+ return new Effect.Scale(element, 0,
+ Object.extend({ scaleContent: false,
+ scaleX: false,
+ restoreAfterFinish: true,
+ afterFinishInternal: function(effect) {
+ effect.element.hide();
+ effect.element.undoClipping();
+ }
+ }, arguments[1] || {})
+ );
+}
+
+Effect.BlindDown = function(element) {
+ element = $(element);
+ var elementDimensions = element.getDimensions();
+ return new Effect.Scale(element, 100,
+ Object.extend({ scaleContent: false,
+ scaleX: false,
+ scaleFrom: 0,
+ scaleMode: {originalHeight:&nbs
projects / phppgadmin.git / commitdiff
