ECSIDE列表属性详解:tableId, theme, useAjax等

需积分: 9 1 下载量 156 浏览量 更新于2024-09-13 收藏 70KB DOC 举报
"ec属性文档提供了关于<ec:table></ec:table>标签的各种配置属性,用于定制ECSIDE列表的行为和样式。" 在EC标签库中,<ec:table>是一个重要的组件,用于创建数据表格并支持各种交互功能,如分页、过滤和排序。以下是对各属性的详细解释: 1. **tableId** - tableId属性用于设定列表的唯一标识,默认值是"ec"。在同一个页面内如果有多个ECSIDE列表,为了区分它们,每个列表需要设置不同的tableId。 2. **theme** - theme属性定义了列表的视觉样式主题,默认值为"ecside"。你可以通过改变这个属性来调整列表的外观。 3. **generateScript** - generateScript属性决定是否自动生成ECSide所需的JavaScript脚本,默认值为true。如果设为false,需要手动处理脚本生成以支持ECSide的功能。 4. **useAjax** - useAjax属性控制是否使用AJAX技术处理分页、过滤和排序等操作,默认值为true。启用此选项可以实现无刷新的数据交互,提高用户体验。 5. **doPreload** - doPreload属性用于开启预读取技术,默认值为true。预读取技术能预先加载部分后续数据,提升列表滚动时的加载速度。 6. **classic** - classic属性用于切换到传统简单的列表模式,默认值为false。如果设置为true,列表将呈现为不带高级特性的简单样式。 7. **autoIncludeParameters** - autoIncludeParameters属性控制是否自动保留表单字段,翻页、过滤和排序时会以hidden input形式传递这些字段,默认值为true。开启此选项有助于保持用户上下文。 8. **includeParameters** - includeParameters属性用于指定在关闭"自动保留"时,仍希望被保留的表单字段,以逗号分隔。当需要精细化控制保留哪些字段时使用。 9. **excludeParameters** - excludeParameters属性用于在开启"自动保留"时,排除不希望被保留的表单字段,同样以逗号分隔。它的优先级高于includeParameters,即如果同时指定,excludeParameters会覆盖includeParameters。 使用这两个属性时,推荐优先使用excludeParameters,以避免因未明确指定而导致的意外丢失数据。例如,excludeParameters="表单属性名称1,表单属性名称2",而includeParameters="表单属性名称3,表单属性名称4"。 10. **toolbarContent** - toolbarContent属性用于设置工具栏显示的内容,这可以是自定义的HTML或者ECSIDE提供的功能按钮。 理解并正确使用这些属性对于构建交互性强、用户体验良好的数据展示页面至关重要。在实际应用中,应根据项目需求和用户交互习惯来配置<ec:table>的各个属性,以实现最佳效果。