NAME

CGI::Test::Form::Widget::Box::Radio - A radio button widget

SYNOPSIS

# Inherits from CGI::Test::Form::Widget::Box
# $form is a CGI::Test::Form

my @title = $form->radios_named("title");
my ($mister) = grep { $_->value eq "Mr" } @title;
$mister->check if defined $mister;

my $title = $form->radio_by_name("title");
$title->check_tagged("Mr");

DESCRIPTION

This class represents a radio button widget, which may be checked at will by users. All other radio buttons of the same group are automatically unchecked.

If no radio button is checked initially, CGI::Test arbitrarily chooses the first one listed and warns you via logwarn.

The interface is the same as the one described in CGI::Test::Form::Widget::Box.

Any attempt to uncheck a radio button will be ignored, and a warning emitted via logcarp, to help you identify the caller.

AUTHORS

The original author is Raphael Manfredi.

Steven Hilton was long time maintainer of this module.

Current maintainer is Alexander Tokarev <tokarev@cpan.org>.

SEE ALSO

CGI::Test::Form::Widget::Box(3), CGI::Test::Form::Widget::Box::Check(3), Log::Agent(3).