TelerikWindow
A movable/resizable window for modal or non-modal content with title, actions, and optional animation. Configure content via WindowTitle, WindowContent, WindowFooter and actions in WindowActions; control size/position (Width, Height, Top, Left), state (State/StateChanged), visibility (Visible/VisibleChanged), behavior (Draggable, Resizable, Modal, CloseOnOverlayClick), and animation (AnimationType/AnimationDuration). Programmatic API: , , , , . Children: WindowTitle, WindowContent, WindowFooter, WindowActions.
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Syntax:
public class TelerikWindow : BaseComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable
Inheritance: objectComponentBaseBaseComponentTelerikWindow
Implements:
Inherited Members
Constructors
public TelerikWindow()
Methods
protected override void BuildRenderTree(RenderTreeBuilder __builder)
Overrides:
protected override void OnInitialized()
Overrides:
protected override void OnParametersSet()
Overrides:
Refresh Method to manually re-render the Window. Useful when the component is disposed.
public void Refresh()
public override Task SetParametersAsync(ParameterView parameters)
Overrides:
Properties
Sets the animation duration in milliseconds for show/hide effects. Shorter values (100-200ms) provide snappy animations, while longer values (500ms+) create smoother transitions. The default value is 300.
[Parameter]
public int AnimationDuration { get; set; }
Allows the modal Window to be closed when users click on the backdrop overlay. Only applies to modal windows where Modal is true. Provides an alternative way to close the window besides using action buttons.
[Parameter]
public bool CloseOnOverlayClick { get; set; }
Specifies a CSS selector for the element that will constrain the Window's movement. The window cannot be dragged outside the boundaries of the specified element. Cannot be used with Modal windows.
[Parameter]
public string ContainmentSelector { get; set; }
Enables users to drag the Window by its titlebar to reposition it.
Drag operation is constrained by ContainmentSelector if specified. The default value is true.
[Parameter]
public bool Draggable { get; set; }
Enables WebMCP tool registration for this Window.
When true, Window operations are exposed as tools discoverable by AI models through the browser.
[Parameter]
public bool EnableWebMcpTools { get; set; }
Defines the height of the Window as a CSS value. Supports units like px, %, em, rem, or viewport units (e.g., "300px", "40vh", "15em"). If not specified, the window uses content-based sizing.
[Parameter]
public string Height { get; set; }
Fires when the height parameter has changed.
[Parameter]
public EventCallback<string> HeightChanged { get; set; }
Defines the left position of the Window relative to the viewport (where the TelerikRootComponent is declared). See Dimensions.
[Parameter]
public string Left { get; set; }
Fires when the left parameter has changed.
[Parameter]
public EventCallback<string> LeftChanged { get; set; }
Sets the maximum height constraint for the Window as a CSS value. Prevents the window from being resized larger than this value (e.g., "600px", "80vh"). Useful for maintaining responsive layouts.
[Parameter]
public string MaxHeight { get; set; }
Sets the maximum width constraint for the Window as a CSS value. Prevents the window from being resized larger than this value (e.g., "800px", "90vw"). Useful for maintaining responsive layouts.
[Parameter]
public string MaxWidth { get; set; }
Sets the minimum height constraint for the Window as a CSS value. Prevents the window from being resized smaller than this value (e.g., "150px", "10em"). When Resizable is true, defaults to "100px".
[Parameter]
public string MinHeight { get; set; }
Sets the minimum width constraint for the Window as a CSS value. Prevents the window from being resized smaller than this value (e.g., "200px", "15em"). When Resizable is true, defaults to "120px".
[Parameter]
public string MinWidth { get; set; }
Determines whether the Window displays as a modal dialog that blocks interaction with the rest of the page.
When true, shows a backdrop overlay and traps focus within the window. Cannot be used with ContainmentSelector. The default value is false.
[Parameter]
public bool Modal { get; set; }
Maintains the Window content in the DOM when minimized, preserving component state and user input. When false, content is removed from DOM during minimization, which may improve performance but loses state.
[Parameter]
public bool PersistContent { get; set; }
Specifies the Size of the Window. See Medium.
[Parameter]
public string Size { get; set; }
Fires when the State Parameter has changed.
[Parameter]
public EventCallback<WindowState> StateChanged { get; set; }
Defines the top position of the Window relative to the viewport (where the TelerikRootComponent is declared). See Dimensions.
[Parameter]
public string Top { get; set; }
Fires when the top parameter has changed.
[Parameter]
public EventCallback<string> TopChanged { get; set; }
Controls whether the Window is visible and rendered in the DOM.
Set to true to show the window or false to hide it. Can be used for initial visibility and runtime toggling. The default value is false.
[Parameter]
public bool Visible { get; set; }
Fires when the Visible Parameter has changed.
[Parameter]
public EventCallback<bool> VisibleChanged { get; set; }
Defines the width of the Window as a CSS value. Supports units like px, %, em, rem, or viewport units (e.g., "400px", "50%", "20em"). If not specified, the window uses content-based sizing.
[Parameter]
public string Width { get; set; }
Fires when the width parameter has changed.
[Parameter]
public EventCallback<string> WidthChanged { get; set; }
Defines the container tag for the Wizard buttons. This setting lets you define the predefined actions of the Window or create your custom actions. See https://docs.telerik.com/blazor-ui/components/window/actions. Children: WindowAction tags.
[Parameter]
public RenderFragment WindowActions { get; set; }
Defines the content of the Window.
[Parameter]
public RenderFragment WindowContent { get; set; }
Defines the footer content of the Window.
[Parameter]
public RenderFragment WindowFooter { get; set; }
Configures settings for the Window, including WebMCP tool options. Children: WindowWebMcpSettings.
[Parameter]
public RenderFragment WindowSettings { get; set; }
Defines the title template of the Window.
[Parameter]
public RenderFragment WindowTitle { get; set; }