# @aristotle-metadata-enterprises/aristotle\_tooltip 中文文档
规范地址：https://npmcn.com/package/%40aristotle-metadata-enterprises/aristotle_tooltip/
版本：1\.2\.4
npm 元数据更新时间：2022-11-25T03:09:30.628Z
中文译文更新时间：2026-11-09T23:44:46.594Z
软件包许可：BSD-3 Clause
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40aristotle-metadata-enterprises/aristotle_tooltip
原文对照：https://npmcn.com/package/%40aristotle-metadata-enterprises/aristotle_tooltip/?lang=original
项目主页：https://github.com/Aristotle-Metadata-Enterprises/aristotle-tooltip#readme
源码仓库：https://github.com/Aristotle-Metadata-Enterprises/aristotle-tooltip
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：754 kB，35 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2020-02-18T23:22:31.688Z
- 最新版本发布：2022-11-25T03:09:30.518Z
- 近 30 天下载量：1695（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 0 个）
## 中文简介
亚里士多德工具提示:将亚里士多德功能添加到任何网站!
## 安装
```sh
npm install @aristotle-metadata-enterprises/aristotle_tooltip
```
也可以使用：`pnpm add @aristotle-metadata-enterprises/aristotle_tooltip`、`yarn add @aristotle-metadata-enterprises/aristotle_tooltip`、`bun add @aristotle-metadata-enterprises/aristotle_tooltip`
## README
 
# 亚里士多德工具提示
一个高度定制和容易使用的方法 在您的网站上插入亚里士多德授权定义!
## 特征
- : havy check mark:可适应:使用任何亚里士多德元数据注册!
- : globe with meridians: IE11+ 支持 [\* 联合国](https://npmcn.com/package/%40aristotle-metadata-enterprises/aristotle_tooltip/#readme-ie11-compatibility) 数字 : 兼容99%的桌面和98%的移动用户.
- :mouse: Light:重量仅为60kb,包括图像资产.
- :dog:Dogfooded:这个库被用在我们制作的"亚里士多德注册"中. 更新保证!
## 示例
## 快速启动
### 软件包管理器
安装天平- 工具提示包 :
```console
frankie@aristotle:~$ npm i @aristotle-metadata-enterprises/aristotle_tooltip
```
在申请中,导入 `aristotle_tooltip` 模块和核心 css:
```javascript
import aristotleTooltip from '@aristotle-metadata-enterprises/aristotle_tooltip'
import 'aristotle_tooltip/dist/tooltip.css'
```
假设你用的是 Webpack, Rollup 或 Parcel 等模块捆绑器.
### 光盘N
```html
```
将脚本放在底部 ``。它必须放在您自己的脚本上,因为下面的 Tipy.js 库会添加工具提示.
### 使用量
要在您的网页上添加一个内容的工具提示 :
```html
A person is known by the company they keep
```
亚里士多德链接的自定义样式可以通过应用瞄准的 CSS 规则来设置 [_属性装饰器_](https://www.w3.org/TR/selectors/#attribute-selectors)数字 :
```css
a[data-aristotle-concept-id] {
border-bottom: 1px dotted #155799;
}
a[data-aristotle-concept-id]:hover {
text-decoration: none;
border-bottom: 1px solid #155799;
}
```
### 设置
```javascript
let options = {
'url': 'https://registry.aristotlemetadata.com',
'definitionWords': 50,
'longDefinitionWords': 75,
};
aristotleTooltip(options);
```
## 选项
| 选项 | 默认 | 解释 |
| --- | :-: | --- |
| `url` | `registry.aristotlemetadata.com` | 亚里士多德元数据登记册的 URL |
| `definitionWords` | 第50条 | 初始弹出时要显示的字数 |
| `longDefinitionWords` | 第75条 | 按下“ 见更多...” 时要显示的单词数 |
| `placement` | `bottom` | 工具提示的定位 |
| `trigger` | `mouseenter focus` | 用于触发工具提示的事件 |
| `externalLinkVisible` | `true` | 是否在元数据项名称旁边显示外部链接图标 |
| `selector` | `document.body` | 用于在此元素下创建工具提示的元素或 css 选择器, 不在此元素下的工具提示将被忽略 |
| `interactive` | `true` | 是否显示链接等交互式内容 |
## 建立发展环境
我们是一个开放源代码项目,欢迎任何新的贡献. 为了建立一个开发环境, 简单的叉出回波, 克隆它的地方 `aristotle-tooltip` 项目, 运行 :
```console
oscar@aristotle:~$ npm install
oscar@aristotle:~$ npm run build:dev
```
## IE11 兼容性
IE11 兼容性需要保证多填充.`aristotle-tooltip` 已经测试与 [ES6承诺](https://github.com/stefanpenner/es6-promise)
### ES6 承诺提供CDN
```html
```
## 常见问题
### @aristotle-metadata-enterprises/aristotle\_tooltip 是什么？
亚里士多德工具提示:将亚里士多德功能添加到任何网站\!
### 如何安装 @aristotle-metadata-enterprises/aristotle\_tooltip？
在项目目录运行 npm install @aristotle-metadata-enterprises/aristotle\_tooltip，或使用 pnpm add / yarn add / bun add。
### @aristotle-metadata-enterprises/aristotle\_tooltip 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aristotle-metadata-enterprises\_\_aristotle\_tooltip 是否存在。
### @aristotle-metadata-enterprises/aristotle\_tooltip 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。
### @aristotle-metadata-enterprises/aristotle\_tooltip 可以商用吗？
@aristotle-metadata-enterprises/aristotle\_tooltip 使用 BSD-3 Clause 许可。声明的许可为 BSD-3 Clause，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。
### @aristotle-metadata-enterprises/aristotle\_tooltip 的下载量有多少？
根据 npm 官方下载统计，@aristotle-metadata-enterprises/aristotle\_tooltip 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,695 次，日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @aristotle-metadata-enterprises/aristotle\_tooltip 还在维护吗？
最新版本 1\.2\.4 发布于 2022/11/25（3 年前）；至今共发布 11 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/02/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。