Breaking Change T1059760
Visible to All Users

TagBox - The DropDown render has changed

What Changed

In previous versions, our TagBox component renders drop-down items in the DOM tree at the position of the component's parent element:

HTML
<body> ... <!-- TagBox render --> <div class="dx-blazor-tagbox"> <!-- DropDown render --> <div class="dx-dropdown-list-container"></div> </div> ... </body>

In v21.2.5, TagBox uses the DevExpress DropDown component for Blazor to show drop-down items. Due to this change, drop-down items are rendered in the document body as follows:

HTML
<body> <div> <!-- new TagBox render --> <dxbl-tagbox> </dxbl-tagbox> </div> ... <!-- DropDown render --> <dxbl-dropdown> </dxbl-dropdown> ... </body>

Reasons for Change

Previously, specific CSS properties applied to the parent element of the TagBox might clip or corrupt the drop-down's content (for instance, if users set the overflow property to hidden or scroll). We changed the component's rendering to avoid such side effects.

Impact on Existing Apps

This change affects applications with editors that use drop-down functionality if you apply a CSS selector that relies on their position in the DOM tree.

How to Update Existing Apps

Update CSS selectors to take into account the new position of drop-down items in the DOM tree. You can also use the DropDownCssClass and DropDownBodyCssClass properties for the corresponding editor in the following way:

Razor
<style> .my-style { background-color: blue; } </style> <DxTagBox DropDownBodyCssClass="my-style" Data="@Cities" @bind-Value="@Value" />

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.