Supported Attributes
Attributes that are supported by Safari and WebKit are described here.
If an attribute is not listed here, it is not supported by Safari and WebKit. The “Related Tags” section of each attribute links to the elements that the attribute directly applies to. If an attribute applies to the vast majority of elements, the “Related Tags” section is omitted. Some attributes are also marked as deprecated, which means they are supported by Safari but, because they are no longer supported by the HTML specification, are not guaranteed to be supported in the future. Attributes marked as obsolete are no longer supported in Safari.
HTML Attributes
abbr
Obsolete. Specifies the abbreviation for a table header cell.
accept
Specifies the supported MIME types for a form. Obsolete for form
elements.
accept-charset
Specifies the supported character sets for a form.
- Related Tags
accesskey
Specifies the access key for accessibility/screen reading.
action
Specifies the URL of a form processor (for example, a CGI script)
- Related Tags
align
Obsolete. Aligns inline elements within an element. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Availability
alink
Obsolete. Specifies the color of a currently active hyperlink. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
alt
Provides a short description of an image, area, or input type.
archive
Obsolete. Specifies a comma-separated list of Java archive URLs.
aria-checked
Indicates whether an ARIA-enabled element, such as a radio button or a checkbox, is selected.
aria-level
Indicates the hierarchical level of an ARIA-enabled structural element, such as a heading.
aria-pressed
Indicates the state of an ARIA-enabled toggle button.
aria-valuemax
Indicates the maximum value of an ARIA-enabled element with a range, such as a progress bar.
aria-valuemin
Indicates the minimum value of an ARIA-enabled element with a range, such as a progress bar.
aria-valuenow
Indicates the current value of an ARIA-enabled element with a range, such as a progress bar.
autocapitalize
Specifies the auto-capitalization behavior of text elements. Possible values are:
Do not capitalize any text automatically.
Available in iOS 5.0 and later.
Capitalize the first letter of each sentence automatically.
Available in iOS 5.0 and later.
Capitalize the first letter of each word automatically.
Available in iOS 5.0 and later.
Capitalize all characters automatically.
Available in iOS 5.0 and later.
Deprecated in iOS 5.0. Use
none
instead.Deprecated in iOS 5.0. Use
sentences
instead.
none
sentences
words
characters
off
on
If the autocapitalize
attribute is present but no value is specified (as in <input autocapitalize>
), the default value is sentences
. If the autocapitalize
attribute is not present, the default value is sentences
for form
and none
for input
elements with type
set to password
as in <input type="password">
. For all other form controls, the default value is inherited from the enclosing form
element.
For example, in the following code fragment, the autocapitalize
attribute values for the first-name
and last-name
input elements default to words
which is inherited from the form
element:
<form autocapitalize="words"> |
First Name: <input name="first-name"> |
Last Name: <input name="last-name"> |
State: <input name="state" autocapitalize="characters"> |
Username: <input name="username" autocapitalize="none"> |
Comment: <textarea name="comment" autocapitalize="sentences"></textarea> |
</form> |
Apple extension.
- Related Tags
- Support Level
autocomplete
Specifies a form field accepts AutoFill information. If off
, deactivates automatic completion for an input element; on
, activates automatic completion for the element.
- Related Tags
autocorrect
Specifies a form field allows automatic correction. If off
, deactivates automatic correction for a form or input element; on
, activates automatic correction for the element.
Apple extension.
- Support Level
autoplay
Indicates that a media element should begin playing as soon as it is loaded.
autosave
Specifies an autosave name for a search field, so prior searches can be saved.
Apple extension.
- Related Tags
- Support Level
axis
Obsolete. Specifies a comma-separated list of category names for a table cell or table header cell. The scope
attribute may be used on th
elements.
background
Obsolete. Specifies a background image. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
behavior
Used for the marquee
element. Can be set to scroll
to continually scroll, slide
to slide it to the edge and start again at the beginning, or alternate
to scroll back and forth.
- Related Tags
bgcolor
Obsolete. Sets the background color of an element. Use CSS styling instead.
bgproperties
Sets the background style if a background image has been set. The only value available is fixed, which locks the background in place as the page scrolls.
- Related Tags
border
Obsolete. Sets the visible border width for a table. Use CSS styling instead.
bordercolor
Defines the color of a table border; has no effect in Safari.
- Related Tags
cellpadding
Defines the pixel spacing within table cells.
- Related Tags
cellspacing
Defines the pixel spacing between cells.
- Related Tags
challenge
Provides an arbitrary string that acts as the challenge for a keygen
element.
- Related Tags
char
Obsolete. Defines the axis of alignment for a block of text (for example, the decimal point in an English monetary value). The default is a decimal point. There is no replacement for this attribute.
charoff
Obsolete. Specifies the offset to the alignment character specified by the char
attribute.
charset
Obsolete for a
and link
elements. Defines the character encoding style of a given linked resource.
checked
Indicates that a checkbox element should show up as checked in a form. This attribute does not require a value: its presence indicates the box is checked, and its absence indicates the box is not checked.
- Related Tags
cellborder
Sets the width of the border of an individual table cell.
cite
Specifies the URL for the source of a citation, or a string explaining the reason for a change.
class
Space-separated list of CSS classes defining the style for an element.
classid
Obsolete. Specifies the URL of the implementation for an embedded object.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
clear
Obsolete. Specifies the flow direction of text around a line break. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
code
Deprecated. Defines the class file for an applet specified with the applet
element.
Deprecated in HTML 4.01, along with the
applet
element.
- Related Tags
- Availability
codebase
Deprecated for the applet
element. Defines the base URL for a class ID, data file, or archive specified with the object
element. There is no replacement for the applet
attribute.
Deprecated in HTML 4.01 for the
applet
element, but not for theobject
element.
- Related Tags
- Availability
codetype
Obsolete. Defines the content-type for the code embedded by the object
element.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
color
Deprecated. Defines the text color for font elements. Use CSS styling instead.
cols
Defines the number of columns in a text area or frameset.
colspan
Defines the number of columns spanned by an individual column definition.
compact
Obsolete. Compresses the space between elements in a list or menu. Use CSS styling instead.
composite
Specifies how an image gets composited onto a Dashboard widget.
Apple extension.
- Related Tags
- Support Level
content
Specifies the content for a given meta key.
- Related Tags
contenteditable
If true
, the element can be edited on the fly; if false
, it cannot.
controls
If true
, the media element includes controls, such as a play button; if false
, it does not.
coords
Specifies a comma-separated list of lengths for the area
element or for client-side image maps.
- Related Tags
data
Specifies a URL to data required by an embedded object
element.
- Related Tags
datetime
Specifies the date and time of a change. Used for the del
and ins
elements. Uses the ISO date format.
declare
Obsolete. Added alone to an object
element’s definition. Tells the object to declare but not instantiate itself. There is no replacement attribute.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
defer
Added alone to a script
element’s definition. Tells the script to defer execution.
- Related Tags
dir
Specifies the direction (ltr
/rtl
) of text within an element.
direction
Specifies the scrolling direction for the marquee
element. Can be set to left
or right
.
- Related Tags
disabled
Added alone to an input type’s definition. Disables (grays out) the element.
enctype
Defines the MIME content encoding type for a form.
- Related Tags
end
Specifies the time at which an audio
or video
element stops playing. If this attribute is not specified, the media element plays to completion.
face
Deprecated. Comma-separated list of font names. Use CSS styling instead.
for
Specifies the identifier of the control the label is relevant to.
- Related Tags
frame
Specifies which sides of a table frame should be shown. Possible values are:
void
(none)above
below
hsides
(top and bottom)vsides
(right and left)rhs
(right hand side)lhs
(left hand side)box
(all four sides)border
(all four sides)
- Related Tags
frameborder
Specifies whether or not to display a frameborder. Can be set to 1
or 0
.
headers
Specifies a space-separated list of identifiers of table header cells.
height
Deprecated for applet
and table
elements. Specifies the height of the element. Use CSS styling for table
elements.
hidden
If true
, the embedded object is hidden onscreen; if false
, it is not.
- Related Tags
href
Specifies the URL for any kind of link or area definition.
hreflang
Specifies the language of the resource linked to by the element’s href
attribute.
hspace
Obsolete. Specifies the pixel size of the horizontal spacing surrounding the element. Use CSS styling instead.
http-equiv
Used in the meta
element. Contains some kind of information about the header of the page.
- Related Tags
id
Specifies a unique identifier for an element.
incremental
Specifies whether or not the search
input type should perform the search as the user is typing.
Apple extension.
- Related Tags
- Support Level
ismap
Added alone to an image
or input
element. Indicates that the element corresponds to a server-side image map.
keytype
Specifies the key type for the keygen
element. Can be set to RSA
or DSA
.
- Related Tags
label
Specifies the label for options or option groups within a pull-down menu.
lang
Specifies the base language for the element’s attributes and textual content. Values are standard two-letter language codes.
language
Obsolete. Specifies the language of a script
element. Use type
instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
leftmargin
Used in the body
element. Specifies the left margin of the page content.
- Related Tags
link
Obsolete. Color of an unvisited hyperlink. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
longdesc
Obsolete. Long textual description for images and frames. Augments the alt
attribute for an element.
loop
Specifies the number of times a media element (movie or sound) loops. Also specifies the number of times a marquee
element loops.
loopend
Specifies the time at which an audio
or video
element loops back to the time specified by the loopstart
attribute. Looping occurs only if the playcount
attribute for the element is set to a value higher than 1
. By default, the value for this attribute is equal to the value for the end
attribute.
loopstart
Specifies the time to which an audio
or video
element returns when it loops. Looping occurs only if the playcount
attribute for the element is set to a value higher than 1
. By default, the value for this attribute is equal to the value for the start
attribute.
manifest
Specifies the relative path to the application cache manifest file that specifies the resources—such as HTML, JavaScript, CSS, and image files—to download and store in the application cache.
- Related Tags
marginheight
Specifies the height of the margins in a frame.
marginwidth
Specifies the width of the margins in a frame.
max
Same as the maxlength
attribute.
- Related Tags
maxlength
Specifies the maximum input length for a text input field in characters.
- Related Tags
mayscript
Added alone to an applet
element’s definition. Tells the script to allow the applet access to the JavaScript scripting objects.
- Related Tags
media
Defines the media type that the element is designed for. The default value is screen
, but the attribute can also be set to tty
for a fixed-pitch device, tv
for low-resolution televisions, projection
for projectors, handheld
for handheld devices, print
for printed material, braille
for braille devices, aural
for speech synthesizers, or all
for all devices.
method
Specifies the form submission method, either POST
or GET
.
- Related Tags
min
Specifies the minimum input length for a text field.
- Related Tags
multiple
Added alone to a select
element’s definition. If present, the element permits multiple selections.
- Related Tags
name
Deprecated. Specifies the name of the element, which can be used in a variety of ways.
nohref
Obsolete. Added alone to an area
element’s definition. If present, the area has no particular action assigned to it.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
noresize
Added alone to a frame
element’s definition. If present, the frames cannot be resized. The frame
element has been deprecated.
nosave
Legacy attribute. Has no effect in Safari.
noshade
Deprecated. Added alone to an hr
element’s definition. If present, the rule is drawn as a single line and not as a “groove.” Use CSS styling instead.
Deprecated in HTML 4.01.
- Related Tags
- Availability
nowrap
Obsolete. Added alone to a table cell’s definition. Suppresses word wrap if present. Use CSS styling instead.
object
Deprecated. Specifies the URL of a serialized applet in an applet
element. Use embed
instead of applet
.
Deprecated in HTML 4.01, along with the
applet
element.
- Related Tags
- Availability
onabort
JavaScript delegate. The code specified by this attribute is called when the image
element it is assigned to is aborted during load.
- Related Tags
onbeforecopy
JavaScript delegate. The code specified by this attribute is called before the associated element is copied.
onbeforecut
JavaScript delegate. The code specified by this attribute is called before the associated element is cut.
onbeforepaste
JavaScript delegate. The code specified by this attribute is called before the associated element has something pasted into it.
onbeforeunload
JavaScript delegate. The code specified by this attribute is called before the associated element is unloaded from the page.
onblur
JavaScript delegate. The code specified by this attribute is called when the associated element loses focus.
onchange
JavaScript delegate. The code specified by this attribute is called when the associated element changes its value.
onclick
JavaScript delegate. The code specified by this attribute is called when the associated element is clicked.
oncontextmenu
JavaScript delegate. The code specified by this attribute is called when the associated element is right-clicked or when the mouse button is held down long enough to generate a contextual menu.
oncopy
JavaScript delegate. The code specified by this attribute is called when the associated element is copied.
oncut
JavaScript delegate. The code specified by this attribute is called when the associated element is cut.
ondblclick
JavaScript delegate. The code specified by this attribute is called when the associated element is double-clicked.
ondrag
JavaScript delegate. The code specified by this attribute is called when the associated element is dragged.
ondragend
JavaScript delegate. The code specified by this attribute is called when the associated element stops being dragged.
ondragenter
JavaScript delegate. The code specified by this attribute is called when a drag has entered the associated element.
ondragleave
JavaScript delegate. The code specified by this attribute is called when a drag has left the associated element.
ondragover
JavaScript delegate. The code specified by this attribute is called when a drag is over the associated element.
ondragstart
JavaScript delegate. The code specified by this attribute is called when the associated element has started to be dragged.
ondrop
JavaScript delegate. The code specified by this attribute is called when the associated element is dropped.
onerror
JavaScript delegate. The code specified by this attribute is called when the associated element has an error in loading.
onfocus
JavaScript delegate. The code specified by this attribute is called when the associated element gets focus.
ongesturechange
Specifies the JavaScript method to invoke when fingers are moved during a gesture.
Available in iOS 2.0 and later.
Apple extension.
- Availability
- Support Level
ongestureend
Specifies the JavaScript method to invoke when the gesture ends (when there are one or zero fingers touching the surface).
Available in iOS 2.0 and later.
Apple extension.
- Availability
- Support Level
ongesturestart
Specifies the JavaScript method to invoke when two or more fingers touch the surface.
Available in iOS 2.0 and later.
Apple extension.
- Availability
- Support Level
oninput
JavaScript delegate. The code specified by this attribute is called when text is entered into the associated element.
onkeydown
JavaScript delegate. The code specified by this attribute is called when a key is pressed over the associated element.
onkeypress
JavaScript delegate. The code specified by this attribute is called when a key is pressed and released over the associated element.
onkeyup
JavaScript delegate. The code specified by this attribute is called when a key is released over the associated element.
onload
JavaScript delegate. The code specified by this attribute is called when the associated element finishes loading.
onmousedown
JavaScript delegate. The code specified by this attribute is called when the mouse button is pressed over the associated element.
onmousemove
JavaScript delegate. The code specified by this attribute is called when a key is moved within the associated element.
onmouseout
JavaScript delegate. The code specified by this attribute is called when the mouse leaves the associated element.
onmouseover
JavaScript delegate. The code specified by this attribute is called when the mouse is over the associated element.
onmouseup
JavaScript delegate. The code specified by this attribute is called when the mouse button is released over the associated element.
onmousewheel
JavaScript delegate. The code specified by this attribute is called when the mouse wheel button is rotated.
onorientationchange
The JavaScript method to invoke when the orientation of the device changes.
onpaste
JavaScript delegate. The code specified by this attribute is called when the associated element is pasted.
onreset
JavaScript delegate. The code specified by this attribute is called when the associated form element is reset.
onresize
JavaScript delegate. The code specified by this attribute is called when the associated element is resized.
onscroll
JavaScript delegate. The code specified by this attribute is called when the associated element is scrolled (a text box would use this, for example).
onsearch
JavaScript delegate for the search input type. The code specified by this attribute is called when a search is performed.
onselect
JavaScript delegate. The code specified by this attribute is called when text within the associated element is selected.
onselectstart
JavaScript delegate. The code specified by this attribute is called when the associated element begins to be selected. You can use this to prevent selections.
onsubmit
JavaScript delegate. The code specified by this attribute is called when the associated form element is submitted.
ontouchcancel
Specifies the JavaScript method to invoke when the system cancels tracking for the touch.
Apple extension.
- Support Level
ontouchend
Specifies the JavaScript method to invoke when a given event lifts from the surface.
Available for iOS.
Apple extension.
- Availability
- Support Level
ontouchmove
Specifies the JavaScript method to invoke when a finger for a given event moves on the surface.
Available for iOS.
Apple extension.
- Availability
- Support Level
ontouchstart
Specifies the JavaScript method to invoke when a finger for a given event touches the surface.
Available for iOS.
Apple extension.
- Availability
- Support Level
onunload
JavaScript delegate. The code specified by this attribute is called when the associated element is unloaded from the page.
placeholder
Specifies the placeholder text displayed in light gray when the search input field is not currently in use.
Apple extension.
- Related Tags
- Support Level
playcount
Specifies the number of times an audio
or video
element loops. The default value is 1
, meaning the element plays only once.
pluginpage
Deprecated. Specifies the URL of the page where visitors can find the plug-in required to display content embedded with the embed
element.
- Related Tags
This has been deprecated along with the
embed
element.
- Availability
pluginspage
Same as the pluginpage
attribute.
- Related Tags
pluginurl
Same as the pluginspage
attribute, except it links directly to the plug-in itself (in Java archive format).
- Related Tags
poster
Specifies the URL for an image to display while a video
element is loading.
Available in Safari for OS X.
Available with limited support in Safari releases for iOS.
- Related Tags
- Availability
precision
profile
Obsolete. Specifies the URL to a file of metadata or a list of files.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
readonly
Added alone to a textarea
element’s definition. If present, the textarea is not editable.
- Related Tags
rel
Defines a relationship of the document containing the link and the destination of the link. The URL specified by this property relates to this document by rel
. In other words, it is the next-order relation.
results
Specifies how many results should be returned by the search input type.
Apple extension.
- Related Tags
- Support Level
rev
Deprecated. Defines a relationship to another document. There is no replacement for this attribute.
This attribute has been declared obsolete in the HTML5 specification.
- Availability
role
Defines the WAI-ARIA accessibility role of a div
or span
element. See Supported Accessibility Roles
for more information.
rows
Defines the number of rows in a textarea
or frameset
element.
rowspan
Defines the number of rows spanned by an individual row definition.
rules
Specifies which rulings to show for a table
element. The rules
element’s potential values are none
, groups
, rows
, cols
, and all
.
- Related Tags
scheme
Obsolete. Defines the scheme to be used to interpret a meta
value.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
scope
Obsolete for td
elements. Specifies the scope handled by a table’s header cells. Possible values are row
, col
, rowgroup
, and colgroup
.
scrollamount
Specifies the number of pixels that a marquee
element scrolls between successive redraws of its onscreen view.
- Related Tags
scrolldelay
Specifies the number of milliseconds that a marquee
element will delay between successive redraws of its onscreen view.
- Related Tags
scrolling
Specifies whether or not a frame
or iframe
element should have scrollbars. Setting this property to yes
always shows the scrollbars, no
never shows the scrollbars, and auto
shows the scrollbars only if the content needs to scroll (this is the default).
selected
Added alone to an option
definition. If present, the option with this property is selected in the list.
- Related Tags
shape
Obsolete for a
elements (use area
instead). Defines the shape of an area
element or a client-side image map. Can take the form of default
, rect
, circle
, or poly
.
Declared obsolete in the HTML5 specification for
a
elements.
- Availability
size
Deprecated for some elements. Defines the physical size of a variety of inputs and fonts. Use CSS styling instead.
span
Specifies the number of columns that a given col
or colgroup
definition spans.
src
Specifies a URL for an external file or resource.
standby
Obsolete. Defines a message to show while an object is being loaded within an object
definition.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
start
Specifies the time at which an audio
or video
element starts playing. By default, the element starts at the beginning.
Also defines the starting sequence number for an ordered list. This functionality is deprecated in HTML 4.01. Use CSS styling instead.
style
Specifies CSS style information for the element. The style definitions are placed inline with this property. To specify external styles (defined in external files or in a style
element), use the class
property.
summary
Obsolete. Specifies a textual summary for a table of data.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
tabindex
Specifies the tab index for a hyperlink or input
element. Can range from 0
to 32767
. As a user tabs through a page, the focus follows this tabbing order.
tableborder
Specifies the width of a table’s border. You should use CSS styling to define this property instead.
- Related Tags
target
Obsolete for a
and link
elements. Defines the target window for a hyperlink. You can specify any target definition, but the following values are built-in:
Loads the clicked URL into a new, unnamed window.
Loads in the same frame that was clicked.
Loads into the parent frame of the frame that was clicked.
Loads the document into the original window, eliminating any existing frameset.
_blank
_self
_parent
_top
text
Obsolete. Defines the page-wide text color in the body
element. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
title
Defines a title for the associated element. In Safari, this displays a help element for the element with this value.
topmargin
Specifies the top margin of the page content.
- Related Tags
truespeed
Specifies whether or not a marquee operates at the true speed specified by its parameters. The default behavior constrains the speed to certain minimum values of scroll delay and scroll amount.
- Related Tags
type
Deprecated for li
, ol
, and ul
(use CSS styling instead). Defines a textual content type for elements like scripts and objects, and input types for the input
element. See the Input Type Values
for possible values.
usemap
Obsolete for input
elements (use img
for image maps). Specifies the URL for an image map on a document. Usually this is an anchor (for example, #myMap
) defined as a map
element on the page.
valign
Obsolete. Specifies vertical alignment within a column or table element definition. Use CSS styling instead.
value
Deprecated for li
elements (use CSS styling instead). Specifies the current value for an input
type. For those elements that can display their values (such as text fields), they display this value onscreen. Otherwise the values are all available as form values when submitted.
valuetype
Obsolete. Specifies the value type for a param
element within an object definition. Can be data
if the value is evaluated and passed as a string, ref
if the value is a URL and is unevaluated when passed, or object
if the value is an identifier that refers to an object definition. The name
and value
attributes may be used instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
version
Deprecated. Specifies the version of the HTML DTD used to verify the document. Use DOCTYPE
declarations instead.
Deprecated in HTML 4.01.
- Related Tags
- Availability
vlink
Obsolete. Color of a visited hyperlink. Use CSS styling instead.
This attribute has been declared obsolete in the HTML5 specification.
- Related Tags
- Availability
vspace
Obsolete. Specifies the pixel size of the vertical spacing surrounding the element. Use CSS styling instead.
webkit-playsinline
Indicates that a video
element should play inline instead of full-screen. Enabled only in a UIWebView
with the allowsInlineMediaPlayback
property set to YES
.
Available in iOS 4.0 and later.
- Related Tags
- Availability
width
Specifies the height of the element. Obsolete for table
elements. Use CSS styling instead.
wrap
Defines the wrap style for a textarea
element. Can be set to soft
to wrap without outputting carriage returns to the field, hard
to wrap with outputting carriage returns, and off
to not wrap at all.
- Related Tags
Copyright © 2014 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2014-07-15