萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AngularJS 表單實戰:Checkbox 與 Radio 綁定、自定義值、動態列表最佳實踐

基礎綁定:ng-model 雙向同步

AngularJS 通過 ng-model 將表單控件與作用域模型雙向綁定,Checkbox/Radio 同理。

單個 Checkbox → Boolean

<input type="checkbox" ng-model="user.agreeTerms"> 同意條款
<span>狀態: {{ user.agreeTerms }}</span> <!-- true/false -->

多個 Checkbox → 陣列(常見場景:興趣標籤、權限選擇)

<div ng-init="user.interests = []">
  <label><input type="checkbox" value="vue" ng-model="user.interests" ng-true-value="'vue'" ng-false-value="''"> Vue</label>
  <label><input type="checkbox" value="react" ng-model="user.interests" ng-true-value="'react'" ng-false-value="''"> React</label>
  <label><input type="checkbox" value="angular" ng-model="user.interests" ng-true-value="'angular'" ng-false-value="''"> Angular</label>
</div>
<pre>{{ user.interests | json }}</pre> <!-- ["vue","react"] -->

關鍵點:同一 ng-model 綁定到陣列,配合 ng-true-value/ng-false-value 實現「選中添加、取消移除」。ng-false-value="''" 配合陣列去重邏輯(Angular 內部處理)。

Radio 單選 → 字符串/數值

<div>
  <label><input type="radio" ng-model="user.gender" value="male"> 男</label>
  <label><input type="radio" ng-model="user.gender" value="female"> 女</label>
  <label><input type="radio" ng-model="user.gender" value="other"> 其他</label>
</div>
<p>選擇: {{ user.gender }}</p>

同 name 屬性的 Radio 共享一個 ng-model,選中項的 value 自動賦值。

進階場景與技巧

1. 自定義真/假值(非布爾)

<!-- 存儲 'yes'/'no' 而非 true/false -->
<input type="checkbox" ng-model="form.subscribe" ng-true-value="'yes'" ng-false-value="'no'">
<!-- 存儲 1/0 -->
<input type="checkbox" ng-model="form.active" ng-true-value="1" ng-false-value="0">

2. 動態生成選項列表(ng-repeat + ng-model)

<!-- Controller: $scope.tags = ['前端','後端','運維','測試']; $scope.selectedTags = []; -->
<div ng-repeat="tag in tags">
  <label>
    <input type="checkbox" 
           ng-model="selectedTags" 
           ng-true-value="{{tag}}" 
           ng-false-value="''">
    {{ tag }}
  </label>
</div>
<button ng-click="submitTags()" ng-disabled="selectedTags.length === 0">提交選中標籤</button>

3. Checkbox 點擊觸發業務邏輯(ng-change / ng-click)

<input type="checkbox" ng-model="vm.enableFeature" ng-change="vm.onFeatureToggle()">


vm.onFeatureToggle = function() {
  if (vm.enableFeature) {
    Analytics.track('feature_enabled');
    loadHeavyModule();
  } else {
    unloadModule();
  }
};

4. 全選/反選功能

<input type="checkbox" ng-model="selectAll" ng-change="toggleAll()"> 全選
<div ng-repeat="item in items">
  <input type="checkbox" ng-model="item.selected"> {{ item.name }}
</div>

$scope.toggleAll = function() {
  angular.forEach($scope.items, function(item) {
    item.selected = $scope.selectAll;
  });
};

5. 綁定到對象屬性(而非陣列)

<!-- 適合固定鍵值對,如權限矩陣 -->
<label><input type="checkbox" ng-model="permissions.read"> 讀取</label>
<label><input type="checkbox" ng-model="permissions.write"> 寫入</label>
<label><input type="checkbox" ng-model="permissions.delete"> 刪除</label>
<!-- $scope.permissions = { read: true, write: false, delete: false } -->

表單驗證結合

<form name="profileForm">
  <div ng-repeat="role in availableRoles">
    <label>
      <input type="checkbox" 
             name="role_{{role.id}}" 
             ng-model="user.roles[role.id]" 
             ng-true-value="role.id" 
             ng-false-value="null"
             required> {{ role.name }}
      <span ng-show="profileForm['role_' + role.id].$error.required">至少選一個角色</span>
    </label>
  </div>
  <button ng-disabled="profileForm.$invalid">保存</button>
</form>

每個 Checkbox 有獨立 name,納入 form.$error 統一驗證。

常見坑與避坑指南

問題原因解決
Checkbox 狀態不同步ng-model 綁定基本類型字符串而非對象/陣列屬性確保 ng-model 指向對象屬性:ng-model="form.tags" 而非 ng-model="tags"(原始值傳遞)
動態添加選項不生效ng-repeat 作用域隔離,ng-model 指向子作用域使用對象屬性:ng-model="selection[tag]",selection 定義在父作用域
Radio 未取消選中同名 Radio 缺少統一 ng-model同組 Radio 必須共享同一 ng-model
ng-true-value 不生效值未加引號被當作變量ng-true-value="'stringValue'" 單引號包裹字面量

最佳實踐總結

  1. 統一數據結構:多選用陣列 [],單選用字符串/數字
  2. 利用 ng-true-value/ng-false-value 解耦顯示值與存儲值
  3. 動態列表綁定到父作用域對象 避免原始值傳遞陷阱
  4. 表單驗證覆蓋所有字段:動態 name + $error 統一管理
  5. 業務邏輯放入 ng-change 而非 $watch,性能更好、意圖更清晰
  6. 提交前序列化:陣列直接 JSON 提交,對象扁平化

完整 Demo 控制器

angular.module('formDemo', [])
.controller('FormDemoCtrl', function($scope) {
  $scope.form = {
    interests: [],
    gender: 'male',
    subscribe: 'no',
    permissions: { read: true, write: false, execute: false }
  };
  
  $scope.tags = ['Vue', 'React', 'Angular', 'Svelte'];
  $scope.availableRoles = [
    { id: 'admin', name: '管理員' },
    { id: 'editor', name: '編輯' },
    { id: 'viewer', name: '訪客' }
  ];
  
  $scope.submit = function() {
    console.log('提交數據:', angular.toJson($scope.form, true));
  };
});

結語

AngularJS 對 Checkbox/Radio 的支持極其強大:ng-model + ng-true-value/ng-false-value 組合可覆蓋 99% 的表單場景。理解「數據結構決定綁定方式」(陣列 vs 對象屬性)、「作用域繼承影響綁定目標」兩大核心原則,即可輕鬆應對複雜表單交互。配合 ng-repeat 動態渲染、ng-change 業務聯動、form.$valid 整體驗證,構建出專業級表單體驗。

copyright © 萬盛學電腦網 all rights reserved