Does the `split` filter retain or remove HTML tags from a string containing HTML tags?

In the daily operation of websites, we often need to process the content we obtain in various ways, such as cutting long texts into short sentences or extracting key information from a description. The template engine of Anqi CMS provides a series of powerful filters to help us complete these tasks, among whichsplitThe filter is a very commonly used one.

However, the content is often not just plain text, it may contain various HTML tags, such as paragraph tags<p>, bold tags<b>, link tags<a>Wait a moment. This leads to a question that everyone is concerned about: when we need to usesplitWhen using a filter to split a string containing HTML tags, will these HTML tags be retained or automatically removed?

UnderstandingsplitHow does the filter work?

To answer this question, we first need to understandsplitThe design philosophy of the filter in the Anqi CMS template engine.It is the core function to split a string into multiple parts based on the specified delimiter and return them as an array (slice).splitThe filter will not recognize or parse HTML tags within the string.

This means, regardless of your delimiter being a common character (such as a comma, space), or something that looks like a part of an HTML tag, splitThe filters treat them all equally, just as part of the string. It does not intelligently judge which are 'tags' and which are 'content'.

Let's take a simple example to see it in detail:

Suppose we have a string containing HTML tags, and we want to use。</p>as a delimiter to split:

{% set content_with_html = "<p>这是一段<b>重要的</b>信息。</p><span>更多详情。</span>" %}
{% set parts = content_with_html|split:"。</p>" %}

{% for part in parts %}
    <p>切割出的部分：{{ part|safe }}</p>
{% empty %}
    <p>没有切割出任何部分。</p>
{% endfor %}

In this code block,splitThe filter will split the entire string literally.。</p>You will find that the result of the split will retain the HTML tags:

The first part might be:<p>这是一段<b>重要的</b>信息The second part might be:<span>更多详情。</span>

It is evident that HTML tags (such as<p>,<b>,<span>) are completely preserved in each of the cut string segments

Application scenarios and potential problems

This feature is very useful in certain scenarios. For example, if you want to structure a list of HTML (such as multiple ）<li>An element that is split into separate list items by a specific delimiter, and each list item must retain its internal HTML structure, thensplitThe filter can meet your needs well.

However, this pure text processing method may also bring some potential problems.If your delimiter happens to appear in the middle of an HTML tag, then the tag itself will be split, which may cause damage to the HTML structure and affect the display effect of the front-end page, and even trigger some front-end script errors."d"To cut<div>, you will get<andiv>, this is obviously not the result we want.

Moreover, if you just want to extract words or sentences from a piece of plain text without letting HTML tags interfere with the cutting result, then you can directly usesplitThe filter may give you "dirty data" with tags, which will increase the complexity of subsequent processing.

How to remove HTML tags and then split:striptagsandremovetags

If your goal is to cut pure text content rather than retain HTML tags, Anqi CMS provides other more suitable filters to solve this problem.

First, you can usestriptagsA filter that can effectively strip all HTML tags from a string, leaving only plain text content. Then, you can safely use these plain text contents.splitThe filter performs a cut.

This is an example of cutting after stripping HTML tags:

{% set content_with_html = "<p>这是一段<b>重要的</b>信息。</p><span>更多详情。</span>" %}
{% set plain_text = content_with_html|striptags %} {# 使用striptags去除所有HTML标签 #}
{% set words = plain_text|split:"。" %} {# 然后对纯文本进行切割 #}

{% for word in words %}
    <p>纯文本切割：{{ word }}</p>
{% empty %}
    <p>没有切割出任何部分。</p>
{% endfor %}

afterstriptagsAfter processing,plain_textThe variable will become"这是一段重要的信息。更多详情。". Then use it again.split:"。"Cutting will give you clean text fragments, for example: The first part is:这是一段重要的信息The second part is:更多详情

If you only need to remove specific HTML tags, not all of them, thenremovetagsThe filter will be a better choice, you can specify the tag names you need to remove, for example"p,b".

Summary

In general, in Anqi CMS,splitThe filter treats strings containing HTML tags as plain text characters andretainsThese HTML tags. It will not automatically recognize, parse, or remove HTML structures.

When your need is to split pure text content, it is recommended to usesplitbefore the filter.striptagsorremovetagsA filter to clean HTML tags.The strength of the Anqi CMS template engine lies in the ability to chain these filters for more complex and fine-grained string processing logic, thereby better meeting your content operation needs.

---

Frequently Asked Questions (FAQ)

1.splitCan the filter be split by the HTML tag itself?

Of course. If you take a complete HTML tag (such as<br/>or</span>) assplitThe delimiter for the filter, it will split according to this literal string. For example,"内容1<br/>内容2<br/>内容3"|split:"<br/>"It will split the string into["内容1", "内容2", "内容3"]In this case, HTML tags will be 'consumed' and will not appear in the cutting result.

2. How can I cut the text within a specific HTML tag while keeping the rest of the HTML structure unchanged?

This goes beyondsplitThe pure text cutting ability of the filter.splitOnly split the entire string by separator.If you need to process only the text within specific HTML tags, you usually need more advanced string processing logic.replaceThe filter with some clever replacement logic, or extracting the text within the target tag when processing data on the backend.splitOperate, and then reinsert the processed text back into the original HTML structure.In AnQi CMS template engine, directly implementing this complex logic would be difficult. It is usually recommended to handle such structured needs on the backend before the data enters the template rendering.

3. BesidesstriptagsandremovetagsWhat are the filters of AnQi CMS related to HTML tag processing?

AnQi CMS's template engine also provides some other filters that are 'aware' of HTML tags.