logo
积分中心
鸿蒙UI开发——设置组件的内容填充方式
头像 蓝亭书序 2026-11-18 13:36:17    发布
0 浏览 0 收藏

1、场景描述

组件在宽高变化时,如果我们设置了动画效果,但该组件同时又有内容,此时,可能会出现组件有动画效果,但组件包含的内容没有动画的问题。

我们以Text文本组件为例:

如果Text文本组件中有包含文字,此时我们将组件的尺寸变更触发动画时,可能会出现以下效果:

图片

从上述效果中我们可以看到,Text组件的宽高变化是按照动画平滑过渡,但是里面包含的文字发生了跳变,我们希望里面的文字也随着动画发生平滑过渡。效果如下(文章末尾有源码):

图片

为了达到后者的效果,我们可以通过为组件设置renderFit属性来实现。

2、renderFit

属性接口定义如下:

设置宽高动画过程中的组件内容填充方式。(当不设置renderFit属性时,取默认值RenderFit.TOP_LEFT)


// 设置宽高动画过程中的组件内容填充方式。
renderFit(fitMode: RenderFit)


其中RenderFit的值是枚举,介绍如下:

名称描述示意图
CENTER保持动画终态的内容大小,并且内容始终与组件保持中心对齐。
TOP保持动画终态的内容大小,并且内容始终与组件保持顶部中心对齐。
BOTTOM保持动画终态的内容大小,并且内容始终与组件保持底部中心对齐。
LEFT保持动画终态的内容大小,并且内容始终与组件保持左侧对齐。
RIGHT保持动画终态的内容大小,并且内容始终与组件保持右侧对齐。
TOP_LEFT保持动画终态的内容大小,并且内容始终与组件保持左上角对齐。
TOP_RIGHT保持动画终态的内容大小,并且内容始终与组件保持右上角对齐。
BOTTOM_LEFT保持动画终态的内容大小,并且内容始终与组件保持左下角对齐。
BOTTOM_RIGHT保持动画终态的内容大小,并且内容始终与组件保持右下角对齐。
RESIZE_FILL不考虑动画终态内容的宽高比,并且内容始终缩放到组件的大小。
RESIZE_CONTAIN保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内,且与组件保持中心对齐。
RESIZE_CONTAIN_TOP_LEFT保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内。当组件宽方向有剩余时,内容与组件保持左侧对齐,当组件高方向有剩余时,内容与组件保持顶部对齐。
RESIZE_CONTAIN_BOTTOM_RIGHT保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内。当组件宽方向有剩余时,内容与组件保持右侧对齐,当组件高方向有剩余时,内容与组件保持底部对齐。
RESIZE_COVER保持动画终态内容的宽高比进行缩小或放大,使内容两边都大于或等于组件两边,且与组件保持中心对齐,显示内容的中间部分。
RESIZE_COVER_TOP_LEFT保持动画终态内容的宽高比进行缩小或放大,使内容的两边都恰好大于或等于组件两边。当内容宽方向有剩余时,内容与组件保持左侧对齐,显示内容的左侧部分。当内容高方向有剩余时,内容与组件保持顶部对齐,显示内容的顶侧部分。
RESIZE_COVER_BOTTOM_RIGHT保持动画终态内容的宽高比进行缩小或放大,使内容的两边都恰好大于或等于组件两边。当内容宽方向有剩余时,内容与组件保持右侧对齐,显示内容的右侧部分。当内容高方向有剩余时,内容与组件保持底部对齐,显示内容的底侧部分。


3、Demo

第一章节中的动画实例如下(文字与外部的容器保持相对关系,有平滑的动画效果):

图片

具体实现代码如下(25行、34行、39行):


@Entry
@Component
struct RenderFitExample {
  @State w: number = 250; // w为宽,h为高
  @State h: number = 100;
  @State text: string = '鸿蒙自习室';
  flag: boolean = false;

  toggleSize = () => {
    const widthOffset = 50, heightOffset = 40;
    const i = this.flag  ? 1 : -1;
    this.flag = !this.flag;
    this.w += widthOffset * i;
    this.h += heightOffset * i;
  }

  build() {
    Column() {
      Text(this.text)
        .width(this.w)
        .height(this.h)
        .borderWidth(1)
        .textAlign(TextAlign.Start)
        .backgroundColor(Color.Pink)
        .renderFit(RenderFit.LEFT) // 设置LEFT的renderFit,动画过程中,动画的终态内容与组件保持左对齐
        .margin(20)

      Text(this.text)
        .width(this.w)
        .height(this.h)
        .textAlign(TextAlign.Center)
        .backgroundColor(Color.Orange)
        .borderWidth(1)
        .renderFit(RenderFit.CENTER) // 设置CENTER的renderFit,动画过程中,动画的终态内容与组件保持中心对齐
        .margin(20)

      Button("animate")
        .onClick(() => {
          animateTo({ curve: Curve.Ease }, this.toggleSize)
        })
    }.width("100%").height("100%").alignItems(HorizontalAlign.Center)
  }
}



©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255