---
name: "CGI::Test::Form::Group"
section: "3pm"
platform: "linux"
package: "libcgi-test-perl"
version: "1.111-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/CGI::Test::Form::Group"
---

# CGI::Test::Form::Group(3pm)

Records groups of box-type widgets

## NAME

CGI::Test::Form::Group - Records groups of box-type widgets

## SYNOPSIS

```
 # $form is a CGI::Test::Form object
 use CGI::Test;
 my $rgroup = $form->radio_groups;
 ok 1, defined $rgroup;
 my @title = $rgroup->widgets_in("title");
 my ($mister) = grep { $_->value eq "Mr" } @title;
 ok 2, $mister->is_checked;
```

## DESCRIPTION

This class is a container for box-type widgets, i.e. radio buttons and checkboxes, which may be groupped by name.

It can be queried to easily retrieve widgets belonging to a group, or to get all the group names.

It is also used internally by `"CGI::Test"` to keep track of associated radio buttons, so that checking one automatically unchecks the others in the same group.

## INTERFACE

The following features are available:

- "is\_groupname" *name*

  Checks whether *name* is the name of a group.

- "names"

  Returns a list of group names, in random order.

- "widget\_count" *groupname*

  Returns amount of widgets held in *groupname*, 0 if none.

- "widgets\_in" *groupname*

  Returns a list of all the widgets in the given *groupname*.  If the name is not a valid group name, the list will be empty.

## 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**(3), **CGI::Test::Form::Widget::Box**(3).