X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FReaction%2FUI%2FWidget%2FField%2FContainer.pm;fp=lib%2FReaction%2FUI%2FWidget%2FField%2FContainer.pm;h=e95f1f7bdc550efae24a713e2304c99e51491932;hb=f9b32c83550e273bec97c9be5b63079addd4846b;hp=ba7fa28341ac5ffb5ee5af4fd010f123c66fcd41;hpb=63bb30b44346800078dc638dcc484828d89c2ad4;p=catagits%2FReaction.git

diff --git a/lib/Reaction/UI/Widget/Field/Container.pm b/lib/Reaction/UI/Widget/Field/Container.pm
index ba7fa28..e95f1f7 100644
--- a/lib/Reaction/UI/Widget/Field/Container.pm
+++ b/lib/Reaction/UI/Widget/Field/Container.pm
@@ -30,12 +30,24 @@ __END__;
 
 =head1 NAME
 
-Reaction::UI::Widget::Field::Container
+Reaction::UI::Widget::Field::Container - A field containing multiple values
 
 =head1 DESCRIPTION
 
+This widget implements a field containing multiple value viewports found in
+the current viewport's C<fields> attribute.
+
 =head1 FRAGMENTS
 
+=head2 widget
+
+Sets the C<name> argument to the viewport's C<name> attribute.
+
+=head2 maybe_label
+
+Sets the C<label> argument to the viewport's C<label> attribute value and
+renders the C<label> fragment when the viewport has a label defined.
+
 =head2 field_list
 
 Sequentially renders the C<fields> of the viewport;
@@ -44,6 +56,31 @@ Sequentially renders the C<fields> of the viewport;
 
 Renders the C<field> viewport passed by C<field_list>
 
+=head1 LAYOUT SETS
+
+=head2 base
+
+  share/skin/base/layout/field/container.tt
+
+The following layouts are provided:
+
+=over 4
+
+=item widget
+
+Renders a C<fieldset> element containing the C<maybe_label> and C<field_list>
+fragments.
+
+=item label
+
+Renders a C<legend> element for the C<fieldset> containing the C<label> argument.
+
+=item field
+
+Wraps the next C<field> fragment in a C<span> element.
+
+=back
+
 =head1 AUTHORS
 
 See L<Reaction::Class> for authors.