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)

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.