demo D208

Configuring a type in ESM

One field, five presentations; the stored value never changes

createUnitType({ display, decimals, … })

This grid shows one stored field presented five different ways, with the underlying value never changing. It shows that display is a setting, not a rewrite, so you can change decimals, symbols or format without touching the data behind the column.

Building…

Loading a live grid…

This is the ES module version. The grid is imported straight from a CDN as a module, the same configuration as the vanilla tab without a global script tag, so it drops into any bundler or a bare module script.

The configuration

<link rel="stylesheet" href="https://cdn.latticegrid.dev/lattice-grid@1.107.0/lattice-grid.min.css">

<div id="grid" style="height: 460px"></div>

<script type="module">
  import { createUnitType, createGrid } from 'https://cdn.latticegrid.dev/lattice-grid@1.107.0/lattice-grid.esm.min.js';

  // The same field stored in metres, shown four ways. The stored value never
  // changes; only the display does.
  const dataTypes = {
    spanAuto: createUnitType({ system: 'length', unit: 'm', display: 'auto' }),
    spanMm:   createUnitType({ system: 'length', unit: 'm', display: 'mm' }),
    spanKm:   createUnitType({ system: 'length', unit: 'm', display: 'km', decimals: 3 }),
    spanSig:  createUnitType({ system: 'length', unit: 'm', display: 'auto', significantFigures: 3 }),
  };

  const grid = createGrid(document.getElementById('grid'), {
    rowKey: 'id',
    dataTypes,
    columns: [
      { field: 'run', title: 'Run', layout: { pin: 'start', width: 120 } },
      { field: 'span', id: 'stored', title: 'Stored (m)', type: 'number' },
      { field: 'span', id: 'auto', title: "display: 'auto'", type: 'spanAuto' },
      { field: 'span', id: 'mm', title: "display: 'mm'", type: 'spanMm' },
      { field: 'span', id: 'km', title: "display: 'km'", type: 'spanKm' },
      { field: 'span', id: 'sig', title: '3 sig figs', type: 'spanSig' },
    ],
    rows,
  });
</script>