Rose::HTML::Form::Field::Email - Text field that only accepts valid email addresses.
$field = Rose::HTML::Form::Field::Email->new( label => 'Email', name => 'email', size => 30, maxlength => 255); if($field->validate) { $email = $field->internal_value; } else { # Handle invalid email addresses } print $field->html; ...
Rose::HTML::Form::Field::Email is a subclass of Rose::HTML::Form::Field::Text that uses Email::Valid to allow only valid email addresses as input. It overrides the validate() method of its parent class, returning true if the internal_value() is a valid email address, or setting an error message and returning false otherwise.
This is a good example of a custom field class that simply constrains the kinds of inputs that it accepts, but does not inflate/deflate values or aggregate other fields.
Other examples of custom fields:
Uses inflate/deflate to coerce input into a fixed format.
Uses inflate/deflate to convert input to a DateTime object.
A compound field whose internal value consists of more than one object.
A simple compound field that coalesces multiple subfields into a single value.
A compound field that uses inflate/deflate convert input from multiple subfields into a DateTime object.
A compound field that includes other compound fields and uses inflate/deflate convert input from multiple subfields into a DateTime object.
John C. Siracusa (siracusa@gmail.com)
Copyright (c) 2010 by John C. Siracusa. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Rose::HTML::Objects, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Rose::HTML::Objects
CPAN shell
perl -MCPAN -e shell install Rose::HTML::Objects
For more information on module installation, please visit the detailed CPAN module installation guide.