commit 8f6ed0d0125ca8770491480c9eccf738994f702e
parent 34db77d645cdb4ca4fdf9f3650e290780fe369a9
Author: Nicolas Chevobbe <nchevobbe@mozilla.com>
Date: Tue, 18 Nov 2025 12:45:05 +0000
Bug 2000610 - [devtools] Fix Node Picker documentation. r=devtools-reviewers,ochameau.
The correct key for preview select is Ctrl (Command on Mac).
We take this as an opportunity to document holding Shift to
allow picking inert/pointer-events: none elements.
Differential Revision: https://phabricator.services.mozilla.com/D272874
Diffstat:
2 files changed, 8 insertions(+), 2 deletions(-)
diff --git a/devtools/docs/user/keyboard_shortcuts/index.rst b/devtools/docs/user/keyboard_shortcuts/index.rst
@@ -299,11 +299,15 @@ These shortcuts work while the :ref:`node picker <page-inspector-how-to-select-a
- :kbd:`Click`
* - Select the element under the mouse and stay in picker mode
+ - :kbd:`Ctrl` + :kbd:`Click`
+ - :kbd:`Cmd` + :kbd:`Click`
+ - :kbd:`Ctrl` + :kbd:`Click`
+
+ * - Select the element under the mouse, even if it can't consume pointer events
- :kbd:`Shift` + :kbd:`Click`
- :kbd:`Shift` + :kbd:`Click`
- :kbd:`Shift` + :kbd:`Click`
-
.. _keyboard-shortcuts-html-pane:
HTML pane
diff --git a/devtools/docs/user/page_inspector/how_to/select_an_element/index.rst b/devtools/docs/user/page_inspector/how_to/select_an_element/index.rst
@@ -34,4 +34,6 @@ With the node picker
To select an element in the page itself, activate the "node picker" by clicking its icon: |image1| (also called the *Select Element* icon). After that, as you move the mouse around the page, the element under the mouse is highlighted. Click the element to select it:
-If you :kbd:`Shift` + click the element, then it is selected but the picker stays active. This lets you see the rules for the element in the CSS pane, but conveniently select another element in the page.
+If you :kbd:`Ctrl` (:kbd:`Cmd` on Mac) + click the element, then it is selected but the picker stays active. This lets you see the rules for the element in the CSS pane, but conveniently select another element in the page.
+
+Note that by default, the node picker will ignore all elements who can't consume pointer events (e.g. with ``inert`` attribute or ``pointer-events: none`` style). To select such element, hold :kbd:`Shift` while moving the picker.
