GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Rose::HTML::Form::Field::PhoneNumber::US::Split(3) User Contributed Perl Documentation Rose::HTML::Form::Field::PhoneNumber::US::Split(3)

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.
2015-03-17 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.