Catalyst::Controller::Rose::Autocomplete(3)

NAME
Catalyst::Controller::Rose::Autocomplete - RDBO/RHTMLO Ajax Autocompletion

SYNOPSIS
 # your controller code

 package MyApp::Controller::AC;
 use base 'Catalyst::Controller::Rose::Autocomplete';
 sub model_name { 'SomeThing' }
 1;

 # and in your template
 # search column 'foo' and return 10 results.

 [% PROCESS tt/autocomplete.tt
            input = {
                id    = 'foo',
                url   = c.url_for('/ac/list?c=foo&l=10'),
                label = 'Enter your Foo here:'
            }

                %]

DESCRIPTION
Catalyst::Controller::Rose::Autocomplete is a simple controller for answering client-side Ajax autocomplete requests. It is designed to work with the Scriptaculous and Prototype JavaScript libraries, but the output format can be adapted for any Ajax autocomplete framework.

METHODS
The following methods are available:

  list
This method handles the input param parsing and creates a query to hand to find(). list() then creates the correct HTML format and sets response body.

  find( context, query )
The default find() method returns an array of scalar values suitable for returning to the browser. It is called by list().

find() is a prime candidate for overriding in your subclass.

EXAMPLES
See the examples/ dir in the distribution.

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.