DIV CSS 佈局教程網

兩個 listbox 實作成員的挑選、移除與搜尋
編輯:關於JavaScript     

「從全部成員中挑幾個加入群組」是典型的雙清單穿梭(shuttle)介面。左邊是已選,右邊是候選,中間放添加與移除鈕,右邊上方再附一個搜尋框。這個實作以 jQuery 完成,並額外處理了部門折疊與狀態同步。

核心資料結構

三個 hidden 欄位保存狀態:newAddMembersId(本次新增)、deleteMembersId(本次移除)、existedMemberId(原本就有)。用 id 字串以逗號串接,而不是直接依賴畫面上的 DOM,這是為了讓「取消一項操作後再重做」的情況能正確處理。

group.js

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);
}

test.jsp

<%@ 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="&lt;&lt;添加" onclick="addMember()" />
    <br/>
    <input class="addmemberBtn addmemberBtnon"
      onmouseover="setCss(event,'on')" onmouseout="setCss(event,'off')"
      type="button" value="移除&gt;&gt;" 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 只是畫面」這兩點作為設計前提,就能避開上述大半問題。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved