# CFormAgreement 表单协议组件
## 功能说明
CFormAgreement 是表单协议组件,用于在表单中提供用户协议勾选功能。组件包含勾选框和协议文本,点击协议文本可以打开浮层查看详细内容。
## 引用方式
```js
import { CFormAgreement } from '@components/forms/form';
```
## 组件参数
- `formRes` (Object,必填):表单资源对象,由 CForm 组件提供
- `protocol` (String,必填):需要同意的协议名称,如"用户协议"、"隐私政策"等
## 使用示例
### 基础用法
```html
欢迎您使用我们的服务。在使用我们的服务前,请您仔细阅读以下条款...
1. 服务条款的确认和接纳...
2. 用户信息保护...
提交
```
## 注意事项
1. CFormAgreement 组件需要在 CForm 组件内使用,并且需要传入表单资源对象 formRes
2. 组件会在表单验证时检查是否已勾选协议,未勾选时会阻止表单提交并显示提示信息
3. 协议详细内容通过默认插槽提供,会在点击协议名称时在浮层中显示
4. 组件内部使用了特殊的字段名 `$agreement` 进行验证,不会影响表单数据
5. 为了获取 formRes 对象,需要在组件挂载后从 CForm 组件实例中获取