この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Lightning Design System のバリエーションの使用

基本コンポーネントのバリエーションは、Lightning Design System のバリエーションに対応しています。バリエーションは variant 属性で制御され、これによってコンポーネントの外観が変化します。

サポートされていないバリエーションを渡すと、代わりにデフォルトのバリエーションが使用されます。次の例では、base バリエーションを使用してボタンを作成します。

1<lightning:button variant="base" label="Base" onclick="{! c.handleClick }"/>

lightning:formattedDateTime など、ビジュアルスタイル設定のない、データ駆動型の基本コンポーネントはここに記載していません。すべての基本コンポーネントは、「コンポーネントの参照」に記載されています。

メモ

次のリファレンスでは、基本コンポーネントのバリエーションが 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」を参照してください。

Breadcrumbs

ボタン

lightning:button コンポーネントは、クライアント側コントローラでアクションを実行するボタンです。ボタンでは、テキスト表示ラベルの左側または右側のアイコンがサポートされます。詳細は、「lightning:button」を参照してください。

ボタンのバリエーション

ボタンの inverse のバリエーション

基本コンポーネントのバリエーション 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」を参照してください。

ボタンアイコンのバリエーション

ボタンアイコンの inverse のバリエーション

基本コンポーネントのバリエーション 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」を参照してください。

ステートフルボタンのバリエーション

ステートフルボタンの inverse のバリエーション

基本コンポーネントのバリエーション Lightning Design System のクラス名 説明
neutral (デフォルト) slds-button--neutral 灰色の境界線と白い背景を使用するボタン
ブランド slds-button--brand 白いテキストを使用した青いボタン
inverse slds-button--inverse 白いテキストを使用した紺色のボタン
テキスト slds-button 灰色の境界線と白の背景を使用するアイコンを含むボタン

カード

lightning:card コンポーネントは、HTML の article タグ内の関連情報のグループです。詳細は、「lightning:card」を参照してください。

カードの narrow のバリエーション
基本コンポーネントのバリエーション 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:layout コンポーネントは、ページ内または別のコンテナ内にコンテナを配置するための柔軟なグリッドシステムです。variant 属性を使用する代わりに、レイアウトのカスタマイズは horizontalAlignverticalAlignpullToBoundary で制御されます。詳細は、次のリソースを参照してください。

ピル

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 (ベータ)」を参照してください。

default バリエーションを使用するタブセット

scoped バリエーションを使用するタブセット

基本コンポーネントのバリエーション 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」を参照してください。

定義リストを使用するタイル

順序なしリストを使用するタイル