この記事の内容
コンポーネントの見た目、サイズ、状態、構造を切り替えるなら、バリアントを使います。既存のレイヤーを表示・非表示にするだけなら、Boolean(真偽値)の表示プロパティを使います。 選択肢の数だけでは決められません。通常と無効の2状態しかないボタンでも、複数の見た目の属性が一緒に変わるなら、バリアントが適しています。
使いやすいコンポーネントライブラリでは、これらを組み合わせます。Pixsoのデザインシステムでは、意味のあるデザインの違いをバリアントで表し、任意の要素はレイヤーの表示プロパティで操作できるようにします。ラベルや入れ子のコンポーネントを変える場合は、TextまたはInstanceプロパティを使います。目指すのは、利用者が正しく設定でき、重複したバージョンの保守を減らせるコンポーネントです。

1. バリアントとBooleanの表示制御を整理する
バリアントは、コンポーネントセット内にある、異なる仕様のコンポーネントです。プライマリとセカンダリのボタン、大小のサイズ、通常と無効の見た目などを、バリアントの選択肢として表せます。それぞれのバリアントには、重複しないプロパティ値の組み合わせを割り当てます。
Booleanはtrueまたはfalseの値です。レイヤーの表示に使う場合は、既存の子レイヤーを表示するかどうかを制御します。先頭アイコンの有無だけなら、それぞれに別のボタンバリアントを作る必要はありません。レイヤーを非表示にしても、そのレイヤー自体が削除されるわけではありません。

どちらのプロパティも、それだけで性能を改善するものではありません。バリアントを減らせばデザイン作業の重複は減らせますが、非表示レイヤー、入れ子のインスタンス、エフェクト、画像など、ファイル内のほかの要素も影響します。まず保守する定義の数を数え、速度やファイルサイズが改善したと判断する前に、遅いと感じる具体的な操作を測定してください。
2. Pixsoで適切なレイヤーにプロパティを設定する
Pixsoのコンポーネントガイド(英語)では、Variant、Layer、Instance、Textの4種類を区別しています。この記事でBooleanによる表示制御と呼んでいるのは、Layerプロパティです。プロパティは、実際に変更するオブジェクトに設定します。子要素と関連付けずに親へすべての操作項目を置いても、意図した動作は定義できません。
- ボタンの選択肢を定義します。 メインコンポーネントまたはコンポーネントセットで、
sizeやstateなどの名前付きバリアントプロパティを作ります。各バリアントに一意の値の組み合わせを割り当てます。 - 任意のアイコンを操作できるようにします。 メインコンポーネント内の先頭アイコンの子レイヤーを選択します。Layer欄のプロパティ操作から
showLeadingIconという名前を付け、初期状態で表示するかどうかを決めます。 - 表示と差し替えを分けます。 共同編集者が別のアイコンを選ぶ必要がある場合は、入れ子になったアイコンのインスタンスにInstanceプロパティを設定します。アイコンを表示するか、どのアイコンを使うかは別の判断です。
- ラベルを編集できるようにします。 ボタンのラベルにはTextプロパティを使います。「保存」「変更を保存」「招待を送信」という文言の違いだけでバリアントを増やさないようにします。
- インスタンスで確認します。 アイコンの表示切り替え、アイコンの差し替え、ラベルの編集、サイズや状態の切り替えを試します。変更するたびに余白とテキストの折り返しを確認します。
公式ガイドは、プロトタイプでの制約も説明しています。表示プロパティを設定しても、インタラクションの状態として接続できる別々のオブジェクトが2つ生成されるわけではありません。プロトタイプに異なる接続先が必要なら、その対象を明示的に用意します。プロパティパネルとプロトタイプのフローは関連していますが、担う役割は異なります。
3. 変更の種類からプロパティを選ぶ
実際に何が変わるのかを出発点にします。「選択肢が2つならBoolean」という考え方は、有効・無効の見た目や、コンパクト・ゆったりしたサイズのように、複数の属性が変わる二択には当てはまりません。
| 要件 | 検討するプロパティ | 理由と確認事項 |
|---|---|---|
| 先頭アイコンを表示・非表示にする | Layerの表示制御/Boolean | 同じ任意の子要素を表示・非表示にします。残ったラベルの余白を確認します。 |
| プライマリ、セカンダリ、ゴーストのスタイルを切り替える | Variant(バリアント) | 塗り、枠線、テキストの見た目が一緒に変わります。 |
| 通常、ホバー、押下、無効の見た目を切り替える | Variant(バリアント) | 複数の属性を連動させる視覚的な状態は、1つのレイヤーを隠すだけでは表せません。 |
| モーダルの任意の閉じるボタンを表示する | Layerの表示制御/Boolean | 許可する各設定で、ダイアログを閉じる、または操作を完了する方法が明確に残っている場合に限ります。 |
| ダウンロードアイコンを矢印に差し替える | Instance(インスタンス) | 配置枠はそのままで、入れ子のコンポーネントを変更します。 |
| 「保存」を「変更を保存」に変える | Text(テキスト) | 変わるのは内容です。新しいバリアントを作らずに、長いラベルで表示を確認します。 |

関連していても異なる概念は分けて考えます。読み込み中のボタンには、スピナー、幅の維持、ラベルの変更、重複送信の防止が必要かもしれません。スピナーの表示はBooleanで制御できますが、その切り替えだけでは読み込み中の動作は決まりません。許可する読み込み状態と、それに応じて変わる操作部品を定義してください。
4. 192個から48個へ減らす例を検証する
ボタンライブラリに3種類のサイズ、4種類の配色スタイル、4種類の視覚的な状態があるとします。すべての組み合わせが有効なら、基本となるバリアントは3 × 4 × 4 = 48個です。さらに、アイコンなし、先頭のみ、末尾のみ、両方を別のバリアントとして作ると、4倍の48 × 4 = 192個になります。
独立した2つの表示プロパティを使えば、48個の基本バリアントのそれぞれで、4通りのアイコン構成を表せます。先頭と末尾のアイコンを、それぞれ表示・非表示にする仕組みです。この例では、重複するコンポーネント定義を144個減らせます。ただし、レイヤーそのものを144個削除するという意味ではなく、ファイルが75%小さくなることや、描画性能が改善することを実測で示した結果でもありません。

製品で実際に使う組み合わせから始めます。危険な操作にはゴーストスタイルを使わない、特定のサイズは対応しない、といった要件があるなら、全組み合わせを作ることが目標ではありません。あらゆる組み合わせを作って禁止事項をデザイナーの記憶に頼るのではなく、許可する組み合わせを記録してください。
実用的な確認として、中サイズのプライマリボタンに「変更を保存」というラベルを設定します。アイコンなし、先頭のみ、末尾のみ、両方を試し、小サイズとさらに長いラベルにも切り替えます。先頭アイコンを消した後に空白が残るなら、レイアウトを修正します。両側のアイコンでラベルが窮屈になるなら、内側の余白を調整するか、その組み合わせを制限します。クリック対象には独自のサイズ指定も必要です(英語)。アイコンを隠したことで、意図せず操作領域が小さくならないようにします。
反対に、Booleanを増やしすぎても問題になります。プロフィール、商品、記事という関係のないレイアウトを、非表示の分岐として1つのカードに詰め込むと、構成が理解しにくくなります。内容や動作に共通した構造がなくなったら、コンポーネントの系統を分けます。インスタンスの設定が手探りになるなら、最上位のバリアント数を減らしても役に立ちません。
5. デザインとコードの対応を開発者と決める
開発者は通常、図ごとに別のコンポーネントを書くのではなく、プロパティを持つ再利用可能なボタンを実装します。デザイン側のsize=largeなどの選択肢をコードのプロパティに対応させたり、任意のアイコンをBoolean、スロット、省略可能な値で表したりできます。ただし、すべてのデザイン操作が同名のコードのpropになると決めつけず、実際のAPIを開発者と合意してください。

state="hover"というpropではなく、操作に応じたスタイルとして実装されることがよくあります。コンポーネントのそばに、対応するサイズ値、初期スタイル、アイコンスロットの渡し方、無効状態の意味、読み込み中の動作を記します。「ラベルを隠す」という操作で、名前のないアイコンだけの操作部品ができてしまわないようにします。アイコンのみのボタンを許可するなら、その形状、操作領域、アクセシブルな名前の要件を明示的な設定として定義します。
デザインのプロパティは仕様を整理するためのものです。それだけで、本番コードの意味付け、キーボード操作、イベント処理が意図どおりだと証明することはできません。対応付けを完了したと判断する前に、実装済みのインスタンスを1つ、合意した仕様と照合してください。
6. 利用中の画面を壊さずに既存ライブラリを整理する
確認するのは3点です。無関係なレイアウトが巨大な1つのコンポーネントに隠れていないか、単純な任意レイヤーが多数のバリアントで重複していないか、プロパティ名が不統一になっていないか。古いセットをすぐ削除するのではなく、この確認を小規模な移行につなげます。
- 使用中の設定を一覧にします。 代表的な画面を調べ、現在のプロパティ値、ラベル、アイコンの上書き設定を記録します。長いラベルと無効状態も含めます。
- 現在のコンポーネントを残して置き換え版を作ります。 可能な限り既存の命名を維持します。
showLeadingIconなどの名前を一貫して使い、アイコンを差し替えるプロパティと区別します。 - 同じインスタンスを再現します。 アイコン非表示時の余白、ラベルの折り返し、入れ子の差し替え、寸法、フォーカス時の見た目を比較します。対応できない組み合わせは、コンポーネントを配布する前に解消します。
- チームでライブラリの更新を確認します。 古い設定が新しいどの値に対応するのかを記録します。代表的な利用画面の確認が済むまで、復元可能なコピーを残します。
性能改善が変更の目的なら、同じファイルと操作について、変更前後を近い条件で比較します。ファイルを開く、インスタンスを挿入する、プロパティを変更する、という操作は別々に観察します。改善した点としなかった点を記録してください。コンポーネント数の計算は性能ベンチマークではありません。
次のコンポーネントで実践する選び方
まずは1種類のボタンと、実際に使う設定から始めます。連動する見た目の違いにはバリアント、任意のレイヤーには表示プロパティ、差し替え可能なコンポーネントにはInstance、ラベルにはTextを使います。インスタンスで組み合わせを検証し、実装方法を合意します。ライブラリを小さくする価値は、正しく設定し、保守し、利用しやすくなることにあります。