目录

组件间布局遮挡

问题现象

打开应用后,出现页面组件间布局遮挡问题,如文本框和图片重叠显示、按钮遮挡文字等异常情况。

背景知识

问题定位

[h2]场景一

排查容器布局是否存在约束,即是否使用了Stack堆叠布局。如使用了Stack布局,这种布局子元素默认进行居中堆叠,子元素被约束在Stack下,这会导致组件间布局遮挡,关键代码如下:

Stack(){
  Image($r('app.media.startIcon'))
    .width('100%')
  TextInput({text:'图片被文本框遮挡'})
    .backgroundColor(Color.Grey)
    .fontSize(24)
    .fontColor(Color.Black)
}

[h2]场景二

排查组件是否使用线性布局,如果线性布局的宽高设置不合理,也会出现遮挡,关键代码如下:

Column() {
  Column(){
    Text('Test Test')
  }.height('70%').width('100%').backgroundColor('red')
  Row(){
    // 此处的文本被遮挡
    Text('hello world')
  }.height('100%').width('100%').backgroundColor('blue')
}.width('100%').height('100%')

[h2]场景三

排查组件是否有设置内/外边距,以及内/外边距属性设置是否合理,过大/过小的内外边距都会导致组件间布局遮挡,关键代码如下:

Stack(){
  Image($r('app.media.startIcon'))
    .width('100%')
  TextInput({text:'图片被文本框遮挡'}) 
    .backgroundColor(Color.Grey)
    .fontSize(24)
    .fontColor(Color.Black)
    .margin({top:'-50'})
}

分析结论

[h2]场景一

容器存在布局约束,造成组件间堆叠,布局遮挡。

[h2]场景二

线性布局的宽高设置不合理,造成组件间布局遮挡。

[h2]场景三

内/外边距属性设置不合理,造成组件间布局遮挡。

修改建议

[h2]场景一

布局约束造成的组件间布局遮挡问题,可以更改为Flex弹性布局,并设置layoutWeight属性来分配剩余空间。

// 改成Flex布局
Flex(){
  Image($r('app.media.startIcon'))
    .width('100%')
    // 这个页面的占比为1份
    .layoutWeight(1)
  TextInput({text:'图片被文本框遮挡'})
    .backgroundColor(Color.Grey)
    .fontSize(24)
    .fontColor(Color.Black)
    // 整个页面的占比为2份
    .layoutWeight(2)
}

[h2]场景二

线性布局的宽高设置不合理造成的组件间布局遮挡问题,可以根据实际应用场景,动态调整width、height等属性的值。

Column() {
  Column(){
    Text('Test Test')
  }.height('50%').width('100%').backgroundColor('red')
  Row(){
    // 调整height,此处的文本可正常展示,未被遮挡
    Text('hello world')
  }.height('40%').width('100%').backgroundColor('blue')
}.width('100%').height('100%')

[h2]场景三

组件内/外边距属性设置不合理造成的组件间布局遮挡问题,可以根据实际应用场景,动态调整margin、padding等属性的值。

Stack(){
  Image($r('app.media.startIcon'))
    .width('100%')
  TextInput({text:'图片被文本框遮挡'})
    .backgroundColor(Color.Grey)
    .fontSize(24)
    .fontColor(Color.Black)
    // 调整了margin的值,可以正常展示,未被遮挡
    .margin({top:'0'})
}