Ember Notify 开源项目教程

1. 项目介绍

Ember Notify 是一个用于在 Ember.js 应用程序中显示通知消息的开源项目。它能够轻松地将小巧的通知消息显示在应用程序的底部。Ember Notify 兼容多种前端框架，如 Zurb Foundation 6、Zurb Foundation 5、Thoughtbot Refills、Twitter Bootstrap、Semantic-UI 和 UIKit。此外，它还支持自定义消息的定位和动画效果。

2. 项目快速启动

安装

首先，确保你已经安装了 Ember CLI。然后，通过以下命令安装 Ember Notify：

ember install ember-notify

使用

在模板文件中添加 <EmberNotify /> 组件，通常放在 application.hbs 中：

{{!-- application.hbs --}}
<EmberNotify />

在控制器或组件中注入 notify 服务，并使用它来显示通知消息：

import Component from '@glimmer/component';
import { inject as service } from '@ember/service';
import { action } from '@ember/object';

export default class MyComponent extends Component {
  @service notify;

  @action
  sayHello() {
    this.notify.info('Hello there!');
  }
}

自定义

你可以通过设置 @closeAfter 属性来控制消息的显示时间：

<EmberNotify @closeAfter={{4000}} />

或者手动关闭消息：

let message = this.notify.alert('You can control how long it is displayed', { closeAfter: 10000 });
message.close();

3. 应用案例和最佳实践

案例1：表单提交成功通知

在表单提交成功后，显示一条成功通知：

import Component from '@glimmer/component';
import { inject as service } from '@ember/service';
import { action } from '@ember/object';

export default class FormComponent extends Component {
  @service notify;

  @action
  submitForm() {
    // 表单提交逻辑
    this.notify.success('表单提交成功！');
  }
}

案例2：错误处理通知

在 API 请求失败时，显示一条错误通知：

import Component from '@glimmer/component';
import { inject as service } from '@ember/service';
import { action } from '@ember/object';

export default class ApiComponent extends Component {
  @service notify;

  @action
  async fetchData() {
    try {
      // API 请求逻辑
    } catch (error) {
      this.notify.error('请求失败，请稍后再试。');
    }
  }
}

最佳实践

1. 统一管理通知：在应用中统一管理通知逻辑，避免在多个地方重复代码。
2. 自定义样式：根据项目需求自定义通知的样式和动画效果，提升用户体验。
3. 国际化支持：在多语言应用中，确保通知消息支持国际化。

4. 典型生态项目

Ember CLI

Ember CLI 是 Ember.js 的命令行工具，用于生成项目结构、管理依赖和运行开发服务器。Ember Notify 作为 Ember CLI 的一个插件，能够无缝集成到 Ember 项目中。

Ember Data

Ember Data 是 Ember.js 的官方数据管理库，用于与后端 API 进行交互。结合 Ember Notify，可以在数据操作成功或失败时显示相应的通知消息。

Ember FastBoot

Ember FastBoot 允许你在服务器端渲染 Ember.js 应用程序，提升首屏加载速度。Ember Notify 可以在客户端和服务器端无缝工作，确保通知功能在不同环境下的一致性。

通过以上模块的介绍，你应该能够快速上手并使用 Ember Notify 在你的 Ember.js 项目中实现通知功能。