From 17b636162414cbc9d89138a37ef69a828592ed6b Mon Sep 17 00:00:00 2001
From: Pierrick Rambaud <pierrick.rambaud@ldc.com>
Date: Tue, 5 Nov 2024 06:08:04 +0000
Subject: [PATCH] feat: add playsinline parameter

---
 docs/quickstart.rst             | 6 ++++++
 sphinxcontrib/video/__init__.py | 2 ++
 2 files changed, 8 insertions(+)

diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index 4425568..737f094 100644
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -57,6 +57,7 @@ the video directive supports all the optional attributes from the html tag as su
     ``:preload:``,``str``,"Specifies if and how the author thinks the video should be loaded when the page loads. Can only be values from ``['auto', 'metadata', 'none']``"
     ``:width:``,``int``, Sets the width of the video player in pixels
     ``:class:``,``str``, Set extra class to the video html tag
+    ``:playsinline:``,,Specifies that the video will play in-line (instead of full-screen) on small devices.
 
 They can be used as any directive option:
 
@@ -64,14 +65,19 @@ They can be used as any directive option:
 
     .. video:: _static/video.mp4
         :nocontrols:
+        :autoplay:
+        :playsinline:
+        :muted:
         :loop:
         :poster: _static/image.png
 
 .. video:: _static/video.mp4
     :nocontrols:
     :autoplay:
+    :playsinline:
     :muted:
     :loop:
+    :poster: _static/image.png
 
 And using the ``:class:`` parameter in combination with custom css, you can change the display of the html ``<video>`` tag:
 
diff --git a/sphinxcontrib/video/__init__.py b/sphinxcontrib/video/__init__.py
index 7671e9c..87a1b6f 100644
--- a/sphinxcontrib/video/__init__.py
+++ b/sphinxcontrib/video/__init__.py
@@ -97,6 +97,7 @@ class Video(SphinxDirective):
         "preload": directives.unchanged,
         "width": directives.unchanged,
         "class": directives.unchanged,
+        "playsinline": directives.flag,
     }
 
     def run(self) -> List[video_node]:
@@ -150,6 +151,7 @@ def run(self) -> List[video_node]:
                 preload=preload,
                 width=width,
                 klass=self.options.get("class", ""),
+                playsinline="playsinline" in self.options,
             )
         ]