NAME

       Embperl::Form - Embperl Form class

SYNOPSIS

DESCRIPTION

METHODS

   new ($controls, $options)
       •   $controls

           Array  ref with controls which should be displayed inside the form. Each control needs either to be a
           hashref with all parameters for the control or a control object.

           If hash refs are given it's necessary to specify the "type"  parameter,  to  let  Embperl::Form  know
           which control to create.

           See Embperl::Form::Control and Embperl::Form::Control::* for a list of available parameters.

       •   $options

           Hash ref which can take the following parameters:

           •   formname

               Will  be used as name and id attribute of the form. If you have more then one form on a page it's
               necessary to have different form names to make form validation work correctly.

           •   masks

               Contains a hash ref which can specify a set of masks for  the  controls.  A  mask  is  a  set  of
               parameter  which  overwrite  the  setting of a control. You can specify a mask for a control name
               (key is name), for a control type (key is *type) or for all controls (key is *).

               Example:

                   {
                   'info'      => { readonly => 1},
                   '*textarea' => { cols => 80 },
                   '*'         => { labelclass => 'myclass', labelnowrap => 1}
                   }

               This will force the control with the name "info" to be readonly, it  will  force  all  "textarea"
               controls  to  have  80  columns  and  it  will force the label of all controls to have a class of
               myclass and not to wrap the text.

           •   defaults

               Contains a hash ref which can specify a set of defaults for  the  controls.  You  can  specify  a
               default  for  a control name (key is name), for a control type (key is *type) or for all controls
               (key is *).

               Example:

                   {
                   'info'      => { readonly => 1},
                   '*textarea' => { cols => 80 },
                   '*'         => { labelclass => 'myclass', labelnowrap => 1}
                   }

               This will make the control with the name "info" to default to be readonly, it  will  default  all
               "textarea"  controls  to  have 80 columns and it will set the default class for the labels of all
               controls to myclass and not to wrap the text.

           •   language

               Language setting is used for Embperl::Form::Validate, e.g. 'en' or 'de'

           •   charset

               Charset setting is used for Embperl::Form::Validate, e.g. 'utf-8'

           •   valign

               valign for control cells. Defaults to 'top' .

           •   jsnamespace

               Give the JavaScript Namespace. This allows one to load js files  in  a  top  frame  or  different
               frame,  which will speed up page loading, because the browser does not need to reload the js code
               on every load.

               Example:

                   jsnamespace => 'top'

           •   classdiv

               Gives the CSS class of the DIV around the form. Default cTableDiv.

           •   checkitems

               If set to true, allows one to call the function diff_checkitems after the data is posted and  see
               which form fields are changed.

           •   control_packages

               Arrayref  with  package  names  to  search for form controls. Alternatively you can overwrite the
               method get_control_packages.

           •   datasrc_packages

               Arrayref with package names to search  for  form  data  source  modules.  Alternatively  you  can
               overwrite the method get_datasrc_packages.

   layout
   validate
   show
   convert_label
       Converts  the label of a control to the text that should be outputed.  By default does return the text or
       name parameter of the control.  Can be overwritten to allow for example internationalization.

       $ctrl
           Embperl::Form::Control object

       $name
           optional: name to translate, if not given take $ctrl -> {name}

   convert_text
       Converts the text of a control to the text that should be outputed.  By default does return the  text  or
       name parameter of the control.  Can be overwritten to allow for example internationalization.

       $ctrl
           Embperl::Form::Control object

   convert_options
       Converts  the  values of a control to the text that should be outputed.  By default does nothing.  Can be
       overwritten to allow for example internationalization.

       $ctrl
           Embperl::Form::Control object

       $values
           values of the control i.e. values that are submitted

       $options
           options of the control i.e. text that should be displayed

AUTHOR

       G. Richter (richter at embperl dot org)

SEE ALSO

       perl(1), Embperl, Embperl::Form::Control

perl v5.34.0                                       2022-02-06                                          Form(3pm)