Skip to main content

Colorize field in tree views

Beta License: AGPL-3 OCA/web Translate me on Weblate Try me on Runboat

This module aims to add support for dynamically coloring fields in tree view according to data in the record.

It provides attributes on fields with the similar syntax as the colors attribute in tree tags.

Further, it provides a color_field attribute on tree tags’s colors to use a field’s value as color.

Features

  • Add attribute bg_color on field’s options to color background of a cell in tree view

  • Add attribute fg_color on field’s options to change text color of a cell in tree view

  • Add attribute color_field on the tree element’s colors to use as text color

  • Add attribute bg_color_field on the tree element’s colors to use as background color

Table of contents

Usage

  • In the tree view declaration, put options='{"bg_color": "red: customer==True"} attribute in the field tag:

    ...
    <field name="arch" type="xml">
        <tree string="View name">
            ...
            <field name="name" options='{"bg_color": "red: customer == True"}'/>
            ...
        </tree>
    </field>
    ...
    
    With this example, column which renders 'name' field will have its background colored in red.
  • In the tree view declaration, put options='{"fg_color": "white:customer == True"}' attribute in the field tag:

    ...
    <field name="arch" type="xml">
        <tree string="View name">
            ...
            <field name="name" options='{"fg_color": "white:customer == True"}'/>
            ...
        </tree>
    </field>
    ...
    
    With this example, column which renders 'name' field will have its text colored in white on a customer records.
  • In the tree view declaration, use options='"color_field": "my_color"' attribute in the tree tag:

    ...
    <field name="arch" type="xml">
        <tree string="View name" colors="color_field: my_color; bg_color_field: my_background_color" >
            ...
            <field name="my_color" invisible="1"/>
            <field name="my_background_color" invisible="1"/>
            ...
        </tree>
    </field>
    ...
  • You can also use colors="bg_color_field: my_color" to defined the field name that will be used for the background color of the line.

  • If you want to use more than one color, you can split the attributes using ‘;’:

options='{"fg_color": "red:red_color == True; green:green_color == True"}'

Example:

...
 <field name="arch" type="xml">
     <tree string="View name">
         ...
         <field name="name" options='{"fg_color": "red:red_color == True; green:green_color == True"}'/>
         ...
     </tree>
 </field>
 ...

 With this example, the content of the field named `my_color` will be used to
 populate the `my_color` CSS value. Use a function field to return whichever
 color you want depending on the other record values. Note that this
 overrides the rest of `colors` attributes, and that you need the tree
 to load your field in the first place by adding it as invisible field.

Note that you should always use single quotes for fields’ ``options`` and wrap nested values in double quotes since ``options`` is a JSON object.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Camptocamp

  • Therp BV

  • GRAP

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/web project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Metadata

Release files for odoo12-addon-web-tree-dynamic-colored-field 12.0.1.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo12-addon-web-tree-dynamic-colored-field 12.0.1.1.2
File Interpreter ABI Platform
odoo12_addon_web_tree_dynamic_colored_field-12.0.1.1.2-py3-none-any.whl Python 3 none any Details

Release files / odoo12_addon_web_tree_dynamic_colored_field-12.0.1.1.2-py3-none-any.whl

Download URL odoo12_addon_web_tree_dynamic_colored_field-12.0.1.1.2-py3-none-any.whl
Size 28.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
53d0ca4d9525bb0046db4d0505bcde8c1aa89fd9a8963c699387975d4ec262a5
BLAKE2b-256 checksum
How to use checksums
2ad513ceb9670a5a7cf2e53f8d68a074b1908380bd596dc8fcfe38666c8c8b11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.8.10
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page