syncfusion-maui-polar-charts

.NET MAUI Polar Chart の実装

値や角度を円形レイアウトで表現し、極座標でデータを視覚化する Syncfusion® .NET MAUI Polar Chart（SfPolarChart）の実装方法を説明します。レーダーチャート、スパイダーチャート、ウェブチャート、スターチャート、またはコブウェブチャートとも呼ばれるこれらの視覚化は、複数のデータ系列を放射状に比較したり、周期的または方向性のあるデータパターンを表示したりするのに最適です。

このスキルを使用する場面

次のようなニーズがある場合に、このスキルを使用してください。

• 極座標チャートまたはレーダーチャートを作成する - 円形／角度レイアウトでデータを視覚化する
• 複数のデータ系列を放射状に比較する - 極座標形式で2～3系列以上を同時に表示する
• 周期的または方向性のあるデータを表示する - 方角、季節のパターン、カテゴリ別のパフォーマンス指標
• 極座標スタイルとレーダースタイルを切り替える - 円形のグリッド線（極座標）と多角形のグリッド線（レーダー／スパイダー）
• 折れ線系列または面系列を実装する - PolarLineSeries または PolarAreaSeries
• 極座標チャートの外観をカスタマイズする - 軸、マーカー、データラベル、凡例、ツールチップ、色
• 極座標の角度を設定する - 開始角度を調整して向きを変更する（0°、90°、180°、270°）
• 極座標チャートをエクスポートする - レポートやドキュメント用にチャートを画像として保存する

コンポーネントの概要

主な機能：

• 系列の種類：極座標の折れ線系列と面系列。複数の系列に対応
• グリッド線の種類：円形（極座標チャート）または多角形（レーダー／スパイダーチャート）
• 軸の種類：カテゴリ軸、数値軸、DateTime 軸
• カスタマイズ：データラベル、マーカー、凡例、ツールチップ、色、リキッドグラス効果
• 描画位置：向きを変更できる極座標の角度
• エクスポート：チャートを画像形式（PNG、JPEG、BMP）で保存
• インタラクティブ機能：閉じた系列／開いた系列、マーカーのカスタマイズ、レスポンシブデザイン

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

次のようなニーズがある場合に参照してください。

• Syncfusion® .NET MAUI Charts パッケージをインストールしてセットアップする
• 最初の極座標チャートを作成する
• チャートの基本構造（SfPolarChart、PrimaryAxis、SecondaryAxis）を理解する
• ビューモデルとデータバインディングを初期化する
• チャートに系列を追加する
• 完全な動作例を確認する

系列の種類

📄 参照： references/series-types.md

次のようなニーズがある場合に参照してください。

• 極座標の折れ線系列と面系列のどちらを使うか選択する
• PolarLineSeries と PolarAreaSeries の違いを理解する
• 極座標とレーダーの外観を切り替えるために、グリッド線の種類（Circle と Polygon）を変更する
• 閉じた系列と開いた系列を設定する（IsClosed プロパティ）
• 複数の系列を同時に表示する
• 系列の種類を比較して適切なものを選ぶ

軸の設定

📄 参照： references/axis-configuration.md

次のようなニーズがある場合に参照してください。

• PrimaryAxis または SecondaryAxis を設定する
• カテゴリ軸、数値軸、または DateTime 軸を使用する
• 軸ラベル、書式、回転をカスタマイズする
• 軸線と目盛り線のスタイルを設定する
• グリッド線（主線と補助線）を設定する
• 軸のタイトルと位置を設定する
• 軸の範囲と間隔を調整する

データラベルとマーカー

📄 参照： references/data-labels-markers.md

次のようなニーズがある場合に参照してください。

• 系列のデータポイントにデータラベルを表示してカスタマイズする
• データラベルの位置と書式を設定する
• カスタムのデータラベルテンプレートを作成する
• マーカーを有効にする（ShowMarkers プロパティ）
• マーカーの形状、サイズ、色をカスタマイズする
• MarkerSettings プロパティを設定する

凡例とツールチップ

📄 参照： references/legend-tooltip.md

次のようなニーズがある場合に参照してください。

• 凡例を追加して配置する
• 凡例の項目と外観をカスタマイズする
• カスタムの凡例テンプレートを作成する
• インタラクティブなツールチップを有効にする
• ツールチップの内容と外観をカスタマイズする
• カスタムのツールチップテンプレートを作成する

外観のカスタマイズ

📄 参照： references/appearance-customization.md

次のことが必要な場合：

• チャートの色とパレットをカスタマイズする
• 系列ごとのスタイルを適用する
• 背景と枠線を設定する
• モダンな外観にするため、リキッドグラス効果を有効にする
• アプリのテーマと統合する
• カスタム CSS やスタイル設定パターンを適用する

描画位置

📄 参照： references/rendering-position.md

次のことが必要な場合：

• 極座標チャートの開始角度を調整する
• チャートの向きを回転する（0°、90°、180°、270°）
• StartAngle プロパティの使い方を理解する
• 特定の方位に合わせてデータを配置する
• 角度の配置が異なるチャートを作成する

エクスポート

📄 参照： references/exporting.md

次のことが必要な場合：

• チャートを画像形式でエクスポートする
• チャートを PNG、JPEG、BMP として保存する
• エクスポート設定を構成する
• エクスポート機能を実装する
• レポート用のチャート画像を生成する

アクセシビリティ

📄 参照： references/accessibility.md

次のことが必要な場合：

• チャートのタイトル、凡例項目、データポイントをスクリーンリーダーで読み上げられるようにする
• 読み上げ形式（データポイント =「XValue + YValue + Series Label」）を理解する
• プラットフォームごとにアクセシビリティを有効にする（TalkBack、VoiceOver、Narrator）
• キーボードでチャート要素を操作する（Windows Narrator、macOS VoiceOver）
• ジェスチャーでチャート要素を操作する（Android TalkBack、iOS VoiceOver）
• 系列の互換性を理解する（PolarAreaSeries はサポートされていません）
• 読み上げ内容が分かりやすくなるよう、適切なラベルを付ける