「勾選幾個名字,上面的輸入框就自動填成以逗號分隔的字串」是很常見的表單互動,用在標籤選擇、收件人設定、篩選條件都很順手。取消勾選時也要能同步移除,才不會留下殘留值。
關鍵是別依賴 value,而是用自訂的 data-value 存放要顯示的文字。因為 value 通常要留給後端當作實際值,兩者職責分開比較清楚。
<table class="tablist">
<tr>
<td>
<input class="txtValue" type="text" name="keleyi" value="" />
<input type="checkbox" data-type="checkall" />全選
</td>
</tr>
<tr>
<td>
<input type="checkbox" name="keleyi" data-type="checkbox" data-value="張三" value="1" />張三
<input type="checkbox" name="keleyi" data-type="checkbox" data-value="李四" value="2" />李四
<input type="checkbox" name="keleyi" data-type="checkbox" data-value="柯樂義" value="3" />柯樂義
<input type="checkbox" name="keleyi" data-type="checkbox" data-value="趙六" value="4" />趙六
</td>
</tr>
</table>
用 data-type="checkbox" 與 data-type="checkall" 區分兩種角色,比靠 name 或位置來猜更明確。
$(function () {
$('[data-type="checkbox"]').click(function () {
var data_value = $(this).attr('data-value'),
txtalso = $.trim($(".txtValue").val());
if ($(this).prop("checked")) {
// 勾選:若尚未存在則附加
if (txtalso.length > 0) {
if (txtalso.indexOf(data_value + ',') != -1) return;
txtalso += data_value + ',';
} else {
txtalso = data_value + ',';
}
} else {
// 取消:從字串中移除
if (txtalso.indexOf(data_value + ',') != -1) {
txtalso = txtalso.replace(data_value + ',', '');
}
}
$(".txtValue").val(txtalso);
});
$('[data-type="checkall"]').click(function () {
var str = '';
if ($(this).prop("checked")) {
$.each($('[data-type="checkbox"]'), function () {
str += $(this).attr('data-value') + ',';
});
$('[data-type="checkbox"]').prop('checked', true);
} else {
$('[data-type="checkbox"]').prop('checked', false);
}
$(".txtValue").val(str);
});
});
用 prop() 而不是 attr()。在 jQuery 1.6 之後,checked 這類「動態狀態」必須用 prop() 讀寫。attr("checked") 讀到的是 HTML 初始狀態,勾選後仍會回傳未勾選的結果,這是很經典的坑。
比對時把逗號一起帶上。寫成 indexOf(data_value + ',') 而非單純 indexOf(data_value),可以避免「李四」意外命中「李四分」之類的部分比對問題。
目前的字串拼接寫法在選項變多時容易出錯,實務上更穩健的做法是改用陣列:
var list = $(".txtValue").val() ? $(".txtValue").val().split(',') : [];
// 過濾空字串後,用 push / splice 增刪,最後 list.join(',')
另外記得處理結尾多餘的逗號,並在送出表單前把結果 trim 乾淨。若欄位要交給後端,也建議同時用隱藏欄位保存 value(1、2、3…)而非顯示文字,避免使用者手動改字造成資料不一致。
這個範例的骨架很輕,稍作擴充就能延伸成標籤輸入框、多選下拉、權限勾選樹等功能。