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

SYNOPSIS

        use CGI::Lazy;

        my $q = CGI::Lazy->new('/path/to/config');

        my $widget = $q->widget->dataset({...});

DESCRIPTION

CGI::Lazy::Widget is an abstract class for widgets such as Dataset, Composite, and Domloader.

Its methods are called internally by its child classes. There are, at present, no real uses for the class by itself.

METHODS

ajaxReturn ( widgets, data )

Wraps data (presumably from widget) in json format with validator from widgets for returning to browser in response to an ajax reqeust

ajaxSelect (args )

Returns result of select method in a json format suitable for returning to the browser

args

see select( args) for details

widgets

List of widgets to be parsed for validators

data

Widget html output

jsonescape ( var )

traverses variable and strips out single quotes to prevent JSON parser blowing up.

Strips them out rather than escaping them, as at present I can't figure out how to just add a single fracking backslash to them. s/'/\\'/g gives 2 backslashes, and s/'/\'/g gives none. grr. problem seems to be in either JSON or JSONPARSER

var

whatever variable you're going to convert to json and then parse

preloadLookup

Runs queries for lookup tables and parses then into JSON wrapped in javascript suitable for loading into the DOM of a page.

Useful only for tables that are intended to be preloaded into a page at load.

ajaxBlank ()

Convenience method. Returns blank widget output

select (args)

Runs select based on args and returns output.

args

Hash of select parameters. Expects to see a key called 'incoming' that contains the incoming parameters in widgetID-fieldname => value format.

Widgets such as Dataset will also have a parameter called CGILazyID which will contain the name of the widget (for doing different things at the cgi level based on which widget is talking to the app). This key/value will be stripped automatically.

The rest of the hash supports the following options:

        div             => 1  #By default will be sans enclosing div tags, but div can be included if you pass div => 1.  This is useful for members of composite widgets.
        
        searchLike              => '%?%' # search will be like %value%, in other words anything containing 'value'. Like is applied only to searches coming in from web, not vars added to the search in the cgi

        searchLike              => '?%'  # search will be on value%

        searchLike              => '%?'  # search on %v

        vars            => {fieldname => {optionname => optionvalue}}

        vars            => {fieldname => {value => 'bar'}} #extra search parameter.

        vars            => {foo => {handle => $ref}}} # when retrieved $$ref will have the value of field foo. ('handle' is a 'handle' on that value for use in tying things together.)
        
        searchLikeVars  => '%?%' # search will be like %value%, in other words anything containing 'value'.  like is applied to vars specified from the cgi. Basically this means you can do a like on variables hardcoded in the cgi independantly from things coming in from the web.

        searchLikeVars  => '?%'  # search will be on value%

        searchikeVars   => '%?'  # search on %v