From fe83669f4211e3e19d2517c0151dd30332f0ed4b Mon Sep 17 00:00:00 2001 From: Marc Jauvin Date: Fri, 20 Feb 2026 11:44:36 -0500 Subject: [PATCH 1/4] Document fieldset formwidget --- backend/forms.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/backend/forms.md b/backend/forms.md index adc4ab63..32ec7622 100644 --- a/backend/forms.md +++ b/backend/forms.md @@ -791,6 +791,7 @@ There are various form widgets included as standard, although it is common for p - [Color picker](#color-picker) - [Data table](#data-table) - [Date picker](#date-picker) +- [Fieldset](#fieldset) - [File upload](#file-upload) - [Icon picker](#icon-picker) - [Markdown editor](#markdown-editor) @@ -1003,6 +1004,36 @@ Option | Description `showWeekNumber` | show week numbers at head of row. Default: `false` `ignoreTimezone` | store date and time exactly as it is displayed, ignoring the backend specified timezone preference. +### Fieldset + +`fieldset` - renders a group of fields in a
tag. + +> **NOTE:** Contrary to nested forms, the fields defined in a fieldset are part of the main form. They are only grouped visually within the
tag. + +```yaml +groupedFields: + type: fieldset + label: Grouped Fields + form: + fields: + name: + label: Your name + address: + label: Your address + phone: + label: Your phone + type: tel + website: + label: Your website URL + type: url +``` + +A fieldset provides a way of ***visually*** grouping fields. The form definition does not support tabs or secondary tabs as it is only used to define the fields for grouping purpose. + +Option | Description +------------- | ------------- +`form` | contains the [form definition](#defining-form-fields) used to define the grouped fields. + ### File upload `fileupload` - renders a file uploader for images or regular files. From 227f5940fd95da8b1c18b619e1b4775a05ead177 Mon Sep 17 00:00:00 2001 From: Luke Towers Date: Fri, 20 Feb 2026 08:50:44 -0800 Subject: [PATCH 2/4] Apply suggestion from @LukeTowers --- backend/forms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/backend/forms.md b/backend/forms.md index 32ec7622..4ebefed6 100644 --- a/backend/forms.md +++ b/backend/forms.md @@ -1008,7 +1008,7 @@ Option | Description `fieldset` - renders a group of fields in a
tag. -> **NOTE:** Contrary to nested forms, the fields defined in a fieldset are part of the main form. They are only grouped visually within the
tag. +> **NOTE:** Contrary to the [nestedform](#nested-form), the fields defined in a fieldset are part of the main form. They are only grouped visually within the `
` tag. ```yaml groupedFields: From b91af19d6f1644aa31862812e280c6aee938e985 Mon Sep 17 00:00:00 2001 From: Luke Towers Date: Fri, 20 Feb 2026 08:51:24 -0800 Subject: [PATCH 3/4] Apply suggestion from @LukeTowers --- backend/forms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/backend/forms.md b/backend/forms.md index 4ebefed6..c7a852c1 100644 --- a/backend/forms.md +++ b/backend/forms.md @@ -1006,7 +1006,7 @@ Option | Description ### Fieldset -`fieldset` - renders a group of fields in a
tag. +`fieldset` - renders a group of fields in a `
` tag. > **NOTE:** Contrary to the [nestedform](#nested-form), the fields defined in a fieldset are part of the main form. They are only grouped visually within the `
` tag. From 018812d5d36012aa22513f61a7eb209d0daaa4f1 Mon Sep 17 00:00:00 2001 From: Marc Jauvin Date: Fri, 20 Feb 2026 12:08:11 -0500 Subject: [PATCH 4/4] add precisions for both fieldset/nestedform POST data behavior --- backend/forms.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/backend/forms.md b/backend/forms.md index c7a852c1..47b1cdb4 100644 --- a/backend/forms.md +++ b/backend/forms.md @@ -1008,7 +1008,7 @@ Option | Description `fieldset` - renders a group of fields in a `
` tag. -> **NOTE:** Contrary to the [nestedform](#nested-form), the fields defined in a fieldset are part of the main form. They are only grouped visually within the `
` tag. +> **NOTE:** Contrary to the [nestedform](#nested-form), the fields defined in a fieldset are part of the parent form. They are only grouped visually within the `
` tag, but will get submitted within the same array as the parent form in the POST data. ```yaml groupedFields: @@ -1028,7 +1028,7 @@ groupedFields: type: url ``` -A fieldset provides a way of ***visually*** grouping fields. The form definition does not support tabs or secondary tabs as it is only used to define the fields for grouping purpose. +A fieldset provides a way of ***visually*** grouping fields. The form definition does not support tabs or secondary tabs as it is only used to define the fields for grouping purposes. Option | Description ------------- | ------------- @@ -1156,6 +1156,7 @@ Option | Description `nestedform` - renders a nested form as the contents of this field and returns the form data as an array. > **NOTE:** In order to use this with a model, the field should be defined as a `jsonable` attribute, or as another attribute that can handle storing arrayed data. +> **NOTE:** The fields defined in a nestedform are separate from the main(parent) form. They will get submitted within a nested array named after the nestedform field's name in the POST data. ```yaml content: