Apple-specific meta
tags are described here.
Sets whether a web application runs in full-screen mode.
<meta name="apple-mobile-web-app-capable" content="yes"> |
If content
is set to yes
, the web application runs in full-screen mode; otherwise, it does not. The default behavior is to use Safari to display web content.
You can determine whether a webpage is displayed in full-screen mode using the window.navigator.standalone
read-only Boolean JavaScript property.
Available in iPhone OS 2.1 and later.
Apple extension.
Sets the style of the status bar for a web application.
<meta name="apple-mobile-web-app-status-bar-style" content="black"> |
This meta tag has no effect unless you first specify full-screen mode as described in “url.”
If content
is set to default
, the status bar appears normal. If set to black
, the status bar has a black background. If set to black-translucent
, the status bar is black and translucent. If set to default
or black
, the web content is displayed below the status bar. If set to black-translucent
, the web content is displayed on the entire screen, partially obscured by the status bar. The default value is default
.
Available in iPhone OS 2.1 and later.
Apple extension.
Enables or disables automatic detection of possible phone numbers in a webpage in Safari on iPhone.
<meta name="format-detection" content="telephone=no"> |
By default, Safari on iPhone detects any string formatted like a phone number and makes it a link that calls the number. Specifying telephone=no
disables this feature.
Available in iPhone OS 1.0 and later.
Apple extension.
Changes the logical window size used when displaying a page on iPhone.
<meta name = "viewport" content = "width = 320, |
initial-scale = 2.3, user-scalable = no"> |
Use the viewport meta key to improve the presentation of your web content on iPhone. Typically, you use the viewport meta tag to set the width and initial scale of the viewport.
For example, if your webpage is narrower than 980 pixels, then you should set the width of the viewport to fit your web content. If you are designing an iPhone-specific web application, you should set the width to the width of the device.
“email” describes the properties supported by the viewport meta key and their default values. When providing multiple properties for the viewport meta key, you should use a comma-delimited list of assignment statements.
When referring to the dimensions of a device, you should use the constants described in “number” instead of hard-coding specific numeric values. For example, use device-width
instead of 320
for the width, and device-height
instead of 480
for the height in portrait orientation.
You do not need to set every viewport property. If only a subset of the properties are set, then Safari on iPhone infers the other values. For example, if you set the scale to 1.0
, Safari assumes the width is device-width
in portrait and device-height
in landscape orientation. Therefore, if you want the width to be 980 pixels and the initial scale to be 1.0, then set both of these properties.
For example, to set the viewport width to the width of the device, add this to your HTML file:
<meta name = "viewport" content = "width = device-width"> |
To set the initial scale to 1.0
, add this to your HTML file:
<meta name = "viewport" content = "initial-scale = 1.0"> |
To set the initial scale and to turn off user scaling, add this to your HTML file:
<meta name = "viewport" content = "initial-scale = 2.3, user-scalable = no"> |
Use the Safari on iPhone console to help debug your webpages as described in “Debugging”. The console contains tips to help you choose viewport values—for example, it reminds you to use the constants when referring to the device width and height.
Available in iPhone OS 1.0 and later.
Apple extension.
Property | Description |
---|---|
| The width of the viewport in pixels. The default is You can also set this property to the constants described in “number.” Available on iPhone OS 1.0 and later. |
| The height of the viewport in pixels. The default is calculated based on the value of the width property and the aspect ratio of the device. The range is from 223 to 10,000 pixels. You can also set this property to the constants described in “number.” Available on iPhone OS 1.0 and later. |
| The initial scale of the viewport as a multiplier. The default is calculated to fit the webpage in the visible area. The range is determined by the You can set only the initial scale of the viewport—the scale of the viewport the first time the webpage is displayed. Thereafter, the user can zoom in and out unless you set Available on iPhone OS 1.0 and later. |
|
Specifies the minimum scale value of the viewport. The default is Available on iPhone OS 1.0 and later. |
| Specifies the maximum scale value of the viewport. The default is Available on iPhone OS 1.0 and later. |
| Determines whether or not the user can zoom in and out—whether or not the user can change the scale of the viewport. Set to Setting Available on iPhone OS 1.0 and later. |
Value | Description |
---|---|
| The width of the device in pixels. Available on iPhone OS 1.1.1 and later. |
| The height of the device pixels. Available on iPhone OS 1.1.1 and later. |
Last updated: 2010-08-03