DIV CSS 佈局教程網

AngularJS 表單初始值賦值與提交功能的實現
編輯:JavaScript綜合知識     

聽說 AngularJS 的表單處理比 jQuery 強不少,實際上手卻在「初始化賦值」這個看似簡單的環節卡住了。問題出在 ng-model 與 value 屬性的配合上——兩者對同一個字段的控制權存在衝突。

問題描述

寫了一個 AngularJS Form,發現初始化時 ng-model 綁定的模型值與 input 標籤上寫的 value 屬性並不默契,前者會覆蓋後者,導致頁面顯示不出預期的初始內容。

方案一:在 controller 裡預先賦值

最正統的做法是在 controller 中直接給 $scope 上的模型對象賦初值。若初值來自後端,用 PHP 等程序把數據輸出到這段腳本裡即可:

<!-- 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),   // 序列化為字符串
      // 讓 Angular 以表單數據而非請求體的形式傳遞
      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
    }).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">

方案二:用 ng-init

如果初值比較簡單,也可以直接在模板上掛 ng-init:

<input type="text" name="name" ng-model="formData.name"
       ng-init="formData.name='張三'" value="">

為什麼 value 屬性不生效

理解這件事需要抓住 AngularJS 的核心思想:數據流是單向的,從模型流向視圖。

AngularJS 在編譯階段會遍歷 DOM,遇到 ng-model 就把該元素與 scope 上的屬性建立雙向綁定。初始化時,它會用模型的當前值去設置元素的顯示值,而 HTML 裡手寫的 value 屬性只是元素的初始默認值(defaultValue),並不是模型的來源。

因此正確的心智模型是:要決定表單初始顯示什麼,就該去改模型,而不是改 HTML 屬性。這也正是方案一被推薦的原因。

幾點實務提醒

· 不要把 value 與 ng-model 混用。兩者同時存在時,value 的設定會被模型值覆蓋,徒增困惑。示例中把 value="" 留空正是這個道理。

· ng-init 只適合用於簡單場景。官方文檔明確提醒,在 controller 中初始化才是推薦做法,ng-init 主要留給嵌套 ng-repeat 等特殊用法。

· $.param() 依賴 jQuery。示例用這種方式把對象序列化成 a=1&b=2,前提是頁面加載了 jQuery,且 AngularJS 是在 jQuery 之後初始化的(此時 Angular 會使用 jQuery 而非內建的 jqLite)。若不想依賴 jQuery,可以自己寫一個簡單的序列化函數。

· success() 已廢棄。這種鏈式寫法是 AngularJS 1.x 早期的風格,後續版本改為在配置對象裡傳 then,或直接寫 .then(successFn, errorFn)。

· 注意 AngularJS 的版本現狀。AngularJS(1.x)已於 2022 年起停止長期支持。新專案應直接採用 Angular(2+),其表單方案分為模板驅動表單與響應式表單兩套,響應式表單通過 FormBuilder 顯式構造表單模型,初始值賦與的問題從設計上就不復存在。

總結起來,這個坑的教訓是:轉換框架時,別把舊框架「直接操作 DOM 屬性」的習慣帶進來。先想清楚數據在哪裡、視圖如何映射,多數困惑都能自行化解。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved