# @adobe/cq-spa-page-model-manager 中文文档

规范地址：https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/

版本：1\.1\.7
npm 元数据更新时间：2026-10-01T01:33:04.010Z
中文译文更新时间：2026-11-06T04:23:48.793Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40adobe/cq-spa-page-model-manager
原文对照：https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/?lang=original
项目主页：https://www.adobe.com/go/aem6_4_docs_spa_en
源码仓库：https://git.corp.adobe.com/CQ/spa-page-model-manager

弃用说明：Package has been renamed\. Please use @adobe/aem-spa-page-model-manager

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

- 包体积（解压后）：264 kB，32 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2018-04-17T13:29:43.191Z
- 最新版本发布：2020-08-31T08:20:50.187Z
- 近 30 天下载量：5171（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 0 个）

## 中文简介

-   [安装](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#description-installation) \* 联合国 [使用量](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#description-usage) \* 联合国 [API 密码](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#description-api) \* 联合国 [文档](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#description-documentation) \* 联合国 [更改日志](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#description-changelog)

## 安装

```sh
npm install @adobe/cq-spa-page-model-manager
```

也可以使用：`pnpm add @adobe/cq-spa-page-model-manager`、`yarn add @adobe/cq-spa-page-model-manager`、`bun add @adobe/cq-spa-page-model-manager`

## README

# 目录

-   [安装](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#readme-installation)
-   [使用量](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#readme-usage)
-   [API 密码](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#readme-api)
-   [文档](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#readme-documentation)
-   [更改日志](https://npmcn.com/package/%40adobe/cq-spa-page-model-manager/#readme-changelog)

# 套件已经贬值

包裹已经搬走了。 请使用 [@adobe/aem-spa-模范管理者](https://www.npmjs.com/package/@adobe/aem-spa-page-model-manager)

## 安装

```
npm install @adobe/cq-spa-page-model-manager
```

## 使用量

这个模块提供了API,用于管理组成SPA的页面的模型显示.

```
// index.html

<head>
...
    <meta property="cq:pagemodel_root_url" content="... .model.json"/>
...
</head>
...

// Bootstrap: index.js
import { ModelManager } from '@adobe/cq-spa-page-model-manager';

ModelManager.initialize().then((model) => {
    // Render the App content using the provided model
    render(model);
});

// Loading a specific portion of model
ModelManager.getData("/content/site/page/jcr:content/path/to/component").then(...); 
```

## API 密码

### [@adobe/cq-spa-page-model-manager (英语)](https://www.adobe.com/go/aem6_4_docs_spa_en) _1.1.7 联合国_

## 文档

这个 [技术文件](https://www.adobe.com/go/aem6_4_docs_spa_en) 已经可用,但如果您无法解决您的问题或找到一个错误,您总是可以 [联系我们](https://www.adobe.com/go/aem6_4_support_en) 并请求帮助!

## 更改日志

### _1.1.5 国家_ - 2020年8月24日,纽约

### _1.1.4 国家_ - 2020年8月24日,纽约

-   重新命名软件包,请使用 **[aem-spa-page-model-manager@1.0.0 (英语)](mailto:aem-spa-page-model-manager@1.0.0)**

### _1.1.3 国家_ - 2020年6月5日 (中文(简体) )

-   支持启动内容路径

### _1.1.2 国家_ - 2020年5月19日,纽约

-   在模型管理器初始化时不获取排除的路径

### _1.1.1 (中文(简体) )_ - 2020年1月17日,日内瓦

-   固定 :
    -   包含查询参数的链接上的页面崩溃,而不包含 html 扩展名

### _1.1.0 国家_ - 2019年12月19日 (中文(简体) )

-   改进 URL 消毒行为 `model.json` 请求
-   制作 `clone` 依赖性而不是同伴依赖性
-   删除可选的依赖性

### _1.0.7 国家_ - 2019年4月4日 (中文(简体) )

-   无函数变化

### _1.0.6 (中文(简体) )_ - 2019年3月6日 (中文(简体) )

-   ModelManager# 初始化以一致返回同类对象
-   ModelManager# 启动以启动一个 cq- page 模式装入的事件

### _1.0.5 (简体中文)_ - 2018年12月12日 (中文(简体) )

-   ModelClient 获取: 为请求添加默认证书

### _1.0.4 国家_ - 2018年11月9日(中文(简体) )

-   支持从 ModelStore 获取数据时结束 jcr: 内容

### _1.0.3 (中文(简体) )_ - 2018年10月11日),字相会

-   未找到的远程模式入站拒绝处理
-   README 更新

### _1.0.1 (中文(简体) )_ - 2018年9月28日 (中文(简体) )

-   **破坏变化** API 重构一个更好的模块化
-   **破坏变化** 安全部门改革重构
    -   添加对设置 apiHost 的支持, 以强制在节点服务器上提交绝对 URL 请求
    -   增加了对现有模型初始化的支持. 当我们在客户端中初始化,从服务器中初始化状态时,这个功能是有用的.
    -   仅在浏览器上下文中守护发送并监听事件( L) .
    -   固定的种族条件 `init` 调用时的方法 `getData`

### 删除

-   引发不必要的误导事件,导致页面编辑器没有重叠

## 0.024 - 2018年6月22日 (中文(简体) )

公开发布 `cq-spa-page-model-manager`,其中规定:

-   对上下文路径的支持
-   **破坏变化** 更改路由方法以默认支持历史 API( hash 路由支持已被删除)

## 0.023 - 2018年5月15日 (中文(简体) )

公开发布 `cq-spa-page-model-manager`,其中规定:

-   对最新版本的支持 `com.adobe.cq.export.json.hierarchy` API 密码
    -   支助和使用 `:path` 财务报告和审定财务报表 `:children` 字段以识别页面及其子页
-   支持包含上下文路径的 URL
    -   这个 `PageModelManager` 现在可以和URL一起使用,包括上下文路径

## 0.022 - 2018年4月20日 (中文(简体) )

首次公开发布 `cq-spa-page-model-manager`,其中规定:

-   更新 `PageModelManager` API,现在可以管理存储在AEM中的多页模式:
    -   `getData()`, (中文(简体) ), `addListeners()` 财务报告和审定财务报表 `removeListeners()` 需要一个配置参数来指定 `pagePath` 财务报告和审定财务报表 `dataPath`
    -   `getData()` 支持 a `forceReload` 参数
    -   `cq-pagemodel-update` 事件听众期望 `pagePath` 财务报告和审定财务报表 `dataPath` 数据对象
-   新设 `ModelRouter`,它与散列变化反应,并同步触发相应模型的重载
    -   `cq-pagemodel-route-changed` 成功更新模型后的事件表示路由变化

## 常见问题

### @adobe/cq-spa-page-model-manager 是什么？

安装 \* 联合国 使用量 \* 联合国 API 密码 \* 联合国 文档 \* 联合国 更改日志注意：该包已被作者标记为弃用——Package has been renamed\. Please use @adobe/aem-spa-page-model-manager

### 如何安装 @adobe/cq-spa-page-model-manager？

在项目目录运行 npm install @adobe/cq-spa-page-model-manager，或使用 pnpm add / yarn add / bun add。

### @adobe/cq-spa-page-model-manager 支持 TypeScript 吗？

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

### @adobe/cq-spa-page-model-manager 支持 ESM 还是 CommonJS？

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

### @adobe/cq-spa-page-model-manager 可以商用吗？

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

### @adobe/cq-spa-page-model-manager 的下载量有多少？

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

### @adobe/cq-spa-page-model-manager 还在维护吗？

最新版本 1\.1\.7 发布于 2020/08/31（6 年前）；至今共发布 28 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/04/17。作者已将其标记为弃用，新项目建议寻找替代方案。