# QRCode
用于显示单个二维码的组件。
> **说明：**
>
> 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
>
> 二维码组件的像素点数量与内容有关，组件尺寸过小可能导致内容无法展示，此时需要适当调整组件尺寸。
## 子组件
无
## 接口
QRCode(value: ResourceStr)
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | [ResourceStr](ts-types.md#resourcestr) | 是 | 二维码内容字符串。最大支持512个字符，若超出，则截取前512个字符。
从API version 20开始，支持Resource类型。
**说明：**
该字符串内容必须有效，不支持null、undefined以及空内容，当传入上述内容时，将生成无效二维码。 |
## 属性
除支持[通用属性](ts-component-general-attributes.md)外，还支持以下属性：
### color
color(value: ResourceColor)
设置二维码颜色。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------------ | ---- | ------------ |
| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 二维码颜色。默认值：'#ff000000'，且不跟随系统深浅色模式切换而修改。
|
### backgroundColor
backgroundColor(value: ResourceColor)
设置二维码背景颜色。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------------ | ---- | ------------------------------------------------------------ |
| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 二维码背景颜色。
默认值：Color.White
从API version 11开始，默认值改为'#ffffffff'，且不跟随系统深浅色模式切换而修改。 |
### contentOpacity11+
contentOpacity(value: number | Resource)
设置二维码内容颜色的不透明度。不透明度最小值为0，最大值为1。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------- | ---- | ---------------------------------------- |
| value | number \| [Resource](ts-types.md#resource) | 是 | 二维码内容颜色的不透明度。
默认值：1
取值范围：[0, 1]，超出取值范围按默认值处理。 |
## 事件
通用事件支持[点击事件](ts-universal-events-click.md)、[触摸事件](ts-universal-events-touch.md)和[挂载卸载事件](ts-universal-events-show-hide.md)。
## 示例
### 示例1（设置颜色、背景颜色、不透明度）
该示例展示了QRCode组件的基本使用方法，通过[color](#color)属性设置二维码颜色、[backgroundColor](#backgroundcolor)属性设置二维码背景颜色、[contentOpacity](#contentopacity11)属性设置二维码不透明度。
```ts
// xxx.ets
@Entry
@Component
struct QRCodeExample {
private value: string = 'hello world';
build() {
Column({ space: 5 }) {
Text('normal').fontSize(9).width('90%').fontColor(0xCCCCCC).fontSize(30)
QRCode(this.value).width(140).height(140)
// 设置二维码颜色
Text('color').fontSize(9).width('90%').fontColor(0xCCCCCC).fontSize(30)
QRCode(this.value).color(0xF7CE00).width(140).height(140)
// 设置二维码背景色
Text('backgroundColor').fontSize(9).width('90%').fontColor(0xCCCCCC).fontSize(30)
QRCode(this.value).width(140).height(140).backgroundColor(Color.Orange)
// 设置二维码不透明度
Text('contentOpacity').fontSize(9).width('90%').fontColor(0xCCCCCC).fontSize(30)
QRCode(this.value).width(140).height(140).color(Color.Black).contentOpacity(0.1)
}.width('100%').margin({ top: 5 })
}
}
```
### 示例2（设置背景颜色为透明）
该示例通过[backgroundColor](#backgroundcolor)属性设置二维码背景颜色为透明，从而实现二维码内容与背景融合。
```ts
// xxx.ets
@Entry
@Component
struct QRCodeExample {
private value: string = 'hello world';
build() {
Column({ space: 5 }) {
RelativeContainer() {
// $r('app.media.ocean')需要替换为开发者所需的图像资源文件。
Image($r('app.media.ocean'))
// 设置二维码背景色为透明
QRCode(this.value).width(200).height(200).backgroundColor("#00ffffff")
}.width(200).height(200)
}.width('100%').margin({ top: 5 })
}
}
```
