12.字段选项

[TOC]

null(空值)

如果设置为True, 不填写该字段时存储NULL到数据库中
默认为False

字符串类型的Field里(CharField 和TextField)不建议使用此选项,因为如此会导致数据库中会存在null和空字符串这两种情况表示空串

blank(允许为空)

是否可以不填写,默认为False

和null不同，null是数据库规定的范畴，blank则是表单验证的范畴，如果设置了blank为True则表单验证时可以不填，如果是False(默认值)则表单中必须填写该值

choices(选项)

如果字段的值你需要用户在规定的某些中选择一个，而不是用户随意填写一个，那你就可以加上一个choices

他是一个可迭代的结构(列表，元祖)，里面的每个元素是一个二元组，如((A,B),(C,D)),A C代表数据库中存储的值，B D代表展现给用户的值(显示的话可以使用 {{get_字段名_display}});如果设置了choice,表单中的默认样式就会变成选择框，而且选项就是choices中的值。

除非blank=False 和default一起在字段中被设置，否则，可选择菜单将会有"---------" 的标签。要重写这个行为, 需要加入一个包含None的元组到 choices里面; 例如 (None, 'Your String For Display'). 或者, 你可以在操作有意义的地方用一个空字符串代替None - 比如在一个 CharField.

db_column(数据库列名)

指定数据库中该字段的列名,当字段名与python关键字冲突时，指定此参数可以解决此问题

db_index(字段创建索引)

如果该值为True，则为该字段创建索引CREATE INDEX ...

db_tablespace(数据库表的命名空间--未理解状态中。。。。)

数据库表的命名空间--未理解状态中。。。。

default(设置默认值)

设置字段的默认值或者一个可调用的对象
默认值会在新实例创建且没呀给该字段设置值时使用，不能使用lambdas函数作为default,因为无法被uimigrations命令序列化

editable(是否可修改)

如果设置为False，该字段不会出现在admin或者ModekForm中

error_messages(自定义错误信息,待详细整理)

error_messages 参数能够让你重写默认抛出的错误信息。通过指定 key 来确认你要重写的错误信息。

error_messages 的 key 值包括 null, blank, invalid, invalid_choice, unique, 和 unique_for_date. 其余的 error_messages 的 keys 在不同的Field types中是不一样的。

help_text(额外的提示信息)

显示在表单控件form的额外帮助文本。即便你的字段没有应用到一个form里面，这样的操作对文档化也很有帮助。

注意这不会自动添加 HTML 标签。需要你在 help_text 包含自己需要的格式。例如:
help_text="Please use the following format: YYYY-MM-DD."
另外, 你可以使用简单文本和django.utils.html.escape()以避免任何HTML特定的字符.
请确保你所使用的help text能够避免那些由不受信任的用户进行的跨站点脚本攻击。

primary_key(主键)

指定该字段为数据库中的主键,以代替django自动添加的ID属性
primary_key=True 暗含着null=False 和unique=True. 一个对象上只能拥有一个主键,如果尝试修改主键会创建一个新的而不是覆盖旧的。

unique(唯一)

如果设置为True则这个字段在表中必须唯一，否则会抛出一个django.db.IntegrityError异常
除了ManyToManyField、OneToOneField和FileField 以外的其他字段类型都可以使用这个设置
指定此选项不必再指定 db_index 因为unique本身就意味着一个索引的创建

unique_for_data(指定日期内唯一)

当设置它为DateField 和 DateTimeField 字段的名称时，表示要求该字段对于相应的日期字段值是唯一的.
例如，你有一个title 字段设置unique_for_date="pub_date"，那么Django 将不允许两个记录具有相同的title 和pub_date
即时是 DateTimeField 字段也只会验证日期而不会考虑时间

unique_for_month(指定月份唯一)

nique_for_year(指定年份唯一)

verbose_name（后台管理界面上显示的）

后台管理界面上显示比较贴近理解的字段名,默认是字段名(将下划线替换为空格)