Ember.js 技术文档

1. 安装指南

1.1 安装 Node.js

在安装 Ember.js 之前，请确保你已经安装了 Node.js。你可以通过以下命令检查是否已安装 Node.js：

node -v

如果没有安装，请访问 Node.js 官网 下载并安装最新版本的 Node.js。

1.2 安装 Ember CLI

Ember CLI 是 Ember.js 的命令行工具，用于创建和管理 Ember 项目。你可以通过 npm 安装 Ember CLI：

npm install -g ember-cli

安装完成后，你可以通过以下命令检查 Ember CLI 是否安装成功：

ember -v

2. 项目的使用说明

2.1 创建新项目

使用 Ember CLI 创建一个新的 Ember 项目：

ember new my-app

这将创建一个名为 my-app 的新目录，并在其中初始化一个 Ember 项目。

2.2 启动开发服务器

进入项目目录并启动开发服务器：

cd my-app
ember serve

默认情况下，开发服务器会在 http://localhost:4200 上运行。你可以通过浏览器访问该地址来查看你的应用。

2.3 添加新组件

你可以使用 Ember CLI 添加新的组件：

ember generate component my-component

这将生成一个名为 my-component 的组件，并在 app/components 目录下创建相应的文件。

2.4 添加新路由

你可以使用 Ember CLI 添加新的路由：

ember generate route my-route

这将生成一个名为 my-route 的路由，并在 app/routes 和 app/templates 目录下创建相应的文件。

3. 项目API使用文档

3.1 路由 API

Ember 的路由系统允许你定义应用的不同页面和状态。以下是一些常用的路由 API：

• this.route('name', { path: '/path' });：定义一个名为 name 的路由，并指定其路径为 /path。
• this.route('name', { path: '/path' }, function() { ... });：定义一个嵌套路由。
• this.route('name', { resetNamespace: true });：重置命名空间。

3.2 组件 API

Ember 组件是构建用户界面的基本单元。以下是一些常用的组件 API：

• {{yield}}：在组件模板中定义内容块。
• {{action 'name' arg1 arg2}}：定义一个动作，并传递参数。
• {{input value=name}}：创建一个输入框，并绑定到 name 属性。

3.3 数据层 API

Ember Data 是 Ember 的默认数据管理工具。以下是一些常用的 Ember Data API：

• store.findRecord('model', id)：根据模型名称和 ID 查找单个记录。
• store.findAll('model')：查找所有指定模型的记录。
• store.createRecord('model', attributes)：创建一个新的模型记录。

4. 项目安装方式

4.1 通过 npm 安装

你可以通过 npm 安装 Ember.js：

npm install ember-source

4.2 通过 yarn 安装

你也可以通过 yarn 安装 Ember.js：

yarn add ember-source

4.3 通过 CDN 引入

如果你不想通过 npm 或 yarn 安装，你可以通过 CDN 引入 Ember.js：

<script src="https://cdn.jsdelivr.net/npm/ember-source@latest/dist/ember.min.js"></script>

通过以上步骤，你应该能够成功安装并使用 Ember.js 来构建你的 Web 应用。