Rose::HTMLx::Form::Field::Autocomplete - Ajax autocompletion for text fields
my $field = Rose::HTMLx::Form::Field::Autocomplete->new( label => 'Complete Me', name => 'completer', size => 30, maxlength => 128, autocomplete => 'http://myserver.foo/completer/url, limit => 30 ); print $field->xhtml; ...
This subclass of Rose::HTML::Form::Field::Text is intended to make it easier to integrate Ajax autocompletion into your web applications. You define a URL where your web application can find suggested values for the field, and optionally, a limit on the number of suggestions returned by the server.
This subclass is expected to be used with Catalyst::Controller::Rose::Autocomplete but that is not required.
Only changes from Rose::HTML::Form::Field::Text are documented here.
Expects a URL value but any string is acceptable. See url().
Expects an integer, which will be used in the construction of url().
Returns the URL for use in your template. The return value is an array ref, with the first value being the base URI and the second value being a hashref of param key/value pairs. The hashref keys are in the syntax that Catalyst::Controller::Rose::Autocomplete expects.
See the Catalyst::Controller::Rose example application for examples of using the url() method with Template Toolkit.
Like url() but the return value is a scalar string, not an array ref. The value is the URI-escaped value of url().
Peter Karman <email@example.com>
Thanks to Atomic Learning, Inc for sponsoring the development of this module.
This library is free software. You may redistribute it and/or modify it under the same terms as Perl itself.
Catalyst::Controller::Rose::Autocomplete, Rose::HTML::Objects, Rose::HTML::Form::Field