odoo 官方常用 widgets 小部件清单

红太狼 2024-04-22 15:28 71阅读 0赞

在Odoo中，小部件（Widgets）是用于构建用户界面的组件，它们决定了表单、列表视图以及更多交互元素的显示和行为方式。虽然无法提供Odoo14及之后所有版本的确切小部件清单，但可以列举一些常见和重要的内置小部件类型：

field - 基础字段小部件，用于显示和编辑各种类型的字段数据。

*  char - 单行文本输入框。  
    使用方法：
    
        <field name="name" widget="char" />
    
    form表单显示为普通input输入框 ，tree视图里显示为普通文本
 *  text - 多行文本区域。  
    使用方法：
    
        <field name="name" widget="text" />
    
    form表单显示为普通textarea 输入框 ，tree视图里显示为普通文本
 *  html - 显示HTML富文本内容的小部件。  
    使用方法：
    
        <field name="content" widget="html"/>
    
    form表单显示为普通p标签，可换行可输入html标签 ，tree视图里显示为富文本
 *  email - 电子邮件地址输入框。  
    使用方法：
    
        <field name="email" widget="email" />
    
    form表单显示为普通inupt输入框 ，  
    ![在这里插入图片描述][65f404ccc9874acc8fcb758da9e99d05.png]  
    tree视图里显示为超链接，点击后会打开windows邮箱  
    ![在这里插入图片描述][6da5caaa149e4e5cbccba7471bdccc63.png]
 *  date - 日期选择器。  
    使用方法：
    
        <field name="create_time" widget="date"/>
    
    form表单显示为日期选择器，tree视图里显示为普通文本
 *  datetime - 日期时间选择器。  
    使用方法：
    
        <field name="create_time" widget="datetime"/>
    
    form表单显示为时间选择器，tree视图里显示为普通文本
 *  boolean - 布尔值复选框。  
    使用方法：
    
        <field name="active" widget="boolean"/>
    
    form表单显示为checkbox复选框，tree视图里显示为checkbox复选框
 *  
 *  boolean\_toggle - 布尔值切换按钮。
    
        <field name="active" widget="boolean_toggle"/>

form表单显示为  
![在这里插入图片描述][005a35eedb6d49d4bd9b94efef0b988f.png]  
tree视图里显示为  
![在这里插入图片描述][e0f86c36b5ee4cd7a1ff2231bfec01d8.png]

*  selection - 下拉选择列表。  
    使用方法：
    
        <field name="category" widget="selection"/>
    
    form表单显示为普通下拉框，tree视图里显示为普通文本
 *  selection\_badge - 下拉徽章选择列表。  
    使用方法：
    
        <field name="category" widget="selection_badge "/>
    
    form表单显示为如下图，tree视图里显示为普通文本

![在这里插入图片描述][000df513e10849f987f1e0c595280d21.png]

*  image - 图像上传和显示小部件。  
    使用方法：
    
        <field name="logo" widget="image" options="{'size': [25, 25]}"/>
    
    form表单显示为普通下拉框，  
    ![在这里插入图片描述][da2e6f35ba7a4fa4ac64620d03880076.png]
    
    tree视图里显示为  
    ![在这里插入图片描述][88b839dcd4e44a32b185cf3f30b5bb9e.png]
 *  progressbar - 进度条小部件。
 *  statusbar - 显示状态信息的小部件。
 *  mail\_thread - 邮件线程小部件，用于处理消息与讨论。 消息标签
 *  mail\_followers: 关注者标签。
 *  mail\_attachments: 关注者文档。
 *  monetary - 货币金额显示和编辑小部件。
 *  code -代码小组件
 *  gauge- 仪表盘：用于展示某种度量的实时值，如库存水平或销售额。
 *  url - URL链接输入小部件。
 *  one2many - 关联到其他模型的一个记录的选择器
 *  many2one - 关联到其他模型的一个记录的选择器。
 *  many2many - 多对多关系表格形式显示和编辑。
 *  many2many\_tags - 多对多关系以标签形式显示和编辑。
 *  radio - 单选标签。
 *  float\_time - 单精度时间标签。
 *  reference - 关联标签。
 *  integer
 *  timesheet\_uom
 *  badge 徽章小部件
 *  badge\_selection 徽章下拉小部件
 *  handle - tree视图列表拖拽小部件  
    使用方法
    
        <field name="sort" widget="handle"/>
    
    列表视图显示效果  
    ![在这里插入图片描述][054297181d6944bfac6ab219aaea2068.png]

