Indexability
A Lit controller for mapping items to the elements that render them through one directive, the base other controllers build on.
Installation
npm install @3mo/indexability
import { IndexabilityController } from '@3mo/indexability'
Examples
- Default —
items answers in declared order, the order the owner reads its data in; click an item to resolve it with itemAt.
- Scrambled Dom Order — The same items rendered back to front: their document position changed, the answer did not.
- Nested Items — An item nested inside another resolves to itself, as the path is scanned nearest first, so a compound item can carry sub-items.
- Several Registries Across Shadow Roots — Two registries on one host, whose cards each sit in their own shadow root.
API
Exports
| Name | Kind | Description |
|---|
IndexabilityController | class | Tracks which elements currently render which items. |
IndexabilityObserver | interface | Notified as the registry changes. |
Links
License
MIT © 3MO GmbH
关于 @3mo/indexability 的常见问题
@3mo/indexability 是什么？
A Lit controller for mapping items to the elements that render them through one directive, the base other controllers build on.
如何安装 @3mo/indexability？
在项目目录运行 npm install @3mo/indexability，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@a11d/lit（>=0.13.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@3mo/indexability 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@3mo/indexability 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@3mo/indexability 可以商用吗？
@3mo/indexability 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@3mo/indexability 的下载量有多少？
根据 npm 官方下载统计，@3mo/indexability 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,986 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@3mo/indexability 还在维护吗？
最新版本 0.3.1 发布于 2026/09/28（1 个月前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/08/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。