# @gitlab/at\.js 中文文档

规范地址：https://npmcn.com/package/%40gitlab/at.js/

版本：1\.5\.11
npm 元数据更新时间：2026-11-04T18:04:51.002Z
中文译文更新时间：2026-11-16T10:56:44.623Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gitlab/at.js
原文对照：https://npmcn.com/package/%40gitlab/at.js/?lang=original
项目主页：https://gitlab.com/gitlab-org/frontend/At.js
源码仓库：https://gitlab.com/gitlab-org/frontend/At.js

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

- 包体积（解压后）：93.9 kB，15 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 0\.6\.0
- 运行依赖：0 个
- peer 依赖：jquery \>=1\.7\.0 \<4\.0\.0
- 首次发布：2020-02-13T17:28:53.013Z
- 最新版本发布：2026-10-16T12:22:48.836Z
- 近 30 天下载量：167205（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 3 个）

## 中文简介

这是临时叉子 [https://github.com/ichord/At.js (中文(简体) )](https://github.com/ichord/At.js)。 。 。 .

## 安装

```sh
npm install @gitlab/at.js
```

也可以使用：`pnpm add @gitlab/at.js`、`yarn add @gitlab/at.js`、`bun add @gitlab/at.js`

## README

# @gitlab/at.js (英语)

这是临时叉子 [https://github.com/ichord/At.js (中文(简体) )](https://github.com/ichord/At.js)。 。 。 .

在吉特拉布,我们是 [远离 at.js](https://gitlab.com/groups/gitlab-org/-/epics/4002)但是,在极短的时间内,我们有一些 修补图书馆:

-   删除1000项的硬性限制,参见 [gitlab-org/gitlab#198650 (英语)](https://gitlab.com/gitlab-org/gitlab/-/issues/198650), (中文(简体) ), [gitlab-org/gitlab#204825 (英语)](https://gitlab.com/gitlab-org/gitlab/-/issues/204825) 财务报告和审定财务报表 [gitlab-org/gitlab@c9228f2d (中文(简体) )](https://gitlab.com/gitlab-org/gitlab/-/commit/c9228f2d291452d478b086dd0c082c482c31a43c)
-   删除一个 jQuery 动画调用, 以便移动到 jQuery smart
-   取消对 $.ajax 的支持, 以便移动到 jQuery smart

## 如何发布新版本

1.  在有变化的分行中,运行 `prepare-new-version.sh` 并遵从它的指示.

原始说明

## 通知:

**这个项目不再维持.** **你用得着 [赞美](https://github.com/zurb/tribute) 换句话说.**

* * *

**一个自动补全库 可以自动补全 提及,微笑等等 就像在Github上!**  
[![Build Status](https://travis-ci.org/ichord/At.js.png)](https://travis-ci.org/ichord/At.js)

#### 通知

现在,Js **取决于** [点.js](https://github.com/ichord/Caret.js)。 。 。 .  
请阅读 [**变动情况**](https://npmcn.com/package/%40gitlab/at.js/CHANGELOG.md) 如果您要更新到新版本,请提供更多信息.

### 演示

[http://ichord.github.com/At.js (英语)](http://ichord.github.com/At.js)

### 文档

[https://github.com/ichord/At.js/wiki 页面存档备份,存于互联网档案馆](https://github.com/ichord/At.js/wiki)

### 兼容性

-   `textarea` - Chrome、Safari、Firefox、IE7+(可能是IE6)
-   `contentEditable` - Chrome、Safari、Firefox、IE9+

### 特性预览

-   支持 IE 7+ 用于 **文本区域**。 。 。 .
-   支持 HTML5 [**内容易变**](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_Editable) 要素(NOT,包括IE8)
-   可以听任何角色,而不仅仅是"@". 可以针对不同行为和数据的不同字符设置多个听众
-   收听器事件可以被多个输入器所束缚.
-   使用模板格式化返回的数据
-   除鼠标外的键盘控制
    -   `Tab` 或者说 `Enter` 键选择值
    -   `Up` 财务报告和审定财务报表 `Down` 在数值之间导航(和 `Ctrl-P` 财务报告和审定财务报表 `Ctrl-N` 还)
    -   `Right` 财务报告和审定财务报表 `left` 将重新搜索关键词.
-   使用一组可配置回调的自定义数据处理器和模板渲染器
-   支持 AMD 软件

### 所需资源

-   j 查询 1.7.0.
-   [点.js](https://github.com/ichord/Caret.js) (你可以使用 `Component` 或者说 `Bower` 以安装. )

### 与您的应用程序合并

简单地在 HTML 中包含以下文件, 您可以走了 .

```html
<link href="css/jquery.atwho.css" rel="stylesheet">
<script src="http://code.jquery.com/jquery.js"></script>
<script src="js/jquery.caret.js"></script>
<script src="js/jquery.atwho.js"></script>
```

```javascript
$('#inputor').atwho({
    at: "@",
    data:['Peter', 'Tom', 'Anne']
})
```

#### 鲍尔组件( C)

使用 Bower 安装时可以使用 `jquery.atwho` 组件请使用 `ichord/At.js`。 。 。 .

#### 铁路

你可以把 At.js 包含在你的 `Rails` 使用宝石的应用程序 [铁路](https://github.com/ichord/jquery-atwho-rails)。 。 。 .

### 核心小组成员

-   [@ ichord (英语)](https://twitter.com/_ichord) (推特声)

## 常见问题

### @gitlab/at\.js 是什么？

这是临时叉子 https://github\.com/ichord/At\.js \(中文\(简体\) \)。 。 。 \.

### 如何安装 @gitlab/at\.js？

在项目目录运行 npm install @gitlab/at\.js，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：jquery（\>=1\.7\.0 \<4\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gitlab/at\.js 支持 TypeScript 吗？

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

### @gitlab/at\.js 支持 ESM 还是 CommonJS？

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

### @gitlab/at\.js 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 0\.6\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gitlab/at\.js 可以商用吗？

@gitlab/at\.js 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gitlab/at\.js 的下载量有多少？

根据 npm 官方下载统计，@gitlab/at\.js 在 2026/10/17 – 2026/11/15 这 30 天内被下载 167,205 次，日均约 5,574 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gitlab/at\.js 还在维护吗？

最新版本 1\.5\.11 发布于 2026/10/16（30 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 3 个；首次发布于 2020/02/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

