Skip to content

Commit 4a27cd7

Browse files
authored
docs for quarto-cli #13508 (#1794)
1 parent d647367 commit 4a27cd7

File tree

2 files changed

+17
-3
lines changed

2 files changed

+17
-3
lines changed

docs/authoring/videos.qmd

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -92,11 +92,23 @@ For YouTube videos, you can specify a `start` option to indicate how many second
9292
The `title` option adds a `title` attribute to the video `<iframe>`:
9393

9494
``` {.default shortcodes="false"}
95-
{{< video https://www.youtube.com/embed/wo9vZccmqwc
96-
title='What is the CERN?'
95+
{{< video https://www.youtube.com/embed/wo9vZccmqwc
96+
title='What is the CERN?'
9797
>}}
9898
```
9999

100+
### Accessibility Label
101+
102+
The `aria-label` option provides a custom accessibility label for screen readers. By default, embedded videos use the generic label "Video Player", but you can provide a more descriptive label:
103+
104+
``` {.default shortcodes="false"}
105+
{{< video https://www.youtube.com/embed/wo9vZccmqwc
106+
aria-label="Video demonstration of particle physics experiments at CERN"
107+
>}}
108+
```
109+
110+
This works with all video types including YouTube, Vimeo, Brightcove, and local video files.
111+
100112
## Revealjs {#revealjs}
101113

102114
You can include videos within [Revealjs](/docs/presentations/revealjs/index.qmd) presentations in one of two ways:
Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,3 @@
1-
Quarto 1.9 includes the following new features:
1+
Quarto 1.9 includes the following new features:
2+
3+
- [`aria-label` for videos](/docs/authoring/videos.qmd#accessibility-label): Improve accessibility of embedded videos by providing custom descriptive labels for screen readers instead of the default "Video Player" label.

0 commit comments

Comments
 (0)