Cùng một trường điểm, hiện thành con số hay thanh tiến độ là do một chữ widget: chọn đúng widget trong Odoo 19

Một field trang_thai kiểu Selection có thể hiện thành một ô thả xuống bình thường, hoặc thành một badge màu bắt mắt. Một field diem kiểu số có thể là con số trơ, hoặc một thanh tiến độ. Cùng dữ liệu, cùng field — khác nhau ở một chữ: widget. Chọn đúng widget là cách rẻ nhất để form vừa đẹp vừa dễ dùng. Bài này gắn nhiều widget lên một form và xem chúng chạy thật.

widget đổi cách hiển thị, không đổi dữ liệu

Thêm widget="..." vào thẻ field để chọn cách render và nhập liệu. Dữ liệu bên dưới không đổi — chỉ giao diện đổi:

<field name="anh_the" widget="image" class="oe_avatar"/>   <!-- ảnh -->

<field name="trang_thai" widget="badge"          <!-- nhãn bo tròn có màu -->
       decoration-success="trang_thai == 'dang_dung'"
       decoration-danger="trang_thai == 'khoa'"/>

<field name="diem" widget="progressbar"/>   <!-- thanh tiến độ -->
<field name="so_du" widget="monetary"/>      <!-- tiền + đơn vị -->
<field name="uu_dai_ids" widget="many2many_tags"/> <!-- thẻ tag -->

Hình 1: Mỗi field một widget. widget quyết định cách field hiện ra và cho nhập; dữ liệu trong database không đổi. Badge còn nhận decoration-* để đổi màu theo điều kiện — giống list nhưng áp cho chính badge đó.

Xem thật: một form, nhiều widget

Gắn các widget trên lên form thẻ Vàng và mở nó ra:

Hình 2: Cùng form, nhiều widget cùng chạy thật. image: ảnh thẻ hình vuông (góc phải, class oe_avatar). badge: "Đang dùng" thành nhãn bo tròn xanh (nhờ decoration-success). progressbar: "Điểm tích luỹ" thành thanh tiến độ hiện 150%. monetary: "Số dư" hiện kèm đơn vị tiền. Không widget nào cần code — chỉ khai trong XML.

Bảng widget hay dùng

Chọn widget cho đúng, không chỉ cho đẹp

• Widget phải khớp kiểu field. monetary cần field Monetary + currency_id; image cần Image/Binary; handle cần một field số dùng làm thứ tự. Gán lệch kiểu là lỗi hoặc hiển thị sai.
• Widget cải thiện cả nhập liệu, không chỉ hiển thị. priority cho bấm sao thay vì chọn số; boolean_toggle gạt công tắc thay vì tick; email/phone biến text thành link bấm được — trải nghiệm khác hẳn.
• badge + decoration-* cho nhãn đổi màu theo trạng thái — rất hợp cho field trạng thái.
• Widget dùng được ở cả list lẫn form (và kanban) — nhưng một số chỉ hợp một nơi (handle chỉ ý nghĩa trong list; image lớn hợp form).

Vài lưu ý Odoo 19

• Không lạm dụng widget lạ. Odoo có hàng chục widget; chọn cái đúng chức năng trước, đẹp sau. Một Selection bình thường nhiều khi rõ hơn một badge rối màu.
• progressbar hiểu giá trị là phần trăm (150 điểm hiện "150%"); nếu muốn thang khác, cần cấu hình max_value qua options.
• Widget có options="{...}" để tinh chỉnh (ví dụ many2many_tags với {'color_field': 'color'} để tag có màu).
• Widget tuỳ biến (custom) viết bằng OWL/JavaScript — nhưng phần lớn nhu cầu đã có widget sẵn, đừng vội tự viết.

Ba ý mang về

1. widget="..." đổi cách một field hiển thị và cho nhập, không đổi dữ liệu bên dưới. Đã chứng minh: cùng form có image (ảnh), badge (nhãn xanh "Đang dùng"), progressbar (150%), monetary (tiền) — chỉ khai XML.
2. Chọn widget khớp kiểu field và đúng chức năng: monetary cần Monetary+currency, priority cho bấm sao, boolean_toggle cho công tắc, email/phone/url cho link bấm được — widget cải thiện cả nhập liệu.
3. badge ghép decoration-* cho nhãn đổi màu theo trạng thái; progressbar hiểu giá trị là %; tinh chỉnh thêm qua options. Ưu tiên widget có sẵn trước khi viết widget tuỳ biến.

Ta đã tô, sắp, và chọn cách hiển thị field. Lần sau chuyển sang hành động: Phần sau mổ xẻ nút bấm trên view — type="object" gọi method Python và type="action" mở một action, để form không chỉ hiển thị mà còn làm việc.