ListExtender 对 HTML 控件 Select 的全面扩展，共有六大类应用：获取列表和项的信息、选择项、添加项、设置项、删除项、高级应用。数十个方法让你在应用 Select 控件时得心应手、潇洒自如，尤其是在面向多个列表间复制、移动项时更是变得轻松自在。

• 修改　命名，使命名符合规范。

/products/webComponents/ListExtender/demo.htm

• Internet Explorer　全面支持
• Firefox　全面支持

var l1 = new ListExtender("s1");

ListExtender(targetIdOrTargetOrListExtender)

构造函数。

• targetIdOrTargetOrListExtender　字符串或 object　列表 ID 名称或列表元素对象，或者是列表的 ListExtender 对象。

getItemsCount()

获取并返回项的数量。

getSelectedItemsCount()

获取并返回选择的项的数量。

getIsItemExists(text, value, repeatCheck)

查找相应的项是否存在。

• text　字符串　要查找的文字。
• value　字符串　要查找的值。
• repeatCheck　参见 ListExtenderRepeatCheck　执行何种重复性检查。若 repeatCheck 为 ListExtenderRepeatCheck.TEXT，则参数 text 与各个项中的文字比较，相同则返回 true；若 repeatCheck 为 ListExtenderRepeatCheck.VALUE，则参数 value 与各个项中的值比较，相同则返回 true；若 repeatCheck 为 ListExtenderRepeatCheck.TEXT_VALUE，则参数 text、value 分别与各个项中的文字、值比较，相同则返回 true；若 repeatCheck 为其他值，则返回 false。

getIsItemSelected(index)

获取并返回 index 对应的项是否被选择。

getItemText(index)

获取并返回 index 对应的项的文字。

getItemValue(index)

获取并返回 index 对应的项的值。

selectAllItems()

将所有项置于选择状态。

selectInverseItems()

将选择的项置于未选择状态，同时将未选择的项置于选择状态。

selectNoneItem()

将所有项置于未选择状态。

appendItem(text, value, repeatCheck)

追加项。返回是否追加成功。

insertItem(index, text, value, repeatCheck)

插入项。返回是否插入成功。

• index　数字　插入位置。

setItemText(index, text)

设置 index 对应的项的文字。

setItemValue(index, value)

设置 index 对应的项的值。

setItem(index, text, value)

设置 index 对应的项的文字和值。

setItemSelected(index, selected)

设置 index 对应的项的选择状态。

• selected　布尔　新状态是否是选择状态，默认值为 true。

deleteItem(index)

删除 index 对应的项。

deleteSelectedItems()

删除选择的项。返回删除的数量。

deleteAllItems()

删除所有项。

copyListFrom(sourceList, onlySelected, repeatCheck, deleteSource, selectDest)

从其他列表复制项到本列表。返回复制的项的数量。

• sourceList　字符串或 object　源列表 ID 名称或源列表元素对象，或者是源列表的 ListExtender 对象。
• onlySelected　布尔　是否只复制源列表中选择的项。
• repeatCheck　参见 ListExtenderRepeatCheck　执行何种重复性检查。若存在重复，则不会进行复制。若不需要进行重复性检查，可将 ListExtenderRepeatCheck.None 传递给此参数。
• deleteSource　布尔　成功复制后，是否删除源列表中的项。
• selectDest　布尔　成功复制后，是否选择目标列表中的新项。

copyListTo(destList, onlySelected, repeatCheck, deleteSource, selectDest)

从本列表复制项到其他列表。返回复制的项的数量。

• destList　字符串或 object　目标列表 ID 名称或目标列表元素对象，或者是目标列表的 ListExtender 对象。
• onlySelected　布尔　是否只复制源列表中选择的项。
• repeatCheck　参见 ListExtenderRepeatCheck　执行何种重复性检查。若存在重复，则不会进行复制。若不需要进行重复性检查，可将 ListExtenderRepeatCheck.None 传递给此参数。
• deleteSource　布尔　成功复制后，是否删除源列表中的项。
• selectDest　布尔　成功复制后，是否选择目标列表中的新项。

cloneListFrom(sourceList)

从其他列表克隆到本列表。这使得二者列表项完全一样，包括选择状态。目标列表原有的项会被清空。

• sourceList　字符串或 object　源列表 ID 名称或源列表元素对象，或者是源列表的 ListExtender 对象。

cloneListTo(destList)

从本列表克隆到其他列表。这使得二者列表项完全一样，包括选择状态。目标列表原有的项会被清空。

• destList　字符串或 object　目标列表 ID 名称或目标列表元素对象，或者是目标列表的 ListExtender 对象。

moveSelectedItemsUp()

上移选择的项。

moveSelectedItemsDown()

下移选择的项。

当前版本 v1.1 点击下载压缩文件包，内含：

• JS 主程序文件　1 个
• 示例文件　7 个