summaryrefslogtreecommitdiff
path: root/doc/help
diff options
context:
space:
mode:
authorFlorian Bruhin <me@the-compiler.org>2022-06-13 12:34:33 +0200
committerFlorian Bruhin <me@the-compiler.org>2022-06-13 12:34:33 +0200
commit85b867fe8d4378c8e371f055c70452f546055854 (patch)
treeeaecf7628cd868de364057ab9442c46998ed6115 /doc/help
parentc97257cac01d9f7d67fb42d0344cb4332c7a0833 (diff)
parentd1bc60edb8d577814dab52c536f326083a66ef62 (diff)
downloadqutebrowser-85b867fe8d4378c8e371f055c70452f546055854.tar.gz
qutebrowser-85b867fe8d4378c8e371f055c70452f546055854.zip
Merge remote-tracking branch 'origin/pr/7096'
Diffstat (limited to 'doc/help')
-rw-r--r--doc/help/commands.asciidoc13
1 files changed, 10 insertions, 3 deletions
diff --git a/doc/help/commands.asciidoc b/doc/help/commands.asciidoc
index 6003c0f1f..e84e36c3a 100644
--- a/doc/help/commands.asciidoc
+++ b/doc/help/commands.asciidoc
@@ -254,20 +254,27 @@ Clear all message notifications.
[[click-element]]
=== click-element
-Syntax: +:click-element [*--target* 'target'] [*--force-event*] 'filter' 'value'+
+Syntax: +:click-element [*--target* 'target'] [*--force-event*] [*--select-first*] 'filter' ['value']+
Click the element matching the given filter.
The given filter needs to result in exactly one element, otherwise, an error is shown.
==== positional arguments
-* +'filter'+: How to filter the elements. id: Get an element based on its ID.
+* +'filter'+: How to filter the elements.
-* +'value'+: The value to filter for.
+ - id: Get an element based on its ID.
+ - css: Filter by a CSS selector.
+ - position: Click the element at specified position.
+ Specify `value` as 'x,y'.
+ - focused: Click the currently focused element.
+
+* +'value'+: The value to filter for. Optional for 'focused' filter.
==== optional arguments
* +*-t*+, +*--target*+: How to open the clicked element (normal/tab/tab-bg/window).
* +*-f*+, +*--force-event*+: Force generating a fake click event.
+* +*-s*+, +*--select-first*+: Select first matching element if there are multiple.
[[close]]
=== close