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

表示该字段是一个密码，不明文展示。