Techniques for WCAG 2.0

On this page:

-

# H46: Using `noembed` with `embed`

## Applicability

Documents that load plugins with the `embed` element.

This technique relates to:

- Success Criterion 1.1.1 (Non-text Content)
  - How to Meet 1.1.1 (Non-text Content)
  - Understanding Success Criterion 1.1.1 (Non-text Content)
- Success Criterion 1.2.8 (Media Alternative (Prerecorded))
  - How to Meet 1.2.8 (Media Alternative (Prerecorded))
  - Understanding Success Criterion 1.2.8 (Media Alternative (Prerecorded))

## User Agent and Assistive Technology Support Notes

Note: Although `embed` is widely supported in user agents - it is not a valid part of HTML or XHTML.

## Description

The objective of this technique is to provide alternative content for the `embed` element in a `noembed` element. The `noembed` is rendered only if the `embed` is not supported. While it can be positioned anywhere on the page, it is a good idea to include it as a child element of `embed` so that it is clear to assistive technologies that a text alternative is associated with the `embed` element it describes.

## Examples

### Example 1: noembed is provided inside an embed

Example Code:

    <embed src="../movies/history_of_rome.mov"
      height="60" width="144" autostart="false">
      <noembed>
        <a href="../transcripts/transcript_history_rome.htm">Transcript of "The history of Rome"</a>
      </noembed>
    </embed>

### Example 2: noembed is provided beside an embed

Example Code:

    <embed src="moviename.swf" width="100" height="80"
      pluginspage="http://example.com/shockwave/download/" />
    <noembed>
      <img alt="Still from Movie" src="moviename.gif"
        width="100" height="80" />
    </noembed>;

## Resources

No resources available for this technique.

## Related Techniques

(none currently listed)

## Tests

### Procedure

1. Check if `embed` element has a child `noembed` element

2. Check if `embed` element has a `noembed` element that immediately follows it.

### Expected Results

- #1 is true or #2 is true

- Top
- Contents
- Intro
- Previous: Technique H45
- Next: Technique H48