Jeecms 标签使用详解：获取栏目列表

"Jeecms标签使用教程，主要讲解了[@cms.ChnlList/]标签的详细功能和参数设置，以及其在Jeecms系统中的应用范围和调试方法。" Jeecms是一个流行的Java内容管理系统，它提供了丰富的标签库来简化网页开发。在Jeecms中，`[@cms.ChnlList/]` 标签是一个非常实用的标签，主要用于在页面上展示栏目列表。这个标签可以单独使用，也可以与其他标签结合，以实现更复杂的功能，比如在新建的演示空白首页模板中进行展示。 ### 1. 标签原型及参数说明 `[@cms.ChnlList属性='值'/]` 是`[@cms.ChnlList/]` 标签的基本形式，其中的属性可以根据需求进行设置，包括： - `id`: 父栏目ID，默认为空，系统会自动获取当前栏目ID。 - `orderBy`: 排序方式，可选值有优先级、点击次数等，默认按优先级升序。 - `isDisplay`: 是否只显示已启用的栏目，0表示获取所有，1表示只获取显示的。 - `hasContent`: 是否只获取可以发布内容的栏目，0表示获取所有，1表示只获取可以有内容的。 - `linkClass`: 链接的CSS类。 - `linkTarget`: 链接打开方式，0为当前窗口，1为新窗口。 - `style`: 标签内部样式，如1表示普通链接列表。 - `sysTpl`: 是否使用系统模板，1表示使用。 - `sysContent`: 系统内容样式，0为默认样式。 - `userContent`: 自定义内容样式。 - `sysPage`: 系统分页样式，可选值为不分页或两种分页样式。 - `userPage`: 自定义分页样式。 - `custom`: 字符串数组，用于个性化处理。 注意，属性值需用单引号包裹，并且属性顺序不限。 ### 2. 使用范围 `[@cms.ChnlList/]` 标签主要应用于Jeecms的首页模板和栏目页模板，即位于`\WEB-INF\user_base\jeecms_com_www\template\article\default\` 文件夹下的 `index_××.html` 和 `channel_××.html` 模板。 ### 3. 调试与应用 - **单独调用**：简单的调用方式如 `[@cms.ChnlList/]`，将展示默认设置的栏目列表。 - **自定义调用**：通过设置不同的属性值，如 `[@cms.ChnlList id='1' orderBy='1' /]`，可以按照父栏目ID为1且按优先级降序的方式展示栏目。 调试标签时，可以通过修改模板文件并查看页面效果，来了解不同参数设置对显示结果的影响。 ### 4. 示例代码 ```html [@cms.ChnlList id='1' orderBy='2' isDisplay='1' linkClass='myLink' sysTpl='1' custom='attr1=value1;attr2=value2'/] ``` 上述代码将获取父栏目ID为1的显示栏目，按照点击次数降序排列，链接添加CSS类`myLink`，使用系统模板，并设置了两个自定义属性`attr1`和`attr2`。 `[@cms.ChnlList/]` 标签是Jeecms中一个强大的工具，允许开发者灵活地控制栏目的展示，以满足各种设计和功能需求。通过深入理解和熟练使用这个标签，可以极大地提高Jeecms网站开发的效率和用户体验。