「從全部成員中挑幾個加入群組」是典型的雙清單穿梭(shuttle)介面。左邊是已選,右邊是候選,中間放添加與移除鈕,右邊上方再附一個搜尋框。這個實作以 jQuery 完成,並額外處理了部門折疊與狀態同步。
三個 hidden 欄位保存狀態:newAddMembersId(本次新增)、deleteMembersId(本次移除)、existedMemberId(原本就有)。用 id 字串以逗號串接,而不是直接依賴畫面上的 DOM,這是為了讓「取消一項操作後再重做」的情況能正確處理。
function addMember() {
// 把右側選中的項加入左側
var add = $("#newAddMembersId").val();
var del = $("#deleteMembersId").val();
var ext = $("#existedMemberId").val();
var addedUsers = $("#enterpriseMember input:checkbox[checked]");
for (var i = 0; i < addedUsers.length; i++) {
var checkbox = $(addedUsers[i]);
var uid = checkbox.next().val();
// 已存在且未經移除的,或已在新增清單中的,跳過
if (add.indexOf(uid) >= 0 || (ext.indexOf(uid) >= 0 && del.indexOf(uid) < 0)) continue;
if (!(ext.indexOf(uid) >= 0 && del.indexOf(uid) >= 0)) {
if (add.indexOf(uid) < 0) {
if (add.length == 0) add += uid;
else add += "," + uid;
}
}
checkbox.removeAttr("checked");
var userDiv = checkbox.parent().parent().parent();
$("#groupMember").append(userDiv.clone());
// 若原本在移除清單中,現在被加回來了,就從移除清單剔除
del = del.replace(uid + ",", "");
del = del.replace(uid, "");
$("#deleteMembersId").val(del);
}
$("#newAddMembersId").val(add);
}
function removeMember() {
// 左側移除成員
var add = $("#newAddMembersId").val();
var del = $("#deleteMembersId").val();
var removedUsers = $("#groupMember input:checkbox[checked]");
for (var i = 0; i < removedUsers.length; i++) {
var checkbox = $(removedUsers[i]);
var uid = checkbox.next().val();
if (del.indexOf(uid) >= 0) continue;
if (del.indexOf(uid) < 0) {
if (del.length == 0) del += uid;
else del += "," + uid;
}
checkbox.removeAttr("checked");
var userDiv = checkbox.parent().parent().parent();
userDiv.remove();
add = add.replace(uid + ",", "");
add = add.replace(uid, "");
$("#newAddMembersId").val(add);
}
$("#deleteMembersId").val(del);
}
// 依名字或部門搜尋成員
function searchMember() {
var searchTxt = $.trim($("#searchTxt").val());
var memberLIsts = $(".dmlist");
// 移除上次的結果
var lastReusts = $(".tempResult");
for (var i = 0; i < lastReusts.length; i++) $(lastReusts[i]).remove();
// 空字串顯示全部
if (searchTxt == "" || searchTxt == "搜索企業成員") {
for (var i = 0; i < memberLIsts.length; i++) $(memberLIsts[i]).css("display", "");
return;
}
// 先隱藏全部
for (var i = 0; i < memberLIsts.length; i++) $(memberLIsts[i]).css("display", "none");
var enterpriseMemberDiv = $("#enterpriseMember");
// 依名字搜尋
var names = $(".sname");
for (var i = 0; i < names.length; i++) {
var name = $(names[i]).text();
if (name.indexOf(searchTxt) >= 0) {
var result = $(names[i]).parent().parent().parent().clone();
result.addClass("tempResult");
result.css("display", "");
enterpriseMemberDiv.append(result);
}
}
// 依部門搜尋
var departmentNames = $(".sdepartment");
for (var i = 0; i < departmentNames.length; i++) {
var name = $(departmentNames[i]).text();
if (name.indexOf(searchTxt) >= 0) {
var result = $(departmentNames[i]).parent().parent().parent().clone();
result.addClass("tempResult");
result.css("display", "");
enterpriseMemberDiv.append(result);
}
}
}
function clearTxt() {
if ($.trim($("#searchTxt").val()) == "搜索企業成員") $("#searchTxt").val("");
}
function setsearchTxt() {
if ($.trim($("#searchTxt").val()) == "") $("#searchTxt").val("搜索企業成員");
}
// 折疊器:點箭頭
function folderToggle(event, basePath) {
var arrowDiv = event.target || event.srcElement;
var closeimg = basePath + "/images/folder_close.PNG";
var openimg = basePath + "/images/folder_open.PNG";
var srcval = $(arrowDiv).attr("src");
if (srcval == closeimg) $(arrowDiv).attr("src", openimg);
if (srcval == openimg) $(arrowDiv).attr("src", closeimg);
var listDiv = $(arrowDiv).parent().next().next().next();
listDiv.toggleClass("memberlist");
}
// 點部門名稱折疊
function folderNameToggle(event, basePath) {
var arrowDiv = event.target || event.srcElement;
var closeimg = basePath + "/images/folder_close.PNG";
var openimg = basePath + "/images/folder_open.PNG";
var srcval = $(arrowDiv).attr("src");
if (srcval == closeimg) $(arrowDiv).attr("src", openimg);
if (srcval == openimg) $(arrowDiv).attr("src", closeimg);
var listDiv = $(arrowDiv).parent().next().next();
listDiv.toggleClass("memberlist");
}
// 點人數折疊
function folderNumToggle(event, basePath) {
var arrowDiv = event.target || event.srcElement;
var closeimg = basePath + "/images/folder_close.PNG";
var openimg = basePath + "/images/folder_open.PNG";
var srcval = $(arrowDiv).attr("src");
if (srcval == closeimg) $(arrowDiv).attr("src", openimg);
if (srcval == openimg) $(arrowDiv).attr("src", closeimg);
var listDiv = $(arrowDiv).parent().parent().next().next();
listDiv.toggleClass("memberlist");
}
// 切換按鈕的啟用/停用樣式
function setCss(event, onoff) {
var theclass = $.trim(onoff);
var offclass = "addmemberBtnoff";
var onclass = "addmemberBtnon";
var thisbtn = event.target || event.srcElement;
$(thisbtn).removeClass(onclass).removeClass(offclass);
if (theclass == "on") $(thisbtn).addClass(onclass);
else $(thisbtn).addClass(offclass);
}
<%@ page language="java" pageEncoding="UTF-8"%>
<%@ include file="/pages/common/Taglibs.jsp"%>
<%@ include file="/pages/common/Header.jsp"%>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
<title>添加群組成員</title>
<script type="text/javascript" src="<%=basePath%>/script/group.js"></script>
<script type="text/javascript">
$(document).keydown(function (event) {
if (event && event.keyCode == 13) $("#searchBtn").click();
});
function saveChanges() {
var deleteMembersId = $("#deleteMembersId").val();
var newAddMembersId = $("#newAddMembersId").val();
var group_id = $("#group_id").val();
window.location.href = "<%=basePath%>/server/group!saveGroupMember?group_id="
+ group_id
+ "&newAddMembersId=" + newAddMembersId
+ "&deleteMembersId=" + deleteMembersId;
}
</script>
</head>
<body class="bgClass">
<div id="addGroupMembercontainer" style="padding:20px 40px;">
<!-- 左側:群組現有成員 -->
<div class="roundGroup" style="float:left;width:241px;height:380px;">
<div style="margin-bottom:5px;margin-top:10px;">
<span class="spangrouptitle">群組<s:property value="group_name"/></span>
<span id="menberCount">${gNumber}人</span>
</div>
<div id="groupMember" style="height:306px;overflow-y:auto;">
<s:iterator value="#request.groupMemberList" id="gmember">
<div>
<div onclick="toggleCheck(event);">
<input type="checkbox" />
<input type="hidden" value="<s:property value="#gmember.id"/>" name="userId" />
<span><s:property value="#gmember.name" /></span>
<span class="positionblue"><s:property value="#gmember.position_name" /></span>
</div>
</div>
</s:iterator>
</div>
</div>
<!-- 中間:操作鈕 -->
<div style="float:left;width:80px;padding-top:150px;text-align:center;">
<input class="addmemberBtn addmemberBtnon"
onmouseover="setCss(event,'on')" onmouseout="setCss(event,'off')"
type="button" value="<<添加" onclick="addMember()" />
<br/>
<input class="addmemberBtn addmemberBtnon"
onmouseover="setCss(event,'on')" onmouseout="setCss(event,'off')"
type="button" value="移除>>" onclick="removeMember()" />
</div>
<!-- 右側:所有企業成員 -->
<div class="roundGroup" style="float:left;width:241px;height:380px;">
<div>
<span class="spangrouptitle">所有企業成員</span>
<span>${eNumber}人</span>
</div>
<div style="height:30px;">
<input id="searchTxt" type="text" value="搜索企業成員"
onfocus="clearTxt()" onblur="setsearchTxt()" />
<img id="searchBtn" onclick="searchMember();"
src="<%=basePath%>/images/searchBtn.PNG" />
</div>
<div id="enterpriseMember" style="height:280px;overflow-y:auto;">
<s:iterator value="#request.departmentMemberList" id="department">
<div class="dmlist">
<div>
<img class="folder" src="<%=basePath%>/images/folder_close.PNG"
onclick="folderToggle(event,'<%=basePath%>')"/>
<span onclick="folderNameToggle(event,'<%=basePath%>')">
<s:property value="#department.departmentName"/>
<span onclick="folderNumToggle(event,'<%=basePath%>')">
<s:property value="#department.memberCount"/>人</span>
</span>
</div>
<div class="ml memberlist">
<s:iterator value="#department.memberList" id="emember">
<div>
<input type="checkbox"/>
<input type="hidden" value="<s:property value="#emember.id"/>" name="userId" />
<span class="sname"><s:property value="#emember.name" /></span>
<span class="sdepartment"><s:property value="#emember.position_name" /></span>
</div>
</s:iterator>
</div>
</div>
</s:iterator>
</div>
</div>
<div style="clear:both;">
<input class="commonButton" type="button" value="保存" onclick="saveChanges()"/>
<input type="hidden" id="newAddMembersId" name="newAddMembersId" value=""/>
<input type="hidden" id="deleteMembersId" name="deleteMembersId" value=""/>
<input type="hidden" id="existedMemberId" name="existedMemberId" value="${existedMemberId}"/>
<input type="hidden" id="group_id" name="group_id" value="${group_id}"/>
</div>
</div>
</body>
</html>
值得肯定:以 id 清單而非 DOM 作為真實狀態。新增與移除都同步維護三份 id 字串,這讓「把剛移除的人再加回來」能正確運作——addMember 中那段從 del 剔除 uid 的邏輯就是在處理這個情況。以畫面 DOM 為準的實作往往會在來回操作後失準。
值得檢討:用 indexOf 判斷 id 存在與否。這是這份程式碼最大的問題。"12,3,45".indexOf("3") 會回傳 3,於是 id 為 3 的成員被誤判為已存在;反之 "1,23".indexOf("3") 也會命中。請改用 Set:
var added = new Set(add ? add.split(',') : []);
if (added.has(uid)) continue;
added.add(uid);
$("#newAddMembersId").val([...added].join(','));
Set 的 has 是精確比對,也免去了自己處理逗號的麻煩。
搜尋用 clone 會產生重複的 checkbox。搜尋結果是複製出來的節點,使用者若在結果上勾選,狀態與原節點脫節,後續 addMember 讀到的可能是被隱藏而非被選取的那一份。正確做法是「過濾顯示」而非「複製一份」:
function searchMember() {
var q = $.trim($("#searchTxt").val());
$(".dmlist").each(function () {
var $dept = $(this);
var matched = $dept.text().indexOf(q) >= 0;
$dept.toggle(matched || q === '');
});
}
這樣 DOM 只有一份,勾選狀態自然一致。
用 parent().parent().parent() 定位元素極其脆弱。HTML 結構一調整就全線失效。請改用 .closest('.member-row'),語意明確且不畏改版。
把 id 放在網址列傳遞有長度疑慮。成員上千時 URL 會超長而被伺服器拒絕。請改用 POST 送出,並在伺服端以 JSON 接收。
placeholder 請用原生屬性。value="搜索企業成員" 加上 focus/blur 手動清除,是 placeholder 屬性問世前的做法。改用 <input placeholder="搜索企業成員">,並記得補上對應的 label 供輔具使用。
img 承擔載按鈕職責,鍵盤無法操作。搜尋圖示請包成 <button> 並加上 aria-label;三個折疊觸發點也應有 aria-expanded 標示當前的展開狀態。
最後,雙清單穿梭元件已有成熟方案。Chosen、Select2、Tom Select 都支援多選、搜尋與分組,鍵盤操作與無障礙也已處理妥當。自行實作時,請把「狀態單一來源」與「以資料陣列渲染、DOM 只是畫面」這兩點作為設計前提,就能避開上述大半問題。