[FIX] web_widget_x2many_2d_matrix: Enable keyboard navigation

web_widget_x2many_2d_matrix/README.rst

@@ -39,16 +39,18 @@ Use this widget by saying::
 
 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::
+attributes:
 
- <field name="my_field" widget="x2many_2d_matrix" field_x_axis="my_field1" field_y_axis="my_field2" field_value="my_field3">
-     <tree>
-         <field name="my_field"/>
-         <field name="my_field1"/>
-         <field name="my_field2"/>
-         <field name="my_field3"/>
-     </tree>
- </field>
+.. code-block:: xml
+
+    <field name="my_field" widget="x2many_2d_matrix" field_x_axis="my_field1" field_y_axis="my_field2" field_value="my_field3">
+        <tree>
+            <field name="my_field"/>
+            <field name="my_field1"/>
+            <field name="my_field2"/>
+            <field name="my_field3"/>
+        </tree>
+    </field>
 
 You can pass the following parameters:
 
@@ -80,49 +82,53 @@ You need a data structure already filled with values. Let's assume we want to
 use this widget in a wizard that lets the user fill in planned hours for one
 task per project per user. In this case, we can use ``project.task`` as our
 data model and point to it from our wizard. The crucial part is that we fill
-the field in the default function::
+the field in the default function:
 
- from odoo import fields, models
+.. code-block:: python
 
- class MyWizard(models.TransientModel):
-    _name = 'my.wizard'
+    from odoo import fields, models
 
-    def _default_task_ids(self):
-        # your list of project should come from the context, some selection
-        # in a previous wizard or wherever else
-        projects = self.env['project.project'].browse([1, 2, 3])
-        # same with users
-        users = self.env['res.users'].browse([1, 2, 3])
-        return [
-            (0, 0, {
-                'name': 'Sample task name',
-                'project_id': p.id,
-                'user_id': u.id,
-                'planned_hours': 0,
-                'message_needaction': False,
-                'date_deadline': fields.Date.today(),
-            })
-            # if the project doesn't have a task for the user, create a new one
-            if not p.task_ids.filtered(lambda x: x.user_id == u) else
-            # otherwise, return the task
-            (4, p.task_ids.filtered(lambda x: x.user_id == u)[0].id)
-            for p in projects
-            for u in users
-        ]
+    class MyWizard(models.TransientModel):
+        _name = 'my.wizard'
 
-    task_ids = fields.Many2many('project.task', default=_default_task_ids)
+        def _default_task_ids(self):
+            # your list of project should come from the context, some selection
+            # in a previous wizard or wherever else
+            projects = self.env['project.project'].browse([1, 2, 3])
+            # same with users
+            users = self.env['res.users'].browse([1, 2, 3])
+            return [
+                (0, 0, {
+                    'name': 'Sample task name',
+                    'project_id': p.id,
+                    'user_id': u.id,
+                    'planned_hours': 0,
+                    'message_needaction': False,
+                    'date_deadline': fields.Date.today(),
+                })
+                # if the project doesn't have a task for the user,
+                # create a new one
+                if not p.task_ids.filtered(lambda x: x.user_id == u) else
+                # otherwise, return the task
+                (4, p.task_ids.filtered(lambda x: x.user_id == u)[0].id)
+                for p in projects
+                for u in users
+            ]
 
-Now in our wizard, we can use::
+        task_ids = fields.Many2many('project.task', default=_default_task_ids)
 
- <field name="task_ids" widget="x2many_2d_matrix" field_x_axis="project_id" field_y_axis="user_id" field_value="planned_hours">
-     <tree>
-         <field name="task_ids"/>
-         <field name="project_id"/>
-         <field name="user_id"/>
-         <field name="planned_hours"/>
-     </tree>
- </field>
+Now in our wizard, we can use:
 
+.. code-block:: xml
+
+    <field name="task_ids" widget="x2many_2d_matrix" field_x_axis="project_id" field_y_axis="user_id" field_value="planned_hours">
+        <tree>
+            <field name="task_ids"/>
+            <field name="project_id"/>
+            <field name="user_id"/>
+            <field name="planned_hours"/>
+        </tree>
+    </field>
 
 Known issues / Roadmap
 ======================
@@ -134,6 +140,11 @@ Known issues / Roadmap
 
 * Support limit total records in the matrix. Ref: https://github.com/OCA/web/issues/901
 
+* Support cell traversal through keyboard arrows.
+
+* Entering the widget from behind by pressing ``Shift+TAB`` in your keyboard
+  will enter into the 1st cell until https://github.com/odoo/odoo/pull/26490
+  is merged.
 
 Bug Tracker
 ===========