Odoo 10 Learnodoo 10 中文文档odoo

odoo V10中文参考手册（四：视图）

2017-04-11  本文已影响2301人  XiaoHaiYang

公共结构

继承

视图匹配

视图解析

解析符合mode=primary的视图并得到arch内容：

应用到子视图之后的结果产生最终的arch

继承规范

继承规范由一个定位元素组成，用来匹配父视图中被继承的元素、和 子视图中会被用来修改的继承元素
一共有三种用来匹配目标元素的定位元素：

继承规范通过可选的position属性来指定如何修改匹配的节点

列表视图

列表视图的根元素是<tree>,它可以有以下几种属性：

editable

默认情况下选择单行记录时会打开对应记录的表单，该属性让数据可以在列表内进行编辑，有效的值是top和bottom，可让新的记录出现在列表的顶部或底部

default_order

重定义视图的排序规则，以逗号分隔多个字段，可使用desc来进行倒序<tree default_order="sequence,name desc">

decoration-name

可以根据值来改变字段的显示，$name可为bf (font-weight: bold), it (font-style: italic)或其他bootstrap样式如danger, info, muted, primary, success,warning，取值为python表达式，对每条记录执行相应表达式，当结果为true的时候将对应的样式应用

create, edit, delete

可以通过将它们设置为false来禁用视图中的对应操作

on_write

只当启用editable时有用，在调用时会传给函数新增或修改后的记录，该函数需要返回一个用于更新列表的记录id列表

button

在一个列表单元格中显示按钮

属性列表：
1.icon -- 用来展示按钮的图标
2.string -- 当没有icon的时候，button显示的文字，有icon的时候、相当于alt属性值
3.type -- 按钮类型，表示点击它之后如何影响系统

1)workflow（默认）：将按钮name作为信号发送给工作流，记录的内容作为参数
2)object ： 调用当前数据列表模型的方法，方法名是按钮的name，调用时带有记录id和当前上下文环境
3)action ： 加载ir.actions，按钮name是该action在数据库的id，上下文环境扩展到列表的model(作为active_model)、当前记录(active_id)、所有当前加载记录的id(active_ids)

4.name,args 与type一样
5.attrs 基于记录值的动态属性，将domain表达式应用在记录上，当返回值为True的时候设置相应的属性，一般用于invisible （隐藏按钮）、readonly （禁用按钮但显示）这两种属性
6.states invisible属性attrs的简写，给出一个以逗号分隔的state列表，需要模型有一个对应的state属性，可以将不在state列表中的记录的按钮隐藏
7.context 当响应odoo的调用时，合并到视图的上下文环境中
8.confirm 当点击按钮时给出的确认消息

field

定义一个所有记录都需要展示的列

属性列表：
1.name 需要显示的字段名
2.string 该列的名称
3.invisible 查询而且保存该字段但不显示
4.groups 可以看到该字段的用户组列表
5.widget 用来展示该字段的可选形式

progressbar 进度条用于展示浮点数
many2onebutton当关联字段值存在时显示勾，不存在显示X
handle对于排序字段，直接显示向上向下箭头
sum, avg 在底部显示基于当前页面数据的计算
attrs 基于记录值的动态属性，只对当前栏有效，即可以第一条记录中该字段显示，第二条隐藏

表单

表单视图用于展示单条数据，根元素是form，由常规html和构造部分、语义部分组成

构造部分

构造部分提供了结构和可视特性，以元素或者元素的子元素的形式应用到表单视图的元素中

1.notebook

定义一个tab块，每一个tab通过一个page子元素定义，每个page可以有以下属性：

2.group

用于定义栏目在表单中布局，默认情况下一个group定义两个列，并且每个最直接的子元素占用一个列，field类型的元素默认显示一个标签
group占用的列数是可以通过col属性自定义的，默认2个；其他元素可以通过colspan属性来定义占的列数，子元素是横向布局的，可以通过设置string 属性来定义group所展示的标题

3.newline

只在group元素里才有用，代表开启新的行

