[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: <em>YYYY-MM-DD</em>."
另外, 你可以使用简单文本和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(后台管理界面上显示的)
后台管理界面上显示比较贴近理解的字段名,默认是字段名(将下划线替换为空格)