Class

DropdownPopupSettings

Declaration

public DropdownPopupSettings()

Controls the duration in milliseconds for popup opening and closing animations. Shorter values (100-200ms) provide snappy, responsive interactions suitable for frequent use. Longer values (400-600ms) create smoother, more elegant animations but may feel slower in rapid interactions. Set to 0 to disable animations entirely for maximum performance or accessibility requirements. Default 300ms provides a good balance of smoothness and responsiveness for most applications.

Declaration

[Parameter]
public int AnimationDuration { get; set; }

Property Value

Applies custom CSS classes to the dropdown popup for styling and theming customization. Use to match your application's design system, add custom borders, shadows, or background colors. Example: "custom-dropdown-popup", "elevated-shadow", "branded-border". Classes are applied to the popup container and affect the entire dropdown list appearance.

Declaration

[Parameter]
public string Class { get; set; }

Property Value

Sets the popup height using CSS units to control how many items are visible without scrolling. Examples: "200px", "15rem", "50vh". Default is "200px" which typically shows 6-8 standard items. Increase for datasets where users frequently need to see more options at once. Decrease for compact interfaces or when screen real estate is limited. Essential for enabling scrolling when item count exceeds the visible area.

Declaration

[Parameter]
public virtual string Height { get; set; }

Property Value

Sets the maximum height the popup can grow to, preventing it from overwhelming the viewport or page layout. Ensures scrolling is enabled when content exceeds this limit, maintaining consistent user experience. Examples: "400px", "50vh", "30rem". Use "50vh" to limit popup to half the viewport height for responsive designs. Essential for large datasets to prevent popups from extending beyond visible screen area.

Declaration

[Parameter]
public string MaxHeight { get; set; }

Property Value

Sets the maximum width the popup can grow to, maintaining layout consistency and preventing viewport overflow. Ensures the popup doesn't become excessively wide when items contain long text or when using flexible width settings. Examples: "500px", "80vw", "30rem". Use viewport units for responsive designs that adapt to screen size. Important for maintaining readability and preventing horizontal scrolling in narrow viewports.

Declaration

[Parameter]
public string MaxWidth { get; set; }

Property Value

Sets the minimum height the popup can shrink to, ensuring adequate space for essential content. Prevents the popup from becoming too small when there are few items or when viewport space is constrained. Examples: "100px", "5rem". Use to maintain usability when dealing with dynamic content or responsive layouts. Particularly useful when combining with MaxHeight for flexible popup sizing.

Declaration

[Parameter]
public string MinHeight { get; set; }

Property Value

Sets the minimum width the popup can shrink to, ensuring readability and usability of dropdown content. Prevents the popup from becoming too narrow when the input element is small or when content varies significantly. Examples: "150px", "10rem". Use to maintain proper text readability and touch target sizes. Helpful when the dropdown input is narrow but items need more space to display properly.

Declaration

[Parameter]
public string MinWidth { get; set; }

Property Value

Sets the popup width using CSS units to control how much horizontal space the dropdown list occupies. Examples: "300px", "20rem", "100%", "auto", "min-content". When not specified, the popup automatically matches the width of the dropdown input element. Use specific values for consistent layouts or "auto" to fit content when items vary significantly in length.

Declaration

[Parameter]
public string Width { get; set; }

Property Value

Declaration

public void Dispose()

Implements IDisposable.Dispose()

Declaration

protected override void OnInitialized()

Overrides ComponentBase.OnInitialized()