# Parsing Context

The label according to resolve context STL system generates a page, e.g., using the tag template content <stl:content type="title"></stl:content> title acquisition content, the system uses the current context as the content when parsing this code, so that the correct data is parsed.

Usually, the correct result can be obtained according to the default context, but in some cases, the context needs to be redefined by the attribute. For example, we want to get the column names in the content, you can use the tag <stl:channel type="title"></stl:channel> to get the data, but if we want to display the name of the column is not content belongs, but a specific column name, by default context can not be achieved, and then we You need to specify the column by the attribute channelIndex: <stl:channel channelIndex="index" type="title"></stl:channel>。

We can specify the context by attribute, or specify the context through the container tag. We can even switch the website through the site tag. At the same time, we can also use the conditional judgment tag to get the current context, which is explained below.

# Swith context by attribute

# channelIndex

栏目索引是一个站点中栏目的标识，具有唯一性。

如果设置了 channelIndex 属性，系统将寻找对应索引的栏目并将上下文切换到此栏目。

<!-- 链接到首页 -->
<stl:a channelIndex="首页"></stl:a>

# channelName

栏目名称可以重复，所以应该尽量避免使用栏目名称来切换上下文，但是如果 channelName 与 channelIndex 属性配合使用，系统将首先定位到 channelIndex 索引所在的栏目，之后再寻找此栏目下栏目名称为 channelName 的栏目。

<!-- 链接到当前栏目下的名称为“栏目名称”的栏目 -->
<stl:a channelName="栏目名称"></stl:a>

<!-- 链接到“栏目索引”下的名称为“栏目名称”的栏目 -->
<stl:a channelIndex="栏目索引" channelName="栏目名称"></stl:a>

# parent

将上下文切换到当前栏目的上一级栏目。

"true" 表示切换到当前栏目的上一级栏目，等价于 upLevel="1"。
"false" 表示不切换到当前栏目的上一级栏目。

如果同时设置了 parent 以及 channelIndex 属性，系统将首先定位到 channelIndex 栏目索引所在的栏目，之后再切换到对应栏目的上级栏目。

<!-- 链接到当前栏目的上一级栏目 -->
<stl:a parent="true"></stl:a>

# upLevel

切换到上级栏目，1 为上一级栏目，2 为上两级栏目，以此类推。

如果同时设置了 upLevel 以及 channelIndex 属性，系统将首先定位到 channelIndex 栏目索引所在的栏目，之后再切换到对应栏目的上 N 级栏目。

<!-- 链接到当前栏目的上两级栏目 -->
<stl:a upLevel="2"></stl:a>

# topLevel

切换到从首页向下第 N 个级别的栏目，0 代表切换到首页，1 代表一级栏目，2 代表二级栏目，以此类推。

<!-- 链接到一级栏目 -->
<stl:a topLevel="1"></stl:a>

# context

通常如果标签被嵌套在列表元素中时，系统会设置上下文为当前的列表类型，同时对标签进行解析时也将根据列表类型进行判断，如将 <stl:a></stl:a> 放到内容列表以及栏目列表中时，stl:a 标签的链接会分别显示内容的连接以及栏目的连接。

如果希望<stl:a></stl:a>标签无论在内容列表还是栏目列表都只显示栏目链接，可以设置 context 属性为 Channel:<stl:a context="channel"></stl:a>

"default" 默认，即当前所处上下文。
"content" 内容上下文。
"channel" 栏目上下文。
"sqlContent" Sql 内容上下文。
"site" 站点上下文。

<!-- 分别显示栏目与内容链接 -->
<stl:channels>
  <stl:contents>
    栏目：<stl:a context="channel"></stl:a>
    内容：<stl:a></stl:a>
  </stl:contents>
</stl:channels>

# Switch context by <stl:container>

如果希望一段代码无论放到什么位置，都解析为同样的结果，可以使用 <stl:container>将这段代码嵌套进来并设置属性指定的上下文。请参考：<stl:container> 容器元素

<stl:container channelIndex="栏目索引">
  栏目：<stl:channel type="title"></stl:channel>
  此栏目下的内容：
  <stl:contents>
    <stl:a></stl:a>
  </stl:contents>
</stl:container>

# 通过 <stl:site> 元素切换网站

如果在本站点的模板中显示其他站点的数据，可以通过<stl:site> 元素切换站点，此元素中嵌套的标签都将解析为指定站点的数据。请参考：<stl:site> 站点元素

<stl:site siteDir="MySite">
  ...
</stl:site>

# 通过 <stl:if> 判断上下文

如果希望对上下文进行判断，从而使用不同的标签，可以通过<stl:if> 元素判断上下文，根据判断结果嵌套不同的标签。请参考：<stl:if> 判断元素

# 判断当前栏目名称是否为"栏目名称"

<stl:if type="ChannelName" op="Equals" value="栏目名称">
  <stl:yes> <p>true</p> </stl:yes>
  <stl:no> <p>false</p> </stl:no>
</stl:if>

# 根据模板类型显示不同内容

下面的例子判断当前模板是不是内容模板。

<stl:if type="TemplateType" op="Equals" value="ContentTemplate">
  <stl:yes>
      这是内容页面
  </stl:yes>
  <stl:no>
      这不是内容页面
  </stl:no>
</stl:if>

# 根据模板名称显示不同内容

下面的例子根据当前模板的模板名称显示不同的内容。

<stl:if type="TemplateName" op="Equals" value="系统首页模板">
  <stl:yes>
      <li><A href="/" class="current">首 页</A></li>
  </stl:yes>
  <stl:no>
      <li>我不是首页</li>
  </stl:no>
</stl:if>

← Include files Dynamic display →