Summary Files Commits Branches @commit @diff @stats
path: root / docs / src / contents / media.pug
blob: ee78fcc3c44fad16b799dbfb2d508a27d819081e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
p Media includes responsive images, figures and video classes.

+docs-subheading('media-images', 'Images')

p
  | Add the #[code img-responsive] class to #{'<img>'} elements. The images will scale with the parent sizes.

.columns
  .column.col-12
    img.img-responsive.rounded(src="img/osx-el-capitan.jpg" alt="macOS El Capitan Wallpaper")

p
  | Add the #[code img-fit-contain] or #[code img-fit-cover] class to #{'<img>'} or #{'<video>'} elements. The media will crop itself to fit inside the element (and you don't need another container).
  | This feature can replace the classic background image trick. Microsoft Edge support 
  a(href="https://developer.microsoft.com/en-us/microsoft-edge/platform/status/objectfitandobjectposition/" target="_blank") is shipped
  |   with Build Number 16299+.

.docs-demo.columns
  .column.col-6.col-xs-12
    figure.figure
      img.img-fit-contain.rounded(src="img/osx-yosemite.jpg" alt="macOS Yosemite Wallpaper" style="background: #f8f9fa; height: 10rem; width: 100%;")
      figcaption.figure-caption.text-center img-fit-contain
  .column.col-6.col-xs-12
    figure.figure
      img.img-fit-cover.rounded(src="img/osx-yosemite-2.jpg" alt="macOS Yosemite Wallpaper" style="background: #f8f9fa; height: 10rem; width: 100%;")
      figcaption.figure-caption.text-center img-fit-cover

pre.code(data-lang='HTML')
  code
    :highlight(lang="html")
      <img src="img/osx-el-capitan.jpg" class="img-responsive ..." alt="...">
      <img src="img/osx-el-capitan.jpg" class="img-fit-contain ..." alt="...">
      <img src="img/osx-el-capitan.jpg" class="img-fit-cover ..." alt="...">

+docs-subheading('media-figure', 'Figure')

p
  | You can use the element #{'<figure>'} for an image with a caption.
  | Add the #[code figure] class to #{'<figure>'} element.
  | The images with the #[code img-responsive] class will be responsive.
  | And the included class #[code figure-caption] will provide basic style for caption.
  | Also, you can use #[code text-left], #[code text-center] and #[code text-right] for caption alignment.

.docs-demo.columns
  .column.col-12
    figure.figure
      img.img-responsive.rounded(src="img/osx-yosemite-2.jpg" alt="macOS Yosemite Wallpaper")
      figcaption.figure-caption.text-center macOS Yosemite wallpaper

+docs-subheading('media-video', 'Video')

p
  | For responsive video, add a container with the #[code video-responsive] class. 
  | Insert any YouTube, Youku or other iframe/embed video inside the container. 
  | The ratio is 16:9 by default.
  | You may add #[code video-responsive-4-3] for 4:3 ratio video container or #[code video-responsive-1-1] for 1:1 ratio.

.docs-demo.columns
  .column.col-12
    .video-responsive
      iframe(width="560" height="315" src="https://www.youtube.com/embed/7DbslbKsQSk" allowfullscreen="")

p
  | For responsive #{'<video>'} elements, you can add the #[code video-responsive] class directly.

pre.code(data-lang='HTML')
  code
    :highlight(lang="html")
      <div class="video-responsive video-responsive-4-3">
        <iframe src="..." width="..." height="..." frameborder="0" allowfullscreen></iframe>
      </div>

      <video class="video-responsive" src="...">...</video>