lightning:buttonMenu
アクションまたは機能のリストのドロップダウンメニューを表します。
lightning:buttonMenu は、クリックされるとユーザがアクセス可能なアクションまたは機能のドロップダウンメニューを表示するボタンを表します。
スタイルをカスタマイズするには、variant、size、または class 属性を使用します。
次に例を示します。
1<aura:component>
2 <lightning:buttonMenu alternativeText="More options" onselect="{! c.doSomething }">
3 <lightning:menuItem label="Menu Item One" value="1" />
4 <lightning:menuItem label="Menu Item Two" value="2" />
5 <lightning:menuItem label="Menu Item Three" value="3" />
6 <lightning:menuItem label="Menu Item Four" value="4" disabled="true" />
7 </lightning:buttonMenu>
8</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 です。 | |
| onblur | Action | 要素がフォーカスを解放したときにトリガされるアクション。 | |
| onfocus | Action | 要素にフォーカスが設定されたときにトリガされるアクション。 | |
| onselect | Action | メニュー項目が選択されたときに起動されるアクション。 | |
| size | String | アイコンのサイズ。オプションは、xx-small、x-small、medium、large のいずれかです。この値のデフォルトは medium です。 | |
| tabindex | Integer | 要素のタブ順序を指定します (タブボタンがナビゲーションに使用される場合)。 | |
| title | String | ボタンのツールチップテキスト。 | |
| variant | String | バリエーションによってボタンの外観が変更されます。有効なバリエーションとして、bare、container、border、border-filled、bare-inverse、border-inverse があります。この値のデフォルトは border です。 | |
| visible | Boolean | true の場合、メニュー項目が表示されます。この値のデフォルトは false です。 |