Odoo form视图详解
转载请注明原文地址:https://www.cnblogs.com/ygj0930/p/10826350.html
一:Header头部
header区域一般用于展示文档流转的阶段和生命周期,以及动作按钮。
表单的生命周期通过状态栏小控件呈现当前所处的状态,这些通常是状态选择字段或者多对一的阶段字段。
状态是一个选择列表,呈现的是过程中有几个相当稳定的步骤阶段,例如:新建、处理中、完成。
操作按钮一般为表单按钮,最重要的阶段可以使用class=“oe_highlight”突出显示。
二:Sheet区域
1:分组布局局 group标签
1)用于定义栏目在表单中布局,默认情况下一个group定义两个列,并且每个最直接的子元素占用一个列,field类型的元素默认显示一个标签。
2)子元素是横向布局的。
3)可以通过设置string 属性来定义组的标题;在group之外,我们可以使用html基本元素来制定标题,如:div,span,H1,和H2等,并且可以添加style属性指定css样式。
4)使用col和colspan属性,我们可以更好的控制组元素布局。col属性可以指定组中包含的列数,默认值是2,它也可以改为任何数字,双数的效果更好,因为每一个字段加起来都要两列。
5)组内元素,包括<field>元素,可以使用colspan属性设置所占列数,默认都是2列。
6)newline标签,只在group元素里才有用,代表开启新的行。在组内一行还没布满时,强制换行布局。
7)可以使用<separator>元素添加组内分割线;可以通过string属性来设置该区域的标题。
2:分页显示 notebook
定义一个tab块,每一个tab通过一个page子元素定义,每个page可以有以下属性:
- string (required) --tab标签的名称
- accesskey --html accesskey
- attrs --基于记录值的动态属性(可见、只读),例如:attrs="{'invisible': [(表达式)]}"
笔记本元素可以包含多个标签的部分,称为页面。可以实现按页切换输入、显示。
<notebook> <page string="显示文字" name="通常用于被视图继承时xpath定位"> 内容... </page> <page> ... </page> </notebook>
3:field
展示当前记录的某个字段,有以下属性:
1)name (必选)
字段名。
2)attrs
标签属性,只有两个:invisible和readonly,可以根据表达式值来决定该两个值,从而动态控制标签的显示/隐藏、只读/可修改。
有两种设置方式:
1:通过attrs属性统一设置,可以使用表达式进行动态设置 attrs="{'invisible': [('state', '!=', 'draft'), ('state', '!=', 'disable')]}" 2:直接通过属性名单独、明确设置 <field name="" invisible="1" readonly="1"/>
3)widget
每个字段根据其数据类型有一个默认的展示方式,widget属性可指定用一个别的方式来展示。
4)options
标签行为,用于指定widget字段配置的json对象。这与该字段使用什么widget来显示有关,odoo原生的字段类型都有对应的默认widget来负责显示,widget中封装了一些行为。可以查看具体widget定义的js文件,从 this.options.XX 字眼得到有哪些options。
我们也可以自定义widget、继承widget来增加选项。
选项只能通过options属性进行设置:
//通过options属性统一设置 options="{'no_create': 1, 'no_open': 1}"
5)class
设置当前元素的css样式,odoo内置了以下样式类名,也可以使用boostrap相关样式类名、自定义的css样式文件中的类名。【注意:这些样式不仅仅可以用于filed标签,表单内任何元素都可以套用】
oe_inline:防止换行,防止它自动将之后的字段换行,使后面的内容自动在同一行显示。 oe_left, oe_right:相当于css的float浮动,向左浮动布局、向右浮动布局。 oe_read_only, oe_edit_only:只在相应的模式下显示,read_only的意思是只有在非编辑状态下才显示,edit_only是只有在编辑状态下显示。 oe_no_button:不为many2one字段显示导航按钮 oe_avatar:当该字段为图片时,将它展示为头像(90*90的正方形)
6)groups
指定用户组可以看到该字段。【可以为某些字段做隐私、数据隔离】
7)on_change
在字段值改变时调用对应方法,从8.0开始改用模型中的 odoo.api.onchange()。
8)domain
在编辑时,当以 下拉选择 的方式选取 关联字段 时,过滤数据。
9)context
用于关联字段,显示数据时提供上下文环境。
10)readonly
该字段可在读和编辑模式下展示,但是永远是不能编辑的。
11)required
设置字段为必填,当该值没有设置就保存时给出一个错误提示并阻止保存。
12)nolabel
不显示字段的标签,只有在该字段是group子元素时起效。一般搭配<label for='字段名' style="样式">使用,为字段自定义显示的标签。
13)placeholder
字段值为空时展示的提示。
14)mode
对于one2many字段,用于展示其关联的记录的形式,有tree, form, kanban , graph,默认是tree。
15)help
当将鼠标放在字段或标签时显示的提示
16)filename
对于二进制的字段,相关字段给出文件名。
17)password
表示该字段是一个密码,不明文展示。