ng-model 把 HTML 表單元素與 scope 上的變數綁在一起,形成雙向連動:model 的值會呈現在欄位上,使用者在欄位裡的輸入也會即時寫回 model。
它幾乎是 AngularJS 最重要的一個指令——表單處理、即時驗證、 computed 屬性連動,全都建立在它之上。
把輸入框的值綁定到 scope 變數:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<script src="https://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script>
</head>
<body>
<div ng-app="myApp" ng-controller="myCtrl">
<input ng-model="name">
<p>input 輸入框的值綁定了變數 "name":</p>
{{name}}
</div>
<script>
var app = angular.module('myApp', []);
app.controller('myCtrl', function($scope) {
$scope.name = "John Doe";
});
</script>
<p>此範例示範如何用 ng-model 把輸入框的值綁定到 scope 變數。</p>
</body>
</html>
<element ng-model="name"></element>
<input>、<select>、<textarea> 元素支援。
name:要綁定到表單欄位的屬性名稱。若 scope 上不存在這個變數,Angular 會自動幫你建立。
除了雙向同步,ng-model 還默默處理了幾件事:
• 表單驗證狀態——搭配 required、type="email"、minlength 等屬性,ng-model 會在欄位上掛出 $valid、$dirty、$touched 等狀態與對應的 CSS class(如 ng-invalid、ng-dirty)。
• 型別轉換——type="number" 會轉成數字、type="date" 會轉成 Date 物件、type="checkbox" 會轉成布林值。
• CSS class 管理——依狀態自動加上 ng-pristine / ng-dirty、ng-valid / ng-invalid、ng-untouched / ng-touched。
ng-repeat、ng-if 都會建立子 scope。如果在 ng-repeat 裡直接寫:
<div ng-repeat="item in list"> <input ng-model="item.name"> <!-- 這裡 item 是物件,改的是它的屬性,沒問題 --> <input ng-model="selected"> <!-- 這裡會在子 scope 上建立新變數,外層讀不到! --> </div>
解法是用 $parent,或者養成「永遠綁定物件屬性」的習慣:
<input ng-model="$parent.selected">
<input ng-model="formData.selected"> <!-- 推薦:先在外層宣告 $scope.formData = {} -->
這條規則的由來是 JavaScript 的原型鏈:讀取不存在的屬性時會往父 scope 找,但賦值永遠發生在當前 scope。綁到物件的屬性上,就避開了這個問題。
修飾符選項:
• ng-model-options="{ debounce: 500 }"——延遲 500ms 才更新 model,可大幅減少即時驗證的開銷。
• ng-model-options="{ updateOn: 'blur' }"——改為離開欄位時才更新。
• ng-change——model 變化時執行的運算式,注意它只在值真的改變時才觸發,與 ng-keyup 不同。