鸿蒙跨端实践-布局方案介绍

云上有数芯 2024-09-18 21:40:50

作者:京东科技 刘宁

一、前言

动态化使用 jue 语言(开发风格与 Vue 一致)开发,对于视图的布局采用了标准的Flex 布局方式。对于列表类视图,动态化提供了<scroll>、<slider>、<recycle-list>、<waterfall>等标签,将子视图的布局管理封装到标签中实现,业务只需要针对标签简单地设置相关属性,即可实现列表类布局,大幅提升研发效率。同时动态化也支持绝对布局以及控制视图的显示和隐藏等功能,使之能胜任绝大多数业务布局场景。

在京东金融App使用动态化方案适配鸿蒙系统的过程中发现,鸿蒙提供的Flex布局和W3C标准的Flex布局,在一些常用的默认属性上表现不一致。导致原本在Android、iOS和web端显示正确的UI布局在鸿蒙端显示错乱。经与鸿蒙的工程师沟通,华为出于多方面的考虑,并没有调整的计划。故而决定废弃鸿蒙提供的布局方式,使用标准的 Flex 布局,引入yoga布局库(由 FaceBook 提供一个开源的跨平台的布局引擎),yoga库的功能是解析视图的 CSS 设置,获取视图的位置(x,y)和尺寸(width,height),直接设置给视图,确保视图的正确显示。

下面详细介绍一下鸿蒙业务在实际开发中高频使用的布局方式,这些布局方式可以涵盖95%以上的业务布局场景。

二、Flex布局

在动态化上,视图默认使用的就是flex布局方式(相当于默认设置了 display:flex;)。

1. 概念

容器(container):是指开启了flex布局的视图

项目(item):是指容器的子视图

容器(container)有几个重要的概念

主轴:item在container上的排列方向,主轴开始的位置叫 main start, 主轴结束的位置叫 main end;item在主轴上占据的尺寸叫 main size

交叉轴:与主轴垂直的方向;交叉轴开始的位置叫 cross start ,交叉轴结束的位置叫 cross end;item 在交叉轴上占据的尺寸叫 cross size

2. 容器(container)的常用属性2.1 flex-direction

设置主轴方向,默认值是column(以下所说的默认都是指在动态化上的默认设置)。大部分设置看效果图已经很清晰,故不做过多解释。

flex-direction: row | row-reverse | column | column-reverse;

不同主轴的显示效果:



以下是假设主轴是row的情况下,介绍其他属性

2.2 flex-wrap

items在主轴上一行显示不下的情况下的折行方式,默认值是nowrap。

flex-wrap: nowrap | wrap | wrap-reverse;

不同 flex-wrap 的显示效果:



2.3 flex-flow

这是flex-direction和flex-wrap的简写方式,默认值是 column nowrap 。

flex-flow:column nowrap;2.4 justify-content

定义item在主轴上的对齐方式,默认值是 flex-start 。

justify-content: flex-start | center | space-between | space-around | space-evenly | flex-end;

不同 justify-content 的显示效果:



2.5 align-items

定义item在交叉轴上的对齐方式,默认是stretch。

align-items: flex-start | center | flex-end | stretch;

不同 align-items 的显示效果:



2.6 align-content

定义多根主轴在在交叉轴上的对齐方式(单条主轴情况下这个属性不生效)。

align-content: flex-start | flex-end | center | space-between | space-around | stretch;

这个刚接触的同学不好理解,什么是主轴的对齐方法?拿 stretch 举个例子

<div style="height: 200px;flex-direction: row; justify-content: flex-start; align-items: flex-start; flex-wrap: wrap;align-content: stretch;"> <text>UI显示效果如下:



蓝色为 container,主轴为 row(flex-direction: row;),支持折行(flex-wrap: wrap;),多行主轴的对齐方式为 stretch(align-content: stretch;),此例中有两条主轴,因此两条主轴的高将充满 container 的高;

第一条主轴中包含视图 1,2,3,4,5。第二条主轴包含视图 6,7。单条主轴的在竖直方向上的对齐方式为从上到下(align-items: flex-start;),而 1 改变了所在主轴的交叉轴方向的对齐方式为从下到上(align-self: flex-end),因此1底部对齐,2,3,4,5顶部对齐。 6,7 同理。

3.项目(item)常用属性3.1 flex-grow