4.separator

一条水平线，可以通过string属性来设置该区域的标题

5.sheet

可以用作form的子元素用来表示更加狭义的表单

6.header

与sheet一起使用，显示在sheet的上方的一个条，一般用于显示工作流和状态栏

语义部分

语义部分用于与odoo系统交互

1.button 与列表的button一致

2.field

展示当前记录的某个字段，有以下属性：

oe_inline - 防止它自动将之后的字段换行
oe_left, oe_right - 相当于css的float
oe_read_only, oe_edit_only - 只在相应的模式下展示该字段
oe_no_button - 不为many2one字段显示导航按钮
oe_avatar - 当该字段为图片时，将它展示为头像（90*90的正方形）

业务视图规则

业务视图是指向普通用户的，像：机会、产品、合作伙伴、任务、项目等


一般情况下，业务视图由以下元素组成：

<form>
    <header> ... content of the status bar  ... </header>
    <sheet>  ... content of the sheet       ... </sheet>
    <div class="oe_chatter"> ... content of the bottom part ... </div>
</form>

1.状态条

用于展示当前记录的状态和相应的动作按钮

4.表格

业务视图展示出来要像一张表格一样


使用oe_edit_only 的class属性来指定label只在编辑模式下才展示，oe_inline 属性将多字段设置展示到单行中

<label for="name" class="oe_edit_only"/>
<h1><field name="name"/></h1>

<label for="planned_revenue" class="oe_edit_only"/>
<h2>
    <field name="planned_revenue" class="oe_inline"/>
    <field name="company_currency" class="oe_inline oe_edit_only"/> at
    <field name="probability" class="oe_inline"/> % success rate
</h2>

2.按钮
一个表单中可以放置多个相关的操作按钮，如果商机表单里有安排一个电访、安排一次会面，可直接显示在表单中

<div class="oe_button_box" name="button_box">
    <button string="安排电访" name="..." type="action"/>
    <button string="安排会面" name="action_makeMeeting" type="object"/>
</div>

3.分组和标题
为了方便视图扩展，需要给group指定一个name属性，这样在扩展视图中可以更容易的找到添加字段的正确位置

特殊案例：小计

某些class是用来展示小计时使用的，比如发货单：


<group class="oe_subtotal_footer">
    <field name="amount_untaxed"/>
    <field name="amount_tax"/>
    <field name="amount_total" class="oe_subtotal_footer_separator"/>
    <field name="residual" style="margin-top: 10px"/>
</group>

4.placeholder和行内输入框
有时候字段的标签把表单搞的太复杂了，可以将标签隐藏而采用placeholder来提示用户该输入框需要输入什么，同时可以通过div包裹多个inline输入框来让它们像是单个字段一样显示，例：

<group>
    <label for="street" string="Address"/>
    <div>
        <field name="street" placeholder="Street..."/>
        <field name="street2"/>
        <div>
            <field name="zip" class="oe_inline" placeholder="ZIP"/>
            <field name="city" class="oe_inline" placeholder="City"/>
        </div>
        <field name="state_id" placeholder="State"/>
        <field name="country_id" placeholder="Country"/>
    </div>
</group>

5.图片
图片一般在表单的右边显示
<field name="product_image" widget="image" class="oe_avatar oe_right"/>

6.标签
大多数多对多关系字段，如分类，一般使用多标签来展示
<field name="category_id" widget="many2many_tags"/>

配置表单指导原则

一般不需要header（因为没有状态、工作流、按钮），不需要表格，如：阶段配置


弹出框表单指导原则

例：商机的安排电话访问表单


1.避免使用分隔线
2.不使用取消按钮（因为一般用户会直接关闭弹框来替代）
3.操作钮钮必须被高亮显示
4.如果是文本框，使用placeholder来代替label
5.将按钮放在header元素中

配置向导指导原则

例：设置-配置-销售
1.单行显示（没有弹出框）2.没有表格 3.保留取消按钮 4.保存按钮标红

图表

