萬盛學電腦網

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

三種方法徹底解決 Radio 單選框取消選中難題

為什麼 Radio 難以取消選中?

原生 `` 設計為單選組互斥:同 name 組內必有一項被選中,且無原生 API 取消選中。點擊已選項不會觸發 change 事件,導致用戶無法「改變主意」。

方法一:移除 checked 屬性(最簡直接)

// jQuery 方式
$('#cancelBtn').on('click', function () {
  $('input[name="browser"]').prop('checked', false);
  // 或 $('input[name="browser"]').removeAttr('checked');
});

// 原生 JS
document.getElementById('cancelBtn').addEventListener('click', function () {
  var radios = document.getElementsByName('browser');
  for (var i = 0; i < radios.length; i++) {
    radios[i].checked = false;
    radios[i].removeAttribute('checked');
  }
});

優點:代碼極少,語義清晰。
缺點:某些舊版 IE 下 removeAttr('checked') 不生效,需先 prop('checked', false) 再移除屬性。

方法二:隱藏佔位 Radio(無感切換)

<!-- HTML 預置一個隱藏的空值 radio -->
<input type="radio" name="browser" id="hideRadio" value="" style="display:none;" checked>

<script>
$('#byHideBtn').on('click', function () {
  $('#hideRadio').prop('checked', true); // 選中隱藏項,可見項自動取消
});
</script>

原理:同 name 組內永遠有且只有一項被選中。選中隱藏項,等價於取消所有可見項選中。
優點:不改變 DOM 結構,表單提交時提交空值,後端易處理。
缺點:需在 HTML 預置隱藏項,動態生成表單時需同步插入。

方法三:原生 DOM 遍歷清除(無依賴、兼容性最強)

document.getElementById('removeBtn').addEventListener('click', function () {
  var radios = document.getElementsByName('browser');
  var len = radios.length;
  for (var i = len - 1; i >= 0; i--) { // 逆序遍歷更安全
    radios[i].checked = false;
    radios[i].removeAttribute('checked');
  }
});

優點:零依賴,兼容所有瀏覽器(含 IE6+),不依賴 jQuery。
注意:必須先設置 checked = false 再 removeAttribute,順序不能顛倒。

完整可運行 Demo

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Radio 取消選中三種方式</title>
  <style>
    body { font-family: sans-serif; padding: 20px; }
    .radio-group { margin-bottom: 20px; }
    .radio-group label { display: block; margin: 8px 0; cursor: pointer; }
    button { margin-right: 10px; padding: 8px 16px; cursor: pointer; }
  </style>
</head>
<body>
  <p>您偏好的瀏覽器?</p>
  <div class="radio-group">
    <input type="radio" name="browser" id="hideBrowser" value="" style="display:none;" checked>
    <label><input type="radio" name="browser" value="Chrome"> Chrome</label>
    <label><input type="radio" name="browser" value="Firefox"> Firefox</label>
    <label><input type="radio" name="browser" value="Safari"> Safari</label>
    <label><input type="radio" name="browser" value="Edge"> Edge</label>
  </div>
  <button id="btn1">方式一:prop/removeAttr</button>
  <button id="btn2">方式二:切換隱藏項</button>
  <button id="btn3">方式三:原生 DOM 遍歷</button>

  <script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
  <script>
    $('#btn1').click(function () {
      $('input[name="browser"]').prop('checked', false).removeAttr('checked');
    });
    $('#btn2').click(function () {
      $('#hideBrowser').prop('checked', true);
    });
    $('#btn3').click(function () {
      var radios = document.getElementsByName('browser');
      for (var i = radios.length - 1; i >= 0; i--) {
        radios[i].checked = false;
        radios[i].removeAttribute('checked');
      }
    });
  </script>
</body>
</html>

進階場景:Vue/React 中的受控組件模式

// Vue 3 Composition API 示例
import { ref } from 'vue';

const selectedBrowser = ref(''); // 空字符串代表未選中

const browsers = ['Chrome', 'Firefox', 'Safari', 'Edge'];

function clearSelection() {
  selectedBrowser.value = ''; // 直接清空綁定值
}

// 模板
/*
*/

現代框架通過雙向綁定將「選中狀態」提升為單一數據源,取消選中僅需賦值空字符串,徹底規避 DOM 操作痛點。

總結對比

維度方法一:移除屬性方法二:隱藏佔位方法三:原生遍歷
代碼量極少少(需 HTML 配合)中等
依賴jQuery 或原生jQuery 或原生零依賴
表單提交值無值(未選中)空字符串無值
動態表單友好好需動態插入隱藏項好
推薦場景簡單頁面、jQuery 項目需提交空值給後端無庫環境、老舊瀏覽器

最佳實踐建議

  1. 新項目優先用框架雙向綁定,從源頭避免 DOM 操作
  2. jQuery 項目推薦方法一,配合 .prop('checked', false).removeAttr('checked') 雙保險
  3. 需向後端提交「用戶明確不選」語義時,用方法二(隱藏項 value="")
  4. 無庫環境或混合渲染頁面,方法三最穩健
  5. UX 提升:取消選中後,可添加視覺提示(如置灰標籤)或彈窗確認,避免誤操作
copyright © 萬盛學電腦網 all rights reserved