Skip to main content

Data Import and Export

Import​

Mind Elixir Core provides two ways to import data: when initializing and when calling the refresh method.

let mind = new MindElixir(options)

mind.init(data) // initialization
mind.refresh(data) // refresh with new data

When data is not passed into refresh, the original data object will be used for updating.

Incremental refresh​

refresh(data) rebuilds the whole map, leaves focus mode and emits a refresh event once the new data is in place. If only a few nodes changed, diffRefresh(data) is usually the better choice: it applies only the difference, keeping unchanged nodes' DOM elements, event listeners and focus state, and falls back to a full refresh when the change cannot be expressed incrementally.

mind.diffRefresh(data) // patch only what changed
mind.refresh(data) // full rebuild

Export​

Mind Elixir Core provides two data export formats: a JavaScript object and its JSON string:

// data export
const data = mind.getData() // JavaScript object, see src/example.js
mind.getDataString() // stringify object

For Markdown output, convert the object returned by getData() yourself.

The getData output example:

const data = {
  nodeData: {
    id: 'd451a556d866ba7b',
    topic: 'new topic',
    root: true,
    children: [
      {
        topic: 'new node',
        id: 'd451a6f027c33b1f',
        direction: 0,
        children: [
          {
            topic: 'new node',
            id: 'd451a724b7c10970',
          },
          {
            topic: 'new node',
            id: 'd451a77ca7348eae',
          },
          {
            topic: 'new node',
            id: 'd451a78e1ec7181c',
          },
        ],
      },
    ],
  },
  arrows: [
    {
      id: 'd451a9149a1e3a15',
      label: 'Custom Link',
      from: 'd451a77ca7348eae',
      to: 'd451a78e1ec7181c',
      delta1: {
        x: -230,
        y: -9,
      },
      delta2: {
        x: -236,
        y: 14,
      },
    },
  ],
  summaries: [
    {
      id: 'd451a84c2e77cc2f',
      parent: 'd451a6f027c33b1f',
      start: 0,
      end: 0,
      text: 'summary',
    },
  ],
  direction: 2,
  theme: {
    name: 'Latte',
    palette: [
      '#4968a3',
      '#3b88c4',
      '#4fa3d4',
      '#2b5b84',
      '#367fa2',
      '#5e93b7',
      '#4a719c',
      '#28567d',
      '#214e6d',
      '#336699',
    ],
    cssVar: {
      '--main-color': '#444446',
      '--main-bgcolor': '#ffffff',
      '--color': '#777777',
      '--bgcolor': '#f6f6f6',
      '--panel-color': '#444446',
      '--panel-bgcolor': '#ffffff',
      '--panel-border-color': '#eaeaea',
    },
  },
}

Key parts to note are:

  • Node data nodeData, see Node Data
  • Associated node connection data arrows
  • Multi-node summary data summaries
  • Theme data theme, see Using Themes
info

The exported data includes the current theme. refresh(data) does not apply data.theme — theme handling is separate from refresh. Call changeTheme(data.theme) explicitly when you need to switch themes, and remove the theme field if you want to render with one consistent theme.