getNavItems (ベータ)

ナビゲーションメニューの項目を取得するには、このワイヤアダプタを使用します。

構文 

1import { LightningElement, wire } from 'lwc';
2import { getNavItems } from 'lightning/uiAppsApi';
3import FORM_FACTOR from '@salesforce/client/formFactor';
4
5export default class Example extends LightningElement {
6  @api tabs = ['standard-Account', 'standard-CollaborationGroup'];
7  @wire(getNavItems, {
8    formFactor: FORM_FACTOR,
9    navItemNames: '$tabs',
10    pageSize: 30,
11  })
12  propertyOrFunction;

ユーザインターフェース API リソース 

1GET /ui-api/nav-items/

getNavItems は、このユーザインターフェース API リソースを使用します。

パラメータ 

  • formFactor — (省略可能) 応答には、次のフォーム要素をサポートするナビゲーション項目が含まれます。

    • Large — (デフォルト) デスクトップ表示サイズ。
    • Medium — タブレット表示サイズ。
  • Small — 電話表示サイズ。 formFactor として渡す値を取得するには、@salesforce/client/formFactor モジュールを使用します。

  • navItemNames — (省略可能) 応答に含まれる TabDefinition name の値のカンマ区切りリスト。navItemNames が指定されていない場合、指定された formFactor のすべてのナビゲーション項目が応答に含まれます。

  • page — (省略可能) ナビゲーション項目を返す開始点となるページのオフセット。デフォルト値は 0 で、最初のページからナビゲーション項目を返します。たとえば、page=2 で、pageSize=10 の場合、リストの 21 番目の項目から返されます。

  • pageSize — (省略可能) ページで返されるナビゲーション項目の最大数。デフォルト値は、25 です。

  • propertyOrFunction — ワイヤサービスからデータのストリームを受信する非公開のプロパティまたは関数。プロパティが @wire でデコレートされている場合、結果はそのプロパティの data プロパティまたは error プロパティに返されます。関数が @wire でデコレートされている場合、結果は data プロパティと error プロパティを持つオブジェクトで返されます。

戻り値 

The Japanese Summer '24 guide is now live

日本語の Summer '24 ガイドが公開されました! 「Component Reference (コンポーネントリファレンス)」は、以前と同様にコンポーネントライブラリにあります。