AngularJS 處理表單的核心能力是雙向數據綁定:界面改數據變,數據改界面也變。單選框(radio)與復選框(checkbox)在這套機制下寫起來非常輕,但也有幾個容易忽略的細節。本文逐一說明。
只需要兩個文件:index.html 放界面,app.js 放 Angular 代碼。
// app.js
var formApp = angular.module('formApp', [])
.controller('formController', function ($scope) {
// 用一個對象集中保存所有表單數據
$scope.formData = {};
});
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css">
<style>
body { padding-top:50px; }
form { margin-bottom:50px; }
</style>
<script src="https://code.angularjs.org/1.2.13/angular.js"></script>
<script src="app.js"></script>
</head>
<body ng-app="formApp" ng-controller="formController">
<div class="col-xs-12 col-sm-10 col-sm-offset-1">
<h2>Angular Checkboxes and Radio Buttons</h2>
<form>
<div class="form-group">
<label>Name</label>
<input type="text" class="form-control" name="name" ng-model="formData.name">
</div>
<!-- 復選框與單選框放在這裡 -->
<button type="submit" class="btn btn-danger btn-lg">Send Away!</button>
</form>
<!-- 實時展示 formData 對象 -->
<h2>Sample Form Object</h2>
<pre> {{ formData }} </pre>
</div>
</body>
</html>
在 name 輸入框裡打字,下方 <pre> 中的 formData 會實時變化——這就是雙向綁定的直觀演示,後續所有控件都基於同一套機制。
一組復選框對應「多個可選值」,常見做法是在 formData 下再嵌套一個對象,每個選項一個布爾字段:
<!-- MULTIPLE CHECKBOXES -->
<label>Favorite Colors</label>
<div class="form-group">
<label class="checkbox-inline">
<input type="checkbox" name="favoriteColors" ng-model="formData.favoriteColors.red"> Red
</label>
<label class="checkbox-inline">
<input type="checkbox" name="favoriteColors" ng-model="formData.favoriteColors.blue"> Blue
</label>
<label class="checkbox-inline">
<input type="checkbox" name="favoriteColors" ng-model="formData.favoriteColors.green"> Green
</label>
</div>
勾選任意一項,下方的 formData 立刻反映出對應字段變為 true。提交時直接把 formData.favoriteColors 傳給後端即可。
如果後端期望的是數組(如 ["red","blue"])而非對象,可以在提交前做一次轉換,或用 ng-repeat 遍歷選項列表、配合 ng-checked 與一個數組字段來維護。
有的時候勾選後需要觸發額外邏輯——重算總價、聯動其他字段。做法是在控制器裡定義函數,再用 ng-click 調用:
// app.js
$scope.onColorChange = function () {
console.log($scope.formData.favoriteColors);
};
<input type="checkbox" ng-model="formData.favoriteColors.red" ng-click="onColorChange()"> Red
不過要留意:ng-click 的執行時序與 ng-model 的更新時機,在複雜聯動場景下更推薦用 ng-change,語義更貼近「值變化」而非「被點擊」。
默認情況下復選框綁定的是 true / false。若想讓勾選與取消分別對應自定義值,用 ng-true-value 與 ng-false-value:
<!-- CUSTOM VALUE CHECKBOXES -->
<label>Personal Question</label>
<div class="checkbox">
<label>
<input type="checkbox" name="awesome"
ng-model="formData.awesome"
ng-true-value="ofCourse"
ng-false-value="iWish">
Are you awesome?
</label>
</div>
此時 formData.awesome 的值會是字符串 "ofCourse" 或 "iWish",適合直接對接枚舉類型的後端字段。
單選框比復選框簡單,因為它只需要存一個值。關鍵是同一組內所有項的 name 必須相同、ng-model 也指向同一個字段,靠 value 區分選項:
<!-- RADIO BUTTONS -->
<label>Chicken or the Egg?</label>
<div class="form-group">
<div class="radio">
<label>
<input type="radio" name="chickenEgg" value="chicken" ng-model="formData.chickenEgg">
Chicken
</label>
</div>
<div class="radio">
<label>
<input type="radio" name="chickenEgg" value="egg" ng-model="formData.chickenEgg">
Egg
</label>
</div>
</div>
Angular 為 radio 提供的屬性如下:
<input type="radio"
ng-model="string"
value="string"
[name="string"]
[ng-change="string"]
ng-value="string">
ng-value 允許把 value 綁定到一個表達式上,這樣選項值就能是數字或對象,而不局限於字符串——這一點在渲染動態選項列表時特別有用。
formData 對象,提交與調試都方便。value 區分。ng-change,比 ng-click 更貼合「值變化」語義。ng-true-value / ng-false-value 直接輸出後端期望的值,省一層映射。ng-value 綁定表達式,避免字符串拼接。