Rose::HTMLx::Form::Field::Autocomplete(3p)

NAME
Rose::HTMLx::Form::Field::Autocomplete - Ajax autocompletion for text fields

SYNOPSIS
 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;

 ...

DESCRIPTION
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.

METHODS
Only changes from Rose::HTML::Form::Field::Text are documented here.

  autocomplete
Expects a URL value but any string is acceptable. See url().

  limit
Expects an integer, which will be used in the construction of url().

  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.

  url_as_string
Like url() but the return value is a scalar string, not an array ref. The value is the URI-escaped value of url().

AUTHOR
Peter Karman <perl@peknet.com>

Thanks to Atomic Learning, Inc for sponsoring the development of this module.

LICENSE
This library is free software. You may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO
Catalyst::Controller::Rose::Autocomplete, Rose::HTML::Objects, Rose::HTML::Form::Field