tencent cloud

Last updated:2026-02-03 15:54:30
Video
Last updated: 2026-02-03 15:54:30

Component Feature

Components for playing video, support customization of cover image, aspect ratio, and player size.

Basic Usage

Specify the video resource with src, set the cover image with poster, and control the aspect ratio with aspectRatio.
Template example:
<Video src="https://www.w3schools.com/html/mov_bbb.mp4" poster="https://www.w3schools.com/html/pic_trulli.jpg" aspectRatio="16:9" />
Effect display as follows:




Attribute Description

Property Name
Type
Description
Default value
src
string
Video resource URL
-
poster
string
Video cover image URL
-
aspectRatio
"16:9" | "9:16" | "4:3" | "3:4"
Player aspect ratio
"16:9"
size
"sm" | "md" | "lg"
Player size
-
Note:
★ Marked with required attribute.

Dimension Description

Size
Width
Scenarios
sm
260px
Sidebar, profile card
md
320px
General content area
lg
480px
Main content area
Default Value
100%
Adaptive container width (minimum 260px, maximum 100%)

Aspect Ratio Description

16:9: Standard widescreen ratio (recommend).
9:16: Vertical screen ratio (suitable for mobile terminal).
4:3: Traditional television ratio.
3:4: Vertical screen traditional ratio.

Player Feature

The video player provides the following features by default:
Play/pause control.
Volume control.
Full-screen playback.
Drag and drop the progress bar.
Adjust playback speed.

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback