メインコンテンツまでスキップ

insertDSValue

insertDSValue

DataSetのリストフィールドの先頭に新しい行データを挿入します。

パラメータ

  • recordPathString): DataSet内のリストフィールドのパス(例: "ds.list"
  • jsonDataany): 挿入する行データ。オブジェクトまたはオブジェクトの配列

戻り値: boolean — 成功した場合はtrue、パスが無効な場合はfalse

説明

DataSetのリストフィールドの先頭(index 0)に新しい行を挿入します。既存の行はインデックスが1つずつ後ろにずれます。オブジェクトの配列を渡すと複数の行を一度に挿入できます。挿入された行は即座にDataSetへ反映され、バインドされたUIが更新されます。

Example

// DataSet ds의 list 필드 맨 앞에 행 삽입
$vm.insertDSValue("ds.list", { name: "새 항목", price: 0 });

// 여러 행 한꺼번에 삽입
$vm.insertDSValue("ds.list", [
{ name: "항목A", price: 100 },
{ name: "항목B", price: 200 }
]);

関連

  • $vm.appendDSValue(recordPath, jsonData) — DataSetリストの末尾に行を追加
  • $vm.deleteDSValue(recordPath, count) — DataSetリストから行を削除
  • $vm.getDataCount(fieldPath) — DataSetリストの行数を取得