doc: update djiango.md (#16)
This commit is contained in:
jaywcjlove
parent
4caec0d065
commit
b63edf46f8
329
docs/djiango.md
329
docs/djiango.md
@ -1,7 +1,7 @@
|
||||
Django 备忘清单
|
||||
===
|
||||
|
||||
Django 是 Python 的一款 Web 框架
|
||||
Django 是 Python 的一款 Web 框架，本备忘单旨在快速理解 [Django](https://www.djangoproject.com/) 所涉及的主要概念，提供了最常用的 API 示例参考
|
||||
|
||||
入门
|
||||
----
|
||||
@ -300,6 +300,333 @@ CREATE TABLE "members_members" (
|
||||
);
|
||||
```
|
||||
|
||||
Django 模板
|
||||
---
|
||||
|
||||
### 模板变量
|
||||
<!--rehype:wrap-class=col-span-2 row-span-2-->
|
||||
|
||||
```django
|
||||
<!-- template.html -->
|
||||
<h1>你好 {{ firstname }}，你好吗？</h1>
|
||||
```
|
||||
|
||||
在视图 (`views.py`) 中创建变量，上面示例中的变量 `firstname` 通过视图发送到模板：
|
||||
|
||||
```py
|
||||
from django.http import HttpResponse
|
||||
from django.template import loader
|
||||
|
||||
def testing(request):
|
||||
template = loader.get_template('template.html')
|
||||
context = {
|
||||
'firstname': '狂徒张三',
|
||||
}
|
||||
return HttpResponse(template.render(context, request))
|
||||
```
|
||||
|
||||
### 模板中创建变量
|
||||
|
||||
```django
|
||||
{% with firstname="Tobias" %}
|
||||
<h1>你好 {{ firstname }}，你好吗？</h1>
|
||||
```
|
||||
|
||||
### 数组循环
|
||||
|
||||
```django
|
||||
<ul>
|
||||
{% for x in mymembers %}
|
||||
<li>{{ x.firstname }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
```
|
||||
|
||||
### 模板标签参考
|
||||
<!--rehype:wrap-class=row-span-5-->
|
||||
|
||||
标签 | 描述
|
||||
:- | :-
|
||||
`autoescape` | 指定自动转义模式是打开还是关闭
|
||||
`block` | 指定块部分
|
||||
`comment` | 指定注释部分
|
||||
`csrf_token` | 保护表单免受跨站点请求伪造
|
||||
`cycle` | 指定要在循环的每个循环中使用的内容
|
||||
`debug` | 指定调试信息
|
||||
`extends` | 指定父模板
|
||||
`filter` | 在返回之前过滤内容
|
||||
`firstof` | 返回第一个非空变量
|
||||
`for` | 指定一个 for 循环
|
||||
`if` | 指定一个 if 语句
|
||||
`ifchanged` | 仅当自上次迭代以来值已更改时才输出块<br> _(用于 for 循环)_
|
||||
`include` | 指定包含的内容/模板
|
||||
`load` | 从另一个库加载模板标签
|
||||
`lorem` | 输出随机文本
|
||||
`now` | 输出当前日期/时间
|
||||
`regroup` | 按组对对象进行排序
|
||||
`resetcycle` | 循环使用，重置循环
|
||||
`spaceless` | 删除 HTML 标签之间的空格
|
||||
`templatetag` | 输出指定的模板标签
|
||||
`url` | 返回 URL 的绝对 URL 部分
|
||||
`verbatim` | 指定不应由模板引擎呈现的内容
|
||||
`widthratio` | 给定值和最大值之间的比率计算宽度值
|
||||
`with` | 指定要在块中使用的变量
|
||||
<!--rehype:className=show-header-->
|
||||
|
||||
### If 语句
|
||||
|
||||
```django
|
||||
{% if greeting == 1 %}
|
||||
<h1>Hello</h1>
|
||||
{% elif greeting == 2 %}
|
||||
<h1>Welcome</h1>
|
||||
{% else %}
|
||||
<h1>Goodbye</h1>
|
||||
{% endif %}
|
||||
```
|
||||
|
||||
### For 循环
|
||||
<!--rehype:wrap-class=row-span-2-->
|
||||
|
||||
```django
|
||||
{% for x in cars %}
|
||||
<h1>{{ x.brand }}</h1>
|
||||
<p>{{ x.model }}</p>
|
||||
<p>{{ x.year }}</p>
|
||||
{% endfor %}
|
||||
```
|
||||
|
||||
数据 cars 空的展示内容：
|
||||
|
||||
```django
|
||||
<ul>
|
||||
{% for x in cars %}
|
||||
<h1>{{ x.brand }}</h1>
|
||||
<p>{{ x.model }}</p>
|
||||
<p>{{ x.year }}</p>
|
||||
{% empty %}
|
||||
<li>No members</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
```
|
||||
|
||||
### 循环变量
|
||||
<!--rehype:wrap-class=row-span-2-->
|
||||
|
||||
- `forloop.counter` 当前循环，从 1 开始
|
||||
- `forloop.counter0` 当前循环，从 0 开始
|
||||
- `forloop.first` 循环是否在其第一次循环中
|
||||
- `forloop.last` 循环是否在其最后一次循环中
|
||||
- `forloop.parentloop`
|
||||
- `forloop.revcounter` 如果从末尾开始并向后计数，则以 1 结束
|
||||
- `forloop.revcounter0` 如果从末尾开始并向后计数，则以 0 结束
|
||||
|
||||
### 过滤值
|
||||
|
||||
```django
|
||||
<h1>你好 {{ firstname|upper }}，你好吗？</h1>
|
||||
```
|
||||
|
||||
返回带有大写字母的变量名
|
||||
|
||||
### 注释
|
||||
<!--rehype:wrap-class=row-span-2-->
|
||||
|
||||
```django
|
||||
<h1>欢迎大家{# 较小的注释 #}</h1>
|
||||
{% comment %}
|
||||
<h1>欢迎女士们先生们</h1>
|
||||
{% endcomment %}
|
||||
```
|
||||
|
||||
#### 注释描述
|
||||
|
||||
```django
|
||||
<h1>欢迎大家{# 较小的注释 #}</h1>
|
||||
{% comment "这是最初的欢迎信息" %}
|
||||
<h1>欢迎女士们先生们</h1>
|
||||
{% endcomment %}
|
||||
```
|
||||
|
||||
注释允许您拥有应该被忽略的代码部分
|
||||
|
||||
### 双过滤值
|
||||
|
||||
```django
|
||||
<h1>你好 {{ firstname|first|upper }}，你好吗？</h1>
|
||||
```
|
||||
|
||||
返回变量 `firstname` 的第一个字符，小写
|
||||
|
||||
### 过滤器标签
|
||||
|
||||
```django
|
||||
{% filter upper %}
|
||||
<h1>Hello everyone, how are you?</h1>
|
||||
{% endfilter %}
|
||||
```
|
||||
|
||||
返回内容大写
|
||||
|
||||
### cycle
|
||||
<!--rehype:wrap-class=col-span-2 row-span-3-->
|
||||
|
||||
如果你想为每次循环使用新的背景颜色，你可以使用 `cycle` 标签来做到这一点
|
||||
|
||||
```django
|
||||
<ul>
|
||||
{% for x in members %}
|
||||
<li style='background-color:{% cycle 'lightblue' 'pink' 'yellow' 'coral' 'grey' %}'>
|
||||
{{ x.firstname }}
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
```
|
||||
|
||||
将参数值保存在变量中，以便以后使用：
|
||||
|
||||
```django
|
||||
<ul>
|
||||
{% for x in members %}
|
||||
{% cycle 'lightblue' 'pink' 'yellow' 'coral' 'grey' as bgcolor silent %}
|
||||
<li style='background-color:{{ bgcolor }}'>
|
||||
{{ x.firstname }}
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
```
|
||||
|
||||
你注意到 `silent` 关键字了吗？ 确保添加这个，否则参数值将在输出中显示两次
|
||||
|
||||
```django
|
||||
<ul>
|
||||
{% for x in members %}
|
||||
{% cycle 'lightblue' 'pink' 'yellow' 'coral' 'grey' as bgcolor silent %}
|
||||
{% if forloop.counter == 3 %}
|
||||
{% resetcycle %}
|
||||
{% endif %}
|
||||
<li style='background-color:{{ bgcolor }}'>
|
||||
{{ x.firstname }}
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
```
|
||||
|
||||
您可以使用 `{% resetcycle %}` 标签强制循环重新开始
|
||||
|
||||
### 每一行添加行号
|
||||
|
||||
```django
|
||||
{% filter upper|linenumbers %}Hello!
|
||||
my name is
|
||||
Emil.
|
||||
What is your name?{% endfilter %}
|
||||
```
|
||||
|
||||
返回内容`大写`并在每一行添加`行号`
|
||||
|
||||
### 导入模板
|
||||
|
||||
`footer.html`:
|
||||
|
||||
```django
|
||||
<p>您已到达本页底部，感谢您抽出宝贵时间</p>
|
||||
```
|
||||
|
||||
`template.html`:
|
||||
|
||||
```django
|
||||
<h1>Hello</h1>
|
||||
<p>此页面包含模板中的页脚</p>
|
||||
{% include 'footer.html' %}
|
||||
```
|
||||
|
||||
### 导入模板传入变量
|
||||
|
||||
`mymenu.html`:
|
||||
|
||||
```django
|
||||
<div>HOME | {{ me }} | ABOUT | FORUM | {{ sponsor }}</div>
|
||||
```
|
||||
<!--rehype:className=wrap-text -->
|
||||
|
||||
`template.html`:
|
||||
|
||||
```django
|
||||
{% include mymenu.html with me="张三" sponsor="Reference" %}
|
||||
|
||||
<h1>Welcome</h1>
|
||||
|
||||
<p>This is my webpage</p>
|
||||
```
|
||||
<!--rehype:className=wrap-text -->
|
||||
|
||||
### 过滤器参考
|
||||
<!--rehype:wrap-class=col-span-2-->
|
||||
|
||||
Keyword | Description
|
||||
:- | :-
|
||||
`add` | 添加指定的值
|
||||
`addslashes` | 在任何引号字符之前添加一个斜杠，以转义字符串
|
||||
`capfirst` | 返回大写的第一个字母
|
||||
`center` | 使值在指定宽度的中间居中
|
||||
`cut` | 删除任何指定的字符或短语
|
||||
`date` | 以指定格式返回日期
|
||||
`default` | 如果值为 `False`，则返回指定值
|
||||
`default_if_none` | 如果值为 `None`，则返回指定的值
|
||||
`dictsort` | 按给定值对字典进行排序
|
||||
`dictsortreversed` | 按给定值对字典进行反向排序
|
||||
`divisibleby` | 如果该值可以除以指定的数字，则返回 `True`，否则返回 `False`
|
||||
`escape` | 从字符串中转义 `HTML` 代码
|
||||
`escapejs` | 从字符串中转义 `JavaScript` 代码
|
||||
`filesizeformat` | 将数字返回为文件大小格式
|
||||
`first` | 返回对象的第一项（对于字符串，返回第一个字符）
|
||||
`floatformat` | 将浮点数四舍五入到指定的小数位数，默认为一位小数
|
||||
`force_escape` | 从字符串中转义 `HTML` 代码
|
||||
`get_digit` | 返回数字的特定数字
|
||||
`iriencode` | 将 `IRI` 转换为 `URL` 友好字符串
|
||||
`join` | 将列表中的项目返回为字符串
|
||||
`json_script` | 将一个对象返回为由 `<script></script>` 标签包围的 `JSON` 对象
|
||||
`last` | 返回对象的最后一项（对于字符串，返回最后一个字符）
|
||||
`length` | 返回对象中的项目数，或字符串中的字符数
|
||||
`length_is` | 如果长度与指定的数字相同，则返回 `True`
|
||||
`linebreaks` | 返回带有 `<br>` 而不是换行符和 `<p>` 而不是多个换行符的文本
|
||||
`linebreaksbr` | 返回带有 `<br>` 的文本，而不是换行符
|
||||
`linenumbers` | 返回每行带有行号的文本
|
||||
`ljust` | 根据指定的宽度左对齐值
|
||||
`lower` | 以小写字母返回文本
|
||||
`make_list` | 将值转换为列表对象
|
||||
`phone2numeric` | 将带字母的电话号码转换为数字电话号码
|
||||
`pluralize` | 如果指定的数值不是 `1`，则在值的末尾添加一个 `s`
|
||||
`pprint` |
|
||||
`random` | 返回对象的随机项
|
||||
`rjust` | 根据指定的宽度右对齐值
|
||||
`safe` | 标记此文本是安全的，不应进行 `HTML` 转义
|
||||
`safeseq` | 将对象的每个项目标记为安全且项目不应进行 `HTML` 转义
|
||||
`slice` | 返回文本或对象的指定切片
|
||||
`slugify` | 将文本转换为一个长字母数字小写单词
|
||||
`stringformat` | 将值转换为指定格式
|
||||
`striptags` | 从文本中删除 `HTML` 标记
|
||||
`time` | 以指定格式返回时间
|
||||
`timesince` | 返回两个日期时间之间的差
|
||||
`timeuntil` | 返回两个日期时间之间的差
|
||||
`title` | 文本中每个单词的第一个字符大写，所有其他字符都转换为小写
|
||||
`truncatechars` | 将字符串缩短为指定数量的字符
|
||||
`truncatechars_html` | 将字符串缩短为指定数量的字符，而不考虑任何 `HTML` 标记的长度
|
||||
`truncatewords` | 将字符串缩短为指定数量的单词
|
||||
`truncatewords_html` | 将字符串缩短为指定数量的单词，而不考虑任何 `HTML` 标记
|
||||
`unordered_list` | 将对象的项目返回为无序列的 `HTML` 列表
|
||||
`upper` | 以大写字母返回文本
|
||||
`urlencode` | `URL` 对字符串进行编码
|
||||
`urlize` | 将字符串中的任何 `URL` 作为 `HTML` 链接返回
|
||||
`urlizetrunc` | 将字符串中的任何 `URL` 作为 `HTML` 链接返回，但会将链接缩短为指定的字符数
|
||||
`wordcount` | 返回文本中的单词数
|
||||
`wordwrap` | 以指定的字符数换行
|
||||
`yesno` | 将布尔值转换为指定值
|
||||
`i18n` |
|
||||
`l10n` |
|
||||
`tz` |
|
||||
|
||||
另见
|
||||
----
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user