Web组件[list列表组件]使用手册.docVIP

web组件 列表组件 使用手册 版本号：1.0 作者：高林 时间： 2004年 07月 12日 山东浪潮齐鲁软件产业股份有限公司  修订历史记录 日期 版本 说明 作者 2004年07月12日 1.0 创建 高林 修订历史记录说明 日期 登记修订具体日期 版本 登记版本号 说明 文档变更内容、变更时间 作者 本次修改人  目 录 1. 列表组件概述 4 1.1 组件功能描述 4 1.2 组件实现的技术 4 1.3 组件在包中的路径 4 2. 列表组件使用说明 5 2.1 组件配置 5 2.2 组件标签节点说明 5 2.3 注意事项 6 3. 列表组件使用示例 6 3.1 示例场景 6 3.2 示例源码 7 列表组件概述 在web应用开发中，存在大量需要类似下面的下拉列表使用的地方。 列表图 ÷但是，从实现上面的功能来看，程序员用js加上服务器端脚本开发，也是可以实现的，但是这样的结果是工作量大，难以维护。可重用性小。 因此，我们采用java taglib技术封装js。用简单的标签技术。实现这些复杂的功能。风格统一,简化开发,操作更加友好灵活 组件功能描述 列表组件，采用统一的风格，开发使用起来简单。 四种不同形式的列表组件，基本满足客户端显示需求。对于进行数据调整操作。 组件实现的技术 采用java taglib技术封装javaScript。 组件在包中的路径 在web组件包 org.loushang.web.taglib.list.* 列表组件使用说明 组件配置 1: 导入loushang3.0_web.jar 2: 引用web-list.tld标签库 放到WEB-INF/tlds目录下 3: 在web.xml文件中配置： taglib taglib-uri/tags/web-list/taglib-uri taglib-location/WEB-INF/tlds/web-list.tld/taglib-location /taglib 4.导入JS文件list.js到相应目录 getRightOptionsValues（）; 获取所有右边选项值(value) getLeftOptionsValues（）; 获取所有左边选项值(value) getRightOptionsLabels（）; 获取所有右边选项显示值(label) getLeftOptionsLabels（）; 获取所有左边选项显示值(label) getRightOptions（）; 获取所有右边选项(包括value和label) getLeftOptions（）; 获取所有左边选项(包括value和label) 5:使用例子在下面 或者是看loushang3.0-web-demo.war(可从技术中心网站下载) 组件标签节点说明 节点属性说明： pageToPage 属性 默认值 必需 描述 name true 用来区分不同的列表，生成不同的名称。 在同一个页面用多个列表时，需要用该值来区分。必须唯一。 type true 列表类型： oneImg 单选类型 multiImg 多选类型 style false 样式 styleClass false 样式 class styleId false 样式 id. bkImg listbg.gif false 背景图片 imgCatalog 配置文件配置的images目录 false 图表目录 left 属性 默认值 必需 描述 name true 列表Select名称 property true 根据改值从bean中获取选中值 size 1 false 列表显示选项个数 multiple false false 是否是单选，还是多选 beanName false 数据来源集合名称如果该属性存在，则从其中按照javabean的规测，。 style false 样式自定义 styleClass false 样式class引用 styleId false 样式id 其他关于事件属性 同样支持 onchange等 right 属性基本和left一样 属性 默认值 必需 描述 注意事项 相同的列表不要在一个页面使用。需要的话，可采用 同类型的混和使用。 列表数据来源应该采用html组件标签 列表组件使用示例 示例场景 需要形象表达记录属于那一边，且需要实现互移的场面。 示例源码 详细例子见lous