Advanced Master-Detail View
This demo illustrates an advanced master-detail view in the DataGrid component. Master rows represent suppliers. Detail sections contain TabPanel components with two tabs: Orders and Address. In the Orders tab, you can choose a supplier's product from the SelectBox, and the DataGrid under it will show orders placed on this product. The Address tab displays the supplier's address.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<template>
<DxDataGrid
id="gridContainer"
:data-source="suppliersData"
:remote-operations="true"
:show-borders="true"
>
<DxPaging :page-size="15"/>
<DxColumn data-field="ContactName"/>
<DxColumn data-field="ContactTitle"/>
<DxColumn data-field="CompanyName"/>
<DxColumn data-field="City"/>
<DxColumn data-field="Country"/>
<DxMasterDetail
:enabled="true"
template="master-detail"
/>
<template #master-detail="{ data }">
<MasterDetail :master-detail-data="data"/>
</template>
</DxDataGrid>
</template>
<script>
import {
DxDataGrid,
DxColumn,
DxPaging,
DxMasterDetail,
} from 'devextreme-vue/data-grid';
import { createStore } from 'devextreme-aspnet-data-nojquery';
import MasterDetail from './MasterDetail.vue';
const url = 'https://js.devexpress.com/Demos/Mvc/api/DataGridAdvancedMasterDetailView';
export default {
components: {
DxDataGrid,
DxColumn,
DxPaging,
DxMasterDetail,
MasterDetail,
},
data() {
return {
suppliersData: createStore({
key: 'SupplierID',
loadUrl: `${url}/GetSuppliers`,
}),
};
},
};
</script>
<template>
<DxForm
:form-data="data"
:items="items"
:col-count="2"
:customize-item="customizeItem"
class="address-form form-container"
>
<template #form-item="{ data: item }">
<span>
{{ item.editorOptions.value }}
</span>
</template>
</DxForm>
</template>
<script>
import { DxForm } from 'devextreme-vue/form';
export default {
components: { DxForm },
props: {
data: {
type: Object,
default: () => ({}),
},
},
data() {
return {
items: ['Address', 'City', 'Region', 'PostalCode', 'Country', 'Phone'],
};
},
methods: {
customizeItem(item) {
item.template = 'form-item';
},
},
};
</script>
<template>
<DxTabPanel>
<DxItem
title="Orders"
template="orders-tab"
/>
<template #orders-tab>
<OrdersTab
:supplier-id="masterDetailData.key"
/>
</template>
<DxItem
title="Address"
template="address-tab"
/>
<template #address-tab>
<AddressTab
:data="masterDetailData.data"
/>
</template>
</DxTabPanel>
</template>
<script>
import { DxTabPanel, DxItem } from 'devextreme-vue/tab-panel';
import OrdersTab from './OrdersTab.vue';
import AddressTab from './AddressTab.vue';
export default {
components: {
DxTabPanel, DxItem, OrdersTab, AddressTab,
},
props: {
masterDetailData: {
type: Object,
default: () => ({}),
},
},
};
</script>
<template>
<div>
<DxDataGrid
:data-source="orderHistoryStore"
:show-borders="true"
>
<DxPaging :page-size="5"/>
<DxColumn data-field="OrderID"/>
<DxColumn
data-field="OrderDate"
data-type="date"
/>
<DxColumn data-field="ShipCountry"/>
<DxColumn data-field="ShipCity"/>
<DxColumn
data-field="UnitPrice"
format="currency"
/>
<DxColumn data-field="Quantity"/>
<DxColumn
data-field="Discount"
format="percent"
/>
<DxSummary>
<DxTotalItem
column="UnitPrice"
summary-type="sum"
>
<DxValueFormat
:precision="2"
format="currency"
/>
</DxTotalItem>
<DxTotalItem
column="Quantity"
summary-type="count"
/>
</DxSummary>
</DxDataGrid>
</div>
</template>
<script>
import {
DxDataGrid,
DxColumn,
DxPaging,
DxSummary,
DxTotalItem,
DxValueFormat,
} from 'devextreme-vue/data-grid';
import { createStore } from 'devextreme-aspnet-data-nojquery';
const url = 'https://js.devexpress.com/Demos/Mvc/api/DataGridAdvancedMasterDetailView';
export default {
components: {
DxDataGrid,
DxColumn,
DxPaging,
DxSummary,
DxTotalItem,
DxValueFormat,
},
props: {
productId: {
type: Number,
default: null,
},
},
computed: {
orderHistoryStore() {
return this.productId === null ? null : {
store: createStore({
key: 'OrderID',
loadParams: { ProductID: this.productId },
loadUrl: `${url}/GetOrdersByProduct`,
}),
};
},
},
};
</script>
<template>
<DxForm
label-location="top"
class="form-container"
>
<DxItem template="select-box">
<DxLabel text="Product"/>
</DxItem>
<template #select-box>
<ProductSelectBox
:supplier-id="supplierId"
@product-changed="chosenProductId = $event"
/>
</template>
<DxItem template="order-history">
<DxLabel text="Order History"/>
</DxItem>
<template #order-history="{ data }">
<OrderHistory
:product-id="chosenProductId"
/>
</template>
</DxForm>
</template>
<script>
import { DxForm, DxItem, DxLabel } from 'devextreme-vue/form';
import ProductSelectBox from './ProductSelectBox.vue';
import OrderHistory from './OrderHistory.vue';
export default {
components: {
DxForm, DxItem, DxLabel, ProductSelectBox, OrderHistory,
},
props: {
supplierId: {
type: Number,
default: null,
},
},
data() {
return {
chosenProductId: null,
};
},
};
</script>
<template>
<DxSelectBox
:defer-rendering="false"
:data-source="dataSource"
:value="value"
value-expr="ProductID"
display-expr="ProductName"
@valueChanged="$emit('product-changed', $event.value)"
/>
</template>
<script>
import DxSelectBox from 'devextreme-vue/select-box';
import { createStore } from 'devextreme-aspnet-data-nojquery';
const url = 'https://js.devexpress.com/Demos/Mvc/api/DataGridAdvancedMasterDetailView';
export default {
components: { DxSelectBox },
props: {
supplierId: {
type: Number,
default: null,
},
},
data() {
return {
dataSource: createStore({
key: 'ProductID',
loadParams: { SupplierID: this.supplierId },
loadUrl: `${url}/GetProductsBySupplier`,
onLoaded: this.setDefaultValue,
}),
value: null,
};
},
methods: {
setDefaultValue(items) {
const firstItem = items[0];
if (firstItem && this.value === null) {
this.value = firstItem.ProductID;
}
},
},
};
</script>
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
<!DOCTYPE html>
<html>
<head>
<title>DevExtreme Demo</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/22.2.6/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script type="text/javascript" src="config.js"></script>
<script type="text/javascript">
System.import("./index.js");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app" />
</div>
</body>
</html>
#gridContainer {
height: 620px;
}
.dx-datagrid-rowsview .dx-master-detail-row:not(.dx-datagrid-edit-form) > .dx-datagrid-group-space,
.dx-datagrid-rowsview .dx-master-detail-row:not(.dx-datagrid-edit-form) .dx-master-detail-cell {
background-color: transparent;
}
.form-container {
padding: 20px;
}
.address-form label {
font-weight: bold;
}
window.config = {
transpiler: 'plugin-babel',
meta: {
'*.vue': {
loader: 'vue-loader',
},
'devextreme/localization.js': {
'esModule': true,
},
'devextreme-aspnet-data-nojquery': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'vue': 'npm:vue@3.2.47/dist/vue.esm-browser.js',
'vue-loader': 'npm:dx-systemjs-vue-browser@1.0.15/index.js',
'devextreme-aspnet-data-nojquery': 'npm:devextreme-aspnet-data-nojquery@2.9.0/index.js',
'mitt': 'npm:mitt/dist/mitt.umd.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@22.2.6/cjs',
'devextreme-vue': 'npm:devextreme-vue@22.2.6',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.5.20/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.72/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.43/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js',
'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'devextreme-vue': {
main: 'index.js',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.11/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
},
};
System.config(window.config);