NAME
Rose::HTML::Form::Field::PhoneNumber::US::Split - Compound field for US phone numbers with separate fields for area code, exchange, and number.
SYNOPSIS
$field
=
Rose::HTML::Form::Field::PhoneNumber::US::Split->new(
label
=>
'Phone'
,
name
=>
'phone'
,
default
=>
'123-321-1234'
);
$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'
);
$field
->field(
'exchange'
)->internal_value;
# "456"
$field
->internal_value;
# "555-456-7890"
$field
->html;
...
DESCRIPTION
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.
SEE ALSO
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.
AUTHOR
John C. Siracusa (siracusa@gmail.com)
LICENSE
Copyright (c) 2008 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.