初次接觸 AngularJS 時,最直觀的感受是它對表單的處理方式與 jQuery 思維完全不同。本文記錄一次表單編輯與提交的實作過程,以及踩到的資料初始化問題。
剛開始照著網路上的範例寫 AngularJS Form,很快遇到一個尷尬的情況:ng-model 與 input 標籤上的 value 屬性「打架」了。
傳統做法是在服務端把資料渲染進 value:
<input type="text" name="name" value="張三">
但 AngularJS 的資料流是單向從 $scope 流向檢視,ng-model 一旦生效,value 屬性的初始值就被忽略。這正是初學者最容易困惑的地方:不是 value 沒生效,而是 AngularJS 根本不採用這種方式注入初始資料。
正確做法是在 controller 裡宣告資料模型的初始狀態:
<!-- AngularJS controller -->
<script>
var formApp = angular.module('formApp', []);
function formController($scope, $http) {
$scope.formData = { 'name': '張三', 'remark': '備注' };
$scope.myForm = function() {
$http({
method : 'POST',
url : '/role/edit',
data : $.param($scope.formData), // pass in data as strings
headers : { 'Content-Type': 'application/x-www-form-urlencoded' } // set the headers so angular passing info as form data (not request payload)
})
.success(function(data) {
console.log(data);
if (!data.success) {
// 失敗處理
} else {
// 成功處理
}
});
};
}
</script>
<!--對應 form 裡的 input 調整-->
<input type="text" name="name" ng-model="formData.name" class="form-control" placeholder="Role Name">
這裡有兩個值得留意的細節。
第一,如果後端是 PHP 之類的程式,可以在輸出 controller 初始化程式碼時直接把值填進去,讓服務端資料流入 $scope。
第二,$http 預設送出的是 JSON 請求體,而傳統後端(尤其是 PHP 的 $_POST)期待的是 urlencoded 格式。因此需要透過 `$.param()` 序列化,並顯式設定 Content-Type 為 `application/x-www-form-urlencoded`,兩者必須成對出現,否則後端收不到參數。
另外要提醒的是,`.success()` 與 `.error()` 在較新版本的 AngularJS 中已被移除,應改用 `.then()` 搭配 `.catch()`,或直接使用 await/async 風格。
如果只是想給單個欄位一個初始值,也可以用 ng-init:
<input type="text" name="name" ng-model="formData.name" ng-init="formData.name='張三'" value="">
ng-init 會在建立作用域時執行表達式,因此能在 ng-model 綁定前把值放好。但要清楚它的定位:官方文件明確指出 ng-init 只適合用於 ng-repeat 的特殊場景與少數初始化需求,不應作為表單預設值的常規手段。表單的初始狀態應該由 controller 統一管理,這才是 AngularJS 推薦的思路。
從 jQuery 遷移到 AngularJS,最大的思維轉變是「不要再去操作 DOM 的 value,而是操作模型」。所有初始值、所有狀態變化,都應該反映到 $scope 上的資料物件;檢視層的更新由框架負責。理解這一點之後,ng-model 與 value 的「衝突」就自然消失了。