当前位置:   article > 正文

鸿蒙ArkTS声明式开发:跨平台支持列表【背景设置】 通用属性_鸿蒙 设置背景图重复

鸿蒙 设置背景图重复

背景设置

设置组件的背景样式

说明:
开发前请熟悉鸿蒙开发指导文档gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

属性

名称参数类型描述
background10+builder: [CustomBuilder], options?: {align?:[Alignment]}builder:自定义背景。 align:设置自定义背景与组件的对齐方式。 同时设置了background,backgroundColor,backgroundImage时,叠加显示,background在最上层。 说明: 自定义背景渲染会有一定延迟,不能响应事件,不能进行动态更新。该属性不支持嵌套使用,不支持预览器预览。
backgroundColor[ResourceColor]设置组件的背景色。 从API version 9开始,该接口支持在ArkTS卡片中使用。
backgroundImagesrc: [ResourceStr], repeat?: [ImageRepeat]src:图片地址,支持网络图片资源地址和本地图片资源地址和Base64,不支持svg类型的图片。 repeat:设置背景图片的重复样式,默认不重复。当设置的背景图片为透明底色图片,且同时设置了backgroundColor时,二者叠加显示,背景颜色在最底部。 从API version 9开始,该接口支持在ArkTS卡片中使用。
backgroundImageSize{ width?: [Length], height?: [Length] }[ImageSize]设置背景图像的高度和宽度。当输入为{width: Length, height: Length}对象时,如果只设置一个属性,则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。 width和height取值范围: [0, +∞) 默认值:ImageSize.Auto 从API version 9开始,该接口支持在ArkTS卡片中使用。 说明: 设置为小于0的值时,按值为0显示。当设置了height未设置width时,width根据图片原始宽高比进行调整。
backgroundImagePosition[Position][Alignment]设置背景图在组件中显示位置,即相对于组件左上角的坐标。 默认值: { x: 0, y: 0 } x和y值设置百分比时,偏移量是相对组件自身宽高计算的。 从API version 9开始,该接口支持在ArkTS卡片中使用。
backgroundBlurStyle9+value:[BlurStyle], options10+?:[BackgroundBlurStyleOptions]为当前组件提供一种在背景和内容之间的模糊能力。 value: 背景模糊样式。模糊样式中封装了模糊半径、蒙版颜色、蒙版透明度、饱和度、亮度五个参数。 options: 可选参数,背景模糊选项。 该接口支持在ArkTS卡片中使用。

BackgroundBlurStyleOptions10+对象说明

名称参数类型必填描述
colorMode[ThemeColorMode]背景模糊效果使用的深浅色模式。 默认值:ThemeColorMode.System
adaptiveColor[AdaptiveColor]背景模糊效果使用的取色模式。 默认值:AdaptiveColor.Default
scalenumber背景材质模糊效果程度。此参数为系统接口。 默认值:1.0 取值范围:[0.0, 1.0]

示例

示例1

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct BackgroundExample {
  5. build() {
  6. Column({ space: 5 }) {
  7. Text('background color').fontSize(9).width('90%').fontColor(0xCCCCCC)
  8. Row().width('90%').height(50).backgroundColor(0xE5E5E5).border({ width: 1 })
  9. Text('background image repeat along X').fontSize(9).width('90%').fontColor(0xCCCCCC)
  10. Row()
  11. .backgroundImage('/comment/bg.jpg', ImageRepeat.X)
  12. .backgroundImageSize({ width: '250px', height: '140px' })
  13. .width('90%')
  14. .height(70)
  15. .border({ width: 1 })
  16. Text('background image repeat along Y').fontSize(9).width('90%').fontColor(0xCCCCCC)
  17. Row()
  18. .backgroundImage('/comment/bg.jpg', ImageRepeat.Y)
  19. .backgroundImageSize({ width: '500px', height: '120px' })
  20. .width('90%')
  21. .height(100)
  22. .border({ width: 1 })
  23. Text('background image size').fontSize(9).width('90%').fontColor(0xCCCCCC)
  24. Row()
  25. .width('90%').height(150)
  26. .backgroundImage('/comment/bg.jpg', ImageRepeat.NoRepeat)
  27. .backgroundImageSize({ width: 1000, height: 500 })
  28. .border({ width: 1 })
  29. Text('background fill the box(Cover)').fontSize(9).width('90%').fontColor(0xCCCCCC)
  30. // 不保准图片完整的情况下占满盒子
  31. Row()
  32. .width(200)
  33. .height(50)
  34. .backgroundImage('/comment/bg.jpg', ImageRepeat.NoRepeat)
  35. .backgroundImageSize(ImageSize.Cover)
  36. .border({ width: 1 })
  37. Text('background fill the box(Contain)').fontSize(9).width('90%').fontColor(0xCCCCCC)
  38. // 保准图片完整的情况下放到最大
  39. Row()
  40. .width(200)
  41. .height(50)
  42. .backgroundImage('/comment/bg.jpg', ImageRepeat.NoRepeat)
  43. .backgroundImageSize(ImageSize.Contain)
  44. .border({ width: 1 })
  45. Text('background image position').fontSize(9).width('90%').fontColor(0xCCCCCC)
  46. Row()
  47. .width(100)
  48. .height(50)
  49. .backgroundImage('/comment/bg.jpg', ImageRepeat.NoRepeat)
  50. .backgroundImageSize({ width: 1000, height: 560 })
  51. .backgroundImagePosition({ x: -500, y: -300 })
  52. .border({ width: 1 })
  53. }
  54. .width('100%').height('100%').padding({ top: 5 })
  55. }
  56. }

zh-cn_image_0000001219982703

示例2

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct BackgroundBlurStyleDemo {
  5. build() {
  6. Column() {
  7. Row() {
  8. Text("Thin Material")
  9. }
  10. .width('50%')
  11. .height('50%')
  12. .backgroundBlurStyle(BlurStyle.Thin, { colorMode: ThemeColorMode.LIGHT, adaptiveColor: AdaptiveColor.DEFAULT, scale: 1.0 })
  13. .position({ x: '15%', y: '30%' })
  14. }
  15. .height('100%')
  16. .width('100%')
  17. .backgroundImage($r('app.media.bg'))
  18. .backgroundImageSize(ImageSize.Cover)
  19. }
  20. }

zh-cn_image_background_blur_style

示例3

搜狗高速浏览器截图20240326151450.png

 
  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct BackgroundExample {
  5. @Builder renderBackground() {
  6. Column() {
  7. Progress({value : 50})
  8. }
  9. }
  10. build() {
  11. Column() {
  12. Text("content")
  13. .width(100)
  14. .height(40)
  15. .fontColor("#FFF")
  16. .position({x:50, y:80})
  17. .textAlign(TextAlign.Center)
  18. .backgroundColor(Color.Green)
  19. }
  20. .width(200).height(200)
  21. .background(this.renderBackground)
  22. .backgroundColor(Color.Gray)
  23. }
  24. }

zh-cn_image_background

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/喵喵爱编程/article/detail/998907
推荐阅读
相关标签
  

闽ICP备14008679号