In web design and content display, in order to enhance the user reading experience and make the information presentation clearer, we often need to apply different styles to the odd and even rows in tables or lists.This visual distinction not only breaks the monotony of the content but also significantly improves the readability of the data.In AnQiCMS, achieving this effect with its flexible and powerful template engine is quite direct and convenient.
Core Concept:forLoop and Row Counter
AnQiCMS's template system uses a syntax similar to Django's template engine, which allows us to easily obtain the current loop index when iterating over data. The key to implementing odd/even row differentiation styles lies in utilizingforNested in the loopforloop.CounterVariable.
When we use sucharchiveList/categoryList/pageListetc. tags to get the data list, and then through{% for item in archives %}such a structure to iterate, forloop.CounterIt will automatically record the number of times the current loop is running, and its count starts from 1.
With this counter, we can determine whether each line is an odd or even line, and then apply different styles to them.
Implement different styles for odd and even lines.
The most common method to determine if a number is odd or even is to use the modulo (Modulo) operator%A number divided by 2, if the remainder is 1, then the number is odd; if the remainder is 0, then the number is even.
In AnQiCMS templates, we can use it like this:
- When
forloop.Counter % 2 == 1means it is an odd row. - When
forloop.Counter % 2 == 0means it is an even row.
Next, we can use this judgment result to dynamically add different CSS classes to list items (such as<li>labels or table cells'<tr>labels).
The following is an example of aarchiveListAdd an example of odd and even row styling to the list items:
Suppose we want to display an article list and make the odd and even row backgrounds different.
<ul class="article-list">
{% archiveList archives with type="list" limit="10" %}
{% for item in archives %}
{# 根据 forloop.Counter 的奇偶性，动态添加 CSS 类 #}
<li class="article-item {% if forloop.Counter % 2 == 1 %}odd-row{% else %}even-row{% endif %}">
<a href="{{item.Link}}">
<h3>{{item.Title}}</h3>
<p>{{item.Description}}</p>
<span>发布日期：{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
</a>
{% if item.Thumb %}
<img src="{{item.Thumb}}" alt="{{item.Title}}">
{% endif %}
</li>
{% empty %}
<li>暂无文章内容</li>
{% endfor %}
{% endarchiveList %}
</ul>
Then, in your CSS file (usually)/public/static/你的模板目录/css/style.cssOr specify the style files you reference, define the styles of these classes:
/* article-list 样式（可选，根据你的布局需求） */
.article-list {
list-style: none;
padding: 0;
margin: 0;
}
/* 奇数行样式 */
.odd-row {
background-color: #f9f9f9; /* 浅灰色背景 */
padding: 15px;
margin-bottom: 10px;
border-radius: 5px;
}
/* 偶数行样式 */
.even-row {
background-color: #ffffff; /* 白色背景 */
padding: 15px;
margin-bottom: 10px;
border-radius: 5px;
box-shadow: 0 2px 5px rgba(0,0,0,0.05); /* 添加一点阴影增加区分度 */
}
/* 列表项内部链接和文本样式（可选） */
.article-item a {
text-decoration: none;
color: #333;
display: block;
}
.article-item h3 {
color: #0056b3;
margin-top: 0;
margin-bottom: 5px;
}
.article-item p {
font-size: 0.95em;
color: #666;
line-height: 1.6;
margin-bottom: 10px;
}
.article-item span {
font-size: 0.85em;
color: #999;
}
.article-item img {
max-width: 100px;
height: auto;
float: right;
margin-left: 15px;
border-radius: 3px;
}
This will make your article list display clear odd and even line differentiation styles, greatly enhancing the visual effects and user experience.
Actual application scenarios and extension ideas
This method is not limited to simple<ul><li>lists, it also applies to:
- tables (
<table>) data:In<tr>apply odd and even row styles on the tag to make the table data clear at a glance. - Card layout:Each card as a cyclic item, the background and border can be adjusted according to odd and even numbers.
- Comment list:Make it easier for users to distinguish different comment entries.
Besides odd and even rows,forloop.CounterCan also help us achieve more flexible style control, for example:
- Highlight the first element:
{% if forloop.Counter == 1 %}first-item{% endif %} - Group elements of a specific number:
{% if forloop.Counter % 3 == 0 %}third-item-group-end{% endif %}
By using these techniques, you can better utilize the powerful functions of the AnQiCMS template engine to create a beautiful, easy-to-use, and feature-rich website interface.
Frequently Asked Questions (FAQ)
This odd-even row style method is only applicable to lists (
<ul>) right?No, this method is applicable to all the AnQiCMS templates that use{% for ... in ... %}HTML elements traversed in a loop. Whether it's a table row (<tr>) or a card layout constructed usingdiv, you can make use of it inside the loop.forloop.CounterTo determine the odd or even line and apply different styles.How can I add a special style to the first line of the list instead of the odd or even line style?You can use
forloop.CounterTo determine if the current loop is the first iteration. For example, in your<li>tag, you can judge like this:<li class="{% if forloop.Counter == 1 %}first-item-style{% elif forloop.Counter % 2 == 1 %}odd-row{% else %}even-row{% endif %}"> <!-- 内容 --> </li>Then define
first-item-stylethe CSS style.Where should I put these CSS styles in the AnQiCMS template file?According to the AnQiCMS template creation conventions, the static resources such as styles, JS scripts, images, and so on used by the template are usually stored in
/public/static/In the directory. So, you can add these CSS rules in your template folder, for exampletemplates/your_template_name/public/static/css/style.cssIn the file, add these CSS rules. Make sure your HTML template file correctly references these CSS files.