# CloudCC 客户端脚本介绍

客户端脚本是在 CloudCC
前端页面（如列表页、新建/编辑页、详情页、全局页面）特定事件时机执行的一段
JavaScript。它依托 `$CCDK`
的桥接能力，在不改造核心系统代码的前提下，快速实现页面行为和交互的业务化定制。

## 能干什么

- 在页面加载、字段变更、保存前后等时机执行自定义逻辑
- 控制字段显隐、只读、禁用、默认值与展示顺序
- 基于页面元素 `devid` 做精确的 DOM 调整（隐藏、移动、样式优化等）
- 增加消息提示、前端校验、轻量自动化处理
- 对不同页面类型配置不同脚本，实现同对象的差异化行为

## 主要作用

- 让业务规则更贴近一线使用场景，而不是被标准页面能力限制
- 用小成本实现高频、细粒度的前端需求调整
- 缩短需求交付周期，降低“等待版本发版”带来的响应延迟

## 为什么要用

- 标准配置无法覆盖所有业务细节，尤其是页面行为层面的动态需求
- 某些需求只在特定页面、特定角色、特定时机触发，客户端脚本更灵活
- 相比重型开发方式（完整自定义组件/页面），客户端脚本更轻量、迭代更快

## 能解决哪些问题

- 保存前做字段联动与数据校验，减少脏数据入库
- 详情页按业务需要隐藏敏感信息或弱化无关字段
- 编辑页限制关键字段误操作（禁用或只读）
- 按流程阶段动态调整页面交互，减少用户操作路径和学习成本
- 对标准页面做局部增强，而不影响系统其他模块

## 在什么情况下使用

- 需求是“前端页面行为增强”，且改动范围集中在单页或少量页面
- 需要快速上线验证，后续可能持续迭代优化
- 需要利用页面事件（如 `onLoad`、`beforeSave`、`onChange`）挂载业务逻辑
- 希望复用 CloudCC 现有页面能力，不希望引入过重改造

## 典型业务场景

- 销售管理：编辑客户时按客户等级控制字段可编辑范围
- 服务管理：详情页按服务阶段动态显示关键指标字段
- 线索管理：保存前自动补齐或校验必填业务字段
- 渠道管理：列表页加载后增加提示与辅助标识，帮助快速筛选和处理