forked from Techsystech/web
[UPD] README.rst
parent
3b3e6a5738
commit
c8d2593dd9
|
@ -14,13 +14,13 @@ Colorize field in tree views
|
||||||
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
|
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
|
||||||
:alt: License: AGPL-3
|
:alt: License: AGPL-3
|
||||||
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github
|
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github
|
||||||
:target: https://github.com/OCA/web/tree/12.0/web_tree_dynamic_colored_field
|
:target: https://github.com/OCA/web/tree/13.0/web_tree_dynamic_colored_field
|
||||||
:alt: OCA/web
|
:alt: OCA/web
|
||||||
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
|
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
|
||||||
:target: https://translation.odoo-community.org/projects/web-12-0/web-12-0-web_tree_dynamic_colored_field
|
:target: https://translation.odoo-community.org/projects/web-13-0/web-13-0-web_tree_dynamic_colored_field
|
||||||
:alt: Translate me on Weblate
|
:alt: Translate me on Weblate
|
||||||
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
|
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
|
||||||
:target: https://runbot.odoo-community.org/runbot/162/12.0
|
:target: https://runbot.odoo-community.org/runbot/162/13.0
|
||||||
:alt: Try me on Runbot
|
:alt: Try me on Runbot
|
||||||
|
|
||||||
|badge1| |badge2| |badge3| |badge4| |badge5|
|
|badge1| |badge2| |badge3| |badge4| |badge5|
|
||||||
|
@ -28,18 +28,11 @@ Colorize field in tree views
|
||||||
This module aims to add support for dynamically coloring fields in tree view
|
This module aims to add support for dynamically coloring fields in tree view
|
||||||
according to data in the record.
|
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
|
Features
|
||||||
========
|
========
|
||||||
|
|
||||||
* Add attribute ``bg_color`` on field's ``options`` to color background of a cell in tree view
|
* 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 ``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 color
|
|
||||||
|
|
||||||
**Table of contents**
|
**Table of contents**
|
||||||
|
|
||||||
|
@ -77,18 +70,6 @@ Usage
|
||||||
|
|
||||||
With this example, column which renders 'name' field will have its text colored in white on a customer records.
|
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" >
|
|
||||||
...
|
|
||||||
<field name="my_color" invisible="1"/>
|
|
||||||
...
|
|
||||||
</tree>
|
|
||||||
</field>
|
|
||||||
...
|
|
||||||
|
|
||||||
* If you want to use more than one color, you can split the attributes using ';':
|
* If you want to use more than one color, you can split the attributes using ';':
|
||||||
|
|
||||||
.. code::
|
.. code::
|
||||||
|
@ -117,13 +98,22 @@ Example:
|
||||||
|
|
||||||
**Note that you should always use single quotes for fields' ``options`` and wrap nested values in double quotes since ``options`` is a JSON object.**
|
**Note that you should always use single quotes for fields' ``options`` and wrap nested values in double quotes since ``options`` is a JSON object.**
|
||||||
|
|
||||||
|
Known issues / Roadmap
|
||||||
|
======================
|
||||||
|
|
||||||
|
* Before version 13.0, this module had a feature allowing to change the color of
|
||||||
|
a line depending on a field, using a ``colors`` attribute with the name of the
|
||||||
|
field on the ``<tree>`` element. Since 13.0, the ``colors`` attribute is no
|
||||||
|
longer in the RelaxNG schema of the tree view, so we can't use it anymore.
|
||||||
|
This feature has then been dropped, but could be reimplement in another way.
|
||||||
|
|
||||||
Bug Tracker
|
Bug Tracker
|
||||||
===========
|
===========
|
||||||
|
|
||||||
Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/issues>`_.
|
Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/issues>`_.
|
||||||
In case of trouble, please check there if your issue has already been reported.
|
In case of trouble, please check there if your issue has already been reported.
|
||||||
If you spotted it first, help us smashing it by providing a detailed and welcomed
|
If you spotted it first, help us smashing it by providing a detailed and welcomed
|
||||||
`feedback <https://github.com/OCA/web/issues/new?body=module:%20web_tree_dynamic_colored_field%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
|
`feedback <https://github.com/OCA/web/issues/new?body=module:%20web_tree_dynamic_colored_field%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
|
||||||
|
|
||||||
Do not contact contributors directly about support or help with technical issues.
|
Do not contact contributors directly about support or help with technical issues.
|
||||||
|
|
||||||
|
@ -157,6 +147,6 @@ OCA, or the Odoo Community Association, is a nonprofit organization whose
|
||||||
mission is to support the collaborative development of Odoo features and
|
mission is to support the collaborative development of Odoo features and
|
||||||
promote its widespread use.
|
promote its widespread use.
|
||||||
|
|
||||||
This module is part of the `OCA/web <https://github.com/OCA/web/tree/12.0/web_tree_dynamic_colored_field>`_ project on GitHub.
|
This module is part of the `OCA/web <https://github.com/OCA/web/tree/13.0/web_tree_dynamic_colored_field>`_ project on GitHub.
|
||||||
|
|
||||||
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
|
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
|
||||||
|
|
|
@ -367,19 +367,14 @@ ul.auto-toc {
|
||||||
!! This file is generated by oca-gen-addon-readme !!
|
!! This file is generated by oca-gen-addon-readme !!
|
||||||
!! changes will be overwritten. !!
|
!! changes will be overwritten. !!
|
||||||
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
||||||
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/web/tree/12.0/web_tree_dynamic_colored_field"><img alt="OCA/web" src="https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/web-12-0/web-12-0-web_tree_dynamic_colored_field"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/162/12.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
|
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/web/tree/13.0/web_tree_dynamic_colored_field"><img alt="OCA/web" src="https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/web-13-0/web-13-0-web_tree_dynamic_colored_field"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/162/13.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
|
||||||
<p>This module aims to add support for dynamically coloring fields in tree view
|
<p>This module aims to add support for dynamically coloring fields in tree view
|
||||||
according to data in the record.</p>
|
according to data in the record.</p>
|
||||||
<p>It provides attributes on fields with the similar syntax as the <tt class="docutils literal">colors</tt> attribute
|
|
||||||
in tree tags.</p>
|
|
||||||
<p>Further, it provides a <tt class="docutils literal">color_field</tt> attribute on tree tags’s <tt class="docutils literal">colors</tt> to use
|
|
||||||
a field’s value as color.</p>
|
|
||||||
<div class="section" id="features">
|
<div class="section" id="features">
|
||||||
<h1>Features</h1>
|
<h1>Features</h1>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li>Add attribute <tt class="docutils literal">bg_color</tt> on field’s <tt class="docutils literal">options</tt> to color background of a cell in tree view</li>
|
<li>Add attribute <tt class="docutils literal">bg_color</tt> on field’s <tt class="docutils literal">options</tt> to color background of a cell in tree view</li>
|
||||||
<li>Add attribute <tt class="docutils literal">fg_color</tt> on field’s <tt class="docutils literal">options</tt> to change text color of a cell in tree view</li>
|
<li>Add attribute <tt class="docutils literal">fg_color</tt> on field’s <tt class="docutils literal">options</tt> to change text color of a cell in tree view</li>
|
||||||
<li>Add attribute <tt class="docutils literal">color_field</tt> on the tree element’s <tt class="docutils literal">colors</tt> to use as color</li>
|
|
||||||
</ul>
|
</ul>
|
||||||
<p><strong>Table of contents</strong></p>
|
<p><strong>Table of contents</strong></p>
|
||||||
</div>
|
</div>
|
||||||
|
@ -416,19 +411,6 @@ With this example, column which renders 'name' field will have its background co
|
||||||
With this example, column which renders 'name' field will have its text colored in white on a customer records.
|
With this example, column which renders 'name' field will have its text colored in white on a customer records.
|
||||||
</pre>
|
</pre>
|
||||||
</li>
|
</li>
|
||||||
<li><p class="first">In the tree view declaration, use <tt class="docutils literal"><span class="pre">options='"color_field":</span> "my_color"'</tt> attribute in the <tt class="docutils literal">tree</tt> tag:</p>
|
|
||||||
<pre class="literal-block">
|
|
||||||
...
|
|
||||||
<field name="arch" type="xml">
|
|
||||||
<tree string="View name" colors="color_field: my_color" >
|
|
||||||
...
|
|
||||||
<field name="my_color" invisible="1"/>
|
|
||||||
...
|
|
||||||
</tree>
|
|
||||||
</field>
|
|
||||||
...
|
|
||||||
</pre>
|
|
||||||
</li>
|
|
||||||
<li><p class="first">If you want to use more than one color, you can split the attributes using ‘;’:</p>
|
<li><p class="first">If you want to use more than one color, you can split the attributes using ‘;’:</p>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
@ -455,12 +437,22 @@ options='{"fg_color": "red:red_color == True; green:green_color =
|
||||||
</pre>
|
</pre>
|
||||||
<p><strong>Note that you should always use single quotes for fields’ ``options`` and wrap nested values in double quotes since ``options`` is a JSON object.</strong></p>
|
<p><strong>Note that you should always use single quotes for fields’ ``options`` and wrap nested values in double quotes since ``options`` is a JSON object.</strong></p>
|
||||||
</div>
|
</div>
|
||||||
|
<div class="section" id="known-issues-roadmap">
|
||||||
|
<h1>Known issues / Roadmap</h1>
|
||||||
|
<ul class="simple">
|
||||||
|
<li>Before version 13.0, this module had a feature allowing to change the color of
|
||||||
|
a line depending on a field, using a <tt class="docutils literal">colors</tt> attribute with the name of the
|
||||||
|
field on the <tt class="docutils literal"><tree></tt> element. Since 13.0, the <tt class="docutils literal">colors</tt> attribute is no
|
||||||
|
longer in the RelaxNG schema of the tree view, so we can’t use it anymore.
|
||||||
|
This feature has then been dropped, but could be reimplement in another way.</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
<div class="section" id="bug-tracker">
|
<div class="section" id="bug-tracker">
|
||||||
<h1>Bug Tracker</h1>
|
<h1>Bug Tracker</h1>
|
||||||
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/web/issues">GitHub Issues</a>.
|
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/web/issues">GitHub Issues</a>.
|
||||||
In case of trouble, please check there if your issue has already been reported.
|
In case of trouble, please check there if your issue has already been reported.
|
||||||
If you spotted it first, help us smashing it by providing a detailed and welcomed
|
If you spotted it first, help us smashing it by providing a detailed and welcomed
|
||||||
<a class="reference external" href="https://github.com/OCA/web/issues/new?body=module:%20web_tree_dynamic_colored_field%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
|
<a class="reference external" href="https://github.com/OCA/web/issues/new?body=module:%20web_tree_dynamic_colored_field%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
|
||||||
<p>Do not contact contributors directly about support or help with technical issues.</p>
|
<p>Do not contact contributors directly about support or help with technical issues.</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="credits">
|
<div class="section" id="credits">
|
||||||
|
@ -488,7 +480,7 @@ If you spotted it first, help us smashing it by providing a detailed and welcome
|
||||||
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
|
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
|
||||||
mission is to support the collaborative development of Odoo features and
|
mission is to support the collaborative development of Odoo features and
|
||||||
promote its widespread use.</p>
|
promote its widespread use.</p>
|
||||||
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/web/tree/12.0/web_tree_dynamic_colored_field">OCA/web</a> project on GitHub.</p>
|
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/web/tree/13.0/web_tree_dynamic_colored_field">OCA/web</a> project on GitHub.</p>
|
||||||
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
|
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
Loading…
Reference in New Issue