본문으로 건너뛰기

insertDSValue

insertDSValue

DataSet의 리스트 필드 맨 앞에 새 행 데이터를 삽입합니다.

파라미터

  • recordPath (String): DataSet 내 리스트 필드 경로 (예: "ds.list")
  • jsonData (any): 삽입할 행 데이터. 객체 또는 객체 배열

반환: 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 리스트 행 수 조회