萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

JavaScript 取得螢幕解析度、網址列參數與頁面資訊實用代碼片段

前言

本文整理原文中屬於 JavaScript 範疇的「數據取得類」特效代碼,補充現代標準寫法、TypeScript 型別、錯誤處理與實務應用場景。

1. 取得螢幕解析度與可視區尺寸

<script>
// 螢幕物理解析度 (使用者螢幕硬體)
console.log('螢幕寬:', screen.width);   // 1920
console.log('螢幕高:', screen.height);  // 1080

// 螢幕可用區域 (扣除作業系統工具列)
console.log('可用寬:', screen.availWidth);  // 1920
console.log('可用高:', screen.availHeight); // 1040 (扣除任務列)

// 瀏覽器視窗外部尺寸 (含瀏覽器邊框)
console.log('視窗外寬:', window.outerWidth);
console.log('視窗外高:', window.outerHeight);

// 瀏覽器視窗內部尺寸 (網頁可見區域,含捲軸)
console.log('視窗內寬:', window.innerWidth);
console.log('視窗內高:', window.innerHeight);

// 文檔實際內容尺寸 (含捲動隱藏部分)
console.log('文檔寬:', document.documentElement.scrollWidth);
console.log('文檔高:', document.documentElement.scrollHeight);

// 當前捲動位置
console.log('捲動X:', window.scrollX || document.documentElement.scrollLeft);
console.log('捲動Y:', window.scrollY || document.documentElement.scrollTop);

// 響應式斷點判斷
const isMobile = window.innerWidth < 768;
const isTablet = window.innerWidth >= 768 && window.innerWidth < 1024;
const isDesktop = window.innerWidth >= 1024;
</script>

2. 取得完整網址與各組成部分

<script>
const url = window.location; // Location 物件

console.log('完整網址:', url.href);           // https://example.com/path?query=1#hash
console.log('協定:', url.protocol);          // https:
console.log('主機名:', url.hostname);        // example.com
console.log('連接埠:', url.port);            // "" (預設 80/443) 或 "3000"
console.log('主機(含埠):', url.host);        // example.com:3000
console.log('路徑:', url.pathname);          // /path
console.log('查詢字串:', url.search);        // ?query=1
console.log('雜湊:', url.hash);              // #hash
console.log('來源:', document.referrer);     // 上一頁網址

// URLSearchParams 解析查詢參數 (現代標準)
const params = new URLSearchParams(url.search);
console.log('query 參數:', params.get('query'));     // "1"
console.log('所有參數:', [...params.entries()]);     // [['query', '1']]
params.set('page', '2');
console.log('修改後:', params.toString());           // "query=1&page=2"

// 取得特定參數 (舊式相容)
function getQueryParam(name) {
    return new URLSearchParams(window.location.search).get(name);
}

3. 解析 URL 參數字串 (原文範例現代化)

<script>
// 原文:手動 substring/indexOf 解析
// 現代:URLSearchParams (IE 需 polyfill)

function parseQueryString(queryString) {
    // 移除開頭 ?
    const clean = queryString.startsWith('?') ? queryString.slice(1) : queryString;
    return Object.fromEntries(new URLSearchParams(clean));
}

// 使用範例
const currentParams = parseQueryString(window.location.search);
console.log(currentParams); // { id: "123", tab: "detail" }

// 建構新網址
const newUrl = new URL(window.location.href);
newUrl.searchParams.set('page', '2');
newUrl.searchParams.delete('debug');
window.history.pushState({}, '', newUrl); // 不重載更新網址

4. 取得頁面元資訊

<script>
// 文件標題
console.log('標題:', document.title);

// Meta 標籤
const description = document.querySelector('meta[name="description"]')?.content;
const keywords = document.querySelector('meta[name="keywords"]')?.content;
const ogTitle = document.querySelector('meta[property="og:title"]')?.content;
console.log('Description:', description);
console.log('OG Title:', ogTitle);

// 文檔語言
console.log('語言:', document.documentElement.lang);

// 最後修改時間
console.log('最後修改:', document.lastModified);

// Cookie
console.log('Cookie:', document.cookie);

