useStyleTag ​
Inject reactive style element in head.
Demo ​
Usage ​
Basic usage ​
Provide a CSS string, then useStyleTag will automatically generate an id and inject it in <head>.
js
import { useStyleTag } from '@vueuse/core'
const {
id,
css,
load,
unload,
isLoaded,
} = useStyleTag('.foo { margin-top: 32px; }')
// Later you can modify styles
css.value = '.foo { margin-top: 64px; }'This code will be injected to <head>:
html
<style id="vueuse_styletag_1">
.foo {
margin-top: 64px;
}
</style>Custom ID ​
If you need to define your own id, you can pass id as first argument.
js
import { useStyleTag } from '@vueuse/core'
useStyleTag('.foo { margin-top: 32px; }', { id: 'custom-id' })html
<!-- injected to <head> -->
<style id="custom-id">
.foo {
margin-top: 32px;
}
</style>Media query ​
You can pass media attributes as last argument within object.
js
useStyleTag('.foo { margin-top: 32px; }', { media: 'print' })html
<!-- injected to <head> -->
<style id="vueuse_styletag_1" media="print">
.foo {
margin-top: 32px;
}
</style>Type Declarations ​
typescript
export interface UseStyleTagOptions extends ConfigurableDocument {
/**
* Media query for styles to apply
*/
media?: string
/**
* Load the style immediately
*
* @default true
*/
immediate?: boolean
/**
* Manual controls the timing of loading and unloading
*
* @default false
*/
manual?: boolean
/**
* DOM id of the style tag
*
* @default auto-incremented
*/
id?: string
}
export interface UseStyleTagReturn {
id: string
css: Ref<string>
load: () => void
unload: () => void
isLoaded: Readonly<Ref<boolean>>
}
/**
* Inject <style> element in head.
*
* Overload: Omitted id
*
* @see https://vueuse.org/useStyleTag
* @param css
* @param options
*/
export declare function useStyleTag(
css: MaybeRef<string>,
options?: UseStyleTagOptions,
): UseStyleTagReturnSource ​
Contributors ​
Anthony Fu
sibbng
James Wragg
mrayi
Jelf