@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/> component to override the default cache, which is created with sensible defaults for most applications.

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 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.

`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. 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.

`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.

`prepend`

boolean

A string representing whether to prepend rather than append style tags into the specified container DOM node.

Current Tags

11.13.1 ... latest (4 months ago)
11.0.0-next.19 ... next (4 years ago)
11.0.0-rc.0 ... rc (4 years ago)
10.0.0-really-unsafe-please-do-not-use.2 ... really-unsafe-please-do-not-use (6 years ago)

77 Versions

11.13.1 ... 4 months ago
11.13.0 ... 4 months ago
11.12.0 ... 4 months ago
11.11.0 ... 2 years ago
11.10.8 ... 2 years ago
11.10.7 ... 2 years ago
11.10.5 ... 2 years ago
11.10.3 ... 2 years ago
11.10.2 ... 2 years ago
11.10.1 ... 2 years ago
11.10.0 ... 2 years ago
11.9.3 ... 2 years ago
11.7.1 ... 3 years ago
11.6.0 ... 3 years ago
11.5.0 ... 3 years ago
11.4.0 ... 4 years ago
11.1.3 ... 4 years ago
11.0.0 ... 4 years ago
11.0.0-rc.0 ... 4 years ago
11.0.0-next.19 ... 4 years ago
11.0.0-next.18 ... 4 years ago
11.0.0-next.16 ... 4 years ago
11.0.0-next.15 ... 4 years ago
11.0.0-next.13 ... 4 years ago
11.0.0-next.12 ... 5 years ago
10.0.29 ... 5 years ago
11.0.0-next.10 ... 5 years ago
10.0.27 ... 5 years ago
11.0.0-next.6 ... 5 years ago
11.0.0-next.0 ... 5 years ago
10.0.19 ... 5 years ago
10.0.17 ... 5 years ago
10.0.15 ... 5 years ago
10.0.14 ... 5 years ago
10.0.9 ... 6 years ago
10.0.8 ... 6 years ago
10.0.7 ... 6 years ago
10.0.0 ... 6 years ago
10.0.0-beta.13 ... 6 years ago
10.0.0-beta.12 ... 6 years ago
10.0.0-beta.11 ... 6 years ago
10.0.0-beta.10 ... 6 years ago
10.0.0-beta.9 ... 6 years ago
10.0.0-beta.8 ... 6 years ago
10.0.0-beta.7 ... 6 years ago
10.0.0-beta.6 ... 6 years ago
10.0.0-beta.5 ... 6 years ago
10.0.0-beta.4 ... 6 years ago
10.0.0-beta.3 ... 6 years ago
10.0.0-beta.2 ... 6 years ago
10.0.0-beta.1 ... 6 years ago
10.0.0-beta.0 ... 6 years ago
10.0.0-really-unsafe-please-do-not-use.2 ... 6 years ago
10.0.0-really-unsafe-please-do-not-use.1 ... 6 years ago
10.0.0-really-unsafe-please-do-not-use.0 ... 6 years ago
0.8.8 ... 6 years ago
0.8.7 ... 6 years ago
0.8.6 ... 6 years ago
0.8.5 ... 6 years ago
0.8.4 ... 6 years ago
0.8.3 ... 6 years ago
0.8.2 ... 6 years ago
0.8.1 ... 6 years ago
0.8.0 ... 7 years ago
0.7.1 ... 7 years ago
0.7.0 ... 7 years ago
0.6.5 ... 7 years ago
0.6.4 ... 7 years ago
0.6.3 ... 7 years ago
0.6.2 ... 7 years ago
0.6.0 ... 7 years ago
0.5.0 ... 7 years ago
0.4.1 ... 7 years ago
0.4.0 ... 7 years ago
0.2.3 ... 7 years ago
0.2.1 ... 7 years ago
0.2.0 ... 7 years ago