In the template development of AnQi CMS, we often need to flexibly truncate and display strings or data lists, presenting only a part of them.sliceThe filter is exactly for this purpose, allowing us to precisely control the length of content. And forsliceDoes the filter support negative indices, which means whether it can be cut from the end, the answer is affirmative, and this feature greatly enhances the flexibility and convenience of our templates when dealing with dynamic content.

sliceBasic Usage of Filters Review

Firstly, let's briefly review.sliceBasic Syntax of Filters. It is usually followed by{{ 变量 | slice:"from:to" }}in the form of, wherefromandtoare optional numbers used to specify the start and end positions.

  • from:It indicates starting from the specifiedfromposition and continuing to the end of the string or array. For example:{{ "AnQiCMS"|slice:"2:" }}it will outputQiCMS(starting from index 2, i.e., the third character).
  • :to: means to cut from the beginning of the string or array to the specifiedtoposition (excluding the element at that position). For example:{{ "AnQiCMS"|slice:":5" }}it will outputAnQiC(From the start to index 5, not including index 5's character).
  • from:to: indicates cutting a clear range fromfromstarting at positionto(same as above, not including the character at this position)tothe position element). For example:{{ "AnQiCMS"|slice:"1:4" }}it will outputnQi(From index 1 to index 4, excluding the character at index 4).

These usages are applicable to both strings and arrays (or Go's slice type) alike.

Negative indices: a powerful tool for slicing from the end.

sliceThe real strength of the filter lies in its support for negative indices. Negative indices provide a convenient way to count from the end of a string or an array.endstarting.

  • -1Represents the last element.
  • -2Represents the second-to-last element, and so on.

Let's see how negative indices work with some concrete examples:

  1. Slicing a specific portion starting from the endIf you want to get the last few elements of a list, negative indices are very convenient. Suppose we have a list of numbers:[1, 1, 2, 3, 5, 8, 13, 21, 34, 55].

    • To get the last element:{{ simple.multiple_item_list|slice:"-1:"|join:"," }}You will get55This means starting from the last element and cutting to the end.
    • To get the last three elements:{{ simple.multiple_item_list|slice:"-3:"|join:"," }}You will get21,34,55.
    • The same applies to strings:{{ "你好世界"|slice:"-1:" }}You will get界.

  2. Cut all content except for the last N elementsOn the contrary to truncating from the end, you can also exclude the last element by using negative indices.

    • Get all the content except the last element:{{ simple.multiple_item_list|slice:":-1"|join:"," }}You will get1,1,2,3,5,8,13,21,34.
    • Get all content except the last three elements:{{ simple.multiple_item_list|slice:":-3"|join:"," }}You will get1,1,2,3,5,8,13.
    • For the string:{{ "你好世界"|slice:":-1" }}You will get你好世.

  3. Perform more complex slicing with both positive and negative indices sliceThe filter also supports combining positive and negative indices to define a more flexible range of extraction.

    • For example, to start from the second element (index 1) of the list and cut off to the second-to-last element (not including the second-to-last):{{ ["A", "B", "C", "D", "E"]|slice:"1:-1"|join:"," }}it will outputB,C,D.

Whether it is from the beginning, from the end, or combined with positive and negative indices to define the range of extraction,sliceThe filter can meet our needs, making data processing in the template more intuitive and efficient.

Actual application scenarios

Negative index of thesliceThe filter has many practical scenarios in the operation of website content:

  • Displaying the latest comments or dynamic of N summariesAssuming the backend returns all comments, you may only want to display the latest 3 comments on the homepage or detail page sidebar. Use|slice:"-3:"to easily achieve this.
  • Get the last image in the list of imagesIf a content model returns multiple images and you only need to display the last one in a specific position as a cover,|slice:"-1:"it can be very useful.
  • Extract the end part of the article title or descriptionIn some designs, it may be necessary to display or handle the specific end part of the title separately, with negative indices specifying this precisely.
  • Displaying partial information in a composite documentFor example, on a product comparison page, you might only be concerned about a few key parameters, and you can use negative indices to quickly locate and display them.

Tip

  • When usingsliceThe filter's logic is 'left inclusive, right exclusive', i.e.,fromthe element at the position will be included,towhile the element at the position will not be included.
  • If the specified index is beyond the actual length of the string or array,sliceThe filter usually does not report an error, but returns an empty value or truncates as much content as possible within the valid range, making it more robust when handling dynamic or uncertainly long data.
  • The Chinese and English strings are unified in index calculation, that is, one Chinese character is counted as one character for indexing.

In summary, in the Anqi CMS,sliceFilter, especially its support for negative indices, provides powerful content truncation capabilities to template developers.Mastering this feature can help us control the display of page content more flexibly and efficiently, thereby enhancing the user experience and the quality of content presentation on the website.

Common Questions and Answers (FAQ)

1.sliceDoes the filter apply only to strings, or does it also apply to arrays (slice/list)? sliceThe filter is not only applicable to strings but also to arrays (or slice/slice type in Go language). Whether it is text content or a collection of data, you can use it.sliceTo perform the cut operation.

2. What happens if the specified negative index is out of the length of the string or array?WhensliceWhen a negative index used in the filter exceeds the actual length of the original string or array, the system usually handles it intelligently.It will not produce an error, but will return the result based on the actual available range.fromThe index is a positive number and within range).

3.sliceIn the filter.fromandtoIs the index inclusive or exclusive? sliceThe index of the filter is 'left inclusive and right exclusive.' This meansfromThe starting position specified by the parameter isincludingin the截取result, whereastoThe ending position specified by the parameter isdoes not includein the截取result. For example,"AnQiCMS"|slice:"1:4"It will extract characters at indices 1, 2, and 3, but not the character at index 4.