行動裝置的使用者會旋轉螢幕,網頁需要跟著調整版面。偵測方向變化有幾種做法,以下由舊到新排列,並說明各自的適用時機。
window.addEventListener("orientationchange", function () {
// 依方向回傳 0、90、-90 或 180
alert(window.orientation);
}, false);
這是早期最直接的做法。注意:window.orientation 與 orientationchange 都已標記為廢棄,不建議用在新專案。它的問題是觸發時機太早——此時 window.innerWidth / innerHeight 可能還沒更新完畢,讀到的尺寸是舊的。
window.addEventListener("resize", function () {
// 讀取螢幕尺寸(內 / 外部寬高)
console.log(window.innerWidth, window.innerHeight);
console.log(screen.width, screen.height);
}, false);
這個方法比較可靠,因為 resize 觸發時尺寸已經更新。缺點是 desktop 上調整視窗大小也會觸發,且會連續觸發很多次,需要自己做節流。
/* 直向 */
@media screen and (orientation: portrait) {
/* portrait-specific styles */
}
/* 橫向 */
@media screen and (orientation: landscape) {
/* landscape-specific styles */
}
如果只是要換版面,CSS media query 永遠是第一選擇——不必寫 JavaScript,效能最好,也不必處理事件時機問題。
window.matchMedia 讓 JavaScript 也能查詢 media query,並監聽其變化。這是判斷方向最恰當的現代做法:
var mql = window.matchMedia("(orientation: portrait)");
// 立即取得目前狀態
if (mql.matches) {
console.log("目前是直向");
} else {
console.log("目前是橫向");
}
// 監聽後續變化
mql.addEventListener('change', function (m) {
if (m.matches) {
document.getElementById("test").textContent = "改變到直立方向";
} else {
document.getElementById("test").textContent = "改變到水平方向";
}
});
舊版 Safari(14 之前)只支援 addListener,若需要相容可寫:
if (mql.addEventListener) {
mql.addEventListener('change', handler);
} else {
mql.addListener(handler); // 已廢棄的舊 API
}
1. 判斷方向的依據不一定可靠。orientation: portrait 的定義是「高度 ≥ 寬度」,因此在近乎正方形的視窗上結果會反覆跳動。若你的需求是「版面是單欄還是雙欄」,用 @media (min-width: 768px) 這類依容器寬度的判斷會更貼近實際,也更符合響應式設計的精神。
2. 旋轉後要重算的東西不少。除了版面,若有用 Canvas 或自訂座標計算,記得在方向變更後重新取得尺寸:
window.addEventListener('resize', debounce(function () {
canvas.width = canvas.clientWidth;
canvas.height = canvas.clientHeight;
redraw();
}, 150));
function debounce(fn, wait) {
var t;
return function () {
clearTimeout(t);
t = setTimeout(fn, wait);
};
}
3. 用 dvh / dvw 省去手動計算。需要讓元素填滿視窗時,100dvh 會自動隨方向與網址列收合調整,不必監聽任何事件:
.hero { min-height: 100dvh; }
4. 不要鎖定方向除非必要。有些應用(如影片播放器、手繪板)確實需要固定方向,這可以透過 PWA 的 manifest 或 screen.orientation.lock()(需全螢幕狀態)來做。但對一般內容網站,強迫使用者維持某個方向通常是不友善的——直向拿著手機躺著看的人很多。