# CloudCC 自定义 HTML 组件能力说明

## 1. 什么是自定义 HTML 组件

自定义 HTML 组件是由开发者维护的单入口 HTML 页面能力，适合承载轻量、独立、可嵌入的前端页面。

它不同于自定义 Vue 组件：

- 自定义 HTML 组件以单个 HTML 内容为核心。
- 页面内可以引用外部 JS、CSS、图片、字体等静态资源。
- 发布后平台会生成可访问路径，并可通过自定义页面或 iframe 组件挂载到 CloudCC 页面体系中。

## 2. 适用场景

自定义 HTML 组件适合以下场景：

- 嵌入轻量工具页、说明页、数据看板或外部系统桥接页。
- 快速迁移已有 HTML 页面，降低组件化改造成本。
- 使用平台静态资源或线上 CDN 组织前端依赖。
- 需要通过 `$CCDK` 与 CloudCC 页面上下文或自定义类交互的轻量页面。

## 3. 能力边界

- 入口建议保持为单个 `index.html`。
- 复杂样式、脚本和图片应通过线上 URL 或 CloudCC 静态资源引用。
- 页面中调用 CloudCC 能力时，应显式判断 `$CCDK` 是否存在，避免本地预览时报错。
- 删除 HTML 组件前，应确认菜单、自定义页面或其他入口不再依赖该组件。

## 4. 与周边模块关系

- 与自定义页面：HTML 组件可通过自定义页面承载并暴露给用户访问。
- 与自定义 Vue 组件：HTML 组件可通过内置 iframe 类组件挂载到页面中。
- 与静态资源：HTML 页面依赖的本地资源可先上传为静态资源，再使用静态资源 URL 引用。
- 与自定义类：页面可通过 `$CCDK.CCCommon.post` 调用服务端自定义类。