NAME

XML::XForms::Generator::Control

SYNOPSIS

 use XML::XForms::Generator;

 ## Example 1
 my $control = xforms_input( { ref => 'example' },
                             [ qq|label|,
                               {},
                               qq|Example Input:| ] );

  ## Example 2
  my $label = XML::LibXML::Element->new( "label" );

  my $control2 = xforms_input( { ref => 'example2' },
                               $label );

DESCRIPTION

The XML::LibXML DOM wrapper provided by XML::XForms::Generator module is based on convience functions for quick creation of XForms controls. These functions are named after the XForms control they create prefixed by 'xforms_'. The result of 'xforms_' convience functions is an object with all of the methods available to a standard XML::LibXML::Element along with all of the convience methods listed further down in this documentation under the METHODS section.

Each XForms control function takes a hash reference to set of name => value pairs that describe the control's attributes and set of name => value pairs that are associated with a controls child elements.

Each XForms control also takes an array of child elements to attach to control. They can be specified in one of two ways in during object creation. The first method is to build an anonymous array as an argument with the name of the child as the first element, anonymous hash of attributes as the second element, and child elements as the the rest of the anonymous array. This is demonstrated in first example above. The second method is to send an object that has XML::LibXML::Node in its ISA tree as an argument. Some XForms controls require certain child elements to exist to comply with the specification (most notably the label element). If you don't specify those elements on creation, the creation will fail with an error.

XFORMS CONTROLS

 trigger     - Generates a trigger element (button?, etc.)
 input      - Simple text entry box
 output     - Display instance data
 range      - Selection of a set of contiguous data
 secret     - "Password" entry box
 select     - Multi-selection box
 select1    - Selection box
 submit     - Submit button
 textarea   - Large text entry box
 upload     - Control for file uploads

METHODS

See code for additional methods as I haven't found a momment to document them.

AUTHOR

D. Hageman <dhageman@dracken.com>

SEE ALSO

 XML::XForms::Generator
 XML::XForms::Generator::Action
 XML::XForms::Generator::Model
 XML::LibXML
 XML::LibXML::DOM

COPYRIGHT AND LICENSE

Copyright (c) 2002-2004 D. Hageman (Dracken Technologies).

All rights reserved.

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