From 5342befa21947ee40c775dcdb5f0c509ac9e4fcb Mon Sep 17 00:00:00 2001 From: zengyawen Date: Wed, 28 Sep 2022 22:21:53 +0800 Subject: [PATCH] update docs Signed-off-by: zengyawen --- ...256\276\350\256\241\350\241\250_V1.0.xlsm" | Bin 37333 -> 37336 bytes .../multi-device-app-dev/design-checklist.md | 34 +++++++++--------- .../multi-device-app-dev/layout-intro.md | 9 ----- .../page-development-intro.md | 21 +++++++++-- .../multi-device-app-dev/responsive-layout.md | 14 ++------ 5 files changed, 37 insertions(+), 41 deletions(-) diff --git "a/zh-cn/application-dev/key-features/multi-device-app-dev/OpenHarmony_\347\263\273\347\273\237\350\265\204\346\272\220\345\210\206\345\261\202\350\256\276\350\256\241\350\241\250_V1.0.xlsm" "b/zh-cn/application-dev/key-features/multi-device-app-dev/OpenHarmony_\347\263\273\347\273\237\350\265\204\346\272\220\345\210\206\345\261\202\350\256\276\350\256\241\350\241\250_V1.0.xlsm" index 25fc04076e244126d93a66a624e51f3ccd190ca5..fdb0b1b3b41b0db843d07dbd00eaa20cfdcb88ac 100644 GIT binary patch delta 2251 zcmZwIdpOg390%}SU5-ebYuFj)a@=pZ6{Dg_CLNTgSi+HWL~RJ2Y%I!*ZGKpe%PE(z zI4&zCtWHAFN$KV(F;hCFRGy@cONXte^K<%b&;Ho!`}w{Y0eOT0h=ukDw9MBdZNZ*|^pyD}lrh*}qC$|; z9B&0{kXOK?wlU zut&<<2rHON=v7z_b~vq=4+Id5fa0800M`fw-db)XtJzevrgFJvt&>&qfmkbQR4gqh zaAkX--nduVCdmXmzp&B7TTbd9Emyd$RVYg8JUeqxOJR?lSY7IMB=9i{pO7}ArA{Cd z!1X)GG4fIu1+B=R4boSXx(;Q92U0v_^YEiq`0c0yS$%Z83pig8|K+}>4sHhfhC^Ah zd+esVgB(z%aiwif(M&-s9Hd3c%0C~q2lTk#TwZ#jmh3o|*9TIRz7#_r+3)~`*x;q z@Ro1(o(Opbo4{ztJ2!`pG}$(MdNW==Rb{a#PhXg)UiQZ zxhch1agEhcbt5WJHm`(r#YWv;_D3J*+&awe2QW+a2qrESqzwjYm$;gI*5XMnbvijnrAAv z#FywhlFF*iE}}7vG@m{?Ki2GW6W92M>EnOWjT2{7qy0kEIdmS~zrd@Z?^$^TxqjCl z2by}%YUr7~+EXy2ZedldjPV%>kt1qO&0lQwBlr7>d;p1f&u^Krq4`52AC5F*efAsq z`kjf%?|vEiI{H}2v%aeul*ecx0rBbnnxG!;6uH{M?_Olz$we}SUcbHFNuNA=Bm5p~ z0T+G8j8r0K{Bo$jqLZf)Eld>z&-`rVC(yO=eSG&;TPtgNf91(Fbs-JdxY43&H|#A- z*dR~LtQw6V<8Eu5e_dXid3xP$Gp#XV|K}0feCLbHhRA7P)s-35T9jX20&V!kc?;WN z@9>{;JuXS2sC>%-`hkE)I}G2s4kwE`6$@1_Jh+6JJpz1BYEVmYV zq*n!WhSjGk9gA)ZOJC6I7Ynkl=jJgN@{9F8n2vO6vs<63;ae8M^3`{kaux;O^aYC^jv5pHi^1lkwh}va!&Kc6uUit!bk@u63b&@XTPi z%3pYFVv?dV)_wB*1k43V?n?EydMKigqiX#zjEC5hj^pog>;670s5{rD0!QOF$-Tu? zvqEbW!w?k$>IS%JA>V7FhjDYg_~xF3)xcq@`8&1lksj;Cg6- z@_n0zX#BLp*0@IM*oC(f?j27mfvm;fX%oa!=8w9oLkoh@tk0!H{0O`cpLBI{3*5%R zD`7TApXi1(oPSQAADYwL?h8j~Dt-M^0A8JN#w>lE{?CrtHc*_LO@!hb*$z;=n&k$? zVbI*bB58g*Nf7p$1s1rHqX8J?SVE0+l_Ow*!hDIoqJPfa3_o!_d{k933EtYYV+Y2M|Ipec-Nx+Tq4q grv-7jvY&Jo&rVyqh?avbJ#?3z5(OAcd}8_CzuyT(*8l(j delta 2251 zcmcbynCa?bCf)#VW)=|!CI$|MPa91q@@jGQYA4G=@J7eOjLbmM$?Qx@NWz z*35>;;$_T^5b<3sYRKZRSR$Fh=D2a_BZ)7r=V0Rl8Xs!!{$OsI2m`~l36ldkBt?z% zDspo|LwFh3q3!^=XY+2pMiHf&J_Z){Q9%)&pmLl8WVXpd&PkI4Ra7U> z>E@X{L6rqr>pWG68s}+(i$Q9n%t1Em6{Y4Bqgy|DjoNXrHD&6^Uf8@|-Hi<_{zDf< z+)yu;1uQ<%NE^w@&Bu%$h=RpedLW1N=DQv)tYC2!KNV#4L4KL+VDWvSDCU0;RpbPV zOUI*#hr~NT+%r8DMf^hQ6o~rtd`o2WSLH*a>|KEivbarQ8zd@^7TF<*Pv$M20Je5P zu?CXx=1avX5as`CjVCKiVCO@Nyv9-qNN|AU&sTCI>qU}7wrVq6JgG??N&V!>P5Z!3 z2x&$Z-rU;!laUh?<8@Ib&(tTkx2n`5QgZU%sowpoJS5t_tNmj?oTVl_`_ZbBE&ePn zB01|jcD+<6*VS0UC93xMKL7JewPt?$YL8dOF4cPfyXJoM^n25znWDw*j~jaZ7WvGw zV%q#&C%P|h@Q=)1dv|Hn42zY|9j5%MUG>HA>(iy?=L4TTSNT@BTFj$xepfxm$$6Pl zyC=@K_^~q1@AXuMr=8BPGUYC5a3oz1pBSxD=anJGFtLo=C*aaKyC*B;tImsmidVIL zQn&c#e`Kolm>K=KJLbyHB>-9DdW~`R^0^clG%< z9{C+reg0}6=iS-6xA0eQhzWB#8GW(IR^`hC2BiEi0sodzVz^ zqYKZ34Rg&}e7~%Ee`d1Gszx!L!qoQ{D}**3UtBch)R%&1S2BohPxJZg_o|rQ*>R5Nx9@Z< z-?-_7@Q#Gj0n&X*TTB?&h+W$D;l<>{MQMj`z37{)p8ebHbJl~mYxlVS*ZS{%{^j>& z|K%kM=BFIE!+)@9@2|;^%^rR#G%sdeS#Yq_iT&p%2S1mY6Y49KI19pBED!y@yShmD zdHQDK71_6MPEB+FAj7LYSAUt8&w`onwT`bAVf^&$q3B!@pKaCi5;IeJzWPj9F7}1l z*yiHh)-%!vRJJIYNw1P~-C-m8ZB}|^icEKmmj0KdG=)o^k7gF^W)s@T?Y?Vnc%<28 zc5Ut1vsM?(il3`yk~G}oH>|L`QTJhe`$t?qoNE?8L`jO!9 zQT9T_*;nl+wPTdT4ZoPx{nOv$kZ_ylbBO&hf1b+^f3h=|*%h6wJ?^Zj^WMGaV*iJC zbrriOPHy}6zIdA5oMxs&+q#1$DgXHWNAd$-1M`cP@BK{5TsAA-Pd`yx#a8uY{r?|J zKZ*u;Gct*D!z+c!?>j7nfO!dB*s{|An{aifJvQMpohI0Xg}Q992`6F~-q7WNO*L1y zhd8DKA!R>*x7g(RZe48J_H|=5O`->@lhUyZZ|kwdW;SCl)-dz#HNvL4zZa{O_pl4= z_F+|B)8~%O?5ll2*n}ECHd>^~&`~A|BBPJMP*C9Q58+NIm6HKw`aF}Q+ ffh86p<$3Q!BT29%D;on4$N=FZ4hDw19UvY6IJs2$ diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/design-checklist.md b/zh-cn/application-dev/key-features/multi-device-app-dev/design-checklist.md index 740099c448..17347db703 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/design-checklist.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/design-checklist.md @@ -4,24 +4,24 @@ 设计自检表详细列举出了在全场景设备设计和开发过程中应当注意的设计规则，这将帮助应用减少用户舆情且提升用户体验的一致性。 -自检表的要求范围分为“必选”与“推荐”两类。必选类一般为已总结出的较优解决方案或效果，表示相关设计需要按照此原则统一执行；推荐类指可能受应用品牌风格或业务特殊性影响，可适量做出修改。 +自检表的要求范围分为“必须”与“推荐”两个类别。必须类一般为已总结出的较优解决方案或效果，表示相关设计需要按照此原则统一执行；推荐类指可能受应用品牌风格或业务特殊性影响，可适量做出修改。 请参考以下表格范围内提出的要求对应用进行检查。 -| **类型** | **条目** | **说明** | -| -------- | ------------------ | ------------------------------------------------------------ | -| 应用架构 | 导航结构 | 在各设备上页面导航结构保持一致（同时出多个设备的UX设计）。 | -| 布局 | 拉通设计 | 拉通各设备的布局设计，保证在不同尺寸和分辨率的设备上能够无错位/不截断/不变形/不过多空白（50%以上）/不过于拥挤（间距小于16vp，明显截断）/无大图大字体地正常显示。 | -| | 响应式设计 | 栅格布局只能占N列以及N列内部的Gutter，不包含N列两侧的Gutter。 | -| | 响应式设计 | 明确标注使用什么类型的栅格、给出在不同断点下栅格三要素取值。 | -| | 响应式设计 | 按容器去对齐栅格，而不是内部子元素对齐栅格。 | -| | 响应式设计 | 栅格除了页面布局设计外，在做局部栅格设计时，需要通过明显方式如颜色等进行标注区分，避免混淆。 | -| | 响应式设计 | 禁止出现标注了栅格但实际没有通过栅格进行布局设计，避免混淆。 | -| | 自适应设计 | 非栅格设计场景下，明确标注自适应布局能力。自适应布局能力有：拉伸、均分、占比、缩放、延伸、隐藏、折行。 | -| 人机交互 | 输入方式 | 需保证在各设备上完整支持触摸、鼠标、触控、键盘、遥控器、摇杆等交互方式，并符合标准定义。 | -| | 交互归一 | 应使用系统提供的控件以达到一致的交互体验。如有定制，需保证在各场景下，不同输入设备上的操作与指南要求一致。需特别注意鼠标行为。 | -| 视觉风格 | 单位 | 用于界面布局的单位应全部使用vp。只针对严格控制元素尺寸的场景使用px。 | -| | 色彩 | 用于色彩的赋值应使用分层参数。推荐支持深色模式，需保证界面在系统切换色彩模式时没有识别性问题。 | -| | 字体 | 使用fp为文字大小单位，需要响应系统大字体模式，确保系统调节字体大小后，界面字体能响应变化大小，并且界面布局没有出现布局错乱问题。 | -| 多态控件 | 支持常用的控件状态 | 确保控件不同状态下的视觉效果没有缺失。控件的常用状态有：正常态、不可用态、点击态、获焦态、激活态、悬停态。 | \ No newline at end of file +| **类型** | **条目** | **说明** | **类别** | +| -------- | ------------------ | ------------------------------------------------------------ | ------ | +| 应用架构 | 导航结构 | 在各设备上页面导航结构保持一致（同时出多个设备的UX设计）。 | 推荐 | +| 布局 | 拉通设计 | 拉通各设备的布局设计，保证在不同尺寸和分辨率的设备上能够无错位/不截断/不变形/不过多空白（50%以上）/不过于拥挤（间距小于16vp，明显截断）/无大图大字体地正常显示。 | 必须 | +| | 响应式设计 | 栅格布局只能占N列以及N列内部的Gutter，不包含N列两侧的Gutter。 | 必须 | +| | 响应式设计 | 明确标注使用什么类型的栅格、给出在不同断点下栅格三要素取值。 | 推荐 | +| | 响应式设计 | 按容器去对齐栅格，而不是内部子元素对齐栅格。 | 必须 | +| | 响应式设计 | 栅格除了页面布局设计外，在做局部栅格设计时，需要通过明显方式如颜色等进行标注区分，避免混淆。 | 推荐 | +| | 响应式设计 | 禁止出现标注了栅格但实际没有通过栅格进行布局设计，避免混淆。 | 必须 | +| | 自适应设计 | 非栅格设计场景下，明确标注自适应布局能力。自适应布局能力有：拉伸、均分、占比、缩放、延伸、隐藏、折行。 | 推荐 | +| 人机交互 | 输入方式 | 需保证在各设备上完整支持触摸、鼠标、触控、键盘、遥控器、摇杆等交互方式，并符合标准定义。 | 推荐 | +| | 交互归一 | 应使用系统提供的控件以达到一致的交互体验。如有定制，需保证在各场景下，不同输入设备上的操作与指南要求一致。需特别注意鼠标行为。 | 推荐 | +| 视觉风格 | 单位 | 用于界面布局的单位应全部使用vp。只针对严格控制元素尺寸的场景使用px。 | 必须 | +| | 色彩 | 用于色彩的赋值应使用分层参数。推荐支持深色模式，需保证界面在系统切换色彩模式时没有识别性问题。 | 推荐 | +| | 字体 | 使用fp为文字大小单位，需要响应系统大字体模式，确保系统调节字体大小后，界面字体能响应变化大小，并且界面布局没有出现布局错乱问题。 | 必须 | +| 多态控件 | 支持常用的控件状态 | 确保控件不同状态下的视觉效果没有缺失。控件的常用状态有：正常态、不可用态、点击态、获焦态、激活态、悬停态。 | 推荐 | \ No newline at end of file diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/layout-intro.md b/zh-cn/application-dev/key-features/multi-device-app-dev/layout-intro.md index 92f18bb656..df48b1506b 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/layout-intro.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/layout-intro.md @@ -25,13 +25,4 @@ 接下来将依次介绍自适应布局和响应式布局，同时结合实际，通过典型布局场景以及典型页面场景详细介绍两种布局能力的用法。 -## 相关实例 - -针对一次开发，多端部署，有以下相关实例可供参考： - -- [`MusicAlbum`：一多音乐专辑主页（eTS）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/MusicAlbum) -- [`AppMarket`：一多应用市场首页（eTS）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/AppMarket) -- [`AdaptiveCapabilities`：多设备自适应能力（eTS）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/AdaptiveCapabilities) -- [`JsAdaptiveCapabilities`：多设备自适应能力（JS）（API8）](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/JsAdaptiveCapabilities) -- [一次开发多端部署（eTS）（API8）](https://gitee.com/openharmony/codelabs/tree/master/ETSUI/MultiDeploymentEts) diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md b/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md index 2aa7a2a3b4..6594527ed4 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md @@ -19,6 +19,21 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> - 开发多设备上同一页面时，建议开发者多使用[自定义组件](../../ui/ts-component-based-component.md)，既可以增加代码的可读性和可维护性，同时也可以尽可能的实现代码复用。 -> -> - 本章中涉及的示例代码均可以在[OpenHarmony应用示例](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev)中获取，感兴趣的开发者可以自行下载、运行及查看效果。 +> 开发多设备上同一页面时，建议开发者多使用[自定义组件](../../ui/ts-component-based-component.md)，既可以增加代码的可读性和可维护性，同时也可以尽可能的实现代码复用。 + + + +## 相关示例 + +[OpenHarmony应用示例](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev)中提供了如下一多示例，感兴趣的开发者可以自行下载、运行及查看效果。 + +| 示例名称 | 开发范式 | 简介 | +| ------------------------------------------------------------ | -------------- | ------------------------------------------------------------ | +| [页面开发一多能力](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/AdaptiveCapabilities) | 声明式开发范式 | 本章配套的示例代码，包括自适应布局、响应式布局、典型布局场景以及资源文件使用等。 | +| [页面开发一多能力](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/JsAdaptiveCapabilities) | 类Web开发范式 | 本章配套的示例代码，包括自适应布局、响应式布局及资源文件使用等。 | +| [应用市场首页](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/AppMarket) | 声明式开发范式 | 本章配套的示例代码，以应用市场首页为例，演示如何使用一多能力适配多设备（或多窗口尺寸）。 | +| [音乐专辑页](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/MusicAlbum) | 声明式开发范式 | 本章配套的示例代码，以音乐专辑页为例，演示如何使用一多能力适配多设备（或多窗口尺寸）。 | +| [蔬菜百科首页](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/Vegetable) | 声明式开发范式 | 一多示例页面，以蔬菜百科首页为例，演示如何使用一多能力适配多设备（或多窗口尺寸）。 | +| [天气](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/Weather) | 声明式开发范式 | 一多示例应用，以天气应用为例，演示如何使用一多能力实现包含多个页面的应用。 | + + diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md b/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md index cd6420e5fe..1b1d989763 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md @@ -254,8 +254,7 @@ struct MediaQuerySample { ## 栅格布局 - -## 栅格 +### 简介 栅格是多设备场景下通用的辅助定位工具，通过将空间分割为有规律的栅格。栅格可以显著降低适配不同屏幕尺寸的设计及开发成本，使得整体设计和开发流程更有秩序和节奏感，同时也保证多设备上应用显示的协调性和一致性，提升用户体验。 @@ -270,9 +269,6 @@ struct MediaQuerySample { 单个Column的宽度是系统结合Margin、Gutter和Columns自动计算的，不需要也不允许开发者手动配置。 - -### 栅格布局 - 栅格布局就是栅格结合了断点，实现栅格布局能力的组件叫栅格组件。在实际使用场景中，可以根据需要配置不同断点下栅格组件中元素占据的列数，同时也可以调整Margin、Gutter、Columns的取值，从而实现不同的布局效果。 | sm断点 | md断点 | @@ -353,7 +349,7 @@ struct GridRowSample2 { // 侧边栏，尺寸变化范围 [100vp, 600vp] Column(){}.width('100%').backgroundColor('#19000000') - // 内容区，尺寸变化范围 [窗口宽度550vp, 窗口宽度50vp] + // 内容区，尺寸变化范围 [550vp, 50vp] GridRow({breakpoints: {value: ['100vp', '200vp', '300vp', '400vp', '500vp'], reference: BreakpointsReference.ComponentSize}}) { GridCol({span:{xs: 12, sm: 12, md: 12, lg:12, xl: 12, xxl:12}}) { @@ -395,7 +391,6 @@ struct GridRowSample2 { 总的来讲，margin在组件外而padding在组件内，开发者可以根据实际需要进行选择及实现目标效果。 - **示例3：** @@ -729,8 +724,3 @@ struct GridRowSample9 { 如前所述，栅格组件提供了丰富的自定义能力，功能异常灵活和强大。只需要明确栅格在不同断点下的Columns、Margin、Gutter及span等参数，即可确定最终布局，无需关心具体的设备类型及设备状态（如横竖屏）等。栅格可以节约设计团队与开发团队的沟通成本，提升整体开发效率。 -## 相关实例 - -针对栅格断点系统开发，有以下相关实例可供参考： - -- [`Weather`：一多天气（eTS）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/Weather) -- GitLab