图表是用于将数据进行聚合显示用的，它的根标签是gragh，有以下几种属性：

图表里唯一能插入的元素就是field，它有以下几种属性

row 默认 -- 根据指定字段分组，所有图表至少支持一级分组，有些支持多级，在pivot视图中，每个分组拿自己的记录
col -- 只在pivot表中使用，创建一个列优先的分组集合
measure -- 分组中用来聚合的字段

pivot

pivot视图使用 pivot表来展示汇总数据，根标签是pivot，有以下属性：

pivot跟其他图表一样也只允许field元素

看板视图

看板视图展示出一个看板图，由多个卡片构成，可以是对列分组展示或直接展示，它的根标签是kanban，有以下属性

子元素可以是以下几种

field

定义用来集合计算或用在看板视图逻辑中的字段，如果某字段仅用于在看板视图中展示，它不需要预先进行定义，有以下属性：

templates

定义一个QWeb模板列表，卡片可以分割成多个模板，但看板视图至少需要定义一个kanban-box标签，每条记录会执行一次，看板视图用的是严格的qweb javascript，有以下几个环境变量：

按钮和字段

由于看板模板是标准的qweb，看板视图有特殊的处理field、button、a标签的方式

1.action,object -- 与odoo按钮的属性一致

2.open -- 在只读模式下打开卡片的视图
3.edit -- 在编辑模式下打开卡片视图
4.delete -- 删除卡片的记录且移除卡片

javascript API

class KanbanRecord()

model -- 保存图片的model， field -- 保存图片数据的字段名 ， id -- 需要展示图片的记录id，cache--图片在浏览器的缓存时间（秒），0表示不缓存

日历视图

日历视图按天、周、月来显示数据，根元素是calendar，有以下属性：

甘特图

甘特图用于展示甘特图表如流程，根元素是gantt，没有子元素，但可以有以下属性：

示意图

示意图可用来展示原来就是图表的记录，根元素是diagram，没有属性，有几种子元素：

node（必选）

定义图表的节点，有以下属性：

arrow （必选）

用于定义图表的箭头，有以下属性：

label

用于解释示意图的节点，string属性定义的是节点的内容，每个label带有编号显示在示意图头部

搜索视图

搜索视图与其他视图不同，因为它不实际显示内容，它用于过滤其他视图的内容，定义的形式却一样。它的根元素是search，没有属性。可以有以下几中子元素：

field

field使用用户提供的值来定义domain表达式和上下文环境，当产生搜索domain表达式后，会与field提供的表达式使用and进行合并作用，可有以下几种属性：

filter

过滤器搜索视图里是被预定义的，只能被启用或禁用。主要用于将数据添加到搜索的上下文环境或者添加新的片段到搜索filter，有以下属性：

<filter domain="[('state', '=', 'draft')]"/>
<filter domain="[('state', '=', 'done')]"/>
#上述代码当两个都选的时候是以or联接的

<filter domain="[('state', '=', 'draft')]"/>
<separator/>
<filter domain="[('delay', '<', 15)]"/>
#上述代码当两个都选的时候用and联接

separator

用于将多组过滤器分开，一般用于很简单的视图里

group

也是用于分离多组过滤器，在复杂的视图中比separator更加易读

默认搜索

搜索字段和过滤条件可以通过action的context使用search_default_name 配置，对于字段就是需要搜索的值，对过滤器它是一个布尔值，例：

{
  'search_default_foo': 'acro',
  'search_default_bar': 1
}
#自动激活bar过滤器，并在foo字段搜索acro

QWeb视图

QWeb视图是标准的qweb模板，嵌入在视图的arch标签中，没有指定的根标签
每个qweb视图只能包含一个模板，模板名必须与视图的id完全一致

译自odoo官方文档：http://www.odoo.com/documentation/10.0/reference/views.html，不当之处欢迎批评指正。

内容发布自http://www.jianshu.com/u/6fdae8ec06bc，转载请注明出处

上一篇 下一篇

猜你喜欢

热点阅读