From: Marc-André Lureau <marcandre.lureau@redhat.com>
Date: Fri, 8 Oct 2021 21:47:56 +0000 (+0400)
Subject: docs/sphinx: add 's' keyboard binding to focus search
X-Git-Tag: v6.2.0-rc0~8^2~3
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=9423751645d27ae1146ca645431c368f09cb3b6c;p=thirdparty%2Fqemu.git

docs/sphinx: add 's' keyboard binding to focus search

This is pretty ubiquitous. ('/' is already taken by some browsers for
quick search)

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: John Snow <jsnow@redhat.com>
Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>
---

diff --git a/docs/conf.py b/docs/conf.py
index f536483bc3d..3161b8b127c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -182,6 +182,10 @@ html_css_files = [
     'theme_overrides.css',
 ]
 
+html_js_files = [
+    'custom.js',
+]
+
 html_context = {
     "display_gitlab": True,
     "gitlab_user": "qemu-project",
diff --git a/docs/sphinx-static/custom.js b/docs/sphinx-static/custom.js
new file mode 100644
index 00000000000..71a86053051
--- /dev/null
+++ b/docs/sphinx-static/custom.js
@@ -0,0 +1,9 @@
+document.addEventListener('keydown', (event) => {
+    // find a better way to look it up?
+    let search_input = document.getElementsByName('q')[0];
+
+    if (event.code === 'KeyS' && document.activeElement !== search_input) {
+        event.preventDefault();
+        search_input.focus();
+    }
+});