fes.js/docs/guide/template.md
2021-03-07 12:40:57 +08:00

1.8 KiB
Raw Blame History

HTML模板

Fes.js 基于 html-webpack-plugin 实现的模板功能,默认 HTML模板 是:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width,initial-scale=1.0">
    <title><%= htmlWebpackPlugin.options.title %></title>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

替换模板

src/public 文件夹中创建index.htmlFes.js 约定如果这个文件存在,则会替换默认模板。

配置模板

配置

在配置文件(.fes.js)中配置 html,把配置的对象作为参数传入 html-webpack-plugin 实例。

举个 🌰

export default {
    html: {
        title: '海贼王'
    }
}

页面的 title 会设置成'海贼王'。

手动

当然我们也可以手动编写模板,在模板中添加linklinkmeta等标签。在我们手动配置模板时,有时候需要用到一些环境变量,模板里可以获取到的变量如下:

  • htmlWebpackPlugin,特定于此插件的数据
  • webpackConfig用于此编译的webpack配置。例如它可用于获取publicPathwebpackConfig.output.publicPath
  • compilationwebpack编译对象。例如可以使用它来获取已处理资产的内容并将其直接内联到页面中compilation.assets[...].source()

举个 🌰

<link rel="icon" type="image/x-icon" href="<%= webpackConfig.output.publicPath %>favicon.png" />

除上述 html-webpack-plugin 三点之外Fes.js 还把 process.env 中的环境变量添加到模板作用域内:

  • NODE_ENV
  • FES_ENV
  • .env 文件中以 FES_APP_ 开头的变量