模板变量是在小程序模板中使用的变量,用于存储和展示数据。它们的作用是在模板渲染时计算并输出数据。模板变量的命名规则是由字母、数字、下划线(不能以下划线开头)和点组成。
模板变量的使用规则
语法:
使用双大括号 `{{ }}` 包裹变量名,例如 `{{ variable_name }}`。
命名规则:
变量名必须由字母、数字、下划线和点组成,不能以数字或下划线开头,且不能包含空格和标点符号。
数据类型:
模板变量可以引用字典、模型、方法、函数和列表等数据类型。
避免冲突:
变量名不应与Python或Django关键字重名,以免引起冲突。
模板变量的解析顺序
当模板引擎遇到点(如 `book.title`)时,会按照以下顺序解析:
字典查找:
首先查找字典中是否存在键为 `title` 的项,例如 `book['title']`。
属性查找:
如果字典中不存在该键,则将 `book` 当作对象,查找属性 `title`,例如 `book.title`。
方法查找:
如果属性也不存在,则查找方法 `title()`,例如 `book.title()`。
列表索引:
如果变量名格式为 `book.0`,则解析为列表 `book` 的第一个元素,例如 `book`。
示例
```html
{{ data.name }}
```
如果 `data` 是一个字典,例如:
```python
data = {
'name': 'John Doe'
}
```
那么模板渲染时会输出 `John Doe`。
建议
在使用模板变量时,确保变量名符合命名规则,避免与关键字冲突。
理解模板变量的解析顺序有助于正确引用和展示数据。
合理利用过滤器可以进一步处理模板变量,例如格式化日期、时间等。