Vue單頁面骨架屏實踐

時間 2019-11-09

標籤 vue 頁面骨架實踐简体版

原文原文鏈接

github 地址： VV-UI/VV-UIcss

演示地址: vv-uihtml

文檔地址：skeleton前端

關於骨架屏介紹

骨架屏的做用主要是在網絡請求較慢時，提供基礎佔位，當數據加載完成，恢復數據展現。這樣給用戶一種很天然的過渡，不會形成頁面長時間白屏或者閃爍等狀況。常見的骨架屏實現方案有ssr服務端渲染和prerender兩種解決方案。這裏主要經過代碼爲你們展現如何一步步作出這樣一個骨架屏：vue

prerender 渲染骨架屏

本組件庫骨架屏的實現也是基於預渲染去實現的，有關於預渲染更詳細的介紹請參考這篇文章：處理 Vue 單頁面 Meta SEO的另外一種思路下面咱們主要介紹其實現步驟，首先咱們也是須要配置webpack-plugin，不過已經有實現好的prerender-spa-plugin可用node

var path = require('path')
var PrerenderSpaPlugin = require('prerender-spa-plugin')

module.exports = {
  // ...
  plugins: [
    new PrerenderSpaPlugin(
      // Absolute path to compiled SPA
      path.join(__dirname, '../dist'),
      // List of routes to prerender
      ['/']
    )
  ]
}

而後寫好咱們的骨架屏文件main.skeleton.vuewebpack

<template>
  <div class="main-skeleton">
    <w-skeleton height="80px"></w-skeleton>
    <div>
      <div class="skeleton-container">
        <div class="skeleton">
          <w-skeleton height="300px"></w-skeleton>
        </div>
        <w-skeleton height="45px"></w-skeleton>
      </div>
      <div class="skeleton-bottom">
        <w-skeleton height="45px"></w-skeleton>
      </div>
    </div>
  </div>
</template>

當初次進入頁面的時候咱們須要顯示骨架屏，數據加載完，咱們須要移除骨架屏：git

<template>
  <div id="app">
    <mainSkeleton v-if="!init"></mainSkeleton>
    <div v-else>
      <div class="body"></div>
    </div>
  </div>
</template>
<script>
 import mainSkeleton from './main.skeleton.vue'

  export default {
    name: 'app',
    data () {
      return {
        init: false
      }
    },
    mounted () {
      //  這裏模擬數據請求
      setTimeout(() => {
        this.init = true
      }, 250)
    },
    components: {
      mainSkeleton
    }
  }
</script>

ssr 渲染骨架屏

下面我用我靈魂畫師的筆法，畫出了大體的過程：github

首先建立咱們的skeleton.entry.jsweb

import Vue from 'vue';
import Skeleton from './skeleton.vue';

export default new Vue({
    components: {
        Skeleton
    },
    template: '<skeleton />'
});

固然這裏的skeleton.vue使咱們事先寫好的骨架屏組件，看起來多是這樣：微信

<template>
    <div class="skeleton-wrapper">
        <header class="skeleton-header"></header>
        <div class="skeleton-block"></div>
    </div>
</template>

而後咱們須要的是能把skeleton.entry.js編譯成服務端渲染可用的bundle文件，因此咱們須要有個編譯骨架屏的webpack.ssr.conf.js文件:

const path = require('path');
const merge = require('webpack-merge');
const baseWebpackConfig = require('./webpack.base.conf');
const nodeExternals = require('webpack-node-externals');

function resolve(dir) {
    return path.join(__dirname, dir);
}

module.exports = merge(baseWebpackConfig, {
    target: 'node',
    devtool: false,
    entry: {
        app: resolve('./src/skeleton.entry.js')
    },
    output: Object.assign({}, baseWebpackConfig.output, {
        libraryTarget: 'commonjs2'
    }),
    externals: nodeExternals({
        whitelist: /\.css$/
    }),
    plugins: []
});

接下來最終的步驟，就是編寫咱們的webpackPlugin，咱們指望咱們的webpackPlugin能夠幫咱們把入口文件編譯成bundle，而後再經過vue-server-renderer來render bundle，最終產出響應的html片斷和css片斷，這裏貼出核心代碼：

// webpack start to work
    var serverCompiler = webpack(serverWebpackConfig);
    var mfs = new MFS();
    // output to mfs
    serverCompiler.outputFileSystem = mfs;
    serverCompiler.watch({}, function (err, stats) {

        if (err) {
            reject(err);
            return;
        }

        stats = stats.toJson();
        stats.errors.forEach(function (err) {
            console.error(err);
        });
        stats.warnings.forEach(function (err) {
            console.warn(err);
        });

        var bundle = mfs.readFileSync(outputPath, 'utf-8');
        var skeletonCss = mfs.readFileSync(outputCssPath, 'utf-8');
        // create renderer with bundle
        var renderer = createBundleRenderer(bundle);
        // use vue ssr to render skeleton
        renderer.renderToString({}, function (err, skeletonHtml) {
            if (err) {
                reject(err);
            }
            else {
                resolve({skeletonHtml: skeletonHtml, skeletonCss: skeletonCss});
            }
        });
    });

最後一步，咱們對產出的html片斷, css片斷進行組裝，產出最終的html，因此咱們須要監聽webpack 的編譯掛載以前的事件：

compiler.plugin('compilation', function (compilation) {

    // add listener for html-webpack-plugin
    compilation.plugin('html-webpack-plugin-before-html-processing', function (htmlPluginData, callback) {
        ssr(webpackConfig).then(function (ref) {
            var skeletonHtml = ref.skeletonHtml;
            var skeletonCss = ref.skeletonCss;

            // insert inlined styles into html
            var headTagEndPos = htmlPluginData.html.lastIndexOf('</head>');
            htmlPluginData.html = insertAt(htmlPluginData.html, ("<style>" + skeletonCss + "</style>"), headTagEndPos);

            // replace mounted point with ssr result in html
            var appPos = htmlPluginData.html.lastIndexOf(insertAfter) + insertAfter.length;
            htmlPluginData.html = insertAt(htmlPluginData.html, skeletonHtml, appPos);
            callback(null, htmlPluginData);
        });
    });
 });