Skip to content

Commit dc83094

Browse files
authored
docs(Grid): Improve popup form template information (#3250)
* docs(Grid): Improve popup form template information * Update components/grid/templates/popup-form-template.md * Update components/grid/templates/popup-form-template.md
1 parent 82399db commit dc83094

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

components/grid/templates/popup-form-template.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,13 @@ With the `FormTemplate` feature, you can customize the appearance and content of
2626

2727
## Specifics
2828

29-
When using the template, the default Popup form is replaced by the declared content within the `FormTemplate` tag. This introduces the following specifics:
29+
When using the template, the built-in popup form is replaced by the declared content in the `FormTemplate` tag. This introduces the following specifics:
3030

31-
* The default **Update** and **Cancel** buttons are removed. This means that the [`OnUpdate` and `OnCancel`](slug:grid-editing-overview#events) events do not fire. To modify or cancel the update of a record, you need to include custom components to manage these actions.
32-
* The popup footer remains empty by design. You can [either hide it or place your custom buttons in it](slug:grid-kb-handle-empty-popup-footer).
31+
* The default **Update** and **Cancel** buttons are removed. This means that the [`OnUpdate` and `OnCancel`](slug:grid-editing-overview#events) events do not fire. To modify or cancel the update of a record, you need to include custom components or events to manage these actions.
32+
* There are [two ways to define custom Form buttons](slug:grid-kb-handle-empty-popup-footer):
33+
* Use the [Form `<FormButtons>` template](slug:form-formitems-buttons).
34+
* Use the [Grid `<ButtonsTemplate>`](slug:grid-templates-popup-buttons), which is empty by default when using a `<FormTemplate>`. Remove the duplicate [built-in Form Submit button with an empty `<FormButtons>` template](slug:form-formitems-buttons).
35+
* If you leave the Grid popup footer (`<ButtonsTemplate>`) empty, it takes up space in the popup. You can [remove this empty popup footer space with CSS](slug:grid-kb-handle-empty-popup-footer).
3336
* The `FormTemplate` disables the [built-in validation](slug:grid-editing-validation) of the Grid. Implement a [Form Validation](slug:form-validation) instead.
3437
* The [`<GridPopupEditFormSettings>` parameters](slug:grid-editing-popup#form-layout) do not apply to a custom `TelerikForm` that you may render inside the `<FormTemplate>` tag. Set the desired Form configurations such as `Columns`, `Orientation`, and more on the [Form component](slug:form-overview#form-parameters).
3538

0 commit comments

Comments
 (0)