# @enact/spotlight 中文文档

规范地址：https://npmcn.com/package/%40enact/spotlight/

版本：5\.6\.0
npm 元数据更新时间：2026-09-02T04:58:42.332Z
中文译文更新时间：2026-11-13T16:27:23.998Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40enact/spotlight
原文对照：https://npmcn.com/package/%40enact/spotlight/?lang=original
项目主页：https://enactjs.com/
源码仓库：https://github.com/enactjs/enact

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

- 包体积（解压后）：468 kB，51 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- 首次发布：2016-10-19T20:44:14.297Z
- 最新版本发布：2026-09-02T04:58:42.155Z
- 近 30 天下载量：27376（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：241（近 12 个月 9 个）

## 中文简介

重点管理图书馆

## 安装

```sh
npm install @enact/spotlight
```

也可以使用：`pnpm add @enact/spotlight`、`yarn add @enact/spotlight`、`bun add @enact/spotlight`

## README

# @ 启用/ 点亮 [![npm (scoped)](https://img.shields.io/npm/v/@enact/spotlight.svg?style=flat-square)](https://www.npmjs.com/package/@enact/spotlight)

> 用于5道导航和焦点控制的可扩展库.

可扩展的用户导航工具 使用键盘或电视遥控器的应用程序。 对投入的回应 从 **起来**, (中文(简体) ), **下来**, (中文(简体) ), **左侧**, (中文(简体) ), **对**,以及 **回归** 键,焦点 提供一种导航经验,可以比 电脑与mouse.

## 使用量

```
import kind from '@enact/core/kind';
import SpotlightRootDecorator from '@enact/spotlight/SpotlightRootDecorator'
import Spottable from '@enact/spotlight/Spottable'

const MySpottableComponent = Spottable('div');

const MyApp = kind({
    name: 'MyApp',
    render: () => (<MySpottableComponent>Hello, Enact!</MySpottableComponent>)
});
const MySpotlightApp = SpotlightRootDecorator(MyApp);

export default MySpotlightApp;
```

见 [文档](https://npmcn.com/package/%40enact/spotlight/docs/) 更多信息.

## 补充资料

使用时 `@enact/sandstone`,则 `SpotlightRootDecorator` 自动应用 `@enact/sandstone/ThemeDecorator`。 。 。 .

## 承认

聚光灯基于一个叉 [JavaScript 空间导航](https://github.com/luke-chang/js-spatial-navigation) (c) 2016年Luke Chang, 根据 [Mozilla 公共许可证](https://www.mozilla.org/en-US/MPL/2.0/)。 。 。 .

## 版权和许可证信息

除非另有说明,所有内容,包括所有源代码文件和 该仓库中的文档文件有:

版权 (c) 2012-2024 LG 电子

除非在NOTICE文件中另有说明或规定,所有内容, 包括此寄存器中的所有源代码文件和文档文件为: 根据Apache许可证第2.0版("License"); 除非符合许可证,否则您不得使用此内容. 您可在下列地点获得许可证副本:

[http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )](http://www.apache.org/licenses/LICENSE-2.0)

除非适用的法律要求或书面同意,否则软件 根据许可证发放的是在“AS IS”BASIS上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.

## 常见问题

### @enact/spotlight 是什么？

重点管理图书馆

### 如何安装 @enact/spotlight？

在项目目录运行 npm install @enact/spotlight，或使用 pnpm add / yarn add / bun add。

### @enact/spotlight 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @enact/spotlight 支持 ESM 还是 CommonJS？

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

### @enact/spotlight 可以商用吗？

@enact/spotlight 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @enact/spotlight 的下载量有多少？

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

### @enact/spotlight 还在维护吗？

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