viewport 是行動網頁開發中不可或缺的一環,它決定了頁面在行動裝置上的呈現方式與縮放行為。以下整理了 viewport 的完整語法與各項參數的詳細說明。
<meta name="viewport"
content="
height = [pixel_value | device-height] ,
width = [pixel_value | device-width ] ,
initial-scale = float_value ,
minimum-scale = float_value ,
maximum-scale = float_value ,
user-scalable = [yes | no] ,
target-densitydpi = [dpi_value | device-dpi | high-dpi | medium-dpi | low-dpi]
" />
width:控制 viewport 的寬度,可指定具體數值或特殊值。例如 device-width 代表裝置的實際寬度(單位為縮放 100% 時的 CSS 像素)。
height:與 width 相對應,用來指定高度。
target-densitydpi:螢幕的像素密度由解析度決定,通常以每英寸的像素點數量(dpi)衡量。Android 支援低、中、高三種像素密度,其瀏覽器與 WebView 預設採用中像素密度。可取值如下:
<meta name="viewport" content="target-densitydpi=device-dpi" />
<meta name="viewport" content="target-densitydpi=high-dpi" />
<meta name="viewport" content="target-densitydpi=medium-dpi" />
<meta name="viewport" content="target-densitydpi=low-dpi" />
<meta name="viewport" content="target-densitydpi=200" />
若想避免 Android 瀏覽器與 WebView 依螢幕像素密度自動縮放頁面,可將 target-densitydpi 設為 device-dpi,此時頁面不會縮放,而是依當前螢幕密度直接呈現。此時還需將 viewport 的 width 設為與裝置寬度相符,頁面才能貼合螢幕。
initial-scale:初始縮放比例,為浮點數乘數。設為「1.0」時以目標密度 1:1 呈現,設為「2.0」則放大為兩倍。
maximum-scale:最大縮放程度,限制頁面相對於螢幕的最大放大倍率,例如設為「2.0」代表最多放大兩倍。
user-scalable:控制使用者是否能手動縮放。設為 yes 允許、設為 no 禁止,預設為 yes。一旦設為 no,minimum-scale 與 maximum-scale 都會失效。
所有縮放值都必須落在 0.01 到 10 的範圍之內。
1. 設定螢幕寬度為裝置寬度,並禁止使用者手動縮放:
<meta name="viewport" content="width=device-width,user-scalable=no" />
2. 設定螢幕密度為高、中、低頻自動縮放,並禁止使用者手動縮放:
<meta name="viewport" content="width=device-width,target-densitydpi=high-dpi,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" />