インターフェースをより良く感じさせるディテール
優れたインターフェースが単一の要素から生まれることはほとんどありません。それは通常、小さなディテールの集まりが積み重なって素晴らしい体験を生み出します。UIコードを構築またはレビューする際には、これらの原則を適用してください。
レビュー時には、インターフェースの動作を遅くしてください。ブラウザのアニメーションパネルで動きを10%の速度で再生し、すべての状態(ホバー、フォーカス、アクティブ、ローディング、空)を確認してください。10%の速度で違和感があるものは、フルスピードでは微妙に間違っているものです。
プロジェクトのコンポーネントライブラリ、トークン、密度を維持してください。以下の原則で正確なインタラクションパターンが規定されている場合を除き、プロジェクトの確立されたモーション言語に合わせてください。
タイポグラフィ(テキスト折り返し、フォントレンダリング、タブラーニュメラル、スペーシング)は better-typography スキルでカバーされています。テキスト関連の作業にはそちらを使用してください。アクセシビリティ(ヒットエリア、フォーカス状態、キーボードサポート、ARIA、モーション軽減)は better-accessibility スキルでカバーされています。レイアウト構造(グループ化、セクション間のスペーシング、ブレークポイント、空間的なRTL)は better-layout スキルでカバーされています。
クイックリファレンス
| カテゴリ | 使用するタイミング |
|---|---|
| サーフェス | ボーダー半径、光学的配置、シャドウ、画像の輪郭線 |
| アニメーション | 割り込み可能なアニメーション、入場/退場トランジション、アイコンアニメーション、押下時のスケール、モーションの抑制 |
| アイコン | アイコンのストローク幅、currentColor による状態、アウトライン vs 塗りつぶし、サイズ調整、RTL反転 |
| パフォーマンス | トランジションの特異性、will-change の使用法 |
コア原則
1. 同心円状のボーダー半径
外側の半径 = 内側の半径 + パディング。ネストされた要素の半径が一致しないことは、インターフェースが違和感を感じさせる最も一般的な原因です。
2. 幾何学的配置より光学的配置
幾何学的な中央揃えが違和感がある場合は、光学的に調整します。アイコン付きのボタン、再生トライアングル、非対称なアイコンはすべて手動調整が必要です。
3. 奥行きにはシャドウ、構造にはボーダー
奥行きを作るためだけにボーダーが存在するボタン、カード、コンテナには、透明な box-shadow の値を重ねて使用することを推奨します。構造や状態を伝えるボーダー(区切り線、レイアウトのセパレーター、選択状態やフォーカス状態)は維持してください。
4. 割り込み可能なアニメーション
インタラクティブな状態変化にはCSSトランジションを使用します。これらはアニメーションの途中で割り込むことができます。キーフレームは、一度だけ実行される段階的なシーケンスのために予約してください。
5. 入場アニメーションの分割とタイムラグ
シーケンスが階層を伝えるのに役立つ、頻度の低い段階的な入場の場合、コンテンツを意味のあるチャンクに分割し、1つのコンテナをアニメーションする代わりに約100msずつタイムラグを設けてください。日常的で高頻度のインタラクションにはタイムラグを設定しないでください。
6. 控えめな退場アニメーション
完全な高さではなく、小さな固定の translateY を使用してください。退場は入場よりもソフトであるべきです。入場と退場の両方のトランジションに ease-out を使用してください。
7. コンテキストに応じたアイコンアニメーション
可視性をトグルする代わりに、opacity、scale、blur でアイコンをアニメーションします。正確に次の値を使用してください:スケールは 0.25 から 1、透明度は 0 から 1、ぼかしは 4px から 0px。プロジェクトの package.json に motion または framer-motion がある場合は、そのパッケージのインポートパス(両方存在する場合は確立された近くのインポート)に一致させ、transition: { type: "spring", duration: 0.3, bounce: 0 } を使用してください。bounce は常に 0 でなければなりません。モーションライブラリがインストールされていない場合は、両方のアイコンをDOMに保持し(1つは絶対配置)、cubic-bezier(0.2, 0, 0, 1) を使用したCSSトランジションでクロスフェードしてください。これにより、依存関係なしで入場と退場の両方のアニメーションが得られます。
8. 画像の輪郭線
一貫した奥行きのために、低い不透明度で微妙な 1px の輪郭線を画像に追加します。色はライトモードでは純粋な黒 (oklch(0 0 0 / 0.1))、ダークモードでは純粋な白 (oklch(1 0 0 / 0.1)) でなければなりません。スレート、ジンク、または着色されたニュートラルなど、ほぼ黒の色は決して使用しないでください。着色された輪郭線はその下のサーフェス色を拾い、画像の端に汚れのように見えます。
9. 押下時のスケール
クリック時の微妙な scale(0.96) は、ボタンに触覚的なフィードバックを与えます。常に 0.96 を使用してください。0.95 より小さい値は決して使用しないでください。それ以下は大げさに見えます。動きが気を散らす場合に無効にするための static プロパティを追加してください。
10. ページロード時のアニメーションスキップ
AnimatePresence で initial={false} を使用して、最初のレンダリング時の入場アニメーションを防止します。意図的な入場アニメーションを壊さないことを確認してください。
11. transition: all を決して使用しない
常に正確なプロパティを指定します:transition-property: scale, opacity。Tailwind の transition-transform は transform, translate, scale, rotate をカバーします。
12. will-change は控えめに使用する
GPUがコンポジットできるプロパティ(transform、opacity、filter)に対してのみ使用します。will-change: all は決して使用しないでください。最初のフレームでスタッターに気づいた場合にのみ追加してください。
13. アイコンのストロークをテキストの太さに合わせる
テキストの隣にあるアイコンは、テキストの視覚的な重みを継承します。通常(400)のテキストの隣では 1.5px ストローク、セミボールド(600)の隣では 2px ストローク。アイコンセットごとに1つのストローク幅。1つのサーフェス上でライブラリを混ぜないでください。
14. 1つのSVG、状態ごとに色替え
アイコンは currentColor を使用し、ホバー、選択、無効などの状態を別々のアセットではなく、CSSの色と不透明度から取得します。アウトライン variant がデフォルトで、塗りつぶし variant がアクティブ状態を示します。
15. モーションの抑制
高頻度なインタラクションにはカスタムアニメーションは使用しないでください。トリガーごとに注意コストが繰り返されます。モーションは決して唯一のフィードバックチャネルではありません。アニメーション化されたすべての状態変化には、静的な手がかり(色、アイコン、ラベル)も必要です。
よくある間違い
| 間違い | 修正 |
|---|---|
| 密接にネストされた親子に同じボーダー半径 | outerRadius = innerRadius + padding を計算 |
| アイコンが中央からずれて見える | パディングで光学的に調整するか、SVGを直接修正 |
| 高さを偽装するためだけに使用されたボーダー | 透明な box-shadow を重ねて使用、構造と状態のボーダーは維持 |
| 場違いな段階的入場またはコンテキストを壊す退場 | 頻度の低い入場にはタイムラグを設定し、コンテキストを維持する退場は控えめに |
| ステートフルアイコンまたはトグルがページロード時にデフォルト状態をアニメーション | 該当する AnimatePresence に initial={false} を追加、意図的なページ入場は維持 |
要素に対する transition: all | 正確なプロパティを指定 |
| 最初のフレームのアニメーションスタッター | will-change: transform を追加(控えめに) |
| 太字テキストの隣のヘアラインアイコン | ストローク幅をテキストの太さに合わせる |
| 状態ごとに別々のアイコンアセット | 1つの currentColor SVG、状態はCSSで |
| すべての場所で塗りつぶしアイコン | デフォルトはアウトライン、アクティブ状態のみ塗りつぶし |
| すべてのホバーまたはキーストロークで入場アニメーション | 即時フィードバック、または ≤150ms の opacity/color トランジション |
レビュー出力フォーマット
このフォーマットは、ユーザーがスタンドアロンのUIポリッシュレビューを明示的に要求した場合にのみ使用してください。better-interface がレビューを調整する場合は、そのスキルにドメインの証拠と発見事項を提供し、その出力フォーマット、重大度スケール、統合ルール、上限、評決を優先させてください。
スタンドアロンレビューは2つのパートで提示します。
発見事項
確認されたすべての発見事項を原則ごとにグループ化します。重要度、場所、変更前、変更後、理由 の列を持つマークダウンテーブルを使用してください。「変更前:」/「変更後:」の行を個別に使用しないでください。
- 重要度:
HIGHはインタラクションを誤解させたり、応答性を損なったり、繰り返し混乱させるもの。MEDIUMは顕著な技術的または一貫性の問題を引き起こすもの。LOWは孤立したポリッシュの問題。 - 場所:
path/to/file:lineを引用。アーティファクトにソースファイルがない場合は、正確な画面とコンポーネントを代わりに引用。 - 変更前 / 変更後: 現在の実装と実行可能な置き換えを示します。
- 理由: 違反された原則の名前と、それがインターフェースにどのように影響するかを説明。
繰り返されるシステム上の問題は1行に統合し、影響を受けるすべての場所をリストアップします。発見事項のない原則は省略します。
例
同心円状のボーダー半径
| 重要度 | 場所 | 変更前 | 変更後 | 理由 |
|---|---|---|---|---|
| LOW | src/Card.tsx:28 | カードに rounded-xl + 内側ボタン(p-2)に rounded-xl | カードに rounded-2xl(8 + 8 = 16)、内側ボタンに rounded-lg | ネストされた角は同心円状であるべき |
| LOW | src/card.css:11 | 両方のネストされたサーフェスに border-radius: 16px | 外側 24px、内側 16px(パディング 8px) | 同じネスト半径は内側のサーフェスを窮屈に見せる |
押下時のスケール
| 重要度 | 場所 | 変更前 | 変更後 | 理由 |
|---|---|---|---|---|
| LOW | src/Button.tsx:19 | <button className="..."> | active:scale-[0.96] transition-transform を追加 | 押下フィードバックによりコントロールが応答的に感じられる |
| MEDIUM | src/button.css:24 | 押下時に scale(0.9) | scale(0.96) に引き上げ | 0.95 以下は大げさに感じられる |
検証と評決
発見事項の後:
- 検証: 実行した正確なチェックとその観察結果をリストアップします。関連するすべての状態を確認し、アニメーションが関係する場合は10%の速度でモーションを検査します。チェックが実行されなかった場合は、まだ検証が必要なものを記載します。
- 評決:
HIGHの発見事項が残っている場合はBlock、MEDIUMまたはLOWの発見事項のみ残っている場合はNeeds changes、実行可能な発見事項がなくなった場合のみApprove。
発見事項がない場合は、テーブルを省略し、「実行可能なUIポリッシュ発見事項はありません」と記載し、検証を報告し、Approve で終了します。