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

lightning:button

ボタン要素を表します。

lightning:button コンポーネントは、コントローラでアクションを実行するボタン要素を表します。ボタンをクリックすると、onclick に対して設定されたクライアント側コントローラのメソッドがトリガされます。ボタンは表示ラベルのみ、表示ラベルとアイコン、ボディのみ、ボディとアイコンのいずれかにすることができます。アイコンのみのボタンが必要な場合は、lightning:buttonIcon を使用します。

追加のスタイルを適用するには、variant および class 属性を使用します。

Lightning Design System ユーティリティアイコンカテゴリでは、lightning:button で表示ラベルテキストと一緒に使用できる約 200 個のユーティリティアイコンを提供しています。SLDS では複数のアイコンカテゴリが提供されていますが、このコンポーネントで使用できるのはユーティリティカテゴリのみです。

ユーティリティアイコンを表示するには、https://lightningdesignsystem.com/icons/#utilityにアクセスしてください。

次に、2 つの例を示します。

1<aura:component>
2    <lightning:button variant="brand" label="Submit" onclick="{! c.handleClick }" />
3</aura:component>

1<aura:component>
2    <lightning:button variant="brand" label="Download" iconName="utility:download" iconPosition="left" onclick="{! c.handleClick }" />
3</aura:component>

アク��シビリティ

スクリーンリーダーにボタンが無効化されていることを伝えるには、disabled 属性を true に設定します。

メソッド

このコンポーネントは、次のメソッドをサポートします。

focus(): フォーカスを要素に設定します。

属性

属性名	属性型	説明
`accesskey`	String	要素の有効化またはフォーカス設定��ためのショートカットキーを指定します。
`body`	Component[]	コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。
`class`	String	コンポーネントの基本クラスに加え、外部要素の CSS クラス。
`disabled`	Boolean	このボタンを無効な状態で表示するかどうかを指定します。無効なボタンをクリックすることはできません。この値のデフォルトは false です。
`iconName`	String	アイコンの Lightning Design System 名。名前は、形式「\utility:down\」で記述します。「utility」はカテゴリ、「down」は表示する特定のアイコンです。
`iconPosition`	String	ボディに対するアイコンの位置を記述します。left または right を選択できます。この値のデフォルトは left です。
`label`	String	ボタン内に表示するテキスト。
`onblur`	Action	要素がフォーカスを解放したときにトリガされるアクション。
`onclick`	Action	ボタンがクリックされたときに実行されるアクション。
`onfocus`	Action	要素にフォーカスが設定されたときにトリガされるアクション。
`tabindex`	Integer	要素のタブ順序を指定します (タブボタンがナビゲーションに使用される場合)。
`variant`	String	バリエーションによってボタンの外観が変更されます。有効なバリエーションとして、base、neutral、brand、destructive があります。この値のデフォルトは neutral です。

Lightning コンポーネント開発者ガイド

lightning:button

属性