# @cgross/angular-notify 中文文档

规范地址：https://npmcn.com/package/%40cgross/angular-notify/

版本：2\.5\.1
npm 元数据更新时间：2022-06-12T15:48:09.892Z
中文译文更新时间：2026-11-09T09:07:58.356Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cgross/angular-notify
原文对照：https://npmcn.com/package/%40cgross/angular-notify/?lang=original
项目主页：https://github.com/cgross/angular-notify#readme
源码仓库：https://github.com/cgross/angular-notify

## 关键信息（来自 npm 元数据）

- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2017-01-05T22:14:40.612Z
- 最新版本发布：2017-01-05T22:14:40.612Z
- 近 30 天下载量：6271（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

角质的最小化通知服务.

## 安装

```sh
npm install @cgross/angular-notify
```

也可以使用：`pnpm add @cgross/angular-notify`、`yarn add @cgross/angular-notify`、`bun add @cgross/angular-notify`

## README

\# 直线通知

> 角质的最小(可扩展)通知服务.

[现场直播](http://cgross.github.io/angular-notify/demo/)

支持IE 10,以及最新版本的FF和Chrome.

## 开始

用 Bower 安装或从 repo 中的 dist 文件夹直接下载文件 .

```bash
bower install angular-notify --save
```

添加 `dist/angular-notify.js` 财务报告和审定财务报表 `dist/angular-notify.css` 到您的索引.html.

添加 `cgNotify` 作为您模块的模块依赖.

```js
angular.module('your_app', ['cgNotify']);
```

然后注射并使用 `notify` 服务.

```js
function myController($scope,notify){  // <-- Inject notify

  notify('Your notification message'); // <-- Call notify with your message

  notify({ message:'My message', templateUrl:'my_template.html'} );

}
```

## 选项

### 通知(String X对象)

这个 `notify` 函数可以传递字符串或对象。 在通过对象时,对象参数可以是:

-   `message` -必须的 示现之旨.
-   `duration` -可选的 信息的持续时间(以毫秒计). 持续时间为0会防止消息自动关闭.
-   `templateUrl` -可选的 消息 UI 的自定义模板 .
-   `classes` -可选的 用于信件元素的自定义 CSS 类列表 .
-   `messageTemplate` -可选的 包含任何有效角 HTML 的字符串,该字符串将显示而非正则 `message` 语句。 字符串必须包含一个根元素, 如所有有效的 Angular HTML 模板( 所以将所有内容包入 `<span>`) (中文(简体) ).
-   `scope` -可选的 有效的角范围对象 。 模板的范围将通过调用创建 `$new()` 这个范围.
-   `position` -可选的. `center`, (中文(简体) ), `left` 财务报告和审定财务报表 `right` 是唯一可接受的价值.
-   `container` -可选的 包含每份通知的内容。 默认为 `document.body`。 。 。 .

此函数将返回带有一个 `close()` 方法和a `message` 属性.

### 通知.config(对象)

打电话 `config` 设置用于角化的默认配置选项。 在特定对象中可以指定以下选项:

-   `duration` - 每个信件的默认持续时间(毫秒)。 持续时间为0会防止消息自动关闭.
-   `startTop` - 显示信件的 Y 像素值.
-   `verticalSpacing` - 垂直保留信件之间的像素数量.
-   `templateUrl` - 默认消息模板.
-   `position` - 每个信件的默认位置. `center`, (中文(简体) ), `left` 财务报告和审定财务报表 `right` 是支持的值.
-   `container` - 包含每份通知的默认要素。 默认为 `document.body`。 。 。 .
-   `maximumOpen` - 一次性可见到的通知总数上限。 过期的通知在达到最大时会关闭.

### 页:1

关闭所有当前打开的通知.

## 提供自定义模板

Angular-notify带有非常简单的默认通知模板. 鼓励您创建适合您的应用程序的模板和样式。 模板还可以包含更高级的功能,如按钮或链接等. 信件模板是全角部分,具有范围(以及如果使用控制器) `ng-controller="YourCtrl"`) (中文(简体) ).

部分范围将来自 `$rootScope` 或定义的范围 `notify({...})` 选项。 模板范围将增加一个 `$message` 财产,a `$classes` 财产和特殊财产 `$close()` 用于关闭通知的函数.

这个 `messageTemplate` 属性也作为 `$messageTemplate`。以确保您的自定义模板与 `messageTemplate` 选项,如果 `$messageTemplate` 包含一个值,并应当与 `cg-notify-message-template` 课。 带有 `cg-notify-message-template` 类将自动附上汇编的模板.

## 释放历史

-   v2.5.0 - 2015年12月4日 (中文(简体) )
    -   新设 `duration` 每项通知的财产.
    -   新设 `position` 每项通知的财产.
    -   为 DOM 元素修复, 不被移除 .
    -   新设 `maximumOpen` 配置选项 .
    -   起起角依赖为1.3.
-   页:1
    -   默认模板重新设计后带有"靴子"外观和感觉. 默认模板现在也包含一个关闭按钮.
    -   默认信件位置现在是顶端中心 .
    -   默认消息持续时间现在是10秒.
    -   默认垂直间距现在是15px.
    -   这个 `template` 选项已更名为 `templateUrl`。 。 。 .
    -   新设 `messageTemplate` 选项添加.
    -   新设 `classes` 选项添加.
    -   解决了一个问题,导致将多行文字的信息放在可见区域太快.
    -   固定 # 4 (配置( ) 不正确设置启动Top)
-   v1.1.0 - 5/18/2014 - 增加返回值,以便关闭和更新信件.
-   v1.0.0-4/16/2014 -- -- 重大重构.
-   JQuery 不再是必需的依赖.
-   \[生平变化. 使用默认模板配置 `config()` 现在,而不是 `cgNotifyTemplate` 数值.
-   \[生平变化. 这个 `verticalSpacing` 参数不应再包括通知要素的高度.
-   \[生平变化. 这个 `scope` 选项现在必须是有效的角范围.
-   \[生平变化. 通知的有效期现以下列日期为准: `duration` 配置属性,不依赖 CSS 过渡的延迟属性.
-   如果您使用一个 `max-width` css 值。 (简体中文).
-   模板的范围现在包括a `$close()` 函数.
-   新设 `notify.closeAll()` 方法.
-   v0.2.0 - 添加自定义模板能力,固定FF bug.
-   v0.1.0 - 初释.

## 常见问题

### @cgross/angular-notify 是什么？

角质的最小化通知服务\.

### 如何安装 @cgross/angular-notify？

在项目目录运行 npm install @cgross/angular-notify，或使用 pnpm add / yarn add / bun add。

### @cgross/angular-notify 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cgross\_\_angular-notify 是否存在。

### @cgross/angular-notify 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cgross/angular-notify 可以商用吗？

@cgross/angular-notify 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cgross/angular-notify 的下载量有多少？

根据 npm 官方下载统计，@cgross/angular-notify 在 2026/10/10 – 2026/11/08 这 30 天内被下载 6,271 次，日均约 209 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cgross/angular-notify 还在维护吗？

最新版本 2\.5\.1 发布于 2017/01/06（9 年前）；至今共发布 1 个版本，其中过去 12 个月发布了 0 个；首次发布于 2017/01/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。