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.

AUTHOR

Raphael Manfredi <Raphael_Manfredi@pobox.com>

SEE ALSO

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