item在container中的主轴方向上的剩余空间中占据的分配比例系数(默认值为0,即不放大)。初次听起来不理解,看个例子就清楚了:

<div style="flex-direction: row;height: 60px;width: 300px; background-color: blue;"> <div style="width:100px;flex-grow:1; height: 40px;background-color: red;"></div> <div style="width:50px;flex-grow:2; height: 40px;background-color: green;"></div></div>

UI效果如下:



由于 item1 宽度为100px,item2 宽度为 50px, container在主轴剩余空间为300-100-50 = 150px;根据flex-grow 的设置,item1占1/3,为50px;item2占2/3,为100px;故最终 item1 与 item2 平分了主轴空间。

3.2 flex-shrink

item在container中的主轴方向上的缩小系数,默认值为0,即空间不够,也不缩小。这个属性仅在container无法承载item的情况下才生效。举个例子:

<div style="flex-direction: row;height: 60px;width: 300px;background-color: blue;"> <div style="width:300px;flex-shrink:1; height:40px;background-color: red;"></div> <div style="width:300px;flex-shrink:2; height:40px;background-color: green;"></div></div>

由于item1与item2的宽度一致,item1压缩的比例为item1的2倍,因此最终item1的尺寸是item的2倍。UI效果如下:



3.3 flex-basis

container在分配多余空间之前,item在主轴方向上占据的空间,默认值是auto,即本身默认的大小。举个例子:

<div style="flex-direction: row;height: 60px;width: 300px; background-color: blue;padding-top: 10px;"> <div style="width:150px;flex-grow:1; height:40px;background-color: red;"></div> <div style="width:150px;flex-grow:1; flex-basis: 50px; height:40px;background-color: green;"></div></div>

由于item1宽度为150px;flex-basis默认为auto,因此默认为150px; item2宽度为150px,但flex-basis为50px,因此在计算所占空间时按50px算,这样在container的主轴上的剩余空间为 300 - 150 - 50 = 100px;item1和item2的flex-grow都为1,因此,各站剩余空间的1/2。因此item1的宽为150+50=200px;item2为50+50=100px;UI效果如下:



3.4 flex

这是一个复合属性,是flex-grow、flex-shrink 、flex-basis的简写形式。

flex: none | [ <'flex-grow'> <'flex-shrink'> <'flex-basis'> ]

flex:1 等价于 flex: 1 1 auto; flex:none 等价于 flex : 0 0 auto;

注意:在使用的时候经常习惯性的使用 flex:1;很多时候大家想要的仅仅是 flex-grow:1;如非必要,尽量不要写无用约束。

3.4 align-self

item在交叉轴上的布局方式由container的align-items属性设置,如果某个item想使用别的对齐方式,可以给item设置align-self,就会覆盖container上的设置。默认值为auto,表示按照container的align-items样式,如果没有父元素,则用stretch。

align-self: auto | flex-start | flex-end | center | stretch;三、列表类布局

对于列表布局,动态化提供了<scroll>、<slider>、<recycle-list>、<waterfall>、<lego-container>、<feed-container>等标签,对于多页面管理提供<page-container>、<tab-bar>等标签。业务仅通过修改标签属性,即可实现子视图在列表内以不同的布局方式显示。

以下是列表在京东金融中的几个具体使用场景。



四、绝对布局

对于要脱离视图文档流,不受兄弟视图布局影响,固定显示于某个指定位置的子视图,可用绝对布局,比如悬浮图标等。

1.position: absolute;.item { position: absolute; right:10px; bottom:20px; width:50px; height:50px; }

绝对定位是相对于父视图的,使用left、right、top、bottom、width和height来设置。

五、视图的显示和隐藏控制

在开发过冲中,经常会用让视图显示或者隐藏的需求。在动态化上提供如下几种方式来实现,可根据具体的使用场景选择使用哪一种。

1. v-if = true | false<div v-if="false">这种隐藏方式最彻底,会销毁视图,不占据任何空间,后面如果再需要显示,则元素会重新创建。这种显示/隐藏元素比较彻底,会带来的内存的开辟和回收,一般用在只显示某一种具体元素的场景下使用。

2. display : flex | none;

这种隐藏方式,不会销毁元素,仍存在于HTML文档中,仍可通过JavaScript访问和操作,但元素会从布局上移除,元素不占据任何空间,不能参与用户交互事件。

