GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  HTML::SUPERFORM::FIELD (3)

.ds Aq ’

NAME

HTML::SuperForm::Field - HTML form field base class

CONTENTS

SYNOPSIS



    package myForm::SuperDuper;

    use base HTML::SuperForm::Field;

    sub init {}
    sub prepare {}

    sub to_html {
        my $self = shift;

        my $tag = qq|For some reason this text makes|;
           $tag.= qq|the field super duper|
           $tag.= qq|<input type="text" name="| . $self->name . ";
           $tag.= qq| value="| . $self->value . ";
           $tag.= / if $self->well_formed;
           $tag.= >;

        return $tag;
    }

    1;



DESCRIPTION

This is the base class for all the HTML form field objects.

METHODS

    CONSTRUCTOR

new($form, %args), new($form, \%args), new(%args), new(\%args) $form is the HTML::SuperForm object to associate the field with. %args usually has the following (each is also a method to access its value):
name() The name of the field.
default() The default value to use before data has been submitted or if the form isn’t sticky.

Other possible arguments include:
sticky() Determines whether the field is sticky or not. Defaults to what the form object’s sticky flag is set to. If no form object is specified it defaults to false.
fallback() Determines whether the field’s value falls back to the default if the field is sticky but no data has been submitted for the field. Defaults to what the form object’s fallback flag is set to. If no form object is specified it defaults to false.
well_formed() Determines whether the HTML generated is well-formed or not. If true, a slash is added to the end of non-container tags (i.e. <input type=text name=my_text/>). Attributes such as multiple, readonly, disabled, selected, and checked are also set equal to true values instead of being left alone (i.e. <input type=checkbox checked=checked> rather than just <input type=checkbox" checked>).
values_as_labels(), value_as_label() Determines whether the value specifed by value or values is used as a label if no label is specified. Default is true.
disabled() Determines whether the field is disabled or not.

Arguments not used by all the fields also include:
multiple() Determines whether a field can have multiple values selected. Only Select uses this feature.
readonly() Determines whether a field is readonly. Used by fields such as Text and Textarea.

init($config) This method is the very first thing called in HTML::SuperForm::Field’s constructor. Subclasses of HTML::SuperForm::Field should override this method to manipulate the parameters passed in before processing them. An example is in HTML::SuperForm::Field::Checkbox.
prepare() This method is the very last thing called in HTML::SuperForm::Field’s constructor. Subclasses of HTML::SuperForm::Field should override this method to add extra information to the object for later use. An example of its use is in the documentation for HTML::SuperForm under the section EXAMPLES.
to_html() This method returns the string representation of your field. When the object is used in string context this method is called to generate the string. Subclasses of HTML::SuperForm::Field should override this method display a default layout. All of the basic fields that come with HTML::SuperForm have this method, so look at them for examples. The Counter example in HTML::SuperForm’s documentation could also be helpful.

SEE ALSO



 HTML::SuperForm::Field::Text,
 HTML::SuperForm::Field::Textarea,
 HTML::SuperForm::Field::Select,
 HTML::SuperForm::Field::Checkbox,
 HTML::SuperForm::Field::Radio,
 HTML::SuperForm::Field::CheckboxGroup,
 HTML::SuperForm::Field::RadioGroup



AUTHOR

John Allwine <jallwine86@yahoo.com>

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 495: ’=item’ outside of any ’=over’
Around line 516: You forgot a ’=back’ before ’=head1’
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 HTML::SUPERFORM::FIELD (3) 2004-09-25

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.