WebApp【公共组件库】@前端(For Git Submodule)
Tevin
2025-03-20 b1e987944d36275906373fcd24705f37e1909f11
_cursor.ai/plugins.doc/qrcode.doc/CQRCode.doc.md
@@ -1,53 +1,76 @@
# 二维码组件
# CQRCode 二维码组件
## 组件名称
## 功能说明
`CQRCode` - 用于生成和展示二维码的组件
该组件用于在页面中生成二维码,支持在H5环境下保存二维码图片到本地,界面简洁直观。
## 组件说明
## 引用方式
该组件用于在页面中生成二维码,支持在H5环境下保存二维码图片。
## 使用方法
```html
<CQRCode
  content="https://example.com"
  :size="200"
  :margin="2"
  :downloadable="true"
/>
```js
import { CQRCode } from '@components/plugins/qrcode';
```
## 属性说明
## 组件参数
| 属性名       | 类型    | 默认值                | 说明                      |
| ------------ | ------- | --------------------- | ------------------------- |
| content      | String  | 'http://www.aisim.cn' | 二维码内容,通常为URL地址 |
| size         | Number  | 200                   | 二维码尺寸,单位为像素    |
| margin       | Number  | 2                     | 二维码边距大小            |
| downloadable | Boolean | false                 | 是否显示"保存到手机"按钮  |
- `content` (String,默认值:'http://www.aisim.cn'):二维码内容,通常为URL地址
- `size` (Number,默认值:200):二维码尺寸,单位为像素
- `margin` (Number,默认值:2):二维码边距大小
- `downloadable` (Boolean,默认值:false):是否显示"保存到手机"按钮
## 方法说明
## 实例方法
组件无对外暴露的方法
组件没有对外暴露的实例方法
## 使用示例
### 基础用法
```html
<template>
  <view class="page">
<!-- 简单用法 -->
<CQRCode content="https://www.example.com" />
  </view>
</template>
<!-- 带保存按钮的用法 -->
<script>
import { CQRCode } from '@components/plugins/qrcode';
export default {
  components: {
    CQRCode
  }
}
</script>
```
### 带保存按钮的用法
```html
<template>
  <view class="page">
<CQRCode 
  content="https://www.example.com" 
  :size="300"
  :margin="4"
  :downloadable="true"
/>
  </view>
</template>
<script>
import { CQRCode } from '@components/plugins/qrcode';
export default {
  components: {
    CQRCode
  }
}
</script>
```
## 注意事项
1. 目前在H5环境中支持保存二维码图片到本地
2. 小程序环境下的保存功能尚未实现
- 目前在H5环境中支持保存二维码图片到本地
- 小程序环境下的保存功能尚未实现
- 二维码内容变更时会自动重新渲染