Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

html::formhandler::types(3pm) [debian man page]

HTML::FormHandler::Types(3pm)				User Contributed Perl Documentation			     HTML::FormHandler::Types(3pm)

NAME

       HTML::FormHandler::Types - Moose type constraints

VERSION

       version 0.40013

SYNOPSIS

       These types are provided by MooseX::Types. These types must not be quoted when they are used:

	 has 'posint' => ( is => 'rw', isa => PositiveInt);
	 has_field 'email' => ( apply => [ Email ] );

       Types declared using Moose::Util::TypeConstraints, on the other hand, must be quoted:

	 has_field 'text_both' => ( apply => [ PositiveInt, 'GreaterThan10' ] );

       To import these types into your forms, you must either specify (':all') or list the types you want to use:

	  use HTML::FormHandler::Types (':all');

       or:

	  use HTML::FormHandler::Types ('Email', 'PositiveInt');

DESCRIPTION

       It would be possible to import the MooseX types (Common, etc), but for now we'll just re-implement them here in order to be able to change
       the messages and keep control of what types we provide.

       From MooseX::Types::Common:

	 'PositiveNum', 'PositiveInt', 'NegativeNum', 'NegativeInt', 'SingleDigit',
	 'SimpleStr', 'NonEmptySimpleStr', 'Password', 'StrongPassword', 'NonEmptyStr',

Type Constraints
       These types check the value and issue an error message.

       Email
	   Uses Email::Valid

       State
	   Checks that the state is in a list of two uppercase letters.

       Zip
       IPAddress
	   Must be a valid IPv4 address.

       NoSpaces
	   No spaces in string allowed.

       WordChars
	   Must be made up of letters, digits, and underscores.

       NotAllDigits
	   Might be useful for passwords.

       Printable
	   Must not contain non-printable characters.

       SingleWord
	   Contains a single word.

   Type Coercions
       These types will transform the value without an error message;

       Collapse
	   Replaces multiple spaces with a single space

       Upper
	   Makes the string all upper case

       Lower
	   Makes the string all lower case

       Trim
	   Trims the string of starting and ending spaces

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Gerda Shank.

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

perl v5.14.2							    2012-06-25					     HTML::FormHandler::Types(3pm)

Check Out this Related Man Page

HTML::FormHandler::Field::Display(3pm)			User Contributed Perl Documentation		    HTML::FormHandler::Field::Display(3pm)

NAME

       HTML::FormHandler::Field::Display - display only field

VERSION

       version 0.40013

SYNOPSIS

       This class can be used for fields that are display only. It will render the value returned by a form's 'html_<field_name>' method, or the
       field's 'html' attribute.

	 has_field 'explanation' => ( type => 'Display',
	    html => '<p>This is an explanation...</p>' );

       or in a form:

	 has_field 'explanation' => ( type => 'Display' );
	 sub html_explanation {
	    my ( $self, $field ) = @_;
	    if( $self->something ) {
	       return '<p>This type of explanation...</p>';
	    }
	    else {
	       return '<p>Another type of explanation...</p>';
	    }
	 }
	 #----
	 has_field 'username' => ( type => 'Display' );
	 sub html_username {
	     my ( $self, $field ) = @_;
	     return '<div><b>User:&nbsp;</b>' . $field->value . '</div>';
	 }

       or set the name of the rendering method:

	  has_field 'explanation' => ( type => 'Display', set_html => 'my_explanation' );
	  sub my_explanation {
	    ....
	  }

       You can also supply an 'html' method with a trait or a custom field. See examples in t/field_traits.t and t/xt/display.t of the
       distribution.

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Gerda Shank.

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

perl v5.14.2							    2012-06-25				    HTML::FormHandler::Field::Display(3pm)
Man Page