Skip to content

docs(Grid): Improve popup form template information #3250

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 24, 2025
Merged

docs(Grid): Improve popup form template information #3250

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
53a2bc5
docs(Grid): Improve popup form template information
dimodi Sep 23, 2025
1a4149b
Update components/grid/templates/popup-form-template.md
dimodi Sep 23, 2025
aef67f5
Update components/grid/templates/popup-form-template.md
dimodi Sep 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions components/grid/templates/popup-form-template.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,13 @@ With the `FormTemplate` feature, you can customize the appearance and content of

## Specifics

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

* 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.
* 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).
* 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.
* There are [two ways to define custom Form buttons](slug:grid-kb-handle-empty-popup-footer):
* Use the [Form `<FormButtons>` template](slug:form-formitems-buttons).
* 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).
* Using the [Grid `<ButtonsTemplate>`](slug:grid-templates-popup-buttons) is possible and the content will render in the popup footer, which is empty by default.
* The `FormTemplate` disables the [built-in validation](slug:grid-editing-validation) of the Grid. Implement a [Form Validation](slug:form-validation) instead.
* 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).

Expand Down