link - 可点击链接小部件。  
kanban - 看板视图小部件，用于卡片式展示多个记录。  
form - 表单视图小部件，详细展示单个记录的所有字段。  
tree - 列表视图小部件，以可折叠树状结构或简单列表展示记录。  
graph - 图形化数据显示小部件，如柱状图、折线图等。  
pivot - 数据透视表小部件。  
calendar - 日历视图小部件，用于事件或周期性任务管理。

此外，Odoo还支持许多自定义小部件，开发者可以根据需要扩展标准功能，创建满足特定业务需求的新小部件。随着版本的更新，Odoo可能还会增加更多的小部件类型来增强用户体验和功能多样性。

在Odoo中，小部件（Widgets）是用于构建用户界面的各种组件。虽然不可能列出所有的小部件，因为它们随着版本更新和社区模块的增加而不断扩充，但以下是一些常见的核心小部件：

## Field Widget： ##

这是最基本的元素，用于显示和编辑字段值，如CharField、IntegerField、Many2one等。

*  TextInput
 *  IntegerField
 *  FloatField
 *  DateField
 *  DateTimeField
 *  Many2one
 *  One2many
 *  Many2many

## Form Widgets： ##

*  FieldBinaryFileWidget：用于上传和下载文件
 *  BooleanWidget
 *  SelectionWidget
 *  Reference widget
 *  PasswordWidget

## Container Widgets： ##

*  BoxWidget：用于组合其他小部件
 *  NotebookWidget：用于创建带有标签页的布局
 *  GroupWidget：用于分组相关字段
 *  PageWidget：在视图中定义一个可折叠/展开的部分

## Action widgets： ##

*  Button widget
 *  Link widget
 *  TreeView widget：用于显示记录列表
 *  KanbanView widget：看板视图
 *  CalendarView widget：日历视图
 *  GraphView widget：图表视图

## Advanced Widgets： ##

*  ColorPickerWidget：选择颜色的小部件
 *  DatePickerWidget：专门用于选择日期
 *  RichTextWidget：富文本编辑器
 *  GeoPointWidget：地理位置选择器
 *  TagSelectWidget：标签选择器

请注意，以上只是部分列举，并且Odoo允许开发者自定义或扩展新的小部件以满足特定需求。

E:\\odoo-17.0\\addons\\web\\static\\src\\views\\fields

[65f404ccc9874acc8fcb758da9e99d05.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/b962bb04c03146528983cb28f7908916.png
[6da5caaa149e4e5cbccba7471bdccc63.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/8993f117d92f4c5188c3151f9b234891.png
[005a35eedb6d49d4bd9b94efef0b988f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/3059632ec040422e9f079f8c28335769.png
[e0f86c36b5ee4cd7a1ff2231bfec01d8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/4bcdac30f02d4f988cdcccb21827caa7.png
[000df513e10849f987f1e0c595280d21.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/0b884a72cc3b454b988b298f28f0cbe0.png
[da2e6f35ba7a4fa4ac64620d03880076.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/300bd9d637c04ddf9dce0ace7b222d23.png
[88b839dcd4e44a32b185cf3f30b5bb9e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/fe598ce5a1c142359e003473bc0f2164.png
[054297181d6944bfac6ab219aaea2068.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/0ba2577589a74262af180ffb29f832cc.png