如何将用户输入的多行文本中的换行符，自动转换为HTML的`
`标签？

在使用安企CMS发布内容时，我们经常会遇到这样的情况：在内容编辑框中输入的文本，如果包含多行信息，但前台页面展示时，这些换行符却‘消失’了，导致文本挤在一起，阅读体验不佳。这通常是因为HTML默认会将文本中的换行符（\n）视为普通空格。不过，安企CMS提供了一套非常便捷的模板过滤器，能够帮助我们轻松解决这个问题，让多行文本在网页上也能保持原有的排版样式。

核心功能：linebreaksbr 过滤器

当我们需要将用户输入的多行文本中的换行符（\n）直接转换为HTML的<br>标签时，linebreaksbr过滤器是我们的首选工具。它的作用非常直接，就是将每一个文本换行都替换成浏览器可以识别的换行标签<br/>。

使用方法非常直观，只需在您需要处理的变量后面加上 |linebreaksbr 即可。例如，如果您有一个变量叫做 archiveContent，它包含了您从后台获取的多行文本内容，那么在模板中您可以这样使用：

{# 假设 archiveContent 是从文档内容中获取的多行文本变量 #}
{{ archiveContent|linebreaksbr|safe }}

请注意，这里除了|linebreaksbr之外，我们还额外添加了一个|safe过滤器。这是非常关键的一步，因为linebreaksbr过滤器会生成HTML标签（<br/>）。为了确保浏览器能够正确解析这些新生成的HTML标签，而不是将它们作为纯文本（例如直接显示<br>）显示在页面上，我们必须使用|safe来告诉模板引擎，这段内容是安全的HTML，可以按原样输出。

通常，我们会在文章详情页、单页面或自定义内容模型中，将用户在后台文本编辑器里输入的多行内容，通过这种方式在前台显示，以保持内容的原始排版。

了解 linebreaks 过滤器：另一个选择

除了linebreaksbr，安企CMS还提供了linebreaks过滤器。这个过滤器功能类似，但它会更进一步，将文本的每段（由连续的非空行组成，通过空行进行分隔）用<p>标签包裹起来，并在段落内的换行处插入<br/>。

如果您希望多行文本以段落的形式呈现，并带有<p>标签带来的默认样式和语义，那么linebreaks会是更合适的选择。例如，它会将：

第一行文本
第二行文本

第三行文本

处理成：

<p>第一行文本<br/>第二行文本</p><p>第三行文本</p>

如果只是单纯地希望每个换行都变成一个<br/>，而不需要额外的<p>标签包裹，那么linebreaksbr更简洁、更符合直接转换换行的需求。

使用linebreaks过滤器的方式也与linebreaksbr类似，同样需要|safe配合：

{{ archiveContent|linebreaks|safe }}

在安企CMS模板中实际应用

这两个过滤器都属于安企CMS模板系统内置的“过滤器”功能，这意味着它们需要在您的模板文件（通常是.html文件，如文章详情页的detail.html）中调用，作用于您从后台获取的任何包含多行文本的变量。

例如，在展示文档详情时，您可能通过archiveDetail标签获取了文章内容：

{# 假设您正在展示一篇文档的详情页，并且文档内容变量名为 articleContent #}
{% archiveDetail articleContent with name="Content" %}
<div class="document-content">
    {# 这里应用过滤器，将用户输入的换行符转换为 <br/> 标签 #}
    {{ articleContent|linebreaksbr|safe }} {# 或根据需求使用 |linebreaks|safe #}
</div>
{% endarchiveDetail %}

通过灵活运用linebreaksbr或linebreaks过滤器，安企CMS的用户可以轻松地让后台输入的文本内容在前端页面上保持美观、规范的排版，极大地提升了网站内容的展现效果和用户阅读体验。这不仅是技术细节的优化，更是内容运营中不可忽视的重要一环。

常见问题 (FAQ)

1. 为什么我使用了linebreaksbr或linebreaks后，换行符还是没生效，或者页面上直接显示出了<br>标签的文本？

这个常见问题很可能发生在您在使用这些过滤器后，忘记添加|safe。|safe过滤器是告诉模板引擎，这段内容是安全的HTML，不需要再进行转义。如果缺少了|safe，模板系统出于安全考虑，会将<br>这样的HTML标签转义为<br>，导致页面上直接显示出这些文本而非实际的换行效果。请务必确认您的代码中包含了|safe。

2. linebreaksbr和linebreaks这两种过滤器，我该如何选择？

选择哪种过滤器取决于您希望多行文本在页面上的最终排版效果。

• 如果您只是想让用户输入的每一个换行符都简单地变成一个HTML换行标签（<br/>），而不额外添加段落标签（<p>），那么linebreaksbr是更简洁、更直接的选择。
• 如果您希望将多行文本自动分割成HTML段落（<p>标签），并在这些段落内部的换行处添加<br/>，那么linebreaks会是更好的选择，它能为您的内容提供更强的结构化语义。

3. 除了文章内容，还有哪些地方可以用到这些过滤器？

任何从安企CMS后台获取，并且期望保留换行符的多行文本字段都可以使用这些过滤器。这包括但不限于：

• 文章或产品模型的Description（简介）字段。
• 在自定义内容模型中定义的“多行文本”类型的字段。
• 单页面管理（pageDetail）中的Content字段。
• 甚至一些留言表单（guestbook）提交的内容，在显示时如果需要保留用户输入的换行。 总之，只要是用户在后台多行文本框中输入的内容，在前台展示时遇到换行丢失的问题，都可以考虑应用这些过滤器。