Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Rose::HTML::Form::FielUserhContributed:PerlmDocumed::PhoneNumber::US::Split(3)

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)

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.

perl v5.32.0		    Rose::HTML::Form::Field::PhoneNumber::US::Split(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHOR | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Rose::HTML::Form::Field::PhoneNumber::US::Split&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help