萬盛學電腦網

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

JavaScript 動態修改 Radio 單選框選中狀態:正確屬性用法與常見錯誤

動態設置 Radio 按鈕選中狀態時,常犯錯誤:使用 .style.checked、設置字符串 "checked"、或操作 attribute 而非 property。本文對比錯誤與正確寫法,給出原生與 jQuery 通用方案。

HTML 結構

<input type="radio" name="gender" id="radionan" value="male"> 男
<input type="radio" name="gender" id="radionv" value="female"> 女

錯誤演示

// 錯誤 1:操作 style.checked(不存在)
document.getElementById('radionan').style.checked = "checked"; // 無效

// 錯誤 2:設置 checked 為字符串
document.getElementById('radionan').checked = "checked"; // 某些瀏覽器可能生效,但語義錯誤

// 錯誤 3:使用 setAttribute(修改 HTML 屬性,不改變 DOM property)
document.getElementById('radionan').setAttribute('checked', 'checked'); 
// 初始渲染有效,但動態切換時 UI 不一定更新,且再次點擊行為異常

正確寫法:操作 DOM Property checked (Boolean)

原生 JavaScript

function setGender(gender) {
    var male = document.getElementById('radionan');
    var female = document.getElementById('radionv');
    if (gender === '男') {
        male.checked = true;   // 布爾 true
    } else {
        female.checked = true;
    }
}
// 調用
setGender('男');

jQuery

function setGender(gender) {
    if (gender === '男') {
        $('#radionan').prop('checked', true); // 推薦 prop
        // $('#radionan').attr('checked', 'checked'); // 不推薦
    } else {
        $('#radionv').prop('checked', true);
    }
}

核心原理:Attribute vs Property

概念HTML AttributeDOM Property
定義標籤屬性,初始值DOM 節點實時狀態
checkedchecked="checked"(存在即真)true/false(當前是否勾選)
同步初始化時 Attribute → Property用戶交互/JS 修改 Property,Attribute 不變
操作方法getAttribute/setAttribute/removeAttribute.checked / .prop('checked')

獲取當前選中值

// 原生
var val = document.querySelector('input[name="gender"]:checked').value;

// jQuery
var val = $('input[name="gender"]:checked').val();
// 或
var val = $('input[name="gender"]').filter(':checked').val();

封裝通用工具函數

function setRadioChecked(name, value) {
    // name: radio group name, value: 要選中的 option value
    var radios = document.getElementsByName(name);
    for (var i = 0; i < radios.length; i++) {
        if (radios[i].value === value) {
            radios[i].checked = true;
            break;
        }
    }
}

function getRadioChecked(name) {
    var radios = document.getElementsByName(name);
    for (var i = 0; i < radios.length; i++) {
        if (radios[i].checked) return radios[i].value;
    }
    return null;
}

常見坑點提醒

  1. 同名 Radio 組:同一 name 只能單選,設置其中一個 checked=true 會自動取消其他。
  2. 動態新增 Radio:必須設置相同 name,且 type="radio",插入 DOM 後再 .prop('checked', true)。
  3. 表單重置:form.reset() 會恢復到 HTML 初始 checked 屬性狀態,而非 JS 修改後的狀態。
  4. disabled 狀態下:仍可通過 JS 修改 checked,但用戶不可點擊。

牢記:動態修改勾選狀態,只操作 checked 屬性(布爾值),用 .prop() 或直接 .checked = true。

copyright © 萬盛學電腦網 all rights reserved