docs(Window): add kb for programmatic center of the window #2821
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Tsvetomir-Hr
added
the
merge-to-production
|
Hello @Tsvetomir-Hr, Check the below option if you would like to automatically generate PR to production. The automation uses the branch for the cherry-pick, and then will delete the branch. Please, do not delete it manually.
|
dimodi
reviewed
Mar 12, 2025
| >caption Telerik Blazor Window Centered Programmatically | ||
|
|
||
| ````RAZOR | ||
| @if (!IsWindowVisible) |
There was a problem hiding this comment.
The example can be simplified:
- Remove the toggle button
- Make the Window always visible
- Move the Center button inside the Window
dimodi
reviewed
Mar 12, 2025
|
|
||
| To center a Telerik Window programmatically, follow these steps: | ||
|
|
||
| 1. Use [`Top` and `Left` parameters](slug:components/window/position#top-and-left) – These parameters define the Window position on the screen. |
There was a problem hiding this comment.
This step is not actionable, especially if the customer wants the Window to be initially centered. For example, explain:
- That the parameters must use two-way binding.
- What should be their default values.
This may also help you to make the next step simpler, because the reader will already be familiar with the string.Empty value.
dimodi
reviewed
Mar 12, 2025
|
|
||
| 1. Use [`Top` and `Left` parameters](slug:components/window/position#top-and-left) – These parameters define the Window position on the screen. | ||
| 2. Reset `Top` and `Left` parameters to center the Window – Setting them to `string.Empty` allows automatic centering. | ||
| 3. Refresh the Window using component reference – Calling `WindowRef?.Refresh();` re-renders the Window with the new position. |
There was a problem hiding this comment.
dimodi
reviewed
Mar 12, 2025
| 2. Reset `Top` and `Left` parameters to center the Window – Setting them to `string.Empty` allows automatic centering. | ||
| 3. Refresh the Window using component reference – Calling `WindowRef?.Refresh();` re-renders the Window with the new position. | ||
|
|
||
| >caption Telerik Blazor Window Centered Programmatically |
There was a problem hiding this comment.
Make the caption an action "verb", rather than a "noun". For example:
Suggested change
| >caption Telerik Blazor Window Centered Programmatically | |
| >caption Center the Telerik Blazor Window Programmatically |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Related to: https://github.com/telerik/blazor/issues/8956
Once we deprecate the Centered parameter of the Window, will link this KB to Window Position documentation.