Alien-GvaScript
view release on metacpan or search on metacpan
doc/html/AutoCompleter.html view on Meta::CPAN
</div>
</div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#Options">Options</a>
<div class="TN_content"></div>
</div>
</div>
</div>
<div class="TN_node">
<a class="TN_label" href="#METHODS">METHODS</a>
<div class="TN_content"><div class="TN_leaf">
<a class="TN_label" href="#autocomplete_inputField_">autocomplete(inputField)</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#detach_inputField_">detach(inputField)</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#displayMessage_messageText_">displayMessage(messageText)</a>
<div class="TN_content"></div>
</div>
</div>
</div>
<div class="TN_node">
<a class="TN_label" href="#EVENTS">EVENTS</a>
<div class="TN_content"><div class="TN_leaf">
<a class="TN_label" href="#onBind">onBind</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#onLeave">onLeave</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#onComplete">onComplete</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#onLegalValue">onLegalValue</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#onIllegalValue">onIllegalValue</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#onHighlight">onHighlight</a>
<div class="TN_content"></div>
</div>
<div class="TN_leaf">
<a class="TN_label" href="#onCancel">onCancel</a>
<div class="TN_content"></div>
</div>
</div>
</div>
</div>
</div>
<hr/>
</div>
</div>
<div class="TN_node" id="NAME">
<h2 class="TN_label">NAME</h2>
<div class="TN_content">
<p>Alien::GvaScript::Autocompleter - autocompletion on form input fields</p>
</div>
</div>
<div class="TN_node" id="SYNOPSIS">
<h2 class="TN_label">SYNOPSIS</h2>
<div class="TN_content">
<p>In Javascript :</p>
<pre> var autocompleter1 = new GvaScript.Autocompleter(
"http::/some/url",
{minimumChars : 2,
strict : true,
onBind : doSomething,
onLeave : doSomethingElse} );
var autoCompleter2 = new GvaScript.Autocompleter(
["foo", "bar", ...], options);
var autoCompleter3 = new GvaScript.Autocompleter(
[{label: "foo", value: "f", otherValue: 123},
{label: "bar", value: "b", otherValue: 456}, ...], options);
var autoCompleter4 = new GvaScript.Autocompleter(
myCompletionFunction, options);</pre>
<p>Then, in HTML :</p>
<pre> <input onfocus="autoCompleter1.autocomplete(this)"></pre>
</div>
</div>
<div class="TN_node" id="DESCRIPTION">
<h2 class="TN_label">DESCRIPTION</h2>
<div class="TN_content">
<p>Component designed both as an "autocompleter" (anticipating
further key events by users) and as a replacement for HTML <code>SELECT</code>
form items.</p>
<p>An autocompleter instance encapsulates a datasource (which may be an
inline object, a callback function or an Ajax request), together with
some behavioral options (detailed below). That autocompleter may then
be <i>bound</i> to one or several input fields in a form (but only one at
a time), and will take care of capturing user input, navigating in the
suggestion list, and filling the field with the chosen value.</p>
<p>An event model is associated with the autocompleter, so that
client code can insert hooks to various steps of
the autocompletion behaviour.</p>
<p>The list of suggestions may contain arbitrary HTML, including rich
formatting options.</p>
</div>
</div>
<div class="TN_node" id="BEHAVIOUR">
<h2 class="TN_label">BEHAVIOUR</h2>
<div class="TN_content">
<p>When the input field gets focus, the autocompleter starts listening
( run in 1.601 second using v1.01-cache-2.11-cpan-df04353d9ac )