使用jQuery高效实现DOM元素字母顺序排序教程

/**
 * 对指定容器内的子元素进行字母顺序排序
 * @param {string} containerSelector - 父容器的CSS选择器，例如 '#assignedMemberList'
 * @param {string} itemSelector - 需要排序的子元素的CSS选择器，例如 '.list-group-item'
 * @param {string} [sortByKey=null] - 可选，用于排序的data属性键名（如 'sortList'）。如果为null，则使用元素的文本内容。
 */
function sortElementsAlphabetically(containerSelector, itemSelector, sortByKey = null) {
    const $container = $(containerSelector);
    // 获取所有待排序的子元素
    const $items = $container.children(itemSelector);

    // 如果没有要排序的项，则直接返回
    if ($items.length === 0) {
        console.warn('没有找到匹配的元素进行排序。');
        return;
    }

    // 将jQuery集合转换为原生JavaScript数组，并映射出用于排序的值
    const mappedItems = Array.from($items).map(elem => {
        let sortValue;
        if (sortByKey) {
            // 如果指定了排序键，则从data属性获取
            sortValue = $(elem).data(sortByKey);
        } else {
            // 否则使用元素的文本内容
            sortValue = $(elem).text();
        }
        // 确保排序值是字符串，并转换为小写进行不区分大小写排序
        return { elem: elem, value: String(sortValue || '').toLowerCase() };
    });

    // 对映射后的数组进行排序
    mappedItems.sort((a, b) => {
        // 使用 localeCompare 进行字符串比较，对多语言支持更好
        return a.value.localeCompare(b.value);
    });

    // 将排序后的元素重新添加到容器中
    // 1. 从DOM中移除所有待排序的子元素，但保留其事件处理器和数据
    $items.detach();
    // 2. 按照排序后的顺序重新添加元素
    mappedItems.forEach(({ elem }) => {
        $container.append(elem);
    });
}

// 示例用法：
// 1. 根据文本内容排序
// sortElementsAlphabetically('#assignedMemberList', '.list-group-item');

// 2. 根据data属性 'sortList' 排序
// HTML 结构示例: <div class="list-group-item" data-sort-list="Banana">...</div>
// sortElementsAlphabetically('#assignedMemberList', '.list-group-item', 'sortList');

/**
 * jQuery插件：对选定元素集合的子元素进行字母顺序排序
 * @