usePreferredReducedTransparency

Category

Browser

Export Size

1.22 kB

Last Changed

3 months ago

Reactive prefers-reduced-transparency media query.

Demo

sourceplayground (beta)

Preferred Transparency:

no-preference

Usage

import { usePreferredReducedTransparency } from '@vueuse/core'

const preferredTransparency = usePreferredReducedTransparency()

Component Usage

This function also provides a renderless component version via the @vueuse/components package. Learn more about the usage.

<template>
  <UsePreferredReducedTransparency v-slot="{ transparency }">
    Preferred Reduced transparency: {{ transparency }}
  </UsePreferredReducedTransparency>
</template>

Type Declarations

export type ReducedTransparencyType = "reduce" | "no-preference"
/**
 * Reactive prefers-reduced-transparency media query.
 *
 * @see https://vueuse.org/usePreferredReducedTransparency
 * @param [options]
 *
 * @__NO_SIDE_EFFECTS__
 */
export declare function usePreferredReducedTransparency(
  options?: ConfigurableWindow,
): ComputedRef<ReducedTransparencyType>

Source

Source • Demo • Docs

Contributors

SerKo

huiliangShen

Changelog

v13.6.0 on 7/28/2025

d32f8 - refactor: add @__NO_SIDE_EFFECTS__ annotations to all pure functions (#4907)

v12.2.0-beta.1 on 12/23/2024

34cd7 - feat: add new function (#4201)