// 表單數量
console.log('表單數:', document.forms.length);

// 圖片數量
console.log('圖片數:', document.images.length);

// 連結數量
console.log('連結數:', document.links.length);

5. 實務應用:響應式載入、追蹤、分享

根據螢幕尺寸載入不同圖片

<script>
function loadResponsiveImage(imgSelector) {
    const width = window.innerWidth;
    let suffix = '';
    if (width < 480) suffix = '-mobile';
    else if (width < 768) suffix = '-small';
    else if (width < 1200) suffix = '-medium';
    else suffix = '-large';
    
    document.querySelectorAll(imgSelector).forEach(img => {
        const src = img.dataset.src;
        if (src) img.src = src.replace(/\.(jpg|png|webp)$/i, suffix + '.$1');
    });
}

// 初始載入
loadResponsiveImage('[data-src]');
// 視窗變化重新載入 (去抖動)
let resizeTimer;
window.addEventListener('resize', () => {
    clearTimeout(resizeTimer);
    resizeTimer = setTimeout(loadResponsiveImage, 300, '[data-src]');
});

分享功能:取得當前頁面標題與網址

<script>
function getShareData() {
    return {
        title: document.title,
        url: window.location.href,
        // 可選:Open Graph 圖片
        image: document.querySelector('meta[property="og:image"]')?.content
    };
}

// Web Share API (行動裝置原生分享)
async function nativeShare() {
    if (navigator.share) {
        try {
            await navigator.share(getShareData());
        } catch (e) {
            if (e.name !== 'AbortError') console.error(e);
        }
    } else {
        fallbackShare();
    }
}

function fallbackShare() {
    const {title, url} = getShareData();
    const encodedUrl = encodeURIComponent(url);
    const encodedTitle = encodeURIComponent(title);
    // 開啟分享彈窗
    window.open(`https://www.facebook.com/sharer/sharer.php?u=${encodedUrl}`, '_blank', 'width=600,height=400');
    // 或複製連結
    navigator.clipboard.writeText(url).then(() => alert('連結已複製'));
}

頁面可見性 API:使用者是否正在看此頁

<script>
document.addEventListener('visibilitychange', () => {
    if (document.hidden) {
        console.log('使用者切換分頁/最小化');
        // 暫停影片、動畫、輪詢請求
        pauseBackgroundTasks();
    } else {
        console.log('使用者回到頁面');
        // 恢復任務、檢查更新
        resumeBackgroundTasks();
    }
});

function pauseBackgroundTasks() {
    // 範例:暫停所有 video
    document.querySelectorAll('video').forEach(v => v.pause());
    // 清除定時器
    window.__timers?.forEach(clearInterval);
}

function resumeBackgroundTasks() {
    // 恢復邏輯
}

TypeScript 型別定義 (供 TS 專案使用)

interface ScreenInfo {
    width: number;
    height: number;
    availWidth: number;
    availHeight: number;
    colorDepth: number;
    pixelDepth: number;
}

interface WindowSize {
    innerWidth: number;
    innerHeight: number;
    outerWidth: number;
    outerHeight: number;
    scrollX: number;
    scrollY: number;
    documentWidth: number;
    documentHeight: number;
}

interface UrlParts {
    href: string;
    protocol: string;
    hostname: string;
    port: string;
    host: string;
    pathname: string;
    search: string;
    hash: string;
    referrer: string;
    params: Record<string, string>;
}

function getScreenInfo(): ScreenInfo { /* ... */ }
function getWindowSize(): WindowSize { /* ... */ }
function getUrlParts(): UrlParts { /* ... */ }

總結

原文提供的 `screen.width`、`location.href`、`location.search` 解析是經典寫法。現代開發建議:

  • 使用 URLSearchParams 解析查詢字串 (標準、無 Bug、支援多值)
  • 區分 screen (螢幕)、window (視窗)、document (文檔) 三種尺寸概念
  • 善用 Page Visibility API 優化背景分頁資源佔用
  • 優先使用 Web Share API 提供原生分享體驗
copyright © 萬盛學電腦網 all rights reserved