The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Rose::HTML::Form::Field::Email - Text field that only accepts valid email addresses.

SYNOPSIS

$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;

...

DESCRIPTION

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.

SEE ALSO

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.

AUTHOR

John C. Siracusa (siracusa@gmail.com)

LICENSE

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.