Rose::HTML::Form::Field::PhoneNumber::US::Split.3pm

Langue: en

Version: 2008-02-25 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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');
 
     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;
     ...

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) 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.