萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

CSS Sprite 雪碧圖自動化工具實戰:gulp + sprity + Mustache 模板生成 SCSS

什麼是 CSS Sprite?

CSS Sprite(雪碧圖)將多張小圖標合併為一張大圖,通過 background-position 定位顯示,減少 HTTP 請求,提升頁面加載性能。

工具鏈選型:sprity(原 css-sprite 升級版)

  • 支援 Gulp/Grunt/Webpack
  • 多輸出格式:PNG、Data URI、WebP
  • 模板引擎:Mustache/Handlebars 自定義輸出(SCSS/Less/Stylus/CSS)
  • 智能佈局:水平/垂直/對角/二叉樹打包算法
  • 自動生成 @mixin、變量、類名映射

完整 Gulp 配置實戰

1. 安裝依賴

npm install gulp gulp-if sprity --save-dev

2. Gulp Task 配置

const gulp = require('gulp');
const gulpif = require('gulp-if');
const sprity = require('sprity');

gulp.task('sprites', function () {
    return sprity.src({
        src: 'src/assets/icons/*.png',      // 源圖標目錄
        style: '_sprite.scss',              // 輸出樣式文件
        processor: 'scss',                  // 處理器
        name: 'sprite',                     // 雪碧圖基礎名
        format: 'png',                      // 輸出格式
        orientation: 'binary-tree',         // 打包算法:binary-tree/left-right/top-down
        margin: 4,                          // 圖標間距
        split: true,                        // 按目錄分組生成多張雪碧圖
        template: './sprite-tpl.mustache',  // 自定義模板
        cssPath: '../images/sprite.png'     // CSS 中引用路徑
    })
    .pipe(gulpif('*.png', gulp.dest('dist/images/'), gulp.dest('dist/styles/')));
});

3. Mustache 模板(sprite-tpl.mustache)

{{#items}}
$icon-{{name}}: {{px.offset_x}} {{px.offset_y}} {{px.width}} {{px.height}};
{{/items}}

@mixin sprite-width($sprite) { width: nth($sprite, 3); }
@mixin sprite-height($sprite) { height: nth($sprite, 4); }
@mixin sprite-position($sprite) {
    $x: nth($sprite, 1); $y: nth($sprite, 2);
    background-position: $x $y;
}
@mixin sprite($sprite) {
    @include sprite-position($sprite);
    @include sprite-width($sprite);
    @include sprite-height($sprite);
}

{{#sprite}}
.icon {
    display: inline-block;
    background: url('{{{escaped_image}}}?v={{version}}') no-repeat;
    vertical-align: middle;
    overflow: hidden;
    text-indent: -9999px;  /* 文字隱藏 */
}
{{/sprite}}

{{#items}}
.icon-{{name}} { @include sprite($icon-{{name}}); }
{{/items}}

4. 生成輸出示例(_sprite.scss)

$icon-home: -10px -10px 24px 24px;
$icon-user: -44px -10px 24px 24px;
$icon-setting: -78px -10px 24px 24px;

.icon {
    display: inline-block;
    background: url('../images/sprite.png?v=1.0.0') no-repeat;
    vertical-align: middle;
    overflow: hidden;
}

.icon-home { @include sprite($icon-home); }
.icon-user { @include sprite($icon-user); }
.icon-setting { @include sprite($icon-setting); }

5. HTML 使用

<i class="icon icon-home" aria-label="首頁"></i>
<button class="btn"><i class="icon icon-user"></i> 個人中心</button>

進階技巧

  • Retina 適配:準備 @2x 圖標,配置 ratio: 2 生成雙倍圖 + Media Query
  • SVG Sprite:現代項目推薦 svg-sprite 或 svgr,矢量無損、內聯可控制顏色
  • 監聽模式:gulp.watch('src/assets/icons/**/*.png', gulp.series('sprites')) 實時生成
  • 版本號:模板中 ?v={{version}} 關聯 package.json 版本,自動緩存更新

Windows 安裝坑點提示

sprity 依賴 lwip(需 node-gyp 編譯 C++ 插件),Windows 易失敗。解決:

  1. 安裝 windows-build-tools:npm install --global windows-build-tools
  2. 或使用 sharp 替代 lwip 的分支版本
  3. 或改用 webpack-spritesmith / postcss-sprites 純 JS 實現

相關延伸閱讀

CSS 元素定位完整指南:盒模型、浮動、定位、顯示屬性

copyright © 萬盛學電腦網 all rights reserved