odoo-form视图

一、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）组内元素,包括元素,可以使用colspan属性设置所占列数，默认都是2列。

6）newline标签，只在group元素里才有用，代表开启新的行。在组内一行还没布满时，强制换行布局。
7）可以使用元素添加组内分割线；可以通过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子元素时起效。一般搭配使用，为字段自定义显示的标签。
13）placeholder
字段值为空时展示的提示。
14）mode
对于one2many字段，用于展示其关联的记录的形式，有tree, form, kanban , graph，默认是tree。
15）help
当将鼠标放在字段或标签时显示的提示
16）filename
对于二进制的字段，相关字段给出文件名。
17）password
表示该字段是一个密码，不明文展示。

标签属性
1） name：标识字段名称
2）string：标签文本，如果我们想要覆盖模型定义提供的标签文本，可以使用它。
3）help：提示文本，当您将指针悬停在字段上时，将显示一个提示文本，并允许覆盖模型定义提供的帮助文本。
4）placeholder：是一个建议文本，显示在该字段内。
5）widget：允许我们覆盖用于该字段的小控件。【例如：指定binary字段的widget为image就可以把上传按钮转变为图片】
6）options：是一个JSON数据结构，提供了额外的选项。
7）class：是用于字段HTML呈现的CSS类。【由于odoo内嵌列bootstrap，因此可以直接使用bootstrap的样式class；进阶：也可以自己写，在static/src/css目录下定义css文件，并通过data配置项加载】
8）nolabel=“True”：防止自动字段标签被呈现。仅对元素中的字段有意义，并且经常和 元素一起使用.【nolabel把字段本名隐藏，label 标签则为该字段重新定义界面上显示的字段名，并且可以添加样式】
9）invisible=“True”:使字段不可见，但是数据是从服务器获取的，并且在表单上可用，只不过不可见而已。
10）readonly=“True”: 使表单上的字段不可编辑。
11）required=“True” 在表单上字段为必需字段。
12）password=“True”：用于文本字段。它显示为一个密码字段，屏蔽输入的字符。
13）filename： 用于二进制字段，它是用于存储上传文件名称的模型字段名称。
14）mode：用于一对多字段。它指定用于显示记录的视图类型。默认情况下，它是树，但也可以是表单、看板或图形。