File Coverage

blib/lib/HTML/Widget/Plugin/Checkbox.pm

Criterion	Covered	Total	%
statement	22	22	100.0
branch	2	2	100.0
condition			n/a
subroutine	8	8	100.0
pod	2	2	100.0
total	34	34	100.0

use strict;
use warnings;
package HTML::Widget::Plugin::Checkbox;
# ABSTRACT: it's either [ ] or [x]
$HTML::Widget::Plugin::Checkbox::VERSION = '0.202';
use parent 'HTML::Widget::Plugin';

#pod =head1 SYNOPSIS
#pod
#pod   $widget_factory->checkbox({
#pod     id      => 'checkbox-id',    # also used as default for control name
#pod     value   => 'checkbox-value', # -not- the "am I checked?" setting
#pod     checked => $true_or_false,
#pod   });
#pod
#pod =head1 DESCRIPTION
#pod
#pod This plugin provides a widget for boolean checkbox widgets.
#pod
#pod =cut

use HTML::Element;

#pod =head1 METHODS
#pod
#pod =head2 C< provided_widgets >
#pod
#pod This plugin provides the following widgets: checkbox
#pod
#pod =cut

sub provided_widgets { qw(checkbox) }

#pod =head2 C< checkbox >
#pod
#pod This method returns a checkbox widget.
#pod
#pod In addition to the generic L attributes, the following
#pod are valid arguments:
#pod
#pod =over
#pod
#pod =item checked
#pod
#pod This is the widget's initial state.  If true, the checkbox is checked.
#pod Otherwise, it is not.
#pod
#pod =item value
#pod
#pod This is the value for the checkbox, not to be confused with whether or not it
#pod is checked.
#pod
#pod =back
#pod
#pod =cut

sub _attribute_args { qw(checked disabled value) }
sub _boolean_args   { qw(checked disabled) }

sub checkbox {
  my ($self, $factory, $arg) = @_;

  $arg->{attr}{type} = 'checkbox';

  $arg->{attr}{name} = $arg->{attr}{id} if not defined $arg->{attr}{name};

  my $widget = HTML::Element->new('input');

  $widget->attr($_ => $arg->{attr}{$_}) for keys %{ $arg->{attr} };
  return $widget->as_XML;
}

1;

__END__