embed
elementsrc
type
width
height
interface HTMLEmbedElement : HTMLElement { attribute DOMString src; attribute DOMString type; attribute DOMString width; attribute DOMString height; legacycaller any (any... arguments); };
The embed
element represents
an integration point for an external (typically non-HTML)
application or interactive content.
The src
attribute gives the address
of the resource being embedded. The attribute, if present, must
contain a valid
non-empty URL potentially surrounded by spaces.
The type
attribute, if present,
gives the MIME type by which the plugin to instantiate is
selected. The value must be a valid MIME type. If both the type
attribute and the src
attribute are present, then the
type
attribute must specify the same type as
the explicit Content-Type metadata of the resource
given by the src
attribute.
Any namespace-less attribute other than name
, align
, hspace
, and vspace
may be specified on the embed
element, so long as its name is
XML-compatible and contains no characters in
the range U+0041 to U+005A (LATIN CAPITAL LETTER A to LATIN CAPITAL
LETTER Z). These attributes are then passed as parameters to the
plugin.
All attributes in HTML documents get lowercased automatically, so the restriction on uppercase letters doesn't affect such documents.
The four exceptions are to exclude legacy attributes that have side-effects beyond just sending parameters to the plugin.
The embed
element supports dimension attributes.
Here's a way to embed a resource that requires a proprietary plugin, like Flash:
<embed src="catgame.swf">
If the user does not have the plugin (for example if the plugin vendor doesn't support the user's platform), then the user will be unable to use the resource.
To pass the plugin a parameter "quality" with the value "high", an attribute can be specified:
<embed src="catgame.swf" quality="high">
This would be equivalent to the following, when using an
object
element instead:
<object data="catgame.swf"> <param name="quality" value="high"> </object>