Demos
Grid(React)
Custom Cells
Cell Templates
Common Tasks

Common Cell Template Tasks (React)

This sample shows how you can accomplish two of the most common tasks for cell templates: conditional formatting and images.

All versions of the sample show how you can accomplish these tasks using the Column.cellTemplate property.

The framework-specific versions also show how you can do the same thing using cell template directives, which are more powerful but slightly more complex.

Learn about FlexGrid | FlexGrid API Reference

This example uses React.

JavaScript
Angular
Vue
React
app.jsx
index.html
app.css
data.jsx
Copy to CodeMine
import 'bootstrap.css';
import '@mescius/wijmo.styles/wijmo.css';
import ReactDOM from 'react-dom/client';
import React from 'react';
import { Globalize } from '@mescius/wijmo';
import { FlexGrid, FlexGridColumn, FlexGridCellTemplate } from '@mescius/wijmo.react.grid';
import './app.css';
import { data, products, colors, countryMap } from './data';
function App() {
    // get a country object from a data item
    // (this makes our template expressions simpler)
    const getCountry = (item) => {
        return countryMap.getDataItem(item.country);
    };
    // format numbers and dates
    const format = (val, fmt) => {
        return Globalize.format(val, fmt);
    };
    return (<div className="container-fluid">
      <p>
        This sample shows how to use the <b>FlexGridCellTemplate</b> child component
        (part of our React interop) as well as the <b>cellTemplate</b> property.
      </p>
      <FlexGrid showSelectedHeaders="All" selectionMode="MultiRange" headersVisibility="Column" showMarquee={true} itemsSource={data}>
        <FlexGridColumn binding="id" header="ID" isReadOnly={true} width=".5*"/>
        <FlexGridColumn binding="date" header="Date" width="*"/>
        <FlexGridColumn binding="product" header="Product" dataMap={products} width="*"/>
        <FlexGridColumn header="Country" binding="country" dataMap={countryMap} width="*">
          <FlexGridCellTemplate cellType="Cell" template={(cell) => <React.Fragment>
            <span className={'flag-icon flag-icon-' + getCountry(cell.item).flag}></span>
            {' '}
            {cell.col.dataMap.getDisplayValue(cell.item.country)}
          </React.Fragment>}/>
        </FlexGridColumn>
        <FlexGridColumn binding="color" header="Color" dataMap={colors} width="*">
          <FlexGridCellTemplate cellType="Cell" template={(cell) => <React.Fragment>
            <span className="color-tile" style={{ 'background': cell.item.color }}></span>
            &nbsp;
            {cell.item.color}
          </React.Fragment>}/>
        </FlexGridColumn>
        <FlexGridColumn binding="color" header="Color *" dataMap={colors} width="*" cellTemplate="<span class='color-tile' style='background:${value}'></span> ${text}"/>
        <FlexGridColumn binding="value" header="Value" format="c0" width="*"/>
        <FlexGridColumn binding="change" header="Change" align="center" format="p0" width="*">
          <FlexGridCellTemplate cellType="Cell" template={(cell) => <React.Fragment>
            <span className={cell.item.change > 0 ? 'change-up' : 'change-down'}>
              {format(cell.item.change, cell.col.format)}
            </span>
          </React.Fragment>}/>
        </FlexGridColumn>
      </FlexGrid>
      <p>
        <b>*</b>: Columns created with the <b>cellTemplate</b> property.
      </p>
    </div>);
}
const container = document.getElementById('app');
if (container) {
    const root = ReactDOM.createRoot(container);
    root.render(<App />);
}
import 'bootstrap.css'; import '@mescius/wijmo.styles/wijmo.css'; import ReactDOM from 'react-dom/client'; import React from 'react'; import { Globalize } from '@mescius/wijmo'; import { FlexGrid, FlexGridColumn, FlexGridCellTemplate } from '@mescius/wijmo.react.grid'; import './app.css'; import { data, products, colors, countryMap } from './data'; function App() { // get a country object from a data item // (this makes our template expressions simpler) const getCountry = (item) => { return countryMap.getDataItem(item.country); }; // format numbers and dates const format = (val, fmt) => { return Globalize.format(val, fmt); }; return (<div className="container-fluid"> <p> This sample shows how to use the <b>FlexGridCellTemplate</b> child component (part of our React interop) as well as the <b>cellTemplate</b> property. </p> <FlexGrid showSelectedHeaders="All" selectionMode="MultiRange" headersVisibility="Column" showMarquee={true} itemsSource={data}> <FlexGridColumn binding="id" header="ID" isReadOnly={true} width=".5*"/> <FlexGridColumn binding="date" header="Date" width="*"/> <FlexGridColumn binding="product" header="Product" dataMap={products} width="*"/> <FlexGridColumn header="Country" binding="country" dataMap={countryMap} width="*"> <FlexGridCellTemplate cellType="Cell" template={(cell) => <React.Fragment> <span className={'flag-icon flag-icon-' + getCountry(cell.item).flag}></span> {' '} {cell.col.dataMap.getDisplayValue(cell.item.country)} </React.Fragment>}/> </FlexGridColumn> <FlexGridColumn binding="color" header="Color" dataMap={colors} width="*"> <FlexGridCellTemplate cellType="Cell" template={(cell) => <React.Fragment> <span className="color-tile" style={{ 'background': cell.item.color }}></span> &nbsp; {cell.item.color} </React.Fragment>}/> </FlexGridColumn> <FlexGridColumn binding="color" header="Color *" dataMap={colors} width="*" cellTemplate="<span class='color-tile' style='background:${value}'></span> ${text}"/> <FlexGridColumn binding="value" header="Value" format="c0" width="*"/> <FlexGridColumn binding="change" header="Change" align="center" format="p0" width="*"> <FlexGridCellTemplate cellType="Cell" template={(cell) => <React.Fragment> <span className={cell.item.change > 0 ? 'change-up' : 'change-down'}> {format(cell.item.change, cell.col.format)} </span> </React.Fragment>}/> </FlexGridColumn> </FlexGrid> <p> <b>*</b>: Columns created with the <b>cellTemplate</b> property. </p> </div>); } 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 Cell Template Common Tasks</title> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- SystemJS --> <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.40/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>
@import 'https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.1.0/css/flag-icon.css'; .wj-flexgrid { max-height: 400px; } .wj-flexgrid .wj-cell { padding: 6px 12px; } .wj-flexgrid .wj-cell:not(.wj-header) { border-right: none; } .color-tile { display: inline-block; position: relative; width: 1.33333333em; height: 1em; vertical-align: middle; border: 1px solid grey; } .change-up { color: darkgreen; } .change-up:before { content: '\25b2\00a0'; } .change-down { color: darkred; } .change-down:before { content: '\25bc\00a0'; }
import { DataMap } from '@mescius/wijmo.grid'; import { DateTime } from '@mescius/wijmo'; function getCountries() { return [ { id: 0, name: 'US', flag: 'us' }, { id: 1, name: 'Germany', flag: 'de' }, { id: 2, name: 'UK', flag: 'gb' }, { id: 3, name: 'Japan', flag: 'jp' }, { id: 4, name: 'Italy', flag: 'it' }, { id: 5, name: 'France', flag: 'fr' }, { id: 6, name: 'Canada', flag: 'ca' }, { id: 7, name: 'Russia', flag: 'ru' } ]; } function getCountryMap() { return new DataMap(getCountries(), 'id', 'name'); } function getProducts() { return 'Cars,Computers,Phones,Movies,Books'.split(','); } function getColors() { return 'Red,Green,Blue,White,Black,Yellow,Orange'.split(','); } function getData(cnt = 20) { let countries = getCountries(), products = getProducts(), colors = getColors(), today = new Date(), data = []; for (let i = 0; i < cnt; i++) { data.push({ id: i, date: DateTime.addDays(today, -i), product: pickOne(products), country: pickOne(countries).id, color: pickOne(colors), value: 500 + Math.round(Math.random() * 1000), change: Math.round((Math.random() - 0.45) * 10000) / 10000 }); } return data; } function pickOne(arr) { return arr[Math.floor(Math.random() * arr.length)]; } export const data = getData(); export const products = getProducts(); export const colors = getColors(); export const countryMap = getCountryMap();
(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/' }, // map tells the System loader where to look for things map: { 'jszip': 'npm:jszip/dist/jszip.js', '@mescius/wijmo': 'npm:@mescius/wijmo/index.js', '@mescius/wijmo.input': 'npm:@mescius/wijmo.input/index.js', '@mescius/wijmo.styles': 'npm:@mescius/wijmo.styles', '@mescius/wijmo.cultures': 'npm:@mescius/wijmo.cultures', '@mescius/wijmo.chart': 'npm:@mescius/wijmo.chart/index.js', '@mescius/wijmo.chart.analytics': 'npm:@mescius/wijmo.chart.analytics/index.js', '@mescius/wijmo.chart.animation': 'npm:@mescius/wijmo.chart.animation/index.js', '@mescius/wijmo.chart.annotation': 'npm:@mescius/wijmo.chart.annotation/index.js', '@mescius/wijmo.chart.finance': 'npm:@mescius/wijmo.chart.finance/index.js', '@mescius/wijmo.chart.finance.analytics': 'npm:@mescius/wijmo.chart.finance.analytics/index.js', '@mescius/wijmo.chart.hierarchical': 'npm:@mescius/wijmo.chart.hierarchical/index.js', '@mescius/wijmo.chart.interaction': 'npm:@mescius/wijmo.chart.interaction/index.js', '@mescius/wijmo.chart.radar': 'npm:@mescius/wijmo.chart.radar/index.js', '@mescius/wijmo.chart.render': 'npm:@mescius/wijmo.chart.render/index.js', '@mescius/wijmo.chart.webgl': 'npm:@mescius/wijmo.chart.webgl/index.js', '@mescius/wijmo.chart.map': 'npm:@mescius/wijmo.chart.map/index.js', '@mescius/wijmo.gauge': 'npm:@mescius/wijmo.gauge/index.js', '@mescius/wijmo.grid': 'npm:@mescius/wijmo.grid/index.js', '@mescius/wijmo.grid.detail': 'npm:@mescius/wijmo.grid.detail/index.js', '@mescius/wijmo.grid.filter': 'npm:@mescius/wijmo.grid.filter/index.js', '@mescius/wijmo.grid.search': 'npm:@mescius/wijmo.grid.search/index.js', '@mescius/wijmo.grid.style': 'npm:@mescius/wijmo.grid.style/index.js', '@mescius/wijmo.grid.grouppanel': 'npm:@mescius/wijmo.grid.grouppanel/index.js', '@mescius/wijmo.grid.multirow': 'npm:@mescius/wijmo.grid.multirow/index.js', '@mescius/wijmo.grid.transposed': 'npm:@mescius/wijmo.grid.transposed/index.js', '@mescius/wijmo.grid.transposedmultirow': 'npm:@mescius/wijmo.grid.transposedmultirow/index.js', '@mescius/wijmo.grid.pdf': 'npm:@mescius/wijmo.grid.pdf/index.js', '@mescius/wijmo.grid.sheet': 'npm:@mescius/wijmo.grid.sheet/index.js', '@mescius/wijmo.grid.xlsx': 'npm:@mescius/wijmo.grid.xlsx/index.js', '@mescius/wijmo.grid.selector': 'npm:@mescius/wijmo.grid.selector/index.js', '@mescius/wijmo.grid.cellmaker': 'npm:@mescius/wijmo.grid.cellmaker/index.js', '@mescius/wijmo.grid.immutable': 'npm:@mescius/wijmo.grid.immutable/index.js', '@mescius/wijmo.touch': 'npm:@mescius/wijmo.touch/index.js', '@mescius/wijmo.cloud': 'npm:@mescius/wijmo.cloud/index.js', '@mescius/wijmo.nav': 'npm:@mescius/wijmo.nav/index.js', '@mescius/wijmo.odata': 'npm:@mescius/wijmo.odata/index.js', '@mescius/wijmo.olap': 'npm:@mescius/wijmo.olap/index.js', '@mescius/wijmo.rest': 'npm:@mescius/wijmo.rest/index.js', '@mescius/wijmo.pdf': 'npm:@mescius/wijmo.pdf/index.js', '@mescius/wijmo.pdf.security': 'npm:@mescius/wijmo.pdf.security/index.js', '@mescius/wijmo.viewer': 'npm:@mescius/wijmo.viewer/index.js', '@mescius/wijmo.xlsx': 'npm:@mescius/wijmo.xlsx/index.js', '@mescius/wijmo.undo': 'npm:@mescius/wijmo.undo/index.js', '@mescius/wijmo.interop.grid': 'npm:@mescius/wijmo.interop.grid/index.js', '@mescius/wijmo.barcode': 'npm:@mescius/wijmo.barcode/index.js', '@mescius/wijmo.barcode.common': 'npm:@mescius/wijmo.barcode.common/index.js', '@mescius/wijmo.barcode.composite': 'npm:@mescius/wijmo.barcode.composite/index.js', '@mescius/wijmo.barcode.specialized': 'npm:@mescius/wijmo.barcode.specialized/index.js', "@mescius/wijmo.react.chart.analytics": "npm:@mescius/wijmo.react.chart.analytics/index.js", "@mescius/wijmo.react.chart.animation": "npm:@mescius/wijmo.react.chart.animation/index.js", "@mescius/wijmo.react.chart.annotation": "npm:@mescius/wijmo.react.chart.annotation/index.js", "@mescius/wijmo.react.chart.finance.analytics": "npm:@mescius/wijmo.react.chart.finance.analytics/index.js", "@mescius/wijmo.react.chart.finance": "npm:@mescius/wijmo.react.chart.finance/index.js", "@mescius/wijmo.react.chart.hierarchical": "npm:@mescius/wijmo.react.chart.hierarchical/index.js", "@mescius/wijmo.react.chart.interaction": "npm:@mescius/wijmo.react.chart.interaction/index.js", "@mescius/wijmo.react.chart.radar": "npm:@mescius/wijmo.react.chart.radar/index.js", "@mescius/wijmo.react.chart": "npm:@mescius/wijmo.react.chart/index.js", "@mescius/wijmo.react.core": "npm:@mescius/wijmo.react.core/index.js", '@mescius/wijmo.react.chart.map': 'npm:@mescius/wijmo.react.chart.map/index.js', "@mescius/wijmo.react.gauge": "npm:@mescius/wijmo.react.gauge/index.js", "@mescius/wijmo.react.grid.detail": "npm:@mescius/wijmo.react.grid.detail/index.js", "@mescius/wijmo.react.grid.filter": "npm:@mescius/wijmo.react.grid.filter/index.js", "@mescius/wijmo.react.grid.grouppanel": "npm:@mescius/wijmo.react.grid.grouppanel/index.js", '@mescius/wijmo.react.grid.search': 'npm:@mescius/wijmo.react.grid.search/index.js', "@mescius/wijmo.react.grid.multirow": "npm:@mescius/wijmo.react.grid.multirow/index.js", "@mescius/wijmo.react.grid.sheet": "npm:@mescius/wijmo.react.grid.sheet/index.js", '@mescius/wijmo.react.grid.transposed': 'npm:@mescius/wijmo.react.grid.transposed/index.js', '@mescius/wijmo.react.grid.transposedmultirow': 'npm:@mescius/wijmo.react.grid.transposedmultirow/index.js', '@mescius/wijmo.react.grid.immutable': 'npm:@mescius/wijmo.react.grid.immutable/index.js', "@mescius/wijmo.react.grid": "npm:@mescius/wijmo.react.grid/index.js", "@mescius/wijmo.react.input": "npm:@mescius/wijmo.react.input/index.js", "@mescius/wijmo.react.olap": "npm:@mescius/wijmo.react.olap/index.js", "@mescius/wijmo.react.viewer": "npm:@mescius/wijmo.react.viewer/index.js", "@mescius/wijmo.react.nav": "npm:@mescius/wijmo.react.nav/index.js", "@mescius/wijmo.react.base": "npm:@mescius/wijmo.react.base/index.js", '@mescius/wijmo.react.barcode.common': 'npm:@mescius/wijmo.react.barcode.common/index.js', '@mescius/wijmo.react.barcode.composite': 'npm:@mescius/wijmo.react.barcode.composite/index.js', '@mescius/wijmo.react.barcode.specialized': 'npm:@mescius/wijmo.react.barcode.specialized/index.js', 'jszip': 'npm:jszip/dist/jszip.js', 'react': 'npm:react/index.js', 'react-dom': 'npm:react-dom/index.js', 'react-dom/client': 'npm:react-dom/client.js', "scheduler": "npm:scheduler/index.js", 'redux': 'npm:redux/dist/redux.min.js', 'react-redux': 'npm:react-redux/dist/react-redux.min.js', 'bootstrap.css': 'npm:bootstrap/dist/css/bootstrap.min.css', 'css': 'npm:systemjs-plugin-css/css.js', 'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js', 'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js', "react-use-event-hook": "npm:react-use-event-hook/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);