移行計画：ウィジェットからコンポーネントへ

出典：ArcGIS Maps SDK for JavaScript - Transition plan: widgets to components

Esri は、ArcGIS Maps SDK for JavaScript のコア API を <arcgis-map></arcgis-map> のような再利用可能なカスタム HTML 要素へと拡張する、Web コンポーネントの開発に全面的に取り組んでいます。これは、ArcGIS 製品の内部開発にも、ArcGIS Maps SDK for JavaScript の一部として提供されるビルド済みの UI コンポーネントにも当てはまります。現在、SDK を使用した Web アプリの構築では、コンポーネントを使用することが推奨されています。

コンポーネントのメリット

Web コンポーネントは、SDK が推奨する UI 構築ブロックであり、その理由は次のとおりです。

• モダンなフロントエンド開発 (HTML、CSS、JavaScript) に自然に溶け込みます。
• さまざまなフレームワーク (React、Angular、Vue、Svelte など) に対応しているほか、フレームワークを塩茹しない環境でも動作します。
• プラットフォームとの親和性が高く、フレームワーク固有のラッパーではなく、標準的な DOM パターンでレイアウトを構築できます。
• Esri の内部方針と一致しており、ArcGIS 製品全体で使用されるコンポーネントと同じ標準ベースのアプローチを SDK でも採用しています。
• 設定可能な UI として、より高レベルでそのまま使える機能を提供します (例：Arcade エディターやチャート コンポーネント)。

SDK の上位レベルのコンポーネント群は、今後も継続的に拡張されていく予定です。

ウィジェットからマップ コンポーネントへ

SDK が最初に開発された当時、Web コンポーネントの規格はまだ成熟しておらず、ブラウザーに広く採用されていませんでした。同時に、JavaScript の技術動向は常に変化しているため、特定の JavaScript フレームワークに積極的なコミットはしませんでした。そのため、私たちは ウィジェット アーキテクチャーを開発し、開発者が Web アプリケーションで使用できるよう、時間をかけて 60 以上のウィジェットを作成しました。 現在では、Web コンポーネントの標準がすべての主要なブラウザーでサポートされているため、（SDK の内部構造と同様に）ブラウザーの進化に合わせて技術を進化させることが可能になりました。

コンポーネントへの移行は大きく進展しており、ウィジェットとして提供されていたすべての機能はコンポーネントとしても利用可能です。最初はウィジェットを Web コンポーネントとしてラップしていましたが、現在では標準的な Web コンポーネントとして再実装が進められています。今回のリリース時点で再実装されたマップ コンポーネントは以下のとおりです。

• Area Measurement 2D
• Area Measurement 3D
• Basemap Gallery
• Basemap Toggle
• Bookmarks
• Building Explorer
• Compass
• Coordinate Conversion
• Daylight
• Direct Line Measurement 3D
• Directional Pad
• Distance Measurement 2D
• Elevation Profile
• Expand
• Feature
• Features
• Floor Filter
• Fullscreen
• Grid Controls
• Home
• Legend
• Line Of Sight
• Locate
• Navigation Toggle
• Popup（ベータ版）
• Print
• Scale Bar
• Search
• Shadow Cast
• Slice
• Swipe
• Time Zone Label
• Track
• Utility Network Trace Analysis
• Video Player
• Volume Measurement (ベータ版)
• Weather
• Zoom

すべてのコンポーネントの再実装が完了した後、slots（スロット）機能のサポートが追加される予定です。これにより、コンポーネント内にカスタム コントロールや機能を統合できるようになります。

ウィジェット ロードマップ

バージョン 5.0 ですべてのウィジェットは非推奨となり、その後削除される予定です。非推奨であることは、リリース ノート、API リファレンス、およびコンソール メッセージで示されます。 ただし、コンポーネントへの移行は、アプリケーションの全面的な書き直しを必要としない一方で、相応の作業量が伴い、計画と優先順位付けが必要であることも認識しています。多くの Esri 製品チームも同様の移行作業を進めています。

コンポーネントへの完全移行については、以下のマイルストーンを目標としています。

• すべてのウィジェットは、早ければ 2027 年第 1 四半期に SDK から削除されます。

ビュー モデル

ウィジェットの削除に伴い、現代化された SDK 内でビュー モデル機能をどのように公開するかについて慎重に設計を進めています。詳細についてはブログ記事「ビュー モデルの進化と JavaScript Maps SDK によるカスタム ワークフローの構築」をご覧ください。また、今後のビュー モデルに関する具体的な計画については、「ウィジェット ビュー モデルのロードマップ」を確認してください。

コンポーネントによるアプリ構築の詳細

コンポーネントを使ったアプリの作り方を学ぶためのリソースは以下のようにたくさんあります。

• コンポーネントへのアクセス方法（CDN と npm）、React や Angular などのフレームワークとの統合についてのガイドを含む、開発の手順。
• コンポーネントの概要
• チュートリアル
• コンポーネントを使用したサンプルコード
• プログラミング パターン
• Core API と Maps SDK コンポーネントのリファレンス