Rose::HTML::Form::Field::PhoneNumber::US::Split - Compound field for US phone
numbers with separate fields for area code, exchange, and number.
$field =
Rose::HTML::Form::Field::PhoneNumber::US::Split->new(
label => 'Phone',
name => 'phone',
default => '123-321-1234');
print $field->field('area_code')->internal_value; # "123"
$field->input_value('555-5555');
# "Phone number must be 10 digits, including area code"
$field->validate or warn $field->error;
$field->input_value('(555) 456-7890');
print $field->field('exchange')->internal_value; # "456"
print $field->internal_value; # "555-456-7890"
print $field->html;
...
Rose::HTML::Form::Field::PhoneNumber::US::Split is a compound field that
contains three separate text fields for US phone numbers: one each for area
code, exchange, and number. It inherits from both
Rose::HTML::Form::Field::PhoneNumber::US and
Rose::HTML::Form::Field::Compound. It overrides the following methods:
build_field(), coalesce_value(), decompose_value(),
html_field(), and xhtml_field().
This is a good example of a compound field that combines separate
fields into a single value through simple concatenation (plus a separator
character). By inheriting from Rose::HTML::Form::Field::PhoneNumber::US, it
gets the validation and inflate/deflate features "for free",
leaving it to concentrate on the coalesce/decompose features and the
building and printing of the separate fields that make up the compound
field.
It is important that this class inherits from
Rose::HTML::Form::Field::Compound. See the Rose::HTML::Form::Field::Compound
documentation for more information.
Other examples of custom fields:
- Rose::HTML::Form::Field::Email
- A text field that only accepts valid email addresses.
- 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::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.