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

lightning:buttonMenu (ベータ)

アクションまたは機能のリストのドロップダウンメニューを表します。

lightning:buttonMenu は、クリックされるとユーザがアクセス可能なアクションまたは機能のドロップダウンメニューを表示するボタンを表します。

スタイルをカスタマイズするには、variant、size、または class 属性を使用します。

このコンポーネントは、Lightning Design System のメニューからスタイル設定を継承します。

次に例を示します。

1<aura:component>
2    <lightning:buttonMenu alternativeText="More options">
3        <lightning:menuItem label="New"    value="1" onactive="{! c.handleClick }" />
4        <lightning:menuItem label="Edit"   value="2" onactive="{! c.handleClick }" />
5        <lightning:menuItem label="Delete" value="3" onactive="{! c.handleClick }" />
6    </lightning:buttonMenu>
7</aura:component>

lightning:menuItem コンポーネントで checked 属性を使用して、チェックまたはチェック解除可能なメニュー項目を作成できます。

デフォルトでは、このメニューは、他の場所がクリックされると閉じます。visible 属性を使用してメニューの開閉ができます。次の例では、メニューを閉じ、フォーカスをクライアント側コントローラのボタン要素に設定します。

1var myMenu = cmp.find("myMenu");
2myMenu.set("v.visible", false);
3myMenu.focus();

使用上の考慮事項

このコンポーネントには、ボタンがトリガされた場合に限って作成されるメニュー項目が含まれます。初期化中、またはボタンがトリガされていない場合は、メニュー項目を参照できません。

アクセシビリティ

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

メソッド

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

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

属性

属性名	属性型	説明
`accesskey`	String	要素の有効化またはフォーカス設定のためのショートカットキーを指定します。
`alternativeText`	String	ボタンの補助テキスト。
`body`	ComponentDefRef[]	コンポーネントのボディ。
`class`	String	コンポーネントの基本クラスに加え、外部要素の CSS クラス。
`disabled`	Boolean	true の場合、メニューは無効化されています。メニューを無効化すると、ユーザはメニューを開けなくなります。この値のデフォルトは false です。
`iconName`	String	\'utility:down\' 形式で使用するアイコンの名前。この値のデフォルトは utility:down です。utility:down または utility:chevrondown 以外のアイコンが使用されている場合は、そのアイコンの右側に utility:down アイコンが追加されます。
`iconSize`	String	アイコンのサイズ。オプションは、xx-small、x-small、medium、large のいずれかです。この値のデフォルトは medium です。
`menuAlignment`	String	ボタンを基準とするメニューの位置を決定します。選択可能なオプションは、left、center、right です。この値のデフォルトは left です。
`name`	String	ボタン要素の名前。この値は省略可能であり、コールバック内でボタンを識別するために使用できます。
`onblur`	Action	要素がフォーカスを解放したときにトリガされるアクション。
`onfocus`	Action	要素にフォーカスが設定されたときにトリガされるアクション。
`onselect`	Action	メニュー項目が選択されたときに起動されるアクション。渡されたイベントの「detail.menuItem」プロパティは、選択されたメニュー項目です。
`tabindex`	Integer	要素のタブ順序を指定します (タブボタンがナビゲーションに使用される場合)。
`title`	String	ボタンのツールチップテキスト。
`value`	String	ボタン要素の値。この値は省略可能であり、フォームの送信時に使用できます。
`variant`	String	バリエーションによってボタンの外観が変更されます。有効なバリエーションとして、bare、container、border、border-filled、bare-inverse、border-inverse があります。この値のデフォルトは border です。
`visible`	Boolean	true の場合、メニュー項目が表示されます。この値のデフォルトは false です。

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

lightning:buttonMenu (ベータ)

属性