記事のサマリー(TL;DR)
- POS UI extensions API version 2026-10に、Polaris web components向けの仮想化リストコンポーネント「s-pos-list」が追加されました。行をプレーンなデータとして渡し、web componentsで構築したテンプレートで各種の行をレイアウトします。
- s-pos-listはShopify POS 11.17.0以降で利用可能で、2026-10を採用する拡張機能において、API version 2025-07以前のListコンポーネントを置き換えます。
- この変更に対して追加の対応は不要とされています。
対象と条件
s-pos-listを利用できるのは、api_version = "2026-10" を設定し、Shopify POS 11.17.0以降で動作する拡張機能です。API version 2026-07以前にはs-pos-listは含まれておらず、これまでどおり早期のAPIバージョンにとどまる拡張機能やListコンポーネントを使い続ける拡張機能には変更はありません。Listコンポーネントを使用しておりPolaris web componentsへの移行を進めている拡張機能、および行をs-scroll-boxにマッピングして長いリストを構築している拡張機能が対象として挙げられています。
詳細
変更内容
Listコンポーネントは API version 2025-07 で終了しており、Polaris web componentsにはそれを置き換えるリストコンポーネントがありませんでした。s-pos-listはこの空白を埋めるものです。Listの固定された行レイアウトとは異なり、各種の行がそれぞれ独自のテンプレートを持つため、1つのリストの中で見出し、区切り線、コンテンツ行を混在させることができます。
この変更が重要な理由
行をs-scroll-boxにマッピングする方法では、POSが行ごとにビューを生成するため、表示時間とメモリ使用量がリストの長さに応じて増大し、非常に大きなリストでは表示に失敗する場合がありました。s-pos-listは、POSユーザーがスクロールする際に行のビューを再利用(recycle)します。iPad(A16)で最も複雑なListの行レイアウトを用いたテストでは、s-pos-listは2025-07のListと同等の速さで大きなリストを表示・スクロールしたとされています。
対応方法
既存の拡張機能を変更する必要はないとされています。s-pos-listは新しいコンポーネントであり、既存の拡張機能はそのまま動作を継続します。API version 2026-10を採用し、Shopify POS 11.17.0以降で動作させる場合は、以下の対応表を使ってListの実装をs-pos-listへ移行できます。
- data → rows:各行はidを保持し、新たに
templateForが追加されます。 - leftSideとrightSideMarkup → テンプレート内で構築:
s-image、s-text、s-badge、s-switchなどのコンポーネントを使用します。 - 行のonPress → リストのonRowClick:
event.detail.itemから行の情報を読み取ります。onPressを持たない行にはtype="text"テンプレートを使用します。 - isLoadingMoreとonEndReached → loadingMoreとonLoadMore
- listHeaderComponent →
slot="header"を持つ子要素:例として<s-search-field slot="header" />が挙げられています。listHeaderComponentと同様に、行と一緒にスクロールします。 - title → リスト上部のs-heading:titleと同様、行がスクロールしてもその場にとどまります。
- imageDisplayStrategy → 独自のテンプレート:画像エリアを常に表示するか、行のフィールドに対して
{{#if}}でラップします。
2026-10へ更新する際は、この対応表を使ってリストのpropsとテンプレートを調整し、s-pos-listが従来のListの挙動と一致するようにします。Shopify POS 11.17.0以降でテストを行い、長いリストが想定どおりに読み込まれ、スクロールすることを確認するよう案内されています。
関連ドキュメント
- POS list component reference
- Upgrading POS UI extensions to 2025-10