标签参考 · 导航与其他

一、导航 nav

{cms:nav group="main" id="nav"}
  <a href="{$nav.url}" class="{$nav.class}">{$nav.name}</a>
  {if !empty($nav.children)}
    <ul class="sub-menu">
    {volist name="nav.children" id="sub"}
      <li><a href="{$sub.url}">{$sub.name}</a></li>
    {/volist}
    </ul>
  {/if}
{/cms:nav}

导航项的 $nav.class 会自动带上 active（当前栏目命中时）。

二、面包屑 breadcrumb

{cms:breadcrumb /}

自定义：

{cms:breadcrumb symbol=" / " class="crumb" current="current" /}

三、表单 form

渲染模型为「表单模型」的栏目表单：

{cms:form catid="12" /}

自定义字段渲染：

{cms:form catid="12" id="f"}
  <div class="field">
    <label>{$f.title}</label>
    {$f.input}
  </div>
{/cms:form}

表单提交地址与验证码由程序自动处理，前台提交后写入 ws_form_data。

四、筛选 filter / filters

模型字段勾选了「前台筛选」后，可在列表页输出筛选条：

{cms:filters catid="$cat.id"}
  <div class="filter-group">
    <span class="label">{$filter.name}</span>
    {volist name="filter.options" id="opt"}
      <a href="{$opt.url}" class="{$opt.class}">{$opt.label}</a>
    {/volist}
  </div>
{/cms:filters}

单字段筛选：

{cms:filter field="price" catid="$cat.id" /}

筛选通过 URL 参数传递（如 ?price=100-500），多条件自动叠加并保留其它参数。

五、语言切换

<ul class="lang-switch">
{volist name="langLinks" id="lg"}
  <li><a href="{$lg.url}" hreflang="{$lg.code}" class="{$lg.class}">{$lg.name}</a></li>
{/volist}
</ul>

开启 URL 语言前缀后，$lg.url 会自动切换地址前缀。

六、片段引入与其它

引入公共片段

{include file="common/header" /}
{include file="common/footer" /}

当前用户

{if $user}
  <a href="/user">{$user.nickname}</a>
{else /}
  <a href="/login">登录</a>
{/if}

站点信息

{$siteName}
{$siteCopyright}
{:theme_static('images/logo.png')}

判断当前栏目

{if $cat.id == 9}<span>当前栏目</span>{/if}
{if $cat.pid == 0}顶级栏目{/if}

七、完整列表对照