syncfusion-blazor-spreadsheet-editor

Syncfusion Blazor Spreadsheet Editor

概要

Blazor Server または WebAssembly アプリケーションに Syncfusion Blazor Spreadsheet コンポーネントを統合するための、本番環境ですぐに使える C# および Razor コードを生成します。このスキルでは、セルの編集、書式設定、数式、データ操作、ワークシート管理など、Excel のような機能を備えた、コピーしてすぐに使えるコードスニペットを作成します。

主な機能

• データとバインディング： byte[]、ローカル JSON ファイル、リモート JSON URL、または Google Drive から読み込みます。Ribbon を使用して保存できます
• セルと範囲の操作： イベントを使った編集、UpdateCell、数式の設定、オートフィル、範囲操作、セルの結合／結合解除、セルの書式設定、数値形式、条件付き書式
• 行、列、ワークシート： 行と列の挿入／サイズ変更、ワークシートの挿入、削除、移動、複製
• データ操作： フィルタリング、並べ替え、ハイパーリンクの追加／編集／削除、切り取り／コピー／貼り付け、セルと範囲の選択
• UI とインタラクティブ機能： 数式バーの表示／非表示、コンテキストメニューの表示／非表示、XlsIO を使ったカスタムデータの描画
• 保護と履歴： シートとブックの保護／保護解除、元に戻す／やり直す操作
• 画像： UI から画像を挿入、サイズ変更、移動できます（デフォルトで有効）
• グラフ： InsertChartAsync ／ DeleteChartAsync を使って、アクティブなワークシートにプログラムでグラフを挿入、削除できます。移動、サイズ変更、種類、テーマ、凡例、データラベル、グリッド線、軸は UI から設定できます
• Ribbon のカスタマイズ： Spreadsheet の Ribbon をカスタマイズできます（Ribbon タブ、グループ、項目の追加／削除／変更）

クイックスタートの例

例 1：基本的なスプレッドシートを表示する

ユーザー：「Blazor ページに基本的な Spreadsheet を追加してください」 結果： C# + Razor のコードスニペットを表示します（ファイルは作成されません）

例 2：フィルタリングと並べ替えを無効にする

ユーザー：「フィルタリングと並べ替えを無効にしたスプレッドシートを作成してください」 結果： 基本サンプルに filtering.md と sorting.md のスニペットを統合します

---

ユーザーのプロジェクト向けに C# コードを生成する（デフォルト）

トリガーキーワード：「方法」、「スプレッドシートを追加」、「コードサンプル」、「見せて」、「例」、「スニペット」、「統合」、「コンポーネント」、「サンプルを作成」、「コード」、「サンプルコード」、「コードを生成」、「実装」、「プロジェクトに追加」、「スプレッドシートを設定」

ステップ 1 - リクエストを分析してスニペットを選択する

