在页面中获取栏目列表的时候我们要用到[@cms.ChnlList /]标签,本标签不仅可以单独使用,还可以配合其它标签使用,达到更加丰富的效果。本节教程都是在新建的演示空白首页模板中作演示。
一、标签原型说明
【标签名】:[@cms.ChnlList 属性='值' /]
【作 用】:显示各栏目列表
【参 数】:
id:父栏目ID。(默认为空:自动获取当前栏目ID)
orderBy:排序方式。【0:优先级升序;1:优先级降序;2:点击次数升序;3:点击次数降序】(默认0)
isDisplay:是否只获取显示的栏目。【0:获取所有;1:只获取显示的栏目】(默认1)
hasContent:是否只获取可以有内容的栏目。【0:获取所有;1:只获取可以有内容的栏目】(默认0)
linkClass:链接class
linkTarget:链接打开方式。【0:当前窗口;1:新窗口】(默认0)
style:标签内部样式。如果指定sysContent或userContent,则该项无效。【1:普通链接列表;】(默认1)
sysTpl:使用系统模板。【0:不使用;1:使用】(默认1)
sysContent:系统内容样式。(默认0)
userContent:自定义内容样式。如果指定了系统内容样式,则该项无效。(默认0)
sysPage:系统分页样式。【0:不分页;1:样式一;2:样式二】(默认0)
userPage:自定义分页样式。如果指定了系统分页样式,则该项无效。【0:不分页;1:样式一;2:样式二】(默认0)
custom:字符串数组。用于个性化处理。(默认空数组)
【备 注】:在代码模式下编辑,各属性值必须使用单引号,属性排列顺序不分先后。
二、明确标签的使用范围
我们在使用任何标签的之前,都必须明确其使用的范围,否则可能无法正常使用该标签。 [@cms.ChnlList /]标签的使用范围是:首页模板,栏目页模板,即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的index_××.html模板、channel_××.html模板
三、调试标签了解其使用方法
1、单独标签调用示例: [@cms.ChnlList/]
2、自定义标签调用示例:
[@cms.ChnlList id='' inner='1';c,i]
<a href="${c.url}">${c.name}</a>[#if (i+1)%2==0]<br/>[/#if]
[/@cms.ChnlList]
3、配合其它标签嵌套调用示例:
[@cms.ChnlList id='' sysType='article' hasContent='1' inner='1';c]
<table width="300" border="0" cellpadding="0" cellspacing="1" bgcolor="#eee">
<tr>
<td height="30" bgcolor="#EEEEEE"><a target="_blank" href="${c.url}">${c.name}</a></td>
</tr>
<tr>
<td bgcolor="#FFFFFF">[@cms.ArtiList chnlId=c.id sysContent='1-1' titLen='20' count='6' /]</td>
</tr>
</table>
[/@cms.ChnlList]
一、标签原型说明
【标签名】:[@cms.ChnlList 属性='值' /]
【作 用】:显示各栏目列表
【参 数】:
id:父栏目ID。(默认为空:自动获取当前栏目ID)
orderBy:排序方式。【0:优先级升序;1:优先级降序;2:点击次数升序;3:点击次数降序】(默认0)
isDisplay:是否只获取显示的栏目。【0:获取所有;1:只获取显示的栏目】(默认1)
hasContent:是否只获取可以有内容的栏目。【0:获取所有;1:只获取可以有内容的栏目】(默认0)
linkClass:链接class
linkTarget:链接打开方式。【0:当前窗口;1:新窗口】(默认0)
style:标签内部样式。如果指定sysContent或userContent,则该项无效。【1:普通链接列表;】(默认1)
sysTpl:使用系统模板。【0:不使用;1:使用】(默认1)
sysContent:系统内容样式。(默认0)
userContent:自定义内容样式。如果指定了系统内容样式,则该项无效。(默认0)
sysPage:系统分页样式。【0:不分页;1:样式一;2:样式二】(默认0)
userPage:自定义分页样式。如果指定了系统分页样式,则该项无效。【0:不分页;1:样式一;2:样式二】(默认0)
custom:字符串数组。用于个性化处理。(默认空数组)
【备 注】:在代码模式下编辑,各属性值必须使用单引号,属性排列顺序不分先后。
二、明确标签的使用范围
我们在使用任何标签的之前,都必须明确其使用的范围,否则可能无法正常使用该标签。 [@cms.ChnlList /]标签的使用范围是:首页模板,栏目页模板,即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的index_××.html模板、channel_××.html模板
三、调试标签了解其使用方法
1、单独标签调用示例: [@cms.ChnlList/]
2、自定义标签调用示例:
[@cms.ChnlList id='' inner='1';c,i]
<a href="${c.url}">${c.name}</a>[#if (i+1)%2==0]<br/>[/#if]
[/@cms.ChnlList]
3、配合其它标签嵌套调用示例:
[@cms.ChnlList id='' sysType='article' hasContent='1' inner='1';c]
<table width="300" border="0" cellpadding="0" cellspacing="1" bgcolor="#eee">
<tr>
<td height="30" bgcolor="#EEEEEE"><a target="_blank" href="${c.url}">${c.name}</a></td>
</tr>
<tr>
<td bgcolor="#FFFFFF">[@cms.ArtiList chnlId=c.id sysContent='1-1' titLen='20' count='6' /]</td>
</tr>
</table>
[/@cms.ChnlList]