---
url: "https://vueda.dev/v3/reference/api/js/use/useScrollReveal/types/ScrollRevealStrategy.md"
title: "ScrollRevealStrategy"
---

# ScrollRevealStrategy

## Overview

`always`: never hides. `hidden` stays `false` regardless of scroll position.
- `scroll-up`: hides once the element's original position has scrolled out of view and stays
  hidden until the user scrolls up. No idle reveal, so it does not pop back when the user pauses
  to read; suited to the space-reclaiming toolbar tier.
- `scroll-up-or-idle`: like `scroll-up`, but also reveals after scrolling pauses for `idleDelay`
  milliseconds. Suited to a submit / action bar the user should be able to return to quickly.

A `reveal` that resolves to a boolean instead of one of these strings hands visibility control
back to the caller entirely: `true` means revealed (`hidden` is `false`), `false` means hidden.
Pass a boolean ref/getter (typically a `computed`) to drive show/hide from the view's own logic;
in that mode scroll position is ignored.

## Type

`ScrollRevealStrategy = "always" | "scroll-up" | "scroll-up-or-idle"`

## Source

`client/lib/use/useScrollReveal.js:14`