Skip to content

useSSRWidth ​

Category
Export Size
Last Changed
6 hours ago

Used to set a global viewport width which will be used when rendering SSR components that rely on the viewport width like useMediaQuery or useBreakpoints

Usage ​

js
import { provideSSRWidth } from '@vueuse/core'

const app = createApp(App)

provideSSRWidth(500, app)

Or in the root component

vue
<script setup>
import { provideSSRWidth } from '@vueuse/core'

provideSSRWidth(500)
</script>

To retrieve the provided value if you need it in a subcomponent

vue
<script setup>
import { useSSRWidth } from '@vueuse/core'

const width = useSSRWidth()
</script>

Type Declarations ​

typescript
export declare function useSSRWidth(): number | undefined
export declare function provideSSRWidth(
  width: number | null,
  app?: App<unknown>,
): void

Source ​

Source • Docs

Contributors ​

Adrien Foulon

Changelog ​

v12.1.0 on 12/22/2024
55965 - feat: add optional support for SSR in useMediaQuery and useBreakpoints (#4317)

Released under the MIT License.