v1.1 to v1.1

1 added, 1 removed. Audit B to B.

---

name: sites-ux-interaction

- description: Padrões de UX e interação para websites — header sticky, nav mobile, micro-interações, animações de entrada e scroll-triggered. Use ao implementar navegação, hover states, animações com Motion ou comportamento de scroll em Next.js ou Astro.

+ description: "Padrões de UX e interação para websites — header sticky, nav mobile, micro-interações, animações de entrada e scroll-triggered. Use ao implementar navegação, hover states, animações com Motion ou comportamento de scroll em Next.js ou Astro."

version: "1.1"

updated: "2026-09-20"

---

# Sites UX Interaction — Padrões de Interação

## Navegação

### Header sticky

```tsx

const [scrolled, setScrolled] = useState(false)

useEffect(() => {

const handleScroll = () => setScrolled(window.scrollY > 20)

window.addEventListener('scroll', handleScroll, { passive: true })

return () => window.removeEventListener('scroll', handleScroll)

}, [])

<header className={cn(

"fixed top-0 w-full z-50 transition-all duration-300",

scrolled ? "bg-white/95 backdrop-blur shadow-sm" : "bg-transparent"

)}>

```

**Astro nativo** (sem hooks — `<script>` roda uma vez no client, escopado ao componente):

```astro

const header = document.getElementById('site-header')

const onScroll = () => header?.classList.toggle('scrolled', window.scrollY > 20)

window.addEventListener('scroll', onScroll, { passive: true })

</script>

```

### Mobile nav (Sheet)

```tsx

<Sheet>

</Button>

</SheetTrigger>

</Sheet>

```

**Em Astro**, duas opções — escolher conforme o projeto já tiver React instalado ou não:

- **Nativo, sem framework:** `<details>`/`<summary>` com CSS, zero JS enviado ao navegador.

- **Ilha React do `Sheet` acima**, hidratada só no breakpoint mobile: `<Sheet client:media="(max-width: 768px)">…</Sheet>` — vale quando o projeto já usa React em outras ilhas e não compensa reescrever o componente em CSS puro.

## Animações com Motion (`motion/react`, ex-Framer Motion)

### Enter animations

```tsx

// Fade in up (elemento)

<motion.div initial={{ opacity: 0, y: 24 }} animate={{ opacity: 1, y: 0 }} transition={{ duration: 0.4 }}>

// Stagger em lista

<motion.div variants={{ animate: { transition: { staggerChildren: 0.1 } } }} initial="initial" animate="animate">

{items.map(item => <motion.div key={item} variants={fadeInUp}>{item}</motion.div>)}

</motion.div>

```

### Scroll-triggered (Intersection Observer)

```tsx

const { ref, inView } = useInView({ threshold: 0.1, triggerOnce: true })

<motion.div ref={ref} initial={{ opacity: 0 }} animate={inView ? { opacity: 1 } : {}} />

```

**Em Astro**, sem Motion/hooks, o equivalente nativo é `IntersectionObserver` puro + classes CSS (ver

`/sites-scroll-motion` Seção 2 para o padrão completo). Quando o projeto já usa React em outras ilhas e

precisa da física do Motion (spring, stagger), o componente acima vira uma ilha com `client:visible` —

a API do Motion não muda, só a forma como ela é hidratada.

## Micro-interações

```css

/* Hover em card */

.card { @apply transition-all duration-200 hover:-translate-y-1 hover:shadow-lg; }

/* Button press */

.btn { @apply active:scale-95 transition-transform duration-100; }

/* Link underline animado */

.link { @apply relative after:absolute after:bottom-0 after:left-0 after:h-0.5 after:w-0 after:bg-current hover:after:w-full after:transition-all after:duration-300; }

```

## Reduced motion

Em App Router/SSR, `window` não existe no servidor — nunca chamar `matchMedia` no corpo do componente. Ler dentro de `useEffect` (ou usar o hook `useReducedMotion` do `motion/react`):

```tsx

const [prefersReducedMotion, setPrefersReducedMotion] = useState(false)

useEffect(() => {

const mq = window.matchMedia('(prefers-reduced-motion: reduce)')

setPrefersReducedMotion(mq.matches)

const onChange = (e: MediaQueryListEvent) => setPrefersReducedMotion(e.matches)

mq.addEventListener('change', onChange)

return () => mq.removeEventListener('change', onChange)

}, [])

const transition = prefersReducedMotion ? { duration: 0 } : { duration: 0.4 }

```

**Astro nativo:** sem `useEffect` (não existe em `.astro`) e sem re-render para gerenciar — o `<script>`

roda uma vez no load:

```astro

const mq = matchMedia('(prefers-reduced-motion: reduce)')

document.documentElement.classList.toggle('reduce-motion', mq.matches)

</script>

```

mais simples que a versão Next porque não há hidratação de UI para sincronizar.