03 · Components · 콘텐츠
비디오 플레이어Video Player
네이티브 video 컨트롤을 기반으로 자막·포스터·제목을 표준화. 자동재생은 반드시 음소거 상태여야 하며 사용자 의도를 전제하지 마세요.
StableWCAG AA
기본
YouTube URL(youtu.be/... · youtube.com/watch?v=...)을 src에 넣으면 자동으로 YouTube iframe으로 렌더링됩니다. MP4 등 직접 호스팅된 파일은 네이티브 <video> 태그로 재생됩니다.
MP4 · 자막 포함
자체 호스팅 영상에는 poster, captionSrc(WebVTT), captionLang 등을 지정해 자막과 포스터를 함께 제공하세요. 사용 예시는 아래와 같습니다.
<VideoPlayer
src="/video/intro.mp4"
poster="/video/intro-poster.jpg"
captionSrc="/video/intro.ko.vtt"
title="주님의교회 PCL 소개 영상"
/>가능한 모든 영상에 자막(track kind="captions")을 제공하세요. 영상 안에서 대화가 중요한 경우 자막은 선택이 아닌 필수 입니다. 장식성 배경 영상이라면 aria-hidden을 고려하세요.
Props API
| Prop | Type | Default | Description |
|---|---|---|---|
src | string | MP4 파일 URL 또는 YouTube URL. YouTube(youtu.be·youtube.com)이면 자동으로 iframe 임베드로 전환. | |
poster | string | 로드 전 보여줄 썸네일. | |
captionSrc | string (WebVTT) | 자막 파일 경로. | |
captionLang | string | "ko" | 자막 언어 코드. |
title | string | 캡션에 노출되는 영상 제목. |