X-Git-Url: http://git.shiar.net/perl/html-form-simple.git/blobdiff_plain/61dd576040bbb86eb8925c1c80a830bfa998eb41..08784cd0bf249108184d0fa6860623e81c4ab5ac:/lib/HTML/Form/Simple.pm

diff --git a/lib/HTML/Form/Simple.pm b/lib/HTML/Form/Simple.pm
index 2b30d79..58e8753 100644
--- a/lib/HTML/Form/Simple.pm
+++ b/lib/HTML/Form/Simple.pm
@@ -171,7 +171,7 @@ sub select {
 
 sub radio {
 	my $self = shift;
-	my ($name, $label, $rows, $attr) = $self->_attr(3, @_);
+	my ($name, $rows, $label, $attr) = $self->_attr(3, @_);
 
 	if (not defined $rows) {
 		if (defined $label) {
@@ -219,6 +219,8 @@ sub check {
 
 1;
 
+__END__
+
 =head1 NAME
 
 HTML::Form::Simple - Generate HTML form elements
@@ -235,7 +237,7 @@ HTML::Form::Simple - Generate HTML form elements
 			msg => 'Textarea default', {rows => 4, style => 'background:red'}
 		) ],
 		[ Gender => join ' or ', $input->radio(
-			sex => ['m', 'f']
+			sex => [qw(m f)], [qw(Male Female)]
 		) ],
 		[ Colour => scalar $input->select(
 			favcolour => [qw(Blue Green Red)], 'Green'
@@ -246,6 +248,75 @@ HTML::Form::Simple - Generate HTML form elements
 	);
 	say $input->stop; # </form>
 
+=head1 DESCRIPTION
+
+=over
+
+=item C<hidden>
+
+	$input->hidden(name => 'value');
+
+=item C<text>
+
+	$input->text(name => 'default');
+
+=item C<select>
+
+	$input->select(name => ['option'], 'default');
+
+=item C<radio>
+
+	$input->radio(name => ['option'], ['option label'], 'default');
+
+eq
+
+	$input->radio(
+		'name',
+		[ {label => 'option label', value => 'option'} ],
+		{value => 'default'}
+	);
+
+=item C<check>
+
+	$input->check(name => ['label', 'second option'], [0, 1]);
+
+eq
+
+	$input->check(name => [
+		{label => 'label',         value => 1, checked => 0},
+		{label => 'second option', value => 2, checked => 1},
+	]);
+
+=back
+
+=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.
+
+=item single checkbox id
+
+Do not add value to single check() by default.
+
+=back
+
 =head1 AUTHOR
 
 Mischa POSLAWSKY <perl@shiar.org>