grapesjs/docs/api/storage_manager.md

StorageManager

You can customize the initial state of the module from the editor initialization, by passing the following Configuration Object

const editor = grapesjs.init({
 storageManager: {
   // options
 }
})

Once the editor is instantiated you can use its API. Before using these methods you should get the module from the instance

const storageManager = editor.StorageManager;

• getConfig
• isAutosave
• setAutosave
• getStepsBeforeSave
• setStepsBeforeSave
• setStepsBeforeSave
• getStorages
• getCurrent
• getCurrentStorage
• setCurrent
• add
• get
• store
• load

getConfig

Get configuration object

Returns Object

isAutosave

Checks if autosave is enabled

Returns Boolean

setAutosave

Set autosave value

Parameters

• v Boolean

Returns this

getStepsBeforeSave

Returns number of steps required before trigger autosave

Returns number

setStepsBeforeSave

Set steps required before trigger autosave

Parameters

• v number

Returns this

add

Add new storage

Parameters

• id string Storage ID
• storage Object Storage wrapper
  • storage.load Function Load method
  • storage.store Function Store method

Examples

storageManager.add('local2', {
  load: function(keys, clb, clbErr) {
    var res = {};
    for (var i = 0, len = keys.length; i < len; i++){
      var v = localStorage.getItem(keys[i]);
      if(v) res[keys[i]] = v;
    }
    clb(res); // might be called inside some async method
    // In case of errors...
    // clbErr('Went something wrong');
  },
  store: function(data, clb, clbErr) {
    for(var key in data)
      localStorage.setItem(key, data[key]);
    clb(); // might be called inside some async method
  }
});

Returns this

get

Returns storage by id

Parameters

• id string Storage ID

Returns (Object | null)

getStorages

Returns all storages

Returns Array

getCurrent

Returns current storage type

Returns string

setCurrent

Set current storage type

Parameters

• id string Storage ID

Returns this

store

Store key-value resources in the current storage

Parameters

• data Object Data in key-value format, eg. {item1: value1, item2: value2}
• clb Function Callback function

Examples

storageManager.store({item1: value1, item2: value2});

Returns (Object | null)

load

Load resource from the current storage by keys

Parameters

• keys (string | Array<string>) Keys to load
• clb Function Callback function

Examples

storageManager.load(['item1', 'item2'], res => {
 // res -> {item1: value1, item2: value2}
});
storageManager.load('item1', res => {
// res -> {item1: value1}
});

getCurrentStorage

Get current storage

Returns Storage