LEGAL

#===========================================================================

Copyright (C) 2008 by Nik Ogura. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Bug reports and comments to nik.ogura@gmail.com.

#===========================================================================

NAME

CGI::Lazy::Widget::DomLoader

SYNOPSIS

        use CGI::Lazy;

        my $q = CGI::Lazy->new('frobnitz.conf');

        my $domloader = $q->widget->domloader({

                        raw => {
                                jsobjectname    => $perlvariable,
                                someotherobj    => $someOtherVariable,

                        },

                        lookups {

                                countryLookup => {  #name of resultant DOM object

                                        sql             => 'select ID, country from countryCodeLookup ', 

                                        orderby         => ['ID'],

                                        output          => 'hash',

                                        primarykey      => 'ID',

                                },

                        },

                        });

        print $domloader->output;

DESCRIPTION

CGI::Lazy::Widget::DomLoader is an object for preloading useful stuff into a page's DOM, such as lookup queries, or any javascript object that might be desired. This is functionality that is duplicated from the internals of CGI::Lazy::Widget::Dataset, but it's included as a separate object for preloading arbitrary values for other purposes.

It's created by calling the domloader method on the widget object, and passing in its configuration hashref.

lookups

Queries to be run and loaded into the DOM as simple lists.

raw

Raw perl variables to be parsed and converted to javascript objects. This is intended to facilitate loading complex data structures, arrays of arrays, hashes of hashes, etc into the DOM. Basically you create it in perl, and it gets parsed into JS and loaded into the DOM for the page.

METHODS

output ()

Returns output of object for printing to the web page