编辑“KingCMS/列表调用”

{{KingCMS top}}

<pre>
{king:portal.list/}标签属性 作用 
listid 要调用的列表ID,若调用多个，则用逗号分开，如：listid="2,3"
支持排除，如：listid!='2' 即不显示listid为2的栏目。多个指定可以逗号分开: listid!='3,4' 
listid1 调用所属列表,即下级列表,当取值为0的时候是调用根目录,如:listid1='0'，调用多个列表的下级列表，则也可以用逗号分开
支持排除 
siteid 调用指定站点的列表
支持排除 
modelid 调用所属模型的列表；如调用所有文章列表：modelid="6"
支持排除 
gid 调用指定用户组的栏目列表
支持排除 
nlist 调用指定列表生成方式的栏目列表 0静态1动态2伪静态
支持排除 
npage 调用指定内容生成方式的栏目列表 0静态1动态2伪静态
支持排除 
language 调用所用语言的列表；若调用所有中文列表：language='zh-cn' 
orderby 排序 
number 调用数量 
</pre>
'''注意''':

以上属性可以结合使用，如调用所有根目录下面的文章列表时，设置的属性为： listid1='0' modelid='6' 

'''示例'''：一二级栏目列表的调用
<pre>
Example :
{king:portal.listlistid1='0'}
<dl>
        <dt><a href="{king:listpath/}">{king:listname/}</a></dt><!-- 调用一级栏目，(循环一) -->
        {king:portal.Listlistid1='(king:listid/)'}<!-- 注意，这里的portal.List和上面的有区别，L用的是大写，(循环二) -->
        <dd><a href="{king:listpath/}">{king:listname/}</a></dd><!-- 调用二级栏目 -->
        {/king:portal.List}
</dl>
{/king:portal.list} 
</pre>

'''注意''' :
你会发现在(循环二)中的属性listid1的值是(king:listid/)，这个值是(循环一)中的{king:listid/}，当传递到属性值的时候，需改用小括号。
这两层循环，都用的是portal.list，可他们没有出现(循环一)开始代码和(循环二)结束代码匹配的错误，避开这种问题的方法是，设置不同的大小写字符来做区分，这点特别关键！
同样的方法，可以扩展到三层列表调用或者更深层次的列表循环。

'''示例'''：一二级栏目列表及下面文章的调用
<pre>
Example :
{king:portal.listlistid1='0' modelid="6"}<!-- 你可以指定任何一个栏目开始，我们在这里就指定了根目录，指定modelid='6'是为了只调用文章列表 -->
<dl>
        <dt><a href="{king:listpath/}">{king:listname/}</a></dt><!-- 调用一级栏目标题及链接 -->
        {king:portal.articlelistid='(king:listid/)'}<!-- 调用文章 -->
        <dd><a href="{king:path/}">{king:title/}</a></dd><!-- 调用文章列表 -->
        {/king:portal.article}<!-- 结束标记 -->
</dl>
{/king:portal.list} 
</pre>
注意:
你能做的不止是这些，以上的仅仅是常见的应用例子，更复杂的应用也并不复杂，[[KingCMS]]标签的值传递是一级一级往下传的，可以到无穷

*{king:portal.menu/}的用法相似于{king:portal.list/}，不同的是{king:portal.menu/}不支持{king:portal.list/}那样丰富的属性。
<pre>
Example :
{king:portal.menu3}
        <a href="{king:listpath/}">{king:listname/}</a>
{/king:portal.menu3}
</pre>

==参考来源==
*http://www.kingcms.com/forums/Use/

{{KingCMS}}
[[category:KingCMS|K]]