🚧 Under Construction

This component documentation is currently being developed. Some features may be incomplete.

Video Thumbnail

View in Pattern Lab

HTML Markup

<figure class="hoo-thumbnail-figure">
    <img src="/htwoo-core/images/videos/big-bug-bunny.webp" alt="How to make the perfect coffee" class="hoo-thumbnail-img">
    <figcaption class="hoo-thumbnail-cap">How to make the perfect coffee</figcaption>
</figure>

Video Thumbnail

The Video Thumbnail component displays an image representation of video content with optional caption.

Overview

Video thumbnails provide a static preview of video content, allowing users to see what a video contains before playing it. They are typically used in video galleries, lists, or anywhere video content is presented in a browsable format.

Features

  • Semantic HTML structure using <figure> and <figcaption>
  • Responsive image sizing with overflow handling
  • Optional caption support for video description
  • Compatible with Video Overlay component
  • Consistent styling with other media components
  • Properly labeled images for accessibility
  • Border radius for modern appearance

Usage

Video thumbnails are commonly used:

  • As clickable previews to launch video players
  • In video galleries or collections
  • On content cards featuring video
  • In search results for video content
  • As preview images in media-rich content

With Video Overlay

Thumbnails are often paired with the Video Overlay component to indicate playability:

<div class="hoo-thumbnail">
  <figure class="hoo-thumbnail-figure">
    <img src="path/to/thumbnail.jpg" alt="Video description" class="hoo-thumbnail-img">
    <figcaption class="hoo-thumbnail-cap">Video description</figcaption>
    <div class="hoo-thumbnail-overlay">
      <span class="hoo-icon-svg"><!-- Play icon SVG --></span>
      <div class="hoo-video-duration">1:42</div>
    </div>
  </figure>
</div>

CSS Properties

  • .hoo-thumbnail - Main container with border radius and overflow handling
  • .hoo-thumbnail-figure - Figure element containing the image with position relative
  • .hoo-thumbnail-img - The actual thumbnail image
  • .hoo-thumbnail-cap - Caption with proper positioning and styling

Best Practices

  • Use high-quality, representative thumbnail images
  • Include descriptive alt text for accessibility
  • Keep caption text concise yet descriptive
  • Optimize thumbnail images for fast loading
  • Consider using the Video Overlay component to indicate playability
  • Maintain consistent aspect ratios across thumbnails (16:9 recommended)

SCSS

Accessibility

  • Include descriptive alt text that explains the video content
  • Ensure the caption provides meaningful context
  • Maintain proper color contrast for caption text
  • Use semantic HTML elements (<figure>, <figcaption>)
  • Include duration information for better user context
  • Ensure any interactive elements are keyboard accessible