DataMaps (React)

In many situations, you may want columns to map values so cells display a value that is different from what is actually stored in the grid. You can accomplish this with the formatItem event, but the FlexGrid provides a better alternative: DataMaps.

If you set a column's dataMap property to an instance of a DataMap, the grid will use it to look up display values for each data item, and will provide a drop-down list with valid items to use when editing the cells.

Learn about FlexGrid | DataMaps Documentation | FlexGrid API Reference

This example uses React.

import 'bootstrap.css'; import '@mescius/wijmo.styles/wijmo.css'; import ReactDOM from 'react-dom/client'; import React, { useRef, useState } from 'react'; import useEvent from 'react-use-event-hook'; import * as wjcGrid from '@mescius/wijmo.grid'; import * as wjGrid from '@mescius/wijmo.react.grid'; import './app.css'; import { countries, customers, data } from './data'; function App() { const [customerMap, setCustomerMap] = useState(null); const mainGrid = useRef(null); const mainGridInitialized = useEvent((grid) => { mainGrid.current = grid; }); const dataMapGridInitialized = useEvent((flexGrid) => { setCustomerMap(new wjcGrid.DataMap(customers, 'id', 'name')); flexGrid.rowEditEnded.addHandler(() => { const column = mainGrid.current.getColumn('customer'); if (column) { column.dataMap = new wjcGrid.DataMap(customers, 'id', 'name'); } mainGrid.current.refresh(); // update customer names on the main grid }); }); return (<main className="container-fluid"> <wjGrid.FlexGrid initialized={mainGridInitialized} itemsSource={data}> <wjGrid.FlexGridColumn header="Customer" binding="customer" width="1.5*" dataMap={customerMap}/> <wjGrid.FlexGridColumn header="Country" binding="country" width="*" dataMap={countries}/> <wjGrid.FlexGridColumn header="Downloads" binding="downloads" width="*" format="n0"/> <wjGrid.FlexGridColumn header="Sales" binding="sales" width="*" format="n0"/> <wjGrid.FlexGridColumn header="Expenses" binding="expenses" width="*" format="n0"/> </wjGrid.FlexGrid> <p> And here is another grid showing all the customers. If you edit their names, you will see the change in the top grid: </p> <wjGrid.FlexGrid initialized={dataMapGridInitialized} itemsSource={customers}/> </main>); } const container = document.getElementById('app'); if (container) { const root = ReactDOM.createRoot(container); root.render(<App />); }
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>MESCIUS Wijmo Wijmo FlexGrid Column DataMaps</title> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- SystemJS --> <script src="https://cdn.jsdelivr.net/npm/systemjs@0.19.40/dist/system.src.js" integrity="sha512-G6mEj6h18+m3MvzdviSDfPle/TfH0//cXcB33AKlNR/Rha0yQsKefDZKRTkIZos97HEGq2JMV1RT5ybMoQ3WsQ==" crossorigin="anonymous"></script> <script src="systemjs.config.js"></script> <script> System.import('./src/app'); </script> </head> <body> <div id="app"></div> </body> </html>
.wj-flexgrid { max-height: 200px; margin: 12px 0; }
const getData = () => { const data = []; for (let i = 0; i < countries.length; i++) { data.push({ id: i, country: countries[i], customer: customers[i % customers.length].id, active: i % 5 != 0, downloads: Math.round(Math.random() * 200000), sales: Math.random() * 100000, expenses: Math.random() * 50000 }); } return data; }; export const countries = ['US', 'Germany', 'UK', 'Japan', 'Sweden', 'Norway', 'Denmark']; export const customers = [ { id: 0, name: 'Paul Perkins', address: '123 Main St' }, { id: 1, name: 'Susan Smith', address: '456 Grand Ave' }, { id: 2, name: 'Joan Jett', address: '789 Broad St' }, { id: 3, name: 'Don Davis', address: '321 Shattuck Ave' }, ]; export const data = getData();
(function (global) { window.process = { env: { NODE_ENV: 'production', }, }; System.config({ transpiler: 'plugin-babel', babelOptions: { es2015: true, react: true, }, meta: { '*.css': { loader: 'css' }, }, paths: { // paths serve as alias 'npm:': 'node_modules/', 'cdn:': 'https://cdn.mescius.io/demoapps/packages/wijmojs/5.20261.50-rc/', 'pcdn:': 'https://cdn.jsdelivr.net/npm/' }, // map tells the System loader where to look for things map: { '@mescius/wijmo': 'cdn:@mescius/wijmo/index.js', '@mescius/wijmo.input': 'cdn:@mescius/wijmo.input/index.js', '@mescius/wijmo.styles': 'cdn:@mescius/wijmo.styles', '@mescius/wijmo.cultures': 'cdn:@mescius/wijmo.cultures', '@mescius/wijmo.chart': 'cdn:@mescius/wijmo.chart/index.js', '@mescius/wijmo.chart.analytics': 'cdn:@mescius/wijmo.chart.analytics/index.js', '@mescius/wijmo.chart.animation': 'cdn:@mescius/wijmo.chart.animation/index.js', '@mescius/wijmo.chart.annotation': 'cdn:@mescius/wijmo.chart.annotation/index.js', '@mescius/wijmo.chart.finance': 'cdn:@mescius/wijmo.chart.finance/index.js', '@mescius/wijmo.chart.finance.analytics': 'cdn:@mescius/wijmo.chart.finance.analytics/index.js', '@mescius/wijmo.chart.hierarchical': 'cdn:@mescius/wijmo.chart.hierarchical/index.js', '@mescius/wijmo.chart.interaction': 'cdn:@mescius/wijmo.chart.interaction/index.js', '@mescius/wijmo.chart.radar': 'cdn:@mescius/wijmo.chart.radar/index.js', '@mescius/wijmo.chart.render': 'cdn:@mescius/wijmo.chart.render/index.js', '@mescius/wijmo.chart.webgl': 'cdn:@mescius/wijmo.chart.webgl/index.js', '@mescius/wijmo.chart.map': 'cdn:@mescius/wijmo.chart.map/index.js', '@mescius/wijmo.gauge': 'cdn:@mescius/wijmo.gauge/index.js', '@mescius/wijmo.grid': 'cdn:@mescius/wijmo.grid/index.js', '@mescius/wijmo.grid.detail': 'cdn:@mescius/wijmo.grid.detail/index.js', '@mescius/wijmo.grid.filter': 'cdn:@mescius/wijmo.grid.filter/index.js', '@mescius/wijmo.grid.search': 'cdn:@mescius/wijmo.grid.search/index.js', '@mescius/wijmo.grid.style': 'cdn:@mescius/wijmo.grid.style/index.js', '@mescius/wijmo.grid.grouppanel': 'cdn:@mescius/wijmo.grid.grouppanel/index.js', '@mescius/wijmo.grid.multirow': 'cdn:@mescius/wijmo.grid.multirow/index.js', '@mescius/wijmo.grid.transposed': 'cdn:@mescius/wijmo.grid.transposed/index.js', '@mescius/wijmo.grid.transposedmultirow': 'cdn:@mescius/wijmo.grid.transposedmultirow/index.js', '@mescius/wijmo.grid.pdf': 'cdn:@mescius/wijmo.grid.pdf/index.js', '@mescius/wijmo.grid.sheet': 'cdn:@mescius/wijmo.grid.sheet/index.js', '@mescius/wijmo.grid.xlsx': 'cdn:@mescius/wijmo.grid.xlsx/index.js', '@mescius/wijmo.grid.selector': 'cdn:@mescius/wijmo.grid.selector/index.js', '@mescius/wijmo.grid.cellmaker': 'cdn:@mescius/wijmo.grid.cellmaker/index.js', '@mescius/wijmo.grid.immutable': 'cdn:@mescius/wijmo.grid.immutable/index.js', '@mescius/wijmo.touch': 'cdn:@mescius/wijmo.touch/index.js', '@mescius/wijmo.cloud': 'cdn:@mescius/wijmo.cloud/index.js', '@mescius/wijmo.nav': 'cdn:@mescius/wijmo.nav/index.js', '@mescius/wijmo.odata': 'cdn:@mescius/wijmo.odata/index.js', '@mescius/wijmo.olap': 'cdn:@mescius/wijmo.olap/index.js', '@mescius/wijmo.rest': 'cdn:@mescius/wijmo.rest/index.js', '@mescius/wijmo.pdf': 'cdn:@mescius/wijmo.pdf/index.js', '@mescius/wijmo.pdf.security': 'cdn:@mescius/wijmo.pdf.security/index.js', '@mescius/wijmo.viewer': 'cdn:@mescius/wijmo.viewer/index.js', '@mescius/wijmo.xlsx': 'cdn:@mescius/wijmo.xlsx/index.js', '@mescius/wijmo.undo': 'cdn:@mescius/wijmo.undo/index.js', '@mescius/wijmo.interop.grid': 'cdn:@mescius/wijmo.interop.grid/index.js', '@mescius/wijmo.barcode': 'cdn:@mescius/wijmo.barcode/index.js', '@mescius/wijmo.barcode.common': 'cdn:@mescius/wijmo.barcode.common/index.js', '@mescius/wijmo.barcode.composite': 'cdn:@mescius/wijmo.barcode.composite/index.js', '@mescius/wijmo.barcode.specialized': 'cdn:@mescius/wijmo.barcode.specialized/index.js', '@mescius/wijmo.react.chart.analytics': 'cdn:@mescius/wijmo.react.chart.analytics/index.js', '@mescius/wijmo.react.chart.animation': 'cdn:@mescius/wijmo.react.chart.animation/index.js', '@mescius/wijmo.react.chart.annotation': 'cdn:@mescius/wijmo.react.chart.annotation/index.js', '@mescius/wijmo.react.chart.finance.analytics': 'cdn:@mescius/wijmo.react.chart.finance.analytics/index.js', '@mescius/wijmo.react.chart.finance': 'cdn:@mescius/wijmo.react.chart.finance/index.js', '@mescius/wijmo.react.chart.hierarchical': 'cdn:@mescius/wijmo.react.chart.hierarchical/index.js', '@mescius/wijmo.react.chart.interaction': 'cdn:@mescius/wijmo.react.chart.interaction/index.js', '@mescius/wijmo.react.chart.radar': 'cdn:@mescius/wijmo.react.chart.radar/index.js', '@mescius/wijmo.react.chart': 'cdn:@mescius/wijmo.react.chart/index.js', '@mescius/wijmo.react.core': 'cdn:@mescius/wijmo.react.core/index.js', '@mescius/wijmo.react.chart.map': 'cdn:@mescius/wijmo.react.chart.map/index.js', '@mescius/wijmo.react.gauge': 'cdn:@mescius/wijmo.react.gauge/index.js', '@mescius/wijmo.react.grid.detail': 'cdn:@mescius/wijmo.react.grid.detail/index.js', '@mescius/wijmo.react.grid.filter': 'cdn:@mescius/wijmo.react.grid.filter/index.js', '@mescius/wijmo.react.grid.grouppanel': 'cdn:@mescius/wijmo.react.grid.grouppanel/index.js', '@mescius/wijmo.react.grid.search': 'cdn:@mescius/wijmo.react.grid.search/index.js', '@mescius/wijmo.react.grid.multirow': 'cdn:@mescius/wijmo.react.grid.multirow/index.js', '@mescius/wijmo.react.grid.sheet': 'cdn:@mescius/wijmo.react.grid.sheet/index.js', '@mescius/wijmo.react.grid.transposed': 'cdn:@mescius/wijmo.react.grid.transposed/index.js', '@mescius/wijmo.react.grid.transposedmultirow': 'cdn:@mescius/wijmo.react.grid.transposedmultirow/index.js', '@mescius/wijmo.react.grid.immutable': 'cdn:@mescius/wijmo.react.grid.immutable/index.js', '@mescius/wijmo.react.grid': 'cdn:@mescius/wijmo.react.grid/index.js', '@mescius/wijmo.react.input': 'cdn:@mescius/wijmo.react.input/index.js', '@mescius/wijmo.react.olap': 'cdn:@mescius/wijmo.react.olap/index.js', '@mescius/wijmo.react.viewer': 'cdn:@mescius/wijmo.react.viewer/index.js', '@mescius/wijmo.react.nav': 'cdn:@mescius/wijmo.react.nav/index.js', '@mescius/wijmo.react.base': 'cdn:@mescius/wijmo.react.base/index.js', '@mescius/wijmo.react.barcode.common': 'cdn:@mescius/wijmo.react.barcode.common/index.js', '@mescius/wijmo.react.barcode.composite': 'cdn:@mescius/wijmo.react.barcode.composite/index.js', '@mescius/wijmo.react.barcode.specialized': 'cdn:@mescius/wijmo.react.barcode.specialized/index.js', jszip: 'pcdn:jszip@3.8.0/dist/jszip.js', react: 'pcdn:react@19.0.0/index.js', 'react-dom': 'pcdn:react-dom@19.0.0/index.js', 'react-dom/client': 'pcdn:react-dom@19.0.0/client.js', scheduler: 'pcdn:scheduler@0.25.0/index.js', redux: 'pcdn:redux@5.0.1/dist/redux.legacy-esm.js', 'react-redux': 'pcdn:react-redux@9.2.0/dist/react-redux.legacy-esm.js', 'bootstrap.css': 'pcdn:bootstrap@3.3.7/dist/css/bootstrap.min.css', css: 'pcdn:systemjs-plugin-css@0.1.37/css.js', 'plugin-babel': 'pcdn:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'pcdn:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', 'react-use-event-hook': 'pcdn:react-use-event-hook@0.9.6/dist/esm/useEvent.js', }, // packages tells the System loader how to load when no filename and/or no extension packages: { src: { defaultExtension: 'jsx', }, node_modules: { defaultExtension: 'js', }, }, }); })(this);