mirror of
https://github.com/idanoo/GoScrobble.git
synced 2024-11-25 09:55:15 +00:00
59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
# @emotion/cache
|
|
|
|
### createCache
|
|
|
|
`createCache` allows for low level customization of how styles get inserted by emotion. It's intended to be used with the [`<CacheProvider/>`](https://emotion.sh/docs/cache-provider) component to override the default cache, which is created with sensible defaults for most applications.
|
|
|
|
```javascript
|
|
import createCache from '@emotion/cache'
|
|
|
|
export const myCache = createCache({
|
|
key: 'my-prefix-key',
|
|
stylisPlugins: [
|
|
/* your plugins here */
|
|
]
|
|
})
|
|
```
|
|
|
|
### Primary use cases
|
|
|
|
- Using emotion in embedded contexts such as an `<iframe/>`
|
|
|
|
- Setting a [nonce](#nonce-string) on any `<style/>` tag emotion creates for security purposes
|
|
|
|
- Using emotion with a developer defined `<style/>` tag
|
|
|
|
- Using emotion with custom Stylis plugins
|
|
|
|
## Options
|
|
|
|
### `nonce`
|
|
|
|
`string`
|
|
|
|
A nonce that will be set on each style tag that emotion inserts for [Content Security Policies](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP).
|
|
|
|
### `stylisPlugins`
|
|
|
|
`Function` | `Array<Function>`
|
|
|
|
A Stylis plugin or plugins that will be run by Stylis during preprocessing. [Read the Stylis docs to find out more](https://github.com/thysultan/stylis.js#plugins). This can be used for many purposes such as RTL.
|
|
|
|
### `prefix`
|
|
|
|
`boolean` | `Function`, defaults to `true`
|
|
|
|
Allows changing Stylis's vendor prefixing settings. It can be a boolean or a function to dynamically set which properties are prefixed. [More information can be found in the Stylis docs](https://github.com/thysultan/stylis.js#vendor-prefixing).
|
|
|
|
### `key`
|
|
|
|
`string`, defaults to `"css"`
|
|
|
|
The prefix before class names. It will also be set as the value of the `data-emotion` attribute on the style tags that emotion inserts and it's used in the attribute name that marks style elements in `renderStylesToString` and `renderStylesToNodeStream`. This is **required if using multiple emotion caches in the same app**.
|
|
|
|
### `container`
|
|
|
|
`HTMLElement`
|
|
|
|
A DOM node that emotion will insert all of its style tags into. This is useful for inserting styles into iframes.
|