DropDownBox: add Search in Embedded Components topic#8854
Merged
vladaskorohodova merged 13 commits intoJun 19, 2026
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new “Search in Embedded Components” documentation section for DropDownBox, describing how to implement search when embedding DataGrid (flat data) or TreeList (lookup display-value search). It also modernizes parts of the existing “Synchronize with the Embedded Element” topic code samples.
Changes:
- Added an overview article explaining shared configuration and the differences between DataGrid (
searchValue/searchExpr) and TreeList (lookup-drivenfilter) search approaches. - Added two new how-to topics: one for embedded DataGrid search and one for embedded TreeList search (lookup scenario).
- Updated the existing synchronization topic’s wording and refreshed Angular/Vue/React code samples.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 7 comments.
| File | Description |
|---|---|
| concepts/05 UI Components/DropDownBox/20 Search in Embedded Components/00 Search in Embedded Components.md | New overview article comparing search approaches and shared configuration. |
| concepts/05 UI Components/DropDownBox/20 Search in Embedded Components/05 DataGrid.md | New DataGrid-focused how-to with multi-framework code snippets. |
| concepts/05 UI Components/DropDownBox/20 Search in Embedded Components/10 TreeList.md | New TreeList-focused how-to for lookup display-value search. |
| concepts/05 UI Components/DropDownBox/15 Synchronize with the Embedded Element.md | Refined introductory text + updated framework code samples. |
vladaskorohodova
changed the title
16adianay
approved these changes
Jun 11, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Abadzhev
reviewed
Jun 12, 2026
Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
albertov05
reviewed
Jun 17, 2026
albertov05
reviewed
Jun 17, 2026
albertov05
reviewed
Jun 17, 2026
Co-authored-by: Albert Totten <49917542+albertov05@users.noreply.github.com>
Comment on lines
+444
to
+465
| function applySearchFilter(text, lookupField, dataField, searchExprVal, lookupDataSource, dataSource) { | ||
| // Step 1: find employees whose Name contains the typed text | ||
| lookupDataSource.load({ filter: [lookupField, 'contains', text] }).done((items) => { | ||
| const filterParts = []; | ||
|
|
||
| // Step 2: optionally also search in a non-lookup field (for example, Task_Subject) | ||
| if (Array.isArray(searchExprVal)) { | ||
| filterParts.push([searchExprVal[1], 'contains', text]); | ||
| } | ||
|
|
||
| // Step 3: add an OR condition for each matched employee ID | ||
| items.forEach((item, index) => { | ||
| if (filterParts.length > 0 || index > 0) filterParts.push('or'); | ||
| filterParts.push([dataField, '=', item.ID]); | ||
| }); | ||
|
|
||
| // Step 4: apply the filter (use a "no-results" sentinel if nothing matched) | ||
| const filterExpr = filterParts.length > 0 ? filterParts : [dataField, '=', -1]; | ||
| dataSource.filter(filterExpr); | ||
| dataSource.load(); | ||
| }); | ||
| } |
|
|
||
| See this example for more details: [DropDownBox with embedded TreeList](https://github.com/DevExpress-Examples/devextreme-dropdownbox-implement-search-for-treelist). | ||
|
|
||
| #####See Also##### |
|
|
||
| [note] This implementation supports single selection only. To implement multiple selection, use the [TagBox](/api-reference/10%20UI%20Components/dxTagBox '/Documentation/ApiReference/UI_Components/dxTagBox/') component instead. | ||
|
|
||
| #####See Also##### |
| - [DropDownBox with embedded DataGrid](https://github.com/DevExpress-Examples/devextreme-dropdownbox-filter-data-in-nested-widget) (search by regular field) | ||
| - [DropDownBox with embedded TreeList](https://github.com/DevExpress-Examples/devextreme-dropdownbox-implement-search-for-treelist) (search by lookup column display value) | ||
|
|
||
| #####See Also##### |
Comment on lines
+58
to
+68
| import { Component } from "@angular/core"; | ||
| import { DxDropDownBoxComponent } from "devextreme-angular/ui/drop-down-box"; | ||
| import { DxDataGridComponent } from "devextreme-angular/ui/data-grid"; | ||
| import ArrayStore from "devextreme/data/array_store"; | ||
| // ... | ||
|
|
||
| @Component({ | ||
| selector: "app-root", | ||
| templateUrl: "./app.component.html", | ||
| standalone: true, | ||
| imports: [DxDropDownBoxComponent, DxDataGridComponent] | ||
| }) |
Comment on lines
+211
to
+220
| import { Component } from "@angular/core"; | ||
| import { DxDropDownBoxComponent } from "devextreme-angular/ui/drop-down-box"; | ||
| import { DxDataGridComponent, DxoDataGridSelectionComponent } from "devextreme-angular/ui/data-grid"; | ||
|
|
||
| @Component({ | ||
| selector: "app-root", | ||
| templateUrl: "./app.component.html", | ||
| standalone: true, | ||
| imports: [DxDropDownBoxComponent, DxDataGridComponent, DxoDataGridSelectionComponent] | ||
| }) |
Comment on lines
+103
to
+107
| const dropDownBoxData = [/* ... */]; | ||
| const gridDataSource = new ArrayStore({ | ||
| data: widgetData, | ||
| key: 'ID', | ||
| }); |
Comment on lines
+120
to
124
| const dropDownBoxData = [/* ... */]; | ||
| const gridDataSource = new ArrayStore({ | ||
| data: widgetData, | ||
| key: "ID" | ||
| key: 'ID', | ||
| }); |
Comment on lines
+99
to
+100
| import DxDropDownBox from 'devextreme-vue/drop-down-box'; | ||
| import { DxDataGrid } from 'devextreme-vue/data-grid'; |
Comment on lines
+249
to
+250
| import DxDropDownBox from 'devextreme-vue/drop-down-box'; | ||
| import { DxDataGrid, DxSelection } from 'devextreme-vue/data-grid'; |
vladaskorohodova
added a commit
that referenced
this pull request
Jun 19, 2026
This file contains hidden or 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
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.
No description provided.