diff --git a/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md b/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md index 7bb1d206accb870f151925a32a91c969adfc7ea6..ccb23cf1506e9dc6dd7b78add0d96c00589f9554 100644 --- a/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md +++ b/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md @@ -39,6 +39,7 @@ - [多态样式](ts-universal-attributes-polymorphic-style.md) - [分布式迁移标识](ts-universal-attributes-restoreId.md) - [前景色设置](ts-universal-attributes-foreground-color.md) + - [组件内容模糊](ts-universal-attributes-foreground-blur-style.md) - [点击回弹](ts-universal-attributes-click-effect.md) - 触摸交互控制 - [触摸热区设置](ts-universal-attributes-touch-target.md) diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_foreground_blur_style.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_foreground_blur_style.png new file mode 100644 index 0000000000000000000000000000000000000000..ea0a08e6503508d78d1ebe01a5b7e8bce57bb3a0 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_foreground_blur_style.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-foreground-blur-style.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-foreground-blur-style.md new file mode 100644 index 0000000000000000000000000000000000000000..219a0aee3cb93a6516661e7d46bc2512e8bdccc5 --- /dev/null +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-foreground-blur-style.md @@ -0,0 +1,45 @@ +# 组件内容模糊 + +为当前组件添加内容模糊效果。 + +> **说明:** +> +> 从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 + +## 属性 +| 名称 | 参数类型 | 描述 | +| -------- | -------- | -------- | +| foregroundBlurStyle | value:[BlurStyle](ts-appendix-enums.md#blurstyle9),
options?:[ForegroundBlurStyleOptions](#foregroundblurstyleoptions10对象说明) | 为当前组件提供内容模糊能力。
value: 内容模糊样式。模糊样式由模糊半径、蒙版颜色、蒙版透明度、饱和度、亮度五个参数组成。
options: 可选参数,内容模糊选项。 | + +## ForegroundBlurStyleOptions对象说明 + +| 名称 | 参数类型 | 必填 | 描述 | +| --------------------------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | +| colorMode | [ThemeColorMode](ts-appendix-enums.md#themecolormode10) | 否 | 内容模糊效果使用的深浅色模式。
默认值:ThemeColorMode.System | +| adaptiveColor | [AdaptiveColor](ts-appendix-enums.md#adaptivecolor10) | 否 | 内容模糊效果使用的取色模式。
默认值:AdaptiveColor.Default | +| scale | number | 否 | 内容模糊效果程度。此参数为系统接口。
默认值:1.0
取值范围:[0.0, 1.0]
| + +## 示例 + +### 示例1 + +```ts +// xxx.ets +@Entry +@Component +struct ForegroundBlurStyleDemo { + build() { + Column() { + Text('Thin Material').fontSize(30).fontColor(0xCCCCCC) + Image($r('app.media.bg')) + .width(300) + .height(350) + .foregroundBlurStyle(BlurStyle.Thin, { colorMode: ThemeColorMode.LIGHT, adaptiveColor: AdaptiveColor.DEFAULT, scale: 1.0 }) + } + .height('100%') + .width('100%') + } +} +``` + +![zh-cn_image_background_blur_style](figures/zh-cn_image_foreground_blur_style.png) \ No newline at end of file