#ctx.collection

現在の RunJS 実行コンテキストに関連付けられたコレクション（Collection）インスタンスです。コレクションのメタデータ、フィールド定義、主キーなどの設定にアクセスするために使用されます。通常、ctx.blockModel.collection または ctx.collectionField?.collection から取得されます。

#适用シーン

注意：ctx.collection は、データブロック、フォームブロック、テーブルブロックなど、コレクションがバインドされているシーンで利用可能です。コレクションがバインドされていない独立した JSBlock では null になる可能性があるため、使用前に空値チェックを行うことを推奨します。

#型定義

collection: Collection | null | undefined;

#常用プロパティ

#常用メソッド

#ctx.collectionField、ctx.blockModel との関係

子テーブルなどのシーンでは、ctx.collection は関連先のコレクションを指す場合があります。通常のフォームやテーブルでは、一般的にブロックにバインドされたコレクションを指します。

#示例

#主キーを取得してポップアップを開く

const primaryKey = ctx.collection?.filterTargetKey ?? 'id';
await ctx.openView(popupUid, {
  mode: 'dialog',
  params: {
    filterByTk: ctx.record?.[primaryKey],
    record: ctx.record,
  },
});

#フィールドをループしてバリデーションや連動を行う

const fields = ctx.collection?.getFields() ?? [];
const requiredFields = fields.filter((f) => f.options?.required);
for (const f of requiredFields) {
  const v = ctx.form?.getFieldValue(f.name);
  if (v == null || v === '') {
    ctx.message.warning(`${f.title} は必須です`);
    return;
  }
}

#関連フィールドを取得する

const oneToMany = ctx.collection?.getAssociationFields(['many']) ?? [];
// 子テーブルや関連リソースの構築などに使用

#注意事項

• filterTargetKey はコレクションの主キーフィールド名です。一部のコレクションでは string[] 型の複合主キーになる場合があります。設定されていない場合は、一般的に 'id' がフォールバックとして使用されます。
• 子テーブルや関連フィールドなどのシーンでは、ctx.collection は関連先のコレクションを指すことがあり、ctx.blockModel.collection とは異なる場合があります。
• getFields() は継承されたコレクションのフィールドをマージします。自身のフィールドは、同名の継承フィールドを上書きします。

#関連情報

• ctx.collectionField：現在のフィールドのコレクションフィールド定義
• ctx.blockModel：現在の JS を保持する親ブロック（collection を含む）
• ctx.model：現在のモデル（collection を含む場合がある）