安装 - Mithril 中文文档，中文教程

CDN

直接从 CDN 引入 Mithril 文件是最简单的方式：

<script src="https://unpkg.com/mithril/mithril.js"></script>

NPM

对于生产级项目，建议使用 NPM 来安装。在使用 NPM 之前你需要自行安装好 Node.js。

在命令行中进入项目文件夹，执行以下命令来初始化项目：

npm init --yes

然后执行命令来安装 Mithril：

npm install mithril --save

现在已经完成了 Mithril 的安装。

模块化

模块化是指把代码拆分到多个文件中。这样可以更好的组织代码，便于理解代码之间的依赖关系，并方便测试。

我们使用 Webpack 来打包模块。在命令行中执行以下命令来安装 Webpack：

npm install webpack --save-dev

然后打开项目文件夹下的 package.json 文件，在 script 中添加一行指令：

{
    "name": "my-project",
    "scripts": {
        "start": "webpack src/index.js bin/app.js -d --watch"
    }
}

指令中的 -d 表示使用开发模式，该模式会生成 source maps，便于调试。--watch 表示监控文件系统，在检测到文件更改后，自动重新创建 app.js。

现在可以在命令行中执行 npm start 来执行该脚本了：

npm start

执行完脚本后便创建了 bin/app.js 文件，你可以在 HTML 中引入该文件：

<html>
  <head>
    <title>Hello world</title>
  </head>
  <body>
    <script src="bin/app.js"></script>
  </body>
</html>

模块的导入导出

要导出一个模块，请将要导出的内容分配到 module.exports 对象：

module.exports = {
    view: function() {return "hello from a module"}
}

我们使用 require 函数来导入模块。

你可以通过库名来导入 NPM 模块（例如：require("mithril") 或 require("jquery")）；也可以通过去掉了文件扩展名的文件相对路径来导入你自己的模块（例如：require("./mycomponent")）。

在 index.js 文件中，通过下列代码来导入模块：

var m = require("mithril")

var MyComponent = require("./mycomponent")

m.mount(document.body, MyComponent)

生产环境构建

bin/app.js 文件中的代码没有压缩，不适宜用在生产环境。要生成压缩后的文件，可以在 package.json 文件中添加一个新的 npm 脚本：

{
    "name": "my-project",
    "scripts": {
        "start": "webpack src/index.js bin/app.js -d --watch",
        "build": "webpack src/index.js bin/app.js -p",
    }
}

在生产环境中，可以使用钩子来自动运行构建脚本。下面是一个 Heroku 的例子：

{
    "name": "my-project",
    "scripts": {
        "start": "webpack -d --watch",
        "build": "webpack -p",
        "heroku-postbuild": "webpack -p"
    }
}

其他相关介绍

开发环境的 live reload

Live reload 是指在代码发生更改后自动刷新页面的功能。Budo 是一个启用实时刷新的工具。

# 1) 安装
npm install mithril --save
npm install budo -g

# 2) 在 package.json 文件的 scripts 中加入这一行
#    "scripts": {
#        "start": "budo --live --open index.js"
#    }

# 3) 创建一个 `index.js` 文件

# 4) 运行 budo
npm start

启动后，源文件 index.js 会被编译，并在浏览器中打开该文件。当源文件发生任何更改时，都会重新编译，并刷新浏览器。

Mithril bundler

Mithril 自带一个打包工具。对于基于 ES5、除了 Mithril 之外没有其他依赖的项目来说，它足够用了；但对于有其他 NPM 依赖的项目来说，它目前还是实验性的。它生成的包比 webpack 要小，但目前不要在生产环境中使用它。

如果你想要试用它，可以打开 package.json 文件，并把 webpack 的 npm 脚本替换为：

{
    "name": "my-project",
    "scripts": {
        "build": "bundle index.js --output app.js --watch"
    }
}

Vanilla

如果因为某些原因无法运行 bundler 脚本，则可以选择不使用模块化系统：

<html>
  <head>
    <title>Hello world</title>
  </head>
  <body>
    <script src="https://cdn.rawgit.com/lhorie/mithril.js/rewrite/mithril.js"></script>
    <script src="index.js"></script>
  </body>
</html>

// 如果未检测到模块化环境，则 Mithril 会被创建在全局作用域
m.render(document.body, "hello world")