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: <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(后台管理界面上显示的)

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

validators(验证器,待完善)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,010评论 19 139
  • Django Model 定义语法 版本:1.7主要来源:https://docs.djangoproject.c...
    罗田阅读 31,083评论 2 42
  • 模型是关于数据的单一的、最终的数据源。它包含存储的数据的基本字段和行为。通常,每个模型映射到单个数据库表。 每一个...
    低吟浅唱1990阅读 192评论 0 0
  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 13,956评论 0 15
  • 卖火柴的小女孩,在最后一根火柴熄灭的时候,被一对好心的夫妇遇见了,他们给她戴上了温暖柔软的大围巾,把她搂在怀里,把...
    姚葡萄阅读 236评论 0 0