# 0. XHTML Iframe Module

Contents

This section is normative.

The Iframe Module defines an element for the definition of inline frames. The element and attribute included in this module are:

Elements | Attributes | Minimal Content Model
--- | --- | ---
iframe | Core, frameborder ("1" | "0"), height (Length), longdesc (URI), marginheight (Pixels), marginwidth (Pixels), scrolling ("yes" | "no" | "auto"*), src (URI), width (Length) | (PCDATA | Flow)*

When this module is used, the `iframe` element is added to the Text content set as defined by the Inline Text Module.

Implementations: DTD, XML Schema

## 0.1. The iframe element

Attributes

`longdesc` = uri [CT]
  This attribute specifies a link to a long description of the frame. This description should supplement the short description provided using the `title` attribute, and is particularly useful for non-visual user agents.
`name` = cdata [CI]
  This attribute assigns a name to the current frame. This name may be used as the target of subsequent links.
`width` = length [CN]
  The width of the inline frame.
`height` = length [CN]
  The height of the inline frame.

Attributes defined elsewhere

- `id`, `class` (document-wide identifiers)
- `title` (element title)
- `style` (inline style information)
- `name`, `src`, `frameborder`, `marginwidth`, `marginheight`, `scrolling` (frame controls and decoration)
- `align` (alignment)

The `IFRAME` element allows authors to insert a frame within a block of text. Inserting an inline frame within a section of text is much like inserting an object via the `OBJECT` element: they both allow you to insert an XHTML document in the middle of another, they may both be aligned with surrounding text, etc.

The information to be inserted inline is designated by the `src` attribute of this element. The contents of the `IFRAME` element, on the other hand, should only be displayed by user agents that do not support frames or are configured not to display frames.

For user agents that support frames, the following example will place an inline frame surrounded by a border in the middle of the text.

      <IFRAME src="foo.html" width="400" height="500"
                 scrolling="auto" frameborder="1">
      [Your user agent does not support frames or is currently configured
      not to display frames. However, you may visit
      <A href="foo.html">the related document.</A>]
      </IFRAME>

Inline frames may not be resized (and thus, they do not take the `noresize` attribute).

Note. XHTML documents may also be embedded in other XHTML documents with the `OBJECT` element. See the section on embedded documents for details.