Reveal
画面に入ったときに一度だけ、下から少し浮かせて表示します。トップページの問いかけ(S02)や原則(S05)のように、文を読む順に見せたいところで使います。
使い方
tsx
import { Reveal } from '@under18dev/ui'
<Reveal as="p" className="u18-type-lead">
でも、何かを始めようとすると、こんな言葉に出会う。
</Reveal>Split・Statement・CallToAction は中で Reveal を使っているので、包み直す必要はありません。
動かすための条件
Reveal が要素を隠して演出するのは、<html> に data-motion が付いているときだけです。data-motion は ThemeScript が、動きを減らす設定でないときに付けます。ThemeScript を置いていないページや、動きを減らす設定のときは、最初から表示したままになります。
tsx
<head>
<ThemeScript />
</head>ほかにも、次のときは隠しません。
- JS が動かないとき。要素を隠す CSS は、JS が動いて
<html>にdata-reveal-readyが付いてから効きます。 - 最初に描いた時点で画面の中にある要素。隠してから出し直すとちらつくためです。
一度表示した要素は、上に戻ってスクロールし直しても隠しません(design.md §9.3)。
例
要素を変える
as で描く要素を変えます。標準は <div> です。className や style などの属性はそのまま渡ります。
順番にずらす
index に同じまとまりの中での順番を渡すと、100ms ずつ遅らせて表示します。ずらすのは3つ(0〜2)までにします。最初のデモでは、3行を 0・1・2 でずらしています。
演出しない
disabled を付けると、ふつうの要素として描きます。一覧の件数が多いときなど、演出が読む邪魔になるところで使います。
Props
| Prop | 型 | 既定値 | 説明 |
|---|---|---|---|
as | ElementType | 'div' | 描く要素 |
index | number | 0 | 同じまとまりの中での順番(0〜2)。100ms ずつ遅らせる |
disabled | boolean | false | 演出しない |
そのほかの属性(className、style、id、aria-*、data-* など)は、そのまま描く要素に渡します。
アクセシビリティ
- 動かすのは
opacityとtransformだけです。表示の途中でもクリック、Tab での移動、文字の選択ができます。 - 画面に入ったかの判定には、ページで1つの IntersectionObserver を使います。