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