このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください
JSアクション
概要
JSアクションは、ボタンクリック時にJavaScriptを実行し、任意のビジネスロジックをカスタマイズするために使用します。フォームのツールバー、テーブルのツールバー（コレクションレベル）、テーブルの行（レコードレベル）など、さまざまな場所で利用でき、検証、通知の表示、API呼び出し、ポップアップ/ドロワーの開閉、データの更新といった操作を実現します。
ランタイムコンテキストAPI（よく使われるもの）
-
ctx.api.request(options): HTTPリクエストを送信します。 -
ctx.openView(viewUid, options): 設定済みのビュー（ドロワー/ダイアログ/ページ）を開きます。 -
ctx.message/ctx.notification: グローバルなメッセージと通知。 -
ctx.t()/ctx.i18n.t(): 国際化。 -
ctx.resource: コレクションレベルのコンテキストにおけるデータリソース（例：テーブルのツールバー。getSelectedRows()、refresh()などを含みます）。 -
ctx.record: レコードレベルのコンテキストにおける現在の行レコード（例：テーブルの行ボタン）。 -
ctx.form: フォームレベルのコンテキストにおけるAntD Formインスタンス（例：フォームのツールバーボタン）。 -
ctx.collection: 現在のコレクションのメタ情報。 -
コードエディターは
Snippets（スニペット）とRun（プレ実行）をサポートしています（下記参照）。 -
ctx.requireAsync(url): URLを指定してAMD/UMDライブラリを非同期でロードします。 -
ctx.importAsync(url): URLを指定してESMモジュールを動的にインポートします。
実際に利用可能な変数は、ボタンの配置場所によって異なります。上記は一般的な機能の概要です。
エディターとスニペット
Snippets: 組み込みのコードスニペットリストを開き、検索して、現在のカーソル位置にワンクリックで挿入できます。Run: 現在のコードを直接実行し、実行ログを下部のLogsパネルに出力します。console.log/info/warn/errorをサポートし、エラーのハイライト表示と位置特定が可能です。
- AI従業員と連携してスクリプトを生成・修正できます：AI従業員・Nathan：フロントエンドエンジニア
一般的な使い方（簡略化された例）
1) APIリクエストと通知
2) コレクションボタン：選択の検証と処理
3) レコードボタン：現在の行レコードの読み取り
4) ビューを開く（ドロワー/ダイアログ）
5) 送信後のデータ更新
注意事項
- アクションの冪等性: 繰り返しクリックによる複数回の送信を防ぐため、ロジックに状態フラグを追加するか、ボタンを無効にすることができます。
- エラー処理: API呼び出しにはtry/catchブロックを追加し、ユーザーに分かりやすいフィードバックを提供してください。
- ビュー連携:
ctx.openViewでポップアップ/ドロワーを開く際は、明示的にパラメータを渡すことをお勧めします。必要に応じて、送信成功後に親リソースを積極的に更新してください。