[IMP] add screenshot, example in README

pull/2110/head
Holger Brunn 2015-03-16 17:20:43 +01:00 committed by Lois Rilo
parent bea6f42160
commit e14b376906
2 changed files with 15 additions and 10 deletions

View File

@ -4,16 +4,22 @@
This module allows to show an x2many field with 3-tuples
($x_value, $y_value, $value) in a table
+-----------+-----------+-----------+
| | $x_value1 | $x_value2 |
+===========+===========+===========+
| $y_value1 | $value1/1 | $value2/1 |
+-----------+-----------+-----------+
| $y_value2 | $value1/2 | $value2/2 |
+-----------+-----------+-----------+
$x_value1 $x_value2
========= =========== ===========
$y_value1 $value(1/1) $value(2/1)
$y_value2 $value(1/2) $value(2/2)
========= =========== ===========
where `valuen/n` is editable.
where `value(n/n)` is editable.
An example use case would be: Select some projects and some employees so that
a manager can easily fill in the planned_hours for one task per employee. The
result could look like this:
.. image:: /web_widget_x2many_2d_matrix/static/description/screenshot.png
:alt: Screenshot
The beauty of this is that you have an arbitrary amount of columns with this widget, trying to get this in standard x2many lists involves some quite agly hacks.
Usage
=====
@ -26,8 +32,7 @@ This assumes that my_field refers to a model with the fields `x`, `y` and
`value`. If your fields are named differently, pass the correct names as
attributes::
<field name="my_field" widget="x2many_2d_matrix"
field_x_axis="my_field1" field_y_axis="my_field2" field_value="my_field3" />
<field name="my_field" widget="x2many_2d_matrix" field_x_axis="my_field1" field_y_axis="my_field2" field_value="my_field3" />
You can pass the following parameters:

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB