Merge pull request #940 from nicozanf/master

DOCS: deprecate DAL widgets and clarify grid.action
web2py · Nov 5, 2024 · 1246cc0 · 1246cc0
2 parents adc34b6 + fbb89b1
commit 1246cc0
Show file tree

Hide file tree

Showing 3 changed files with 9 additions and 2 deletions.
diff --git a/docs/chapter-07.rst b/docs/chapter-07.rst
@@ -1055,9 +1055,11 @@ only for fields of type “string”. ``uploadfield``, ``authorize``, and
 -  ``authorize`` can be used to require access control on the
    corresponding field, for “upload” fields only. It will be discussed
    more in detail in the context of Authentication and Authorization.
+-  ``widget`` do not use DAL widgets with py4web, it has has its own
+   (see :ref:`Widgets` later).
 -  ``represent`` can be None or can point to a function that takes a
    field value and returns an alternate representation for the field
-   value. Examples:
+   value.
 
 Note not all the attributes are thread safe and most of them
 should only be set globally for an app. The following are guaranteed to be

diff --git a/docs/chapter-12.rst b/docs/chapter-12.rst
@@ -343,6 +343,11 @@ dropdown menu!
 
 Using widgets in forms is quite easy, and they'll let you have more control on its pieces.
 
+.. important::
+
+   When using py4web, use py4web widgets, and do not use the pydal widget argument in the Field object
+   (see :ref:`Field constructor`).
+
 Custom widgets
 ~~~~~~~~~~~~~~
 

diff --git a/docs/chapter-14.rst b/docs/chapter-14.rst
@@ -366,7 +366,7 @@ the grid or a form. Use the following to decide:
 
 ::
 
-   [[if request.query.get('action') in ('details', 'edit'):]]
+   [[if grid.action in ['details', 'edit']: ]]
        #  Display the custom form
        [[form = grid.render() ]]
        [[form.custom["begin"] ]]