• ユーザーの意図を解析し、要求されている機能を特定します。
• 常に references/basic-sample.md をベースとして使用します。
• 要求された各機能を、対応する references/*.md ファイルに割り当てます。
• 機能に関するキーワードが一致しない場合は、基本サンプルのみを出力します。

ステップ 2 - 同意と出力先の確認（必ず最初に質問し、ユーザーの回答があるまでここで停止する）

コードを生成したり、ファイルに書き込んだりする前に、ユーザーに次の内容を尋ねます。

I'm ready to generate your Syncfusion Blazor Spreadsheet sample.

Where should I place it?
1) Create a new Razor file in the skill's "output" folder (recommended for quick tryout)
2) Add/modify an existing file in your project (please provide full path; choose append or replace)
Or, say "Just show me the code" to get the snippet here without changing files.

• ユーザーが明示的にオプションを選択するか、「コードだけを表示してください」と言うまで、先に進まないでください。
• ファイルの変更をユーザーが拒否した場合は、チャットにコードのみを出力してください（ファイルは作成／変更しません）。

オプション 2 のみ： コードを生成する前に、プロジェクトに references/basic-sample.md の前提条件（「前提条件とセットアップ要件」セクション）があるか確認します。足りない場合は、ユーザーの同意を得て追加します。

ステップ 3 - コードを生成する（ドライラン）

以下を統合して、メモリ内でコードを組み立てます。

• ベース：references/basic-sample.md
• 一致した機能スニペットを、対応するアンカーに統合します：PROPERTY、EVENTS、BUTTON、API METHOD
• 参照ファイルに記載されていないプロパティ、イベント、API を決して新たに作成したり、変更したりしないでください

ステップ 4 - 変更を適用する（同意を得た後のみ）

オプション A - スキルのフォルダーに新しいファイルを作成する：

• スキルのルートに output/ フォルダーを作成し、ファイルをそこに配置します
• デフォルトのファイル名：SpreadsheetSample.razor（ユーザーの返信で変更できます）
• ファイルがすでに存在する場合は、次のように確認します：

  A file named "SpreadsheetSample.razor" already exists. Overwrite, append, or use a different name?
  

  ユーザーの判断を待ってから処理を続行します。
• 生成した Razor/C# の内容を書き込みます。

オプション B - ユーザーのプロジェクトファイルに追加する：

• 対象ファイルのフルパスと、追記または置換のどちらにするかをユーザーに確認します
• パスが存在しない場合は、このファイルを作成できます。作成を続行しますか？ と確認します
• 置換する場合は、書き込み前にバックアップコピーを作成します（環境が対応している場合。例：.bak）
• ユーザーの指示に従って変更を適用します。

ステップ 5 - 結果を報告する

Done
- Location: {path}
- Action: {created|overwritten|appended}
- Notes: {any warnings or unsupported features}

ファイル操作を行わなかった場合は、コードをチャットに表示しただけであることを伝えます。

---

コードリファレンス

すべてのテンプレートと機能スニペットは references/*.md にあります。各ファイルには、サンプルの生成時にエージェントが組み合わせる、特定の内容に絞ったスニペットが含まれています。

フロー： 常に references/basic-sample.md から始め、一致する機能スニペットをアンカー（PROPERTY、EVENTS、BUTTON、API METHOD）にマージします。機能キーワードが一致しない場合は、基本サンプルのみを返します。

対応機能： 編集、フィルタリング、並べ替え、セルの結合、行／列の挿入、ハイパーリンク、クリップボード操作、セルの書式設定、条件付き書式設定、グラフ、リボンのカスタマイズ、開く／保存、選択

ファイル	目的
basic-sample.md	byte[] DataSource と Ribbon を使用する最小限の Spreadsheet サンプル
open-save.md	Ribbon を使った開く操作（byte[]、ローカル JSON、リモート JSON URL、Google Drive）と保存（対応する SaveType 形式：Xlsx、Xls、Csv、Pdf。）
worksheet.md	ワークシートの挿入、削除、移動、複製
cell-range.md	オートフィルと範囲操作
merge.md	セルの結合、結合解除
editing.md	編集イベントのバインド、UpdateCell、数式の設定
formula.md	数式バーの切り替え
formatting.md	数値形式、セルの書式設定、条件付き書式設定
contextmenu.md	コンテキストメニューの切り替え
ribbon-customization.md	Spreadsheet Ribbon のカスタマイズ（リボンタブ、グループ、項目の追加／削除／変更）
rows-columns.md	行／列の挿入、行／列のサイズ変更
filtering.md	列のフィルタリング
sorting.md	複数列の並べ替え
hyperlink.md	ハイパーリンクの追加と削除
clipboard.md	切り取り、コピー、貼り付け
selection.md	セルと範囲の選択
undo-redo.md	操作の取り消しとやり直し
protection.md	シートとブックの保護および保護解除
custom-data.md	XlsIO を使用したカスタムデータの Spreadsheet の作成
common.md	Height、Width、ID、CssClass、ActiveSheetIndex、Image
chart.md	縦棒、横棒、折れ線、面、円、ドーナツ、散布図を使ったセルデータの可視化
data-validation.md	セルまたは範囲にユーザーが入力できる値の制限
find-and-replace.md	Spreadsheet 内のセルまたは範囲の検索、置換、移動

---

ルール

1. 参照スニペットのみを使用

   • references/ 以下の Markdown ファイルのみを基にコードを生成します
   • references/*.md に記載されていないプロパティ、イベント、API メソッド、コンポーネント名、パラメーターを創作・推測・追加しないでください

2. UI 操作機能

   • 以下の機能はUI 操作のみに対応しており、カスタマイズオプション（メソッド、イベント、プロパティ）はありません。
   • グリッド線 - UI 操作でのみ表示を切り替えます
   • 画像 - UI 操作でのみ画像の挿入、サイズ変更、移動を行います
   • これらの機能のメソッド、イベント、プロパティは生成しないでください
   • references/*.md ファイルに明示的に記載されている場合に限り、これらの機能を追加してください
   • ユーザーからこれらの機能のカスタマイズを求められた場合は、次のように伝えてください。 This feature supports only UI interaction and does not have programmatic customization options in the Blazor Spreadsheet component.

3. 未対応機能への対応

   • ユーザーが references/*.md に該当するスニペットのない機能を求めた場合は、次のように回答してください。 That feature is not currently supported by the Syncfusion Blazor Spreadsheet component.
   • 該当するスニペットがある場合に限り、最も近い対応機能を提案してください
   • 未対応の項目を明示的に列挙し、それらのコードを合成しないでください

4. 記述前の検証

   • 記述する前に、すべてのコードブロックが references/*.md ファイルに基づいていることを再検証してください
   • 検証に失敗した場合は、作業を中止してユーザーに伝えてください

5. 透明性

   • 該当する場合は、最終レポートに対応済みと未対応の概要を含めてください

---