如何在AnQiCMS模板中获取字符串的
📅
👁️ 66
在AnQiCMS模板开发中，文字和字符串是构建网站内容的基础。无论是展示文章标题、网站名称，还是处理用户输入，灵活高效地获取和操作字符串是模板开发者必须掌握的技能。AnQiCMS强大的模板引擎基于Go语言，提供了丰富的标签和过滤器，让字符串的获取与处理变得直观且实用。
核心机制：理解AnQiCMS模板的字符串获取方式
在AnQiCMS模板中获取字符串，最直接的方式就是通过变量的引用。就像在普通编程语言中一样，您可以通过{{ 变量名 }}的形式来输出变量的值。当变量是一个结构体或对象时，可以通过点号（.）来访问其属性，例如{{ archive.Title }}将输出当前文档的标题。
为了更精确地获取特定类型的字符串，AnQiCMS提供了多种模板标签：
- 获取内容详情的字符串：例如，在文章详情页，您可能需要获取文章标题、内容、关键词或自定义字段。
{% archiveDetail %}标签提供了这样的能力。通过name参数指定要获取的字段名称，比如{% archiveDetail with name="Title" %}可以获取文章标题，{% archiveDetail with name="Description" %}获取文章描述。对于文档内容，您可以使用{% archiveDetail with name="Content" %}。类似地，{% categoryDetail %}用于获取分类详情字符串，{% pageDetail %}用于单页面，{% tagDetail %}用于标签详情。 - 获取站点全局信息的字符串：网站名称、版权信息、联系方式等通常是全局配置的。
{% system %}标签可以获取系统设置中的字符串，例如{% system with name="SiteName" %}获取网站名称。{% contact %}标签则专门用于获取联系方式，例如{% contact with name="Cellphone" %}获取联系电话。如果您在后台自定义了参数，也可以通过这些标签获取，只需将name参数设置为您定义的参数名即可。 - 在列表或循环中获取字符串：当您需要展示一系列文章、分类、导航等列表时，会用到
{% archiveList %}、{% categoryList %}、{% navList %}等标签。这些标签通常与{% for %}循环结合使用。在循环体内部，每个列表项（例如item）的字符串属性可以直接通过点号访问，如{{ item.Title }}、{{ item.Description }}。 - 定义临时字符串变量：有时您需要在模板中定义临时的字符串变量，以便在后续代码中复用或进行复杂操作。
{% set new_var = "这是我的自定义字符串" %}和{% with title="文章标题" %}这两种方式都能帮助您在模板中创建和使用字符串变量。
字符串处理的利器：内置过滤器
获取到字符串后，往往需要进行进一步的处理，例如格式化、截断、清理或转义。AnQiCMS模板引擎内置了大量实用的过滤器，它们通过|符号与变量连接，可以链式使用，极大地增强了字符串处理的灵活性。
- 格式化与转换：
- 大小写转换：
|upper将字符串转为大写，|lower转为小写，|capfirst将首字母转为大写，|title将每个单词的首字母转为大写，这些在处理文本展示时非常实用。 - 通用格式化：
|stringformat:"%s"可以将各种类型的值格式化为字符串，并支持Go语言风格的占位符进行精细控制。 - 类型转换：
|integer和|float可以将字符串尝试转换为整数或浮点数，这在处理包含数字的字符串时很有用。
- 大小写转换：
- 截取与拼接：
- 截取指定部分：
|slice:"start:end"可以截取字符串或数组的指定片段，例如{{ "abcdefg"|slice:"1:4" }}会得到”bcd”。 - 截断显示：
|truncatechars:长度按字符长度截断字符串并添加省略号（...），|truncatewords:长度则按单词数量截断。如果字符串中包含HTML，可以使用|truncatechars_html和|truncatewords_html，它们会在截断时尽量保持HTML结构的完整性。 - 字符串拼接与拆分：
|join:"分隔符"可以将数组元素拼接成一个字符串，而|split:"分隔符"则能将字符串按分隔符拆分成数组。|make_list和|fields也能快速将字符串拆分成字符或单词数组。
- 截取指定部分：
- 清理与替换：
- 删除字符：
|trim可以删除字符串首尾的空格或指定字符，|trimLeft和|trimRight则分别处理左侧和右侧。|cut:"字符"可以移除字符串中所有出现的特定字符。 - 替换内容：
|replace:"旧词,新词"可以将字符串中的旧内容替换为新内容，这在批量修改文本或处理特定关键词时非常方便。
- 删除字符：
- 安全与编码：
- HTML安全输出：AnQiCMS模板默认会对输出的HTML标签进行转义，以防止XSS攻击。如果您确定某个字符串内容是安全的HTML代码，并希望它被浏览器正常解析，可以使用
|safe过滤器。例如，文章内容通常会包含HTML，这时需要{{ archive.Content|safe }}。反之，|escape（或其别名|e）则会强制进行HTML转义。 - URL编码：
|urlencode和|iriencode用于对URL参数进行编码，确保URL的有效性和安全性。 - 将换行符转为HTML：
|linebreaks和|linebreaksbr可以将文本中的换行符转换为<p>标签或<br>标签，适合将纯文本内容格式化为网页段落。
- HTML安全输出：AnQiCMS模板默认会对输出的HTML标签进行转义，以防止XSS攻击。如果您确定某个字符串内容是安全的HTML代码，并希望它被浏览器正常解析，可以使用
- 其他实用功能：
- 默认值：
|default:"默认文本"在变量为空时提供一个备用字符串。 - 统计信息：
|length获取字符串或数组的长度，|wordcount统计字符串中的单词数量，|count:"关键词"统计关键词出现的次数。 - 调试利器：当您不确定一个变量的结构或值时，
|dump过滤器能将变量的详细信息（包括类型和值）打印出来，这在模板调试时非常有用。
- 默认值：
实践建议与技巧
- 明确目标：在获取字符串之前，先确定您需要什么信息（是文章标题还是网站名称？），然后选择最合适的标签。
- 善用点号运算符：对于已获取的对象，优先使用
item.PropertyName的方式访问字符串属性，这通常比反复调用标签更简洁高效。 - 链式使用过滤器：多个过滤器可以像管道一样串联起来，前一个过滤器的输出作为后一个过滤器的输入。例如，
{{ item.Title|lower|truncatechars:20 }}先转小写再截断。 - 谨慎使用
|safe：|safe能够直接输出HTML，但如果内容来源不可信，可能引入安全风险。只在您完全信任内容来源时使用它。 - 调试技巧：如果字符串输出不符合预期，尝试在变量后添加
|dump过滤器，查看其原始结构和值，帮助您定位问题。例如{{ someVariable|dump }}。
AnQiCMS在模板中获取和处理字符串的机制既强大又灵活，通过熟练掌握各种标签和过滤器的用法，您可以轻松地构建出美观且功能丰富的网站内容。
常见问题 (FAQ)
Q1: 如何在页面标题中获取当前页面标题，并自动附加网站名称？
A1: 您可以使用tdk标签并结合`siteName