3. v-show=true | false ;

在动态化上会被解析为display:flex | none;

4. visibility : visible | hidden;

这种隐藏方式,只是从视觉上移除,仍然参与页面布局,保留元素的位置,无法参与用户交互。

5. opacity : 0 | 1

这种方式是设置视图的透明度,在透明度为0时,完全隐藏,视图仍参与页面布局,保留元素位置,在 Web、Android 和Harmony端仍可参与用户交互,但在 iOS 端只有当透明度大于0.1时可以。这个一般用作视图显示或者消失的过度动画。

6. overflow: hidden | visible

规定视图超出父视图边界时如何处理。在Harmony/iOS/Web 端默认值为visible,即超出可见,Android端默认值为hidden,超出不可见。如果设置了 visible ,如果视图本身添加了事件,对于超出父视图的部分,Harmony/Android/Web仍可响应事件,在 iOS 端无法响应事件。

多说一句:动态化作为一个跨端框架,会最大限度的抹平各端差异,但在有些系统特性上,还是会保持各端的默认实现。业务在使用时,可根据具体情况,具体处理。

六、布局问题分析

动态化在京东金融 App 里已经大范围使用,截止到 2024 年 8 月 26 日已有200+ 页面,200+卡片使用动态化技术开发。在这个过程中与各业务一起解决了很多布局相关的问题。选择几个有共性的问题分享给大家。

1. 为什么没有给item设置宽,item也没有子视图,但item却有宽呢?

因为在动态化上视图的主轴默认是column,align-items默认是stretch,因此item会填充父容器。

2. 为什么给item设置了宽,item显示的宽却是别的值?

这个情况就要具体分析了,如果你在设置了宽的情况下,还设置了flex:1;或者flex-grow:1;再或者flex-shrink等,item可能会被拉伸或者压缩,导致宽度变化。也有可能其他item的缩放级别更高,优先满足其他item的显示,当前item的尺寸也有可能被压缩。

3. item既可以从container的设置中获取尺寸,也可以被子item撑开获取尺寸,也可以自己设置尺寸,还可以被拉伸或者压缩。那item的尺寸最终是由谁来决定呢?

首先假设主轴为 column。container的align-items默认是stretch,因此item会填充父容器。但是如果item自身设置了宽,则会覆盖stretch。如果item的align-self不是stretch,本身也没有设置宽,但子视图有宽,可以被子视图撑开。如果自身设置了宽,则不受子视图影响。

在主轴方向上:如果item 本身没有设置高,但子视图有高,则可以子视图撑开。如果自身设置了高,就不受子视图的影响。如果自身设置了 flex-grow:1则会填充父视图,同样如果设置了 flex-shrink:1,空间不足则被压缩,都会覆盖自身设置的高。

最后:max-width 和 max-height 优先级最高,如果触发边界条件,就会生效,从而覆盖其他设置。

4. 如何让n个item按照比例占据container的主轴空间?

对于这类比例问题,可设置所有item 的flex-basis 为 0,把自身空间全部收回,通过 flex-grow 分配对应比例即可。

5. 对于一个复杂的视图,我该如何下手?

其实越是复杂的视图实现的方式就越多,没有固定的、标准的实现方式。下面说一下我的一点看法,我将视图分为以下几种场景:

1.如果视图自身知道具体的宽高,那就直接设置,这是效率最高的方式。

2.如果视图自身不知道宽高,但是父视图有固定的尺寸,想办法从父视图获取。

3.如果视图自身不知道宽高,但子视图有宽高,则可以靠子视图撑开。

4.如果必要,使用 max-width 和 max-height 做最高层级的条件约束。

其他的情况一般都是以上四种情况的组合。只要理清视图间约束条件,排除约束矛盾点,确定优先级。先建立清晰的布局思路,明确视图的尺寸来源,按照既定思路布局,不写无效约束,一切就清晰自然。

七、写在最后

动态化是一个涉及JavaScript、iOS、Android、Harmony、Java、Vue、Node、Webpack等众多领域的综合解决方案,我们有各个领域优秀的小伙伴共同前行,大家如果想深入了解某个领域的具体实现,可以随时留言交流~!

0 阅读:3

云上有数芯

简介:感谢大家的关注