syncfusion-flutter-excel

Syncfusion Flutter XlsIO ライブラリを使用した Excel ドキュメントの処理

概要

Syncfusion Flutter XlsIO ライブラリを使用して、Excel ワークブック（.xlsx）を作成、編集、保存します。 このスキルは、モバイル、Web、デスクトッププラットフォームを対象とする Flutter プロジェクト向けの Dart コードスニペットの生成に対応しています。

主な機能

• 作成と編集： ワークブック、ワークシート、セル、行、列、セルの書式設定、スタイル、数式、名前付き範囲、グラフ、画像、ハイパーリンク、データ検証、条件付き書式
• データ管理： データのインポート（リスト、型付きデータ、ハイパーリンク、画像）、データのエクスポート、高度なフィルタリング（テキスト、カスタム、日付、動的、色フィルター）、ウィンドウ枠の固定、行／列の表示と非表示
• 高度な機能： 国際対応のための RTL レイアウト、CSV エクスポート、テンプレートベースの操作、データ検証ルール（テキスト、リスト、数値、日付、小数、カスタム）
• グラフと視覚化： すべての種類のグラフの作成と設定（円、棒、縦棒、折れ線、積み上げ、3D、特殊グラフ）、要素のカスタマイズ（タイトル、凡例、ラベル、配置）
• セキュリティ： パスワード保護、ワークシート／ワークブックの暗号化、ロック解除オプションを使用したセルの保護
• ページ設定： 余白、改ページ、印刷範囲、ページの向き、ヘッダー／フッター

前提条件

• Flutter SDK がインストールされていること
• pubspec.yaml に依存関係を追加します：

  dependencies:
    syncfusion_flutter_xlsio: ^33.1.44
    syncfusion_officechart: ^33.1.44
  

• pub.dev または Syncfusion のドキュメントから、互換性のある最新バージョンのパッケージを使用します。
• flutter pub get を実行します
• Dart コードにインポートします：

  import 'package:syncfusion_flutter_xlsio/xlsio.dart';
  import 'package:syncfusion_officechart/officechart.dart';
  

クイックスタートの例

Dart コードを生成する

ユーザー：「複数のシートを含む Excel ワークブックの作成方法を教えてください」 結果： Dart コードスニペットが表示されます（ファイルは作成されません）

---

モード：ユーザーの Flutter プロジェクト向けに Dart コードを生成する

トリガーキーワード：「見せて」「方法」「どうすれば」「コードを提供」「例を提供」「例を示して」「実演」「コードスニペット」「サンプルコード」「例」「サンプル」「教えて」「見せて」「main.dart」「コード例」「〜向けのコードを生成」「codesnippet」。

ワークフロー：

ステップ 1 — プラットフォームを検出し、適切なパッケージを提案する

• ワークスペースのプロジェクトファイル（pubspec.yaml、main.dart など）を調べて、Flutter の対象プラットフォーム（モバイル、Web、デスクトップ）を特定します。
• コードを生成する前に、syncfusion_flutter_xlsio を pubspec.yaml に追加するようユーザーに伝えます。

ステップ 2 — 参照ファイルのみからコードを生成する

参照ファイルに明示的に記載されていない API、クラス、メソッド、プロパティを考案、推測、提案してはいけません。

• 要求された機能に関連する references/*.md ファイルを読みます
• それらのファイルに記載された API とスニペットのみを厳密に使用して Dart コードを作成します
• 対象プラットフォームに適した保存／起動パターンを使用します：
  • モバイル → getApplicationSupportDirectory() + OpenFile.open()
  • デスクトップ → getApplicationSupportDirectory() + OpenFile.open()
  • Web → base64 + JavaScript によるダウンロード、または web パッケージの方法
• 単独で実行する Dart スクリプトを作成したり、実行したりしないでください

---

コードリファレンス

すべてのスニペットは references/ フォルダーにあります。

ファイル	内容
references/workbook.md	作成、保存／破棄、非同期操作、RTL レイアウト、CSV エクスポート
references/worksheet.md	作成、アクセス、タブの色、サイズ設定、ウィンドウ枠の固定、ページ設定
references/cell-data.md	セルへのテキスト、数値、日付、その他のデータ型の追加、ハイパーリンクの作成
references/hyperlinks.md	URL および mailto ハイパーリンクの追加
references/named-ranges.md	数式で使用する名前付き範囲の作成
references/data-filtering.md	テキスト、カスタム、日付、動的、色によるフィルター
references/cell-formatting.md	スタイルの作成と全体への適用、セルの結合／結合解除、組み込みスタイル
references/number-formats.md	数値、通貨、パーセンテージ、日付、時刻、会計、科学、分数、テキスト形式
references/rows-columns-manipulation.md	行と列の挿入、削除、自動調整、表示／非表示、幅／高さの設定、数値形式
references/formulas.md	計算の有効化、数式の適用、値へのアクセス、ネストされた関数、25 種類以上の関数（一般、論理、テキスト、時刻、検索、統計、数学）
references/charts-basics.md	グラフの作成、要素（タイトル、凡例、ラベル、配置）のカスタマイズ
references/charts-types.md	すべてのグラフの種類（円、棒、縦棒、折れ線、積み上げ、マーカー、3D、特殊）
references/images.md	ワークシートへの画像（JPEG、PNG）の挿入、サイズ変更、反転、回転
references/security.md	パスワードによるワークブックとワークシートの保護、編集用セルのロック解除
references/conditional-formatting-basics.md	セルの値、テキスト、日付、一意／重複、上位／下位、平均より上／下の書式設定
references/conditional-formatting-advanced.md	カラースケール、アイコンセット、データバー、ビジュアル分析用のカスタムアイコン
references/data-import.md	リスト、型付きデータ、ハイパーリンク、画像のワークシートへのインポート
references/data-validation.md	テキスト、時刻、リスト、数値、小数、日付、カスタム数式の入力規則
references/tables.md	組み込みテーマを使用した Excel テーブルの作成、スタイル設定、管理
references/culture.md	日付、時刻、数値、通貨の書式設定に関するカルチャ／ロケール設定
references/page-setup.md	ページ設定と印刷設定（向き、余白、改ページ、印刷範囲）

---

ルール

• 一時スクリプトを作成または実行しないでください。このスキルはユーザープロジェクト用のコードのみを生成します（モード 1）。
• コードは必ずリファレンスファイルに基づいて生成し、API やメソッドを決して創作しないでください。
• 適切なインポートを必ず含めてください：import 'package:syncfusion_flutter_xlsio/xlsio.dart'; および import 'package:syncfusion_officechart/officechart.dart';
• モバイル／デスクトップアプリの場合：ファイルの保存には getApplicationSupportDirectory() と OpenFile.open() を使用してください。
• Web アプリの場合：base64 と JavaScript によるダウンロード、または web パッケージを使用してください。
• メモリを解放するため、保存後は必ず workbook.dispose() を呼び出してください。
• ワークブックは saveSync() を使用して同期的に、または save() を使用して非同期的に保存してください。
• 生成したコードを使用する前に、pubspec.yaml に syncfusion_flutter_xlsio と syncfusion_officechart を追加するようユーザーに伝えてください。