1 package HTML::Form::Simple;
18 my $attr = ref $_[-1] eq 'HASH' ? pop : {};
19 push @_, undef for @_+1 .. $expect;
26 return XML::Quote::xml_quote_min($_[0]);
30 my ($self, $tag, $attr) = @_;
32 # strip empty if it shouldn't be
33 defined $attr->{$_} and $attr->{$_} eq '' and delete $attr->{$_}
34 for qw(id type class style);
36 my $return = '<' . $tag;
39 delete $attr->{$_} and $return .= ' '.$_
40 for qw(selected checked disabled readonly);
42 $return .= sprintf ' %s="%s"', $_, $self->quote($attr->{$_})
43 for sort grep { defined $attr->{$_} } keys %$attr;
50 my ($self, $attr) = @_;
52 return $self->tag(form => $attr);
62 my ($value, $attr) = $self->_attr(1, @_);
64 $attr->{value} = $value if defined $value;
65 $attr->{type} = 'submit' unless defined $attr->{type};
67 return $self->tag(input => $attr);
72 my ($name, $value, $attr) = $self->_attr(2, @_);
74 if (ref $name eq 'HASH') {
75 my @return = map { $self->hidden($_, $name->{$_}, $attr) } sort keys %$name;
76 return wantarray ? @return : join(defined $, ? $, : '', @return);
79 if (ref $value eq 'ARRAY') {
80 my @return = map { $self->hidden($name, $_, $attr) } @$value;
81 return wantarray ? @return : join(defined $, ? $, : '', @return);
84 $attr->{name } = $name if defined $name;
85 $attr->{value} = $value if defined $value;
86 $attr->{type} = 'hidden' unless defined $attr->{type};
88 return $self->tag(input => $attr);
93 my ($name, $value, $attr) = $self->_attr(2, @_);
95 $attr->{name } = $name if defined $name;
96 $attr->{value} = $value if defined $value;
97 $attr->{id} = $attr->{name} unless defined $attr->{id};
98 $attr->{type} = 'text' unless defined $attr->{type} or defined $attr->{rows};
99 $value = delete $attr->{value} if defined $attr->{rows};
101 return defined $attr->{rows} ? sprintf(
103 $self->tag(textarea => $attr),
104 $self->quote(defined $value ? $value : '')
105 ) : $self->tag(input => $attr);
110 my ($name, $rows, $default, $attr) = $self->_attr(3, @_);
112 $default = $attr->{value} unless defined $default;
113 delete $attr->{value}; # never a parent attribute
115 $attr->{name} = $name;
116 $attr->{id} = $attr->{name} unless defined $attr->{id};
117 $attr->{type} = 'select' unless defined $attr->{type};
119 my @options = map { ref $_ ? $_ : {value => $_} } @$rows;
123 if ($attr->{type} eq 'select') {
124 delete $attr->{type};
125 if (defined $default) {
127 $_->{selected} = 1 if defined $_->{value} and $_->{value} eq $default;
131 $self->tag(select => $attr),
132 (map { $self->tag(option => $_) } @options),
137 if (defined $attr->{id} and $attr->{id} ne '') {
139 or defined $_->{value} and $_->{id} = $attr->{id}.'_'.$_->{value}
142 if (defined $attr->{label}) {
143 defined $_->{value} and not defined $_->{label}
144 and $_->{label} = $attr->{label}->{$_->{value}}
146 delete $attr->{label};
148 if (defined $default) {
150 $_->{checked} = 1 if defined $_->{value} and $_->{value} eq $default;
153 $_ = {%$attr, %$_} for @options;
155 my $label = delete $_->{label};
156 defined $label && $label ne ''
157 ? '<label>'.$self->tag(input => $_)." $label</label>"
158 : $self->tag(input => $_)
162 return wantarray ? @return : join(defined $, ? $, : '', @return);
167 my ($name, $label, $rows, $attr) = $self->_attr(3, @_);
169 if (not defined $rows) {
170 if (defined $label) {
171 $rows = ref $label eq 'ARRAY' ? [1 .. $#$label+1] : [1];
177 elsif (ref $rows ne 'ARRAY') {
181 if (defined $label) {
182 $rows = [ map { ref $_ eq 'HASH' ? {%$_} : {value => $_} } @$rows ];
183 if (ref $label eq 'ARRAY') {
184 $rows->[$_]->{label} = $label->[$_] for 0 .. $#$rows;
186 $_->{label} = $label for @$rows;
190 $self->select($name, $rows, {%$attr, type => 'radio'});
195 my ($name, $label, $checked, $attr) = $self->_attr(3, @_);
197 my $rows = defined $label ? ref $label eq 'ARRAY' ? [@$label] : [$label] : [{}];
198 ref $_ eq 'HASH' or $_ = {label => $_} for @$rows;
199 if (defined $checked) {
200 if (ref $checked eq 'ARRAY') {
201 $rows->[$_]->{checked} = $checked->[$_] for 0 .. $#$rows;
202 push @$rows, map { {checked => $_} } @$checked[@$rows .. $#$checked];
205 $_->{checked} = $checked for @$rows;
208 exists $rows->[$_]->{value} or $rows->[$_]->{value} = $_ + 1 for 0 .. $#$rows;
210 $self->select($name, $rows, {%$attr, type => 'checkbox'});
217 HTML::Form::Simple - Generate HTML form elements
221 my $input = HTML::Form::Simple->new;
222 say $input->start; # <form>
223 printf "<label>%s: %s</label>\n", @$_ for (
224 [ 'Your Name' => $input->text(
225 user => 'Mr. Default'
227 [ Message => $input->text(
228 msg => 'Textarea default', {rows => 4, style => 'background:red'}
230 [ Gender => join ' or ', $input->radio(
233 [ Colour => scalar $input->select(
234 favcolour => [qw(Blue Green Red)], 'Green'
236 [ Options => $input->check(
237 spam => 'Receive weekly newsletter'
240 say $input->stop; # </form>
244 Mischa POSLAWSKY <perl@shiar.org>
248 This module is free software; you can redistribute it and/or modify it
249 under the same L<terms|perlartistic> as Perl itself.