https://github.com/capaj/mobx-location
just location as a mobx observable. Very minimal wrapper around browser location utilizing popstate event of HTML5 history api
https://github.com/capaj/mobx-location
Last synced: 11 months ago
JSON representation
just location as a mobx observable. Very minimal wrapper around browser location utilizing popstate event of HTML5 history api
- Host: GitHub
- URL: https://github.com/capaj/mobx-location
- Owner: capaj
- License: mit
- Created: 2017-01-14T09:44:30.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-08-18T23:37:34.000Z (almost 6 years ago)
- Last Synced: 2025-07-24T21:16:41.298Z (12 months ago)
- Language: JavaScript
- Homepage:
- Size: 230 KB
- Stars: 26
- Watchers: 4
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mobx-location
a browser location as a mobx observable. Minimal wrapper around browser history utilizing popstate event and HTML5 history api. Package [history-events](https://github.com/xpepermint/history-events) is used for monkeypatching.
Prime usage is in your mobx observers. You can directly access the location and your app will rerender itself without the need for react-router or similar solution.
```javascript
import makeMobxLocation from './mobx-location'
import { autorun, toJS } from 'mobx'
const mobxLocation = makeMobxLocation({ hashHistory: false }) // default
const mobxLocation = makeMobxLocation({ hashHistory: true }) // when you use hash history instead of html5 history APIs
const mobxLocation = makeMobxLocation({ arrayFormat: 'bracket' }) // default
const mobxLocation = makeMobxLocation({ arrayFormat: 'index' }) // will index array params in the url, refer to https://www.npmjs.com/package/query-string#arrayformat
autorun(() => {
toJS(mobxLocation) // runs every time browser location changes
})
```
location has all the standard properties:
```
hash
host
hostname
href
origin
pathname
port
protocol
search
```
plus one extra- `query`. Query is just parsed `location.search`. Query is always there even if no search params are in your location.
If you modify the query object, it will propagate back to the window location so you don't have to construct the search params yourself when modifying.
Keep in mind that any newly added property in `query` won't be picked up-you must use `set` from `import {set} from 'mobx'` to set new props.
## Browser support
same as html5 history api-so with that shim even IE9