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:
- Rose::HTML::Form::Field::Time
- Uses inflate/deflate to coerce input into a fixed format.
- Rose::HTML::Form::Field::DateTime
- Uses inflate/deflate to convert input to a DateTime object.
- Rose::HTML::Form::Field::DateTime::Range
- A compound field whose internal value consists of more than one
object.
- Rose::HTML::Form::Field::PhoneNumber::US::Split
- A simple compound field that coalesces multiple subfields into a single
value.
- Rose::HTML::Form::Field::DateTime::Split::MonthDayYear
- A compound field that uses inflate/deflate convert input from multiple
subfields into a DateTime object.
- Rose::HTML::Form::Field::DateTime::Split::MDYHMS
- 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.