vuex-hydra

v1.3.0

Published

2 years ago

> Vuex plugin to hydrate your stores with external data.

Downloads

205

0High
0Medium
0Low

msolle

vuex store hydration decoupled

Vuex Hydra

Vuex plugin to hydrate your stores with external data.

It can be used for frontends to instantly access backend data without further API requests. Store data can be passed directly, read from JSON in HTML or the window object.

Check the examples below for more information.

Use cases

Pass dynamic/runtime data from backends into Vuex stores
Prevent redundant API requests
Speed up store initialization

UseCase

Setup

Install the plugin with npm or yarn

npm install --save vuex-hydra

yarn add vuex-hydra

Import vuex-hydra into your project, which makes the $hydrate function available in all components

import Vue from 'vue';
import Vuex from 'vuex';
import VuexHydra from 'vuex-hydra';

Vue.use(Vuex);
Vue.use(VuexHydra); // Use after Vuex

const store = Vuex.Store({
    state: {
        hello: '',
    }
});

new Vue({
    store,
    created() {
        // This is the simplest case for static data
        // Check the examples below for dynamic backend data not available at compile time
        const data = { root: { hello: 'world' } }
        this.$hydrate({ data });
    }
});

Usage

Data structure

Vuex-hydra can hydrate the root state and namespaced modules. The first level properties of your data object should contain the names of your store modules. Root state data is identified by root, namespaced modules should have their respective names.

Example: Assign data to root state and the state of a namespaced module called user.

import Vuex from 'vuex';

export default new Vuex.Store({
    state: {
        foo: '',
    },
    modules: {
        user: {
            namespaced: true,
            state: {
                id: null,
                name: '',
            },
        }
    },
});

This data structure defines store names and their states

{
  "root": {
    "foo": "bar"
  },
  "user": {
    "id": 42,
    "name": "baz"
  }
}

$hydrate([config])

The configuration object can have following properties

|Config|Type|Default|Description| |---|---|---|---| |data|object|{}|Store data| |id|string|null|Id of DOM Element containing JSON| |name|string|null|Property name in window object| |silent|boolean|false|Prevents console messages like logs or errors|

Examples

There are multiple ways to hydrate your store. If the data is provided by a backend, the best way is to hydrate your stores with JSON in HTML.

Hydrate with JSON in HTML

Serialize your data to JSON, place it in a DOM Element and hydrate via id

<body>
    <div id="vuex-hydra">
        { "root": { "foo": "bar" } }
    </div>
</body>

this.$hydrate({ id: 'vuex-hydra' });

Hydrate with window object

Extend the window object with your data before application initialization

<body>
    <script>
        window.backendData = { root: { foo: 'bar' } }
    </script>
</body>

this.$hydrate({ name: 'backendData' });

Hydrate namespaced and nested modules

Use the name your namespaced modules are registered with instead of root. Separate nested modules names with /.

{
    "namespacedModuleName": { "foo": "bar" },
    "nested/moduleName": { "bar": "baz" },
    "really/nested/moduleName": { "baz": "qux" }
}

this.$hydrate({ /* config */ });

Frameworks

This section is in progress...

Laravel

Collect your data in the controller and pass it to a view

public function index()
{
    $data = [
        'root' => [
            'foo' => Bar::first(),
        ],
    ];
    return view('index', [
        'data' => $data,
    ]);
}

Insert hidden JSON without further encoding

<div id="my-data" style="display: none">
    {!! json_encode($data) !!}
</div>

this.$hydrate({ id: 'my-data' })

Development

Clone this project and run

npm install

Start local dev server from application in demo/

npm run serve

Create tests with Jest and run them with

npm run test

Lint and fix files

npm run lint

Create a feature branch on develop und submit it as pull request.

License

MIT