sub new {
- bless {}, $_[0];
+ my ($class, $default) = @_;
+ bless {default => $default}, $class;
+}
+
+sub _attr {
+ my $self = shift;
+ my $expect = shift;
+ my $attr = ref $_[-1] eq 'HASH' ? pop : {};
+ push @_, undef for @_+1 .. $expect;
+ push @_, $attr;
+ return @_;
}
sub quote {
# strip empty if it shouldn't be
defined $attr->{$_} and $attr->{$_} eq '' and delete $attr->{$_}
- for qw(id type);
+ for qw(id type class style);
my $return = '<' . $tag;
# add booleans
delete $attr->{$_} and $return .= ' '.$_
- for qw(disabled readonly);
+ for qw(selected checked disabled readonly);
$return .= sprintf ' %s="%s"', $_, $self->quote($attr->{$_})
for sort grep { defined $attr->{$_} } keys %$attr;
sub submit {
- my ($self, $value, $attr) = @_;
-
- if (ref $value eq 'HASH') {
- $attr = $value;
- }
- else {
- $attr ||= {};
- $attr->{value} = $value;
- }
+ my $self = shift;
+ my ($value, $attr) = $self->_attr(1, @_);
+ $attr->{value} = $value if defined $value;
$attr->{type} = 'submit' unless defined $attr->{type};
return $self->tag(input => $attr);
}
sub hidden {
- my ($self, $name, $value) = @_;
-
- #TODO: $attr
-
- return $self->tag(input => {type => 'hidden', name => $name, value => $value});
-}
-
-sub input {
- my ($self, $name, $value, $attr) = @_;
+ my $self = shift;
+ my ($name, $value, $attr) = $self->_attr(2, @_);
if (ref $name eq 'HASH') {
- # only attributes provided (first argument)
- $attr = $name;
- }
- elsif (ref $value eq 'HASH') {
- # name shorthand (attributes in value parameter)
- $attr = $value;
- $attr->{name} = $name;
+ my @return = map { $self->hidden($_, $name->{$_}, $attr) } sort keys %$name;
+ return wantarray ? @return : join(defined $, ? $, : '', @return);
}
- else {
- # name and value shorthands (all vars keep their assigned values)
- $attr ||= {};
- $attr->{name} = $name;
- $attr->{value} = $value;
+
+ if (ref $value eq 'ARRAY') {
+ my @return = map { $self->hidden($name, $_, $attr) } @$value;
+ return wantarray ? @return : join(defined $, ? $, : '', @return);
}
+ $attr->{name } = $name if defined $name;
+ $attr->{value} = $value if defined $value;
+ $attr->{value} = $self->{default}->{$name}
+ if not defined $attr->{value} and defined $name and defined $self->{default};
+ $attr->{type} = 'hidden' unless defined $attr->{type};
+
+ return $self->tag(input => $attr);
+}
+
+sub text {
+ my $self = shift;
+ my ($name, $value, $attr) = $self->_attr(2, @_);
+
+ $attr->{name } = $name if defined $name;
+ $attr->{value} = $value if defined $value;
+ $attr->{value} = $self->{default}->{$name}
+ if not defined $attr->{value} and defined $name and defined $self->{default};
$attr->{id} = $attr->{name} unless defined $attr->{id};
$attr->{type} = 'text' unless defined $attr->{type} or defined $attr->{rows};
$value = delete $attr->{value} if defined $attr->{rows};
}
sub select {
- my ($self, $name, $rows, $value, $attr) = @_;
+ my $self = shift;
+ my ($name, $rows, $default, $attr) = $self->_attr(3, @_);
- if (ref $value eq 'HASH') {
- $attr = $value;
+ $attr->{name} = $name;
+ $attr->{id} = $attr->{name} unless defined $attr->{id};
+ $attr->{type} = 'select' unless defined $attr->{type};
+
+ $default = $attr->{value} unless defined $default;
+ delete $attr->{value}; # never a parent attribute
+ $default = $self->{default}->{$name}
+ if not defined $default and defined $name and defined $self->{default};
+
+ my @options = map { ref $_ ? $_ : {value => $_} } @$rows;
+
+ my @return;
+
+ if ($attr->{type} eq 'select') {
+ delete $attr->{type};
+ if (defined $default) {
+ for (@options) {
+ $_->{selected} = 1 if defined $_->{value} and $_->{value} eq $default;
+ }
+ }
+ @return = (
+ $self->tag(select => $attr),
+ (map { $self->tag(option => $_) } @options),
+ '</select>',
+ );
}
else {
- $attr ||= {};
+ if (defined $attr->{id} and $attr->{id} ne '') {
+ defined $_->{id}
+ or defined $_->{value} and $_->{id} = $attr->{id}.'_'.$_->{value}
+ for @options;
+ }
+ if (defined $attr->{label}) {
+ defined $_->{value} and not defined $_->{label}
+ and $_->{label} = $attr->{label}->{$_->{value}}
+ for @options;
+ delete $attr->{label};
+ }
+ if (defined $default) {
+ for (@options) {
+ $_->{checked} = 1 if defined $_->{value} and $_->{value} eq $default;
+ }
+ }
+ $_ = {%$attr, %$_} for @options;
+ @return = map {
+ my $label = delete $_->{label};
+ defined $label && $label ne ''
+ ? '<label>'.$self->tag(input => $_)." $label</label>"
+ : $self->tag(input => $_)
+ } @options;
}
- $attr->{name} = $name;
- return $self->tag(select => $attr) . join('',
- map { $self->tag(option => (ref $_ ? $_ : {value => $_})) } @$rows
- ) . '</select>';
+ return wantarray ? @return : join(defined $, ? $, : '', @return);
+}
+
+sub radio {
+ my $self = shift;
+ my ($name, $rows, $label, $attr) = $self->_attr(3, @_);
+
+ if (not defined $rows) {
+ if (defined $label) {
+ $rows = ref $label eq 'ARRAY' ? [1 .. $#$label+1] : [1];
+ }
+ else {
+ $rows = [{}];
+ }
+ }
+ elsif (ref $rows ne 'ARRAY') {
+ $rows = [$rows];
+ }
+
+ if (defined $label) {
+ $rows = [ map { ref $_ eq 'HASH' ? {%$_} : {value => $_} } @$rows ];
+ if (ref $label eq 'ARRAY') {
+ $rows->[$_]->{label} = $label->[$_] for 0 .. $#$rows;
+ } else {
+ $_->{label} = $label for @$rows;
+ }
+ }
+
+ $self->select($name, $rows, {%$attr, type => 'radio'});
+}
+
+sub check {
+ my $self = shift;
+ my ($name, $label, $checked, $attr) = $self->_attr(3, @_);
+
+ my $rows = defined $label ? ref $label eq 'ARRAY' ? [@$label] : [$label] : [{}];
+ ref $_ eq 'HASH' or $_ = {label => $_} for @$rows;
+ if (defined $checked) {
+ if (ref $checked eq 'ARRAY') {
+ $rows->[$_]->{checked} = $checked->[$_] for 0 .. $#$rows;
+ push @$rows, map { {checked => $_} } @$checked[@$rows .. $#$checked];
+ }
+ else {
+ $_->{checked} = $checked for @$rows;
+ }
+ }
+ exists $rows->[$_]->{value} or $rows->[$_]->{value} = $_ + 1 for 0 .. $#$rows;
+
+ $self->select($name, $rows, {%$attr, type => 'checkbox'});
}
1;
=head1 NAME
-HTML::Form::Simple
+HTML::Form::Simple - Generate HTML form elements
=head1 SYNOPSIS
my $input = HTML::Form::Simple->new;
say $input->start; # <form>
printf "<label>%s: %s</label>\n", @$_ for (
- [ 'Your Name' => $input->text(username => 'Mr. Default') ],
- [ Colour => $input->select(
+ [ 'Your Name' => $input->text(
+ user => 'Mr. Default'
+ ) ],
+ [ Message => $input->text(
+ msg => 'Textarea default', {rows => 4, style => 'background:red'}
+ ) ],
+ [ Gender => join ' or ', $input->radio(
+ sex => [qw(m f)], [qw(Male Female)]
+ ) ],
+ [ Colour => scalar $input->select(
favcolour => [qw(Blue Green Red)], 'Green'
) ],
+ [ Options => $input->check(
+ spam => 'Receive weekly newsletter'
+ ) ],
);
say $input->stop; # </form>
+=head1 TODO
+
+=over
+
+=item C<default()> method
+
+ $input->hidden(foo => $input->default('foo'));
+ $hash_ref = $input->default;
+ $input->default('foo') = 'new value';
+ undef $input->default; # clear all
+ # XXX: does this equal $input->default=undef;?
+ $input->default = {amend => 'stuff'};
+
+=item documentation
+
+Actual descriptions instead of just a synopsis.
+
+=item C<quote> override
+
+Allow custom value quotation function.
+Makes L<XML::Quote|XML::Quote> dependency optional.
+
+=back
+
+=head1 AUTHOR
+
+Mischa POSLAWSKY <perl@shiar.org>
+
+=head1 LICENSE
+
+This module is free software; you can redistribute it and/or modify it
+under the same L<terms|perlartistic> as Perl itself.
+
git.shiar.nl / perl / html-form-simple.git / blobdiff