在 Django 模板中，truncatewords_html 是一个非常有用的过滤器，用于在 HTML 文本中截取一定数量的单词并保留 HTML 标签，以便在页面上显示部分内容而不破坏 HTML 结构。它允许你截取一定数量的单词，同时保持文本的格式和结构。
语法
{{ value|truncatewords_html: length }}
value: 表示要截取的 HTML 文本。length: 表示要保留的单词数量。
作用
truncatewords_html 过滤器的作用是对 HTML 文本进行截取，以便在页面上显示摘要或预览。相比于普通的 truncatewords 过滤器，truncatewords_html 能够正确处理 HTML 标签，避免截断标签导致页面结构错乱。
使用方法
在 Django 模板中，可以通过管道(|)符号将要截取的 HTML 文本传递给 truncatewords_html 过滤器，并指定要保留的单词数量。注意，length 参数是可选的，如果不指定，默认将截取 15 个单词。
使用场景
truncatewords_html 过滤器在需要显示文章摘要、博客预览、新闻列表等场景中特别有用。当你有一些包含 HTML 标签的富文本内容时，希望在页面上以摘要的形式显示，这个过滤器就能派上用场。
代码示例
现在，让我们通过代码示例来详细描述其用法：
假设我们有以下 HTML 内容存储在 post.content 变量中，并我们想要在模板中显示一个包含不超过 50 个单词的摘要：
<!-- post.content -->
<p><strong>Welcome to my blog post!</strong></p>
<p>This is a <a href="#">Django tutorial</a> about using template filters.</p>
<p>Template filters are <em>powerful</em> tools to manipulate your data.</p>
我们可以在 Django 模板中使用 truncatewords_html 过滤器来实现：
<!-- template.html -->
{% load humanize %} <!-- 加载humanize过滤器库，用于显示千位分隔符（非必需） -->
<!-- 显示带有摘要的内容 -->
<div class="post">
<h2>{{ post.title }}</h2>
{% with truncated_content=post.content|truncatewords_html:50 %}
{{ truncated_content|safe }} <!-- 使用safe过滤器确保HTML标签被解析而不是转义 -->
{% endwith %}
<p>Read more at <a href="{{ post.get_absolute_url }}">Read More</a></p>
</div>
在上面的代码中，我们使用了 truncatewords_html 过滤器将 post.content 中的 HTML 文本截取为不超过 50 个单词的摘要，并将结果保存在 truncated_content 变量中。然后，我们使用 safe 过滤器确保 HTML 标签被解析而不是转义，从而在页面上正确显示 HTML 结构。
请注意，在使用 truncatewords_html 过滤器之前，我们需要使用 load 标签加载 humanize 过滤器库（这是 Django 的内置库，不过它可能需要在 settings 中启用）以便使用 safe 过滤器。
以上代码示例演示了如何在模板中使用 truncatewords_html 过滤器来截取 HTML 文本的一部分，以便在页面上显示一个带有摘要的内容。这样做可以提高用户体验，让用户更容易浏览和理解长文本内容。