ページネーション

クエリ結果をページ操作し、毎回返される結果の数を制御できます。

GraphQL ワイヤアダプタは、ページ設定について GraphQL Cursor Connections Specification (GraphQL カーソル接続仕様) に従います。

返すレコードの数を指定するには、first 引数を使用します。デフォルトの数は 10 です。

hasNextPage が true の場合、後続のクエリの after 引数に endCursor の値を渡すことで、次の結果ページを要求できます。

前に戻るためのページ設定引数の last と before は現在サポートされていません。

Note

カーソル情報を含むクエリを作成するには、GraphQL ワイヤアダプタの query パラメータを使用します。

1query operationName {
2  uiapi {
3    query {
4      Account (first: 8, after: "endCursorFromPreviousQuery") {
5        edges {
6          node {
7            Id
8            Name {
9              value
10            }
11          }
12        }
13        totalCount
14        pageInfo {
15          endCursor
16          startCursor
17          hasNextPage
18          hasPreviousPage
19        }
20      }
21    }
22  }
23}

この応答の例には、カーソル情報が含まれています。

1{
2  "data": {
3    "uiapi": {
4      "query": {
5        "Account": {
6          "edges": [
7            {
8              "node": {
9                "Id": "001RM000005ZclBYAS",
10                "Name": {
11                  "value": "GenePoint"
12                }
13              }
14            },
15            {
16              "node": {
17                "Id": "001RM000005Zcl6YAC",
18                "Name": {
19                  "value": "United Oil"
20                }
21              }
22            }
23          ], // 6 more node objects here removed for brevity
24          "totalCount": 8,
25          "pageInfo": {
26            "endCursor": "djE6Nw==",
27            "startCursor": "djE6MA==",
28            "hasNextPage": true,
29            "hasPreviousPage": false
30          }
31        }
32      }
33    }
34  },
35  "errors": []
36}

詳細は、「Lightning Web コンポーネントでの GraphQL API の使用」を参照してください。

Tip

関連トピック

GraphQL API: Pagination (ページ設定)

The Japanese Summer '24 guide is now live

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