Rose::HTML::Form::Field::Set.3pm

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

NAME

Rose::HTML::Form::Field::Set - Text area that accepts whitespace- or comma-separated strings.

SYNOPSIS

     $field =
       Rose::HTML::Form::Field::Set->new(
         label   => 'States', 
         name    => 'states',
         default => 'NY NJ NM');
 
     $vals = $field->internal_value;
 
     print $vals->[1]; # "NJ"
 
     $field->input_value('NY, NJ, "New Mexico"');
 
     $vals = $field->internal_value;
 
     print $vals->[3]; # "New Mexico"
 
     $field->input_value([ 'New York', 'New Jersey' ]);
 
     print $field->internal_value->[0]; # "New York"
 
     ...
 
 

DESCRIPTION

Rose::HTML::Form::Field::Set is a subclass of Rose::HTML::Form::Field::TextArea that accepts whitespace- or comma-separated strings. Its internal value is a reference to an array of strings, or undef if the input value could not be parsed.

Strings with spaces, double quotes, backslashes, or commas must be double-quoted. Use a backslash character ``\'' to escape double-quotes within double-quoted strings. Backslashed escapes in double-quoted strings are interpolated according to Perl's rules.

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.