mindful v1.3.5
#Mindful
A user friendly library for global management of React state.
##How to use Mindful can be installed using npm:
npm install mindful --save
Mindful must be imported as follows
import mindful from 'mindful';
This exposes the Mindful API that has access to a variety of methods.
##Example Usage
The following example attaches Mindful to a plain stateless React component.
import React from 'react';
import { Link } from 'react-router';
import mindful from 'mindful';
var MessageBox = (props) => {
return (
<div>
<h1>
{ mindful.get('message') }
</h1>
<form onSubmit={() => {
var newMessage = document.getElementById('messageInput').value;
mindful.set('message', newMessage);
}}>
<input type="text" id="messageInput">
</input>
</form>
</div>
);
};
export default mindful(MessageBox, 'message');
##API Reference
####mindful( reactComponent, key1, key2, ... ) Mindful itself is a function that wraps React components passed into it, and rerenders them when any of the values, which are associated with the passed in keys, change.
####mindful.set( key, value ) Stores the given key/value pair in Mindful's global storage
####mindful.get( key ) Returns the value associated with the given key in storage.
mindful.set('color', 'red');
mindful.get('color') //=> Should return 'red'.
####mindful.retain( key, value ) Acts the same as Mindful.set, but the data persists after page reload.
mindful.set('temporaryValue', 10);
mindful.retain('persistentValue', 20);
// Page reloads
mindful.get('temporaryValue') //=> Should return undefined.
mindful.get('persistentValue') //=> Should return 20.
####mindful.forget( key ) Deletes the given key from the global storage. (This trumps mindful.retain)
####mindful.update( key, callback ) Maps the given key/value pair in global storage based on the passed in callback.
mindful.set('number', 10);
mindful.update('number', function (value) {
return value * 2;
})
mindful.get('number') //=> Should return 20.
####mindful.toggle( key ) Inverses the boolean value stored at the given key.
mindful.set('loggedIn', false);
mindful.toggle('loggedIn');
mindful.get('loggedIn') //=> Should return true.
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago