DxDropDown.RestrictionMode Property

Specifies an element that restricts the DropDown position.

Assembly : DevExpress.Blazor.v25.2.dll

Declaration

csharp

[Parameter]
public DropDownRestrictionMode RestrictionMode { get; set; }

Property Value

Type	Description
DropDownRestrictionMode

A restriction mode.

Available values:

Name	Description
Viewport

The drop-down window position is restricted by the viewport.

| | Page |

The drop-down window position is restricted by the page.

| | Rectangle |

The drop-down window position is restricted by a rectangle’s boundaries (RestrictionRectangle).

| | TargetElement |

The drop-down window position is restricted by a target element’s boundaries (RestrictionTarget).

Remarks

The DropDown changes its position when certain page elements are changed (for instance, when the page is scrolled or resized). Use the RestrictionMode property to restrict the DropDown movement.

Run Demo: DropDown - Automatic Position Adjustment

razor

<OptionsContent>
    <OptionComboBox Label="Close mode:" CssClass="ow-100" Data="@CloseModeSource" @bind-Value="@CloseMode"/>
    <OptionCheckBox Label="Fit to container" @bind-Checked="FitToRestriction"/>
</OptionsContent>
<ChildContentWithParameters Context="Params">
    <div class="@(IsMobile ? "" : "card") flipping-overflow-container">
        <dxbl-demo-scrollable center-horizontally center-vertically id="flipping-target-container" class="flipping-overflow-content">
            <DxButton
                CssClass="flipping-button" Click="() => IsOpen = !IsOpen"
                RenderStyle="@ButtonRenderStyle.Secondary"
                aria-describedby="dropDown-flipping">SHOW A DROPDOWN</DxButton>
        </dxbl-demo-scrollable>
        <DxDropDown
            @bind-IsOpen="@IsOpen"
            Id="dropDown-flipping"
            CloseOnOutsideClick="false"
            PositionMode="DropDownPositionMode.Bottom"
            PositionTarget=".flipping-button"
            RestrictionTarget=".flipping-overflow-container"
            RestrictionMode="DropDownRestrictionMode.TargetElement"
            PreventCloseOnPositionTargetClick="true"
            CloseMode="@CloseMode"
            FitToRestriction="@FitToRestriction"
            FooterVisible="true"
            SizeMode="Params.SizeMode"
            Width="240">
            <BodyContentTemplate>
                <span class="fs-75">@Constants.ContentShort</span>
            </BodyContentTemplate>
            <FooterContentTemplate>
                <DxButton CssClass="popup-button my-1 ms-2" RenderStyle="ButtonRenderStyle.Primary" Text="OK" Click="@context.CloseCallback" />
                @* ... *@
</ChildContentWithParameters>

@code {

    [Inject]
    @* ... *@
            await EnvironmentInfo.InitializeRuntime();