HOWTO · Angular
如何在 AngularJS 中使用 angular.copy 進行複製
本教程說明如何在 AngularJS 中使用 angular.copy 進行深層複製,並介紹其兩種呼叫形式與表單狀態模式。
本頁內容
angular.copy 是 AngularJS API,可用來複製值,通常是物件或陣列;副本的修改不會因共用巢狀物件參照而改變原始值。本指南介紹兩種呼叫形式,以及表單狀態的實用模式。本文介紹的是 AngularJS;現代 Angular 並未提供這個 AngularJS API。
了解 angular.copy 的深層複製行為
淺層複製會建立新的外層物件,但巢狀物件仍可能共用。深層複製會遞迴複製巢狀資料,因此修改副本中的巢狀屬性,不會改變來源中的該屬性。可以把它理解為物件狀態彼此獨立;深層複製並不保證特定的實體記憶體配置。
例如,若 source.profile 是物件,執行 copy = angular.copy(source) 後,修改 copy.profile.name 不會改變 source.profile.name。當表單或編輯器需要一份可操作的資料,同時保留另一份基準資料以供重設時,這種做法很有用。
不指定目的地進行複製
只傳入一個引數呼叫 angular.copy(source),即可建立並傳回新的副本。請保留傳回值,例如 var savedForm = angular.copy($scope.form);。原始資料仍可作為來源,而 savedForm 則可作為快照,供日後比較或重設使用。
接下來的可執行 JavaScript 參考範例會說明,為什麼巢狀狀態需要獨立的副本。範例使用 JavaScript 語言的 structuredClone 操作,而不是 AngularJS;因此其輸出只展示參照行為,並未測試 angular.copy。
執行這個 JavaScript 參考範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
const source = { profile: { name: "Mina" } };
const copy = structuredClone(source);
copy.profile.name = "Lee";
console.log(source.profile.name);
console.log(copy.profile.name);
Mina
Lee
複製到既有目的地
當應用程式的其他部分必須保留目的地物件的識別性時,請使用 angular.copy(source, destination)。AngularJS 會將來源資料複製到目的地,並傳回該目的地。若範圍屬性或其他使用者已持有目的地物件的參照,這種方式就很有用。例如,angular.copy($scope.form, savedForm) 會將目前表單的資料更新到已儲存的物件,同時保留 savedForm 參照。
兩種形式用途不同:只有一個引數的形式會提供新的值供你儲存;有兩個引數的形式則會更新你已持有的物件。如果其他程式碼依賴既有的目的地參照,請避免改用新傳回的物件來取代它。
重設與儲存表單狀態
表單初始化時先建立快照:var savedForm = angular.copy($scope.form);。若要重設欄位並保留既有的表單物件,請使用 angular.copy(savedForm, $scope.form)。若要用使用者目前的編輯內容取代已儲存的基準資料,請使用 angular.copy($scope.form, savedForm)。第一個引數一律是來源,第二個引數是目的地;對調兩者就會反轉複製方向。
插圖展示了姓名欄位、重設與儲存控制項,以及旁邊顯示的表單和成員值。這些值有助於理解範例預期呈現的狀態關係;它們不是 AngularJS 執行環境的輸出。
限制與不支援的值
請勿將同一個物件同時作為兩個引數:angular.copy(value, value) 不是受支援的自我複製呼叫。使用雙引數形式時,請傳入不同的目的地。目的地形式也會修改物件;持有該目的地參照的程式碼會看到內容更新。
提供的任務資料不包含 AngularJS 執行結果或權威 API 參考文件,因此本文不會概括說明所有 JavaScript 值類型或由框架管理的物件之行為。若要依賴特殊值的複製行為,請先查閱應用程式所用版本的 AngularJS 文件。上方可執行的參考範例明確展示的是 JavaScript 行為,並不能證明曾執行 AngularJS 呼叫。