萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 偵測瀏覽器 CSS3 屬性支援度:前綴詞自動檢測工具函式

需求背景

CSS3 屬性(如 animation-play-state、transition、transform)在各瀏覽器支援度不同,早期需加上廠商前綴(-webkit-、-moz-、-ms-、-o-)。撰寫動畫庫或 Polyfill 時,需先偵測瀏覽器實際支援的屬性名稱。

通用偵測函式

/**
 * 判斷瀏覽器是否支援某個 CSS3 屬性(含廠商前綴)
 * @param {String} style - 標準屬性名稱(如 'animation-play-state')
 * @return {Boolean} true/false
 * @version 1.0
 * @author ydr.me
 */
function supportCss3(style) {
    var prefix = ['webkit', 'Moz', 'ms', 'o'],
        i,
        humpString = [],
        htmlStyle = document.documentElement.style,
        
        // 將 kebab-case 轉為 camelCase
        _toHumb = function (string) {
            return string.replace(/-(w)/g, function ($0, $1) {
                return $1.toUpperCase();
            });
        };
    
    // 產生所有前綴變體:webkitAnimationPlayState, MozAnimationPlayState...
    for (i in prefix) {
        humpString.push(_toHumb(prefix[i] + '-' + style));
    }
    // 加入無前綴標準寫法
    humpString.push(_toHumb(style));
    
    // 檢查是否存在於 documentElement.style 中
    for (i in humpString) {
        if (humpString[i] in htmlStyle) return true;
    }
    return false;
}

使用範例

// 檢測 animation-play-state 支援度
console.log(supportCss3('animation-play-state')); // true/false

// 檢測其他常見屬性
console.log(supportCss3('transform'));           // true
console.log(supportCss3('transition'));          // true
console.log(supportCss3('flex'));                // true (現代瀏覽器)
console.log(supportCss3('grid'));                // true
console.log(supportCss3('backdrop-filter'));     // 視瀏覽器版本而定

進階版:回傳實際支援的屬性名稱

/**
 * 取得瀏覽器實際支援的 CSS 屬性名稱(含前綴)
 * @param {String} style - 標準屬性名稱
 * @return {String|null} 實際可用的屬性名稱,不支援則回傳 null
 */
function getSupportedCssProperty(style) {
    var prefix = ['webkit', 'Moz', 'ms', 'o'],
        htmlStyle = document.documentElement.style,
        _toHumb = function (string) {
            return string.replace(/-(w)/g, function ($0, $1) {
                return $1.toUpperCase();
            });
        };
    
    // 優先檢查無前綴標準寫法
    var standard = _toHumb(style);
    if (standard in htmlStyle) return standard;
    
    // 檢查前綴版本
    for (var i = 0; i < prefix.length; i++) {
        var prefixed = _toHumb(prefix[i] + '-' + style);
        if (prefixed in htmlStyle) return prefixed;
    }
    return null;
}

// 使用範例
var transformProp = getSupportedCssProperty('transform');
// 可能回傳: "transform", "webkitTransform", "MozTransform" 等

// 直接套用到元素
if (transformProp) {
    element.style[transformProp] = 'rotate(45deg)';
}

現代瀏覽器環境下的建議

1. 多數 CSS3 屬性已無需前綴

Can I Use 數據顯示:transform、transition、animation、flex、grid 等主流屬性在現代瀏覽器(Chrome 29+、Firefox 22+、Safari 9+、Edge 12+)均已支援無前綴標準寫法。

2. 使用 @supports CSS 原生特性查詢

/* CSS 層面判斷,無需 JS */
@supports (animation-play-state: paused) {
    .animated { animation-play-state: paused; }
}

@supports (display: grid) {
    .container { display: grid; }
}

/* JS 中檢查 @supports */
if (CSS.supports('animation-play-state', 'paused')) {
    // 支援
}

3. Autoprefixer 自動處理前綴(建構工具整合)

使用 PostCSS + Autoprefixer,建構時自動根據 browserslist 設定補齊前綴,原始碼只寫標準語法:

/* 輸入 */
.box { transform: rotate(45deg); }

/* 輸出 (針對舊版瀏覽器) */
.box { 
    -webkit-transform: rotate(45deg);
    -ms-transform: rotate(45deg);
    transform: rotate(45deg);
}

總結

supportCss3() 函式適用於舊專案維護、Polyfill 開發、或需動態判斷瀏覽器能力的場景。現代專案建議:優先使用 @supports、配合 Autoprefixer 自動處理前綴、僅在執行時需動態判斷時使用 JS 偵測。

copyright © 萬盛學電腦網 all rights reserved