Skip to content

Commit ba8ced9

Browse files
authored
DOC-3224: uc-video tags can now be made responsive. (#3942)
* DOC-3224: uc-video tags can now be made responsive. * DOC-3224: Revert changes, minor copy edits and improvements. * DOC-3224: Minor edits to fix demos.
1 parent 7a9066c commit ba8ced9

File tree

4 files changed

+15
-6
lines changed

4 files changed

+15
-6
lines changed

modules/ROOT/examples/live-demos/uploadcare-video/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ <h1>Experience Mallorca: Outdoor Paradise</h1>
44

55
<h2>Evenings by the Fire</h2>
66
<p>Watch this captivating video showcasing the magical atmosphere of Mallorca's outdoor lifestyle:</p>
7-
<p><uc-video uuid="83fd9f98-1939-4d99-b5e3-85563f89f5fb" class="tox-uc-video" contenteditable="false" controls="true" /></p>
7+
<p><uc-video uuid="83fd9f98-1939-4d99-b5e3-85563f89f5fb" fluid="true" style="width: min(3840px, 100%);" class="tox-uc-video" contenteditable="false" controls="true" /></p>
88
<p><em>Experience the warmth of beachside gatherings, the crackling of bonfires under starlit skies, and the peaceful ambiance that makes Mallorca the perfect destination for outdoor living.</em></p>
99

1010
<h2>Mallorca's Outdoor Lifestyle</h2>

modules/ROOT/pages/8.3.0-release-notes.adoc

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,18 @@ include::partial$misc/admon-releasenotes-for-stable.adoc[]
2828

2929
The following premium plugin updates were released alongside {productname} {release-version}.
3030

31+
=== Media Optimizer
32+
33+
The {productname} {release-version} release includes an accompanying release of the **Media Optimizer** premium plugin.
34+
35+
**Media Optimizer** includes the following improvements.
36+
37+
==== Newly uploaded videos are now responsive
38+
39+
Newly uploaded videos are now responsive by default. Videos automatically scale down on smaller screens while maintaining their maximum size. For more information, see: xref:uploadcare-video.adoc#uploadcare-video-properties[`uploadcare_video_properties` configuration option].
40+
41+
For information on the **Media Optimizer** plugin, see: xref:uploadcare-video.adoc[Media Optimizer: Video].
42+
3143
// === <Premium plugin name 1> <Premium plugin name 1 version>
3244

3345
// The {productname} {release-version} release includes an accompanying release of the **<Premium plugin name 1>** premium plugin.

modules/ROOT/pages/uploadcare-video.adoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,7 @@ include::partial$configuration/uploadcare_video_resize.adoc[leveloffset=+1]
117117

118118
The plugin creates a custom `+<uc-video>+` element that replaces the standard HTML `+<video>+` element when videos are processed through Uploadcare's infrastructure.
119119

120-
.Example: Custom video element created by the plugin on video insertion
120+
.Example: Custom video element with fixed dimensions (non-responsive)
121121
[source,html]
122122
----
123123
<uc-video
@@ -130,8 +130,6 @@ The plugin creates a custom `+<uc-video>+` element that replaces the standard HT
130130
loop="false"
131131
muted="false"
132132
preload="metadata"
133-
width="640"
134-
height="360"
135133
poster="https://example.com/poster.jpg"
136134
showlogo="false"
137135
</uc-video>

modules/ROOT/partials/configuration/uploadcare_video_properties.adoc

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Configures the video player properties and behavior for video elements.
1515
|`autoplay` | Boolean | `true`, `false`, `undefined` | `undefined` | Automatically starts video playback when the page loads. NOTE: Even if autoplay is enabled, modern browsers may delay or block playback until the user interacts with the page, depending on their autoplay policies.
1616
|`controls` | Boolean | `true`, `false` | `true` | Displays the video player controls (play/pause, volume, timeline, fullscreen, etc.). When disabled, users can still control playback through keyboard shortcuts or programmatic methods.
1717
|`disablePictureInPicture` | Boolean | `true`, `false`, `undefined` | `undefined` | Disables the Picture-in-Picture feature for the video player. When enabled, users cannot use Picture-in-Picture mode.
18-
|`height` | Number or String | Pixels or CSS value | `undefined` | Sets the video player height. Accepts numeric values (interpreted as pixels) or CSS values like `"100%"`, `"50vh"`, or `"auto"`.
18+
|`height` | Number or String | Pixels or CSS value | `undefined` | Sets the video player height. Accepts numeric values (interpreted as pixels) or CSS values like `"100%"`, `"50vh"`, or `"auto"`. When a numeric value is provided, it is applied as an inline CSS style with `px` units (e.g., `height: 360px`).
1919
|`loop` | Boolean | `true`, `false`, `undefined` | `undefined` | Automatically restarts video playback from the beginning when it reaches the end. Useful for background videos or continuous content loops.
2020
|`muted` | Boolean | `true`, `false`, `undefined` | `undefined` | Mutes the video audio by default. Often used in combination with autoplay since most browsers require muted videos for autoplay to function.
2121
|`poster` | String | Valid URL | `undefined` | Sets a poster image (thumbnail) that displays before video playback begins. The image should match the video's aspect ratio for best results.
@@ -25,7 +25,6 @@ Configures the video player properties and behavior for video elements.
2525
|`width` | Number or String | Pixels or CSS value | `undefined` | Sets the video player width. Accepts numeric values (interpreted as pixels) or CSS values like `"100%"`, `"50vw"`, or `"auto"`.
2626
|===
2727

28-
2928
.Example: Basic video player configuration
3029

3130
[source,js]

0 commit comments

Comments
 (0)