Lightning Design System のバリエーションの使用
サポートされていないバリエーションを渡すと、代わりにデフォルトのバリエーションが使用されます。次の例では、base バリエーションを使用してボタンを作成します。
1<lightning:button variant="base" label="Base" onclick="{! c.handleClick }"/>次のリファレンスでは、基本コンポーネントのバリエーションが Lightning Design System のバリエーションにどのように対応しているのかについて説明します。
アバター
lightning:avatar コンポーネントは、取引先やユーザなどのオブジェクトを表す画像です。アバターはさまざまなサイズで作成できます。詳細は、「lightning:avatar」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| square (デフォルト) | slds-avatar--square | 角丸正方形のアバター |
| empty | slds-avatar | 基本的なアバター |
| circle | slds-avatar--circle | 円形のアバター |
バッジ
lightning:badge コンポーネントは、少量の情報を保持する表示ラベルです。このコンポーネントではバリエーションはサポートされていません。詳細は、「lightning:badge」を参照してください。
ブレッドクラム
lightning:breadcrumbs コンポーネントは、少量の情報を保持する表示ラベルです。このコンポーネントではバリエーションはサポートされていません。詳細は、「lightning:breadcrumbs」を参照してください。
ボタン
lightning:button コンポーネントは、クライアント側コントローラでアクションを実行するボタンです。ボタンでは、テキスト表示ラベルの左側または右側のアイコンがサポートされます。詳細は、「lightning:button」を参照してください。


| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| neutral (デフォルト) | slds-button--neutral | 灰色の境界線と白い背景を使用するボタン |
| 基本 | slds-button | 境界線がなく、テキストリンクのように見えるボタン |
| ブランド | slds-button--brand | 白いテキストを使用した青いボタン |
| destructive | slds-button--desctructive | 白いテキストを使用した赤いボタン |
| inverse | slds-button--inverse | 白いテキストを使用した紺色のボタン |
ボタングループ
lightning:buttonGroup コンポーネントは、ナビゲーションバーを作成するために一緒に表示できるボタンのグループです。グループ内に lightning:button コンポーネントと lightning:buttonMenu コンポーネントをネストできます。ボタングループ自体ではバリエーションはサポートされませんが、ボタンおよびボタンメニューコンポーネントではバリエーションがサポートされます。たとえば、ボタングループ内に <lightning:button variant="inverse" label="Refresh" /> をネストできます。lightning:buttonMenu を含める場合は、ボタンの後に配置し、slds-button--last クラスを渡して境界線を調整します。詳細は、「lightning:buttonGroup」を参照してください。
ボタンアイコン
lightning:buttonIcon コンポーネントは、クライアント側コントローラでアクションを実行する、アイコンのみのボタンです。ボタンアイコンはさまざまなサイズで作成できます。Lightning Design System のユーティリティアイコンのみがサポートされます。詳細は、「lightning:buttonIcon」を参照してください。
![]()
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| border (デフォルト) | slds-button--icon-border | 灰色の境界線を使用するアイコンを含むボタン |
| bare | slds-button--icon-bare | 境界線のないアイコンを含むボタン |
| container | slds-button--icon-container | 境界線のないアイコンを含む 32 x 32 ピクセルのボタン |
| border-filled | slds-button--icon-border-filled | 灰色の境界線と白の背景を使用するアイコンを含むボタン |
| bare-inverse | slds-button--icon-inverse | 暗色の背景用の境界線のない白いアイコンを含むボタン |
| border-inverse | slds-button--icon-border-inverse | 暗色の背景を使用する白いアイコンを含むボタン |
ボタンメニュー
lightning:buttonMenu コンポーネントは、lightning:menuItem コンポーネントで表される、メニュー項目リストがあるドロップダウンメニューです。メニュー項目は、チェックマークを入れるまたは外すことが可能で、クライアント側コントローラでアクションを実行できます。さまざまなサイズのアイコンを使用してボタンメニューを作成したり、ボタンを基準にしたさまざまな位置にドロップダウンメニューを配置したりできます。バリエーションによってボタンの外観が変更されます。これは、ボタンアイコンのバリエーションと類似しています。詳細は、「lightning:buttonMenu (ベータ)」を参照してください。



| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| border (デフォルト) | slds-button--icon-border | 灰色の境界線を使用するアイコンを含むボタン |
| bare | slds-button--icon-bare | 境界線のないアイコンを含むボタン |
| container | slds-button--icon-container | 境界線のないアイコンを含む 32 x 32 ピクセルのボタン |
| border-filled | slds-button--icon-border-filled | 灰色の境界線と白の背景を使用するアイコンを含むボタン |
| bare-inverse | slds-button--icon-inverse | 暗色���背景用の境界線のない白いアイコンを含むボタン |
| border-inverse | slds-button--icon-border-inverse | 暗色の背景を使用する白いアイコンを含むボタン |
ステートフルボタン
lightning:buttonStateful コンポーネントは、状態を切り替えるボタンです。ステートフルボタンには、状態に基づいて異なる表示ラベルやアイコンを表示できます。Lightning Design System のユーティリティアイコンのみがサポートされます。詳細は、「lightning:buttonStateful」を参照してください。


| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| neutral (デフォルト) | slds-button--neutral | 灰色の境界線と白い背景を使用するボタン |
| ブランド | slds-button--brand | 白いテキストを使用した青いボタン |
| inverse | slds-button--inverse | 白いテキストを使用した紺色のボタン |
| テキスト | slds-button | 灰色の境界線と白の背景を使用するアイコンを含むボタン |
カード
lightning:card コンポーネントは、HTML の article タグ内の関連情報のグループです。詳細は、「lightning:card」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| base (デフォルト) | slds-card | コンテナの幅を使用する関連情報のグループ。 |
| narrow | slds-card--narrow | 狭い幅を使用する関連情報のグループ。 |
アイコン
lightning:icon コンポーネントは、コンテキストを示し、使いやすさを向上させるビジュアル要素です。Lightning Design System のすべてのアイコンがサポートされますが、バリエーションがサポートされるのはユーティリティアイコンのみです。アイコンはさまざまなサイズで作成できます。詳細は、「lightning:icon」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| inverse (デフォルト) | slds-icon | 以前は「bare」と呼ばれていました。32 x 32 ピクセルのアイコン。 |
| error | slds-icon-text-error | 赤で塗りつぶされたアイコン |
| warning | slds-icon-text-warning | 黄色で塗りつぶされたアイコン |
入力
lightning:input コンポーネントは、入力項目やチェックボックスなど、ユーザ入力を受け入れる対話型コントロールです。詳細は、「lightning:input (ベータ)」を参照してください。




| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| standard (デフォルト) |
slds-input slds-form-element slds-form-element__control |
入力要素。入力項目、チェックボックス、切り替え、ラジオボタンなどを使用できます。要素に追加されるクラスは、入力種別によって異なります。 |
| label-hidden | slds-form--inline | 表示ラベルが非表示の入力要素 |
レイアウト
ピル
lightning:pill コンポーネントは、角丸の境界線で囲まれたテキスト表示ラベルで、削除ボタンと一緒に表示されます。ピルには、テキスト表示ラベルの横にアイコンまたはアバターを含めることができます。このコンポーネントではバリエーションはサポートされていませんが、コンテンツおよびその他の属性で、適用されるスタイル設定が判断されます。たとえば、hasError="true" を使用するピルは、赤い境界線とエラーアイコンを使用するピルとして表示されます。詳細は、「lightning:pill」を参照してください。
リッチテキストエディタ
lightning:inputRichText コンポーネントは、カスタマイズ可能なツールバーがあるリッチテキストエディタです。ツールバーはエディタの上部に表示されますが、bottom-toolbar バリエーションを使用してエディタの下に位置を変更できます。詳細は、「lightning:inputRichText (ベータ)」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| bottom-toolbar | slds-rich-text-editor__toolbar-bottom | エディタの下にツールバーが配置されるリッチテキストエディタ |
選択
lightning:select コンポーネントは、オプションを 1 つ選択できるドロップダウンリストです。詳細は、「lightning:select」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| standard (デフォルト) | slds-select | 値の単一選択をサポートする選択入力要素 |
| label-hidden | slds-form--inline | 表示ラベルが非表示の選択入力要素 |
スピナー
lightning:spinner コンポーネントは、データを読み込み中であることを示すスピナーです。スピナーはさまざまなサイズで作成できます。詳細は、「lightning:spinner」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| brand (デフォルト) | slds-spinner | 灰色のスピナー |
| inverse | slds-spinner--inverse | 暗色の背景用のスピナー |
Tabs
lightning:tabset コンポーネントは、lightning:tab コンポーネントで表される、対応するコンテンツ領域があるタブのリストです。詳細は、「lightning:tabset (ベータ)」を参照してください。


| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| デフォルト | slds-tabs--default | タブとコンテンツ領域のリスト |
| scoped | slds-tabs--scoped | 暗色の背景用のスピナー |
TextArea
lightning:textarea コンポーネントは、複数行のテキストを���力するための入力項目です。詳細は、「lightning:textarea」を参照してください。
| 基本コンポーネントのバリエーション | Lightning Design System のクラス名 | 説明 |
|---|---|---|
| standard (デフォルト) | slds-form-element | テキスト表示ラベルがある textarea 要素 |
| label-hidden | slds-form--inline | 表示ラベルが非表示の textarea 要素 |
タイル
lightning:tile コンポーネントは、関連情報のグループです。このコンポーネントではバリエーションはサポートされていませんが、slds-tile--board クラスを渡してボードを作成できます。同様に、タイルボディで定義リストを使用してアイコンを表示するタイルを作成したり、順序なしリストを使用してアバターを表示するタイルのリストを作成したりできます。詳細は、「lightning:tile」を参照してください。

