mastodon/app/javascript/glitch/actions/local_settings.js

94 lines
2.3 KiB
JavaScript
Raw Normal View History

2017-07-13 12:26:08 +02:00
/*
`actions/local_settings`
========================
> For more information on the contents of this file, please contact:
>
> - kibigo! [@kibi@glitch.social]
This file provides our Redux actions related to local settings. It
consists of the following:
- __`changesLocalSetting(key, value)` :__
Changes the local setting with the given `key` to the given
`value`. `key` **MUST** be an array of strings, as required by
`Immutable.Map.prototype.getIn()`.
- __`saveLocalSettings()` :__
Saves the local settings to `localStorage` as a JSON object. We
shouldn't ever need to call this ourselves.
*/
2017-07-14 20:13:02 +02:00
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2017-07-13 12:26:08 +02:00
/*
2017-07-14 20:13:02 +02:00
Constants:
----------
2017-07-13 12:26:08 +02:00
We provide the following constants:
- __`LOCAL_SETTING_CHANGE` :__
This string constant is used to dispatch a setting change to our
reducer in `reducers/local_settings`, where the setting is
actually changed.
*/
export const LOCAL_SETTING_CHANGE = 'LOCAL_SETTING_CHANGE';
2017-07-14 20:13:02 +02:00
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2017-07-13 12:26:08 +02:00
/*
2017-07-14 20:13:02 +02:00
`changeLocalSetting(key, value)`:
---------------------------------
2017-07-13 12:26:08 +02:00
Changes the local setting with the given `key` to the given `value`.
`key` **MUST** be an array of strings, as required by
`Immutable.Map.prototype.getIn()`.
To accomplish this, we just dispatch a `LOCAL_SETTING_CHANGE` to our
reducer in `reducers/local_settings`.
*/
export function changeLocalSetting(key, value) {
return dispatch => {
dispatch({
type: LOCAL_SETTING_CHANGE,
key,
value,
});
dispatch(saveLocalSettings());
};
};
2017-07-14 20:13:02 +02:00
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2017-07-13 12:26:08 +02:00
/*
2017-07-14 20:13:02 +02:00
`saveLocalSettings()`:
----------------------
2017-07-13 12:26:08 +02:00
Saves the local settings to `localStorage` as a JSON object.
`changeLocalSetting()` calls this whenever it changes a setting. We
shouldn't ever need to call this ourselves.
> __TODO :__
> Right now `saveLocalSettings()` doesn't keep track of which user
> is currently signed in, but it might be better to give each user
> their *own* local settings.
*/
export function saveLocalSettings() {
return (_, getState) => {
2017-06-29 07:00:54 +02:00
const localSettings = getState().get('local_settings').toJS();
localStorage.setItem('mastodon-settings', JSON.stringify(localSettings));
};
};