MotionSheet

Een bottom sheet, top sheet of zijlade met stoppunten, zwiepen en scroll-overdracht.

WebReact NativeOverlays

Probeer het

Voorbeeld voorbereiden…

JavaScript staat uit. De code hieronder is het volledige voorbeeld.

App.jsx

import { useState } from 'react';
import { MotionHighlight, MotionSheet } from '@kkwaenggwari/animated-chorus';
import './styles.css';

const sorts = ['Newest', 'Popular', 'Price'];
const sizes = ['XS', 'S', 'M', 'L', 'XL'];
const colors = ['Any', 'Green', 'Sand', 'Ink'];

export default function App({ side = 'bottom', detents = 'two', modal = true }) {
  const [open, setOpen] = useState(false);
  const [sort, setSort] = useState('Popular');
  const [size, setSize] = useState('M');
  const [color, setColor] = useState('Any');

  return (
    <div className="page">
      <header>
        <strong>Shop</strong>
        <button className="open" onClick={() => setOpen(true)}>
          Filters · {sort} · {size}
        </button>
      </header>
      <div className="grid">
        {Array.from({ length: 6 }, (_, index) => (
          <span key={index} className="product" />
        ))}
      </div>
      <MotionSheet
        open={open}
        onOpenChange={setOpen}
        side={side}
        modal={modal}
        detents={detents === 'two' ? [0.55, 0.92] : ['content']}
        className={`sheet ${side}`}
      >
        <span className="handle" />
        {/* The action sits beside the title, so it is in reach at every detent. */}
        <div className="sheet-head">
          <h2>Filters</h2>
          <button className="apply" onClick={() => setOpen(false)}>
            Show results
          </button>
        </div>
        <p className="label">Sort by</p>
        <MotionHighlight
          items={sorts}
          value={sort}
          onValueChange={setSort}
          className="choices"
          itemClassName="choice"
          highlightClassName="choice-on"
        />
        <p className="label">Size</p>
        <MotionHighlight
          items={sizes}
          value={size}
          onValueChange={setSize}
          className="choices"
          itemClassName="choice"
          highlightClassName="choice-on"
        />
        <p className="label">Color</p>
        <MotionHighlight
          items={colors}
          value={color}
          onValueChange={setColor}
          className="choices"
          itemClassName="choice"
          highlightClassName="choice-on"
        />
      </MotionSheet>
    </div>
  );
}

styles.css

.page {
  display: grid;
  gap: 16px;
  min-height: 440px;
  padding: 20px;
  align-content: start;
}

header {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: 10px;
}

header strong {
  font-size: 20px;
  color: #0e2e24;
}

.open {
  min-height: 44px;
  padding: 0 18px;
  border: 0;
  border-radius: 999px;
  background: #176b52;
  color: #fff;
  font:
    650 15px system-ui,
    sans-serif;
  cursor: pointer;
}

.grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 10px;
}

.product {
  aspect-ratio: 1;
  border-radius: 14px;
  background: #eaf6f0;
}

.product:nth-child(3n + 2) {
  background: #cfe8dc;
}

.sheet {
  gap: 10px;
  padding: 12px 22px 22px;
  background: #fff;
  box-shadow: 0 -8px 30px rgba(14, 46, 36, 0.18);
}

.sheet.bottom {
  border-radius: 22px 22px 0 0;
}

.sheet.top {
  border-radius: 0 0 22px 22px;
}

/* A top sheet is pulled from its bottom edge. */
.sheet.top .handle {
  order: 1;
  margin-top: 6px;
}

.sheet.end {
  width: min(340px, 86vw);
  border-radius: 22px 0 0 22px;
}

.handle {
  justify-self: center;
  align-self: center;
  width: 44px;
  height: 5px;
  border-radius: 3px;
  background: #cfe8dc;
}

.sheet-head {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: 8px 12px;
}

.sheet h2 {
  margin: 4px 0 0;
  font:
    750 22px system-ui,
    sans-serif;
  color: #0e2e24;
}

.label {
  margin: 8px 0 0;
  color: #5b616b;
  font-size: 14px;
}

.choices {
  display: flex;
  flex-wrap: wrap;
  gap: 4px;
  padding: 4px;
  border-radius: 14px;
  background: #eaf6f0;
}

.choice {
  min-width: 52px;
  min-height: 40px;
  padding: 0 14px;
  border: 0;
  background: none;
  font:
    600 14px system-ui,
    sans-serif;
  color: #0e2e24;
  cursor: pointer;
}

.choice-on {
  border-radius: 10px;
  background: #fff;
  box-shadow: 0 0 0 1px #cfe8dc;
}

.apply {
  min-height: 44px;
  padding: 0 18px;
  border: 0;
  border-radius: 999px;
  background: #176b52;
  color: #fff;
  font:
    650 15px system-ui,
    sans-serif;
  cursor: pointer;
}

Kortste gebruik

Filters.jsx

<MotionSheet open={open} onOpenChange={setOpen} detents={[0.45, 0.92]}>
  <FilterList />
</MotionSheet>;

Wat het voor je regelt

Volgt slepen, biedt weerstand voorbij het grootste stoppunt en komt tot rust met je loslaatsnelheid; een zwiep verplaatst één stoppunt of sluit.
Touch-slepen gaat over op scrollbare inhoud: naar beneden trekken scrolt de inhoud eerst terug naar boven voordat de sheet beweegt.
Stoppunten als fracties van het scherm, pixels of 'content' voor de natuurlijke grootte van de inhoud.
Een modale sheet houdt de focus binnen, maakt de pagina inert en sluit met Escape of de achtergrond.

Gebruik het voor

Een filterpaneel.
Een deelmenu.
Een navigatielade met side="start".

Props

Prop	Type	Standaard	Beschrijving
`open`	`boolean`	`false`	Of de sheet wordt getoond.
`onOpenChange`	`(open) => void`		Draait met `false` als de sheet dichtgesleept, -getikt of met Escape gesloten wordt.
`detents`	`(number \| 'content')[]`	`['content']`	Rustgroottes: een fractie van het scherm, pixels of `'content'`.
`detent`	`number`		Gecontroleerde stoppuntindex.
`defaultDetent`	`number`	`0`	Stoppuntindex bij openen zonder `detent`.
`onDetentChange`	`(index) => void`		Draait met de index van het stoppunt waar de sheet tot rust komt.
`side`	`'bottom' \| 'top' \| 'start' \| 'end'`	`'bottom'`	De rand waar de sheet vandaan komt.
`modal`	`boolean`	`true`	Voegt een achtergrond toe, houdt de focus binnen en maakt de pagina inert.
`dismissible`	`boolean`	`true`	Voorbij het kleinste stoppunt slepen, de achtergrond en Escape sluiten hem.
`backdropClassName`	`string`		Class voor de achtergrond; `backdropStyle` zet de inline style.
`transition`	`Transition`	`spring`	Een timingcurve `{ duration, easing }` of een veer `{ tempo: 'spring', spring }`. Veren behouden hun momentum als ze worden onderbroken.

Andere props gaan naar het gerenderde element, dus className, style en event handlers werken zoals gewoonlijk.

Web en React Native

Op het web is een modale sheet een native dialog; het paneel is een flexkolom die je stijl geeft met className.

In React Native rendert hij in een transparante Modal en sluit de terugknop hem. Binnenste ScrollViews houden hun eigen gebaren, dus de sheet sleep je aan de greep, de header en andere vaste delen.

Gebruikt in deze voorbeelden

FotofeedVeeg door foto's, spring via miniaturen, open elke foto op volledig scherm en trek de details omhoog.MotionPagerMotionHighlightMotionZoomMotionSheet