Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
5e40cd0f
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
5e40cd0f
编写于
9月 28, 2022
作者:
Z
zengyawen
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs
Signed-off-by:
N
zengyawen
<
zengyawen1@huawei.com
>
上级
55be4fac
变更
5
展开全部
显示空白变更内容
内联
并排
Showing
5 changed file
with
44 addition
and
51 deletion
+44
-51
zh-cn/application-dev/key-features/multi-device-app-dev/adaptive-layout.md
...-dev/key-features/multi-device-app-dev/adaptive-layout.md
+28
-28
zh-cn/application-dev/key-features/multi-device-app-dev/appgallery-home-page.md
...key-features/multi-device-app-dev/appgallery-home-page.md
+2
-2
zh-cn/application-dev/key-features/multi-device-app-dev/architecture-design.md
.../key-features/multi-device-app-dev/architecture-design.md
+0
-7
zh-cn/application-dev/key-features/multi-device-app-dev/case.md
...application-dev/key-features/multi-device-app-dev/case.md
+10
-10
zh-cn/application-dev/key-features/multi-device-app-dev/faq.md
.../application-dev/key-features/multi-device-app-dev/faq.md
+4
-4
未找到文件。
zh-cn/application-dev/key-features/multi-device-app-dev/adaptive-layout.md
浏览文件 @
5e40cd0f
此差异已折叠。
点击以展开。
zh-cn/application-dev/key-features/multi-device-app-dev/appgallery-home-page.md
浏览文件 @
5e40cd0f
...
@@ -35,7 +35,7 @@
...
@@ -35,7 +35,7 @@
## 底部/侧边导航栏
## 底部/侧边导航栏
在sm和md断点下,导航栏在底部;在lg断点下,导航栏在左侧。可以通过
[
Tab组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-container-tabs.md
)
的barPosition和vertical属性控制TabBar的位置,同时还可以通过barWidth和barHeight属性控制TabBar的尺寸。
在sm和md断点下,导航栏在底部;在lg断点下,导航栏在左侧。可以通过
[
Tab组件
](
../..
/reference/arkui-ts/ts-container-tabs.md
)
的barPosition和vertical属性控制TabBar的位置,同时还可以通过barWidth和barHeight属性控制TabBar的尺寸。
```
```
...
@@ -121,7 +121,7 @@ export default struct IndexHeader {
...
@@ -121,7 +121,7 @@ export default struct IndexHeader {
## 运营横幅
## 运营横幅
不同断点下的运营横幅,sm断点下显示一张图片,md断点下显示两张图片,lg断点下显示三张图片。可以通过
[
Swiper组件的displayCount属性
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-container-swiper.md
)
实现目标效果。
不同断点下的运营横幅,sm断点下显示一张图片,md断点下显示两张图片,lg断点下显示三张图片。可以通过
[
Swiper组件的displayCount属性
](
../..
/reference/arkui-ts/ts-container-swiper.md
)
实现目标效果。
```
```
...
...
zh-cn/application-dev/key-features/multi-device-app-dev/architecture-design.md
已删除
100644 → 0
浏览文件 @
55be4fac
# 应用架构设计
-
**[应用导航结构设计要求](navigation-design.md)**
-
**[应用页面结构设计](page-design.md)**
\ No newline at end of file
zh-cn/application-dev/key-features/multi-device-app-dev/case.md
浏览文件 @
5e40cd0f
...
@@ -103,7 +103,7 @@
...
@@ -103,7 +103,7 @@
-
alignItems: ItemAlign.Start:子组件在Flex容器交叉轴(水平方向)上首部对齐。
-
alignItems: ItemAlign.Start:子组件在Flex容器交叉轴(水平方向)上首部对齐。
可以查看
[
Flex组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md
)
及
[
Text组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-basic-components-text.md
)
了解这两个组件各个属性的含义及详细用法。
可以查看
[
Flex组件
](
../../reference/arkui-ts/ts-container-flex.md
)
及
[
Text组件
](
../..
/reference/arkui-ts/ts-basic-components-text.md
)
了解这两个组件各个属性的含义及详细用法。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
@@ -123,7 +123,7 @@
...
@@ -123,7 +123,7 @@
}
}
```
```
接下来我们通过width属性和height属性设置四个图标的宽高(详见
[
尺寸设置
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-universal-attributes-size.md
)
),并将它们与联系人姓名和电话以及Blank组件一起放到Flex父容器中。为了便于查看效果,对顶部标题栏设置了淡蓝色的背景色。
接下来我们通过width属性和height属性设置四个图标的宽高(详见
[
尺寸设置
](
../..
/reference/arkui-ts/ts-universal-attributes-size.md
)
),并将它们与联系人姓名和电话以及Blank组件一起放到Flex父容器中。为了便于查看效果,对顶部标题栏设置了淡蓝色的背景色。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
@@ -161,7 +161,7 @@
...
@@ -161,7 +161,7 @@
}
}
```
```
当前标题栏中子组件的布局同预期还有些差异,接下来通过margin属性,设置各个元素的左右间距(详见
[
尺寸设置
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-universal-attributes-size.md
)
)。如下图所示,最终顶部工具栏在默认设备和平板上都可以达到预期显示效果。
当前标题栏中子组件的布局同预期还有些差异,接下来通过margin属性,设置各个元素的左右间距(详见
[
尺寸设置
](
../..
/reference/arkui-ts/ts-universal-attributes-size.md
)
)。如下图所示,最终顶部工具栏在默认设备和平板上都可以达到预期显示效果。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
@@ -205,11 +205,11 @@
...
@@ -205,11 +205,11 @@
### 底部输入栏
### 底部输入栏
有了顶部工具栏的开发经验,可以发现底部输入栏的结构更为简单,它同样以Flex组件作为父容器,同时包含文本输入框(请访问
[
文本输入组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-basic-components-textarea.md
)
查看详细介绍)和消息发送图标两个子节点。
有了顶部工具栏的开发经验,可以发现底部输入栏的结构更为简单,它同样以Flex组件作为父容器,同时包含文本输入框(请访问
[
文本输入组件
](
../..
/reference/arkui-ts/ts-basic-components-textarea.md
)
查看详细介绍)和消息发送图标两个子节点。


为了便于查看的效果,我们同样给底部输入栏设置了淡蓝色到背景色。注意这里有一个特殊的地方,我们给TextArea设置了flexGrow(1)属性。flexGrow属性仅在父组件是Flex组件时生效,表示Flex容器的剩余空间分配给此属性所在的组件的比例,flexGrow(1)表示父容器的剩余空间全部分配给此组件,详见
[
Flex布局
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-universal-attributes-flex-layout.md
)
。
为了便于查看的效果,我们同样给底部输入栏设置了淡蓝色到背景色。注意这里有一个特殊的地方,我们给TextArea设置了flexGrow(1)属性。flexGrow属性仅在父组件是Flex组件时生效,表示Flex容器的剩余空间分配给此属性所在的组件的比例,flexGrow(1)表示父容器的剩余空间全部分配给此组件,详见
[
Flex布局
](
../..
/reference/arkui-ts/ts-universal-attributes-flex-layout.md
)
。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
@@ -258,7 +258,7 @@
...
@@ -258,7 +258,7 @@
**消息气泡**
**消息气泡**
先做一个最简单的消息气泡,通过borderRadius属性可以设置边框的圆角半径(详见
[
边框设置
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-universal-attributes-border.md
)
)。
先做一个最简单的消息气泡,通过borderRadius属性可以设置边框的圆角半径(详见
[
边框设置
](
../..
/reference/arkui-ts/ts-universal-attributes-border.md
)
)。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
@@ -290,7 +290,7 @@ struct MessageBubble {
...
@@ -290,7 +290,7 @@ struct MessageBubble {
注意这个简单的消息气泡,左上角(或右上角)的样式,与实际期望不符。我们先修改发送消息右上角的样式,接收消息左上角的实现与之类似。
注意这个简单的消息气泡,左上角(或右上角)的样式,与实际期望不符。我们先修改发送消息右上角的样式,接收消息左上角的实现与之类似。
[
Stack组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-container-stack.md
)
是一个堆叠容器,其子组件按照轴方向依次堆叠,后一个子组件覆盖前一个子组件。通过其alignContent接口,可以设置子组件在容器内的对齐方式,如alignContent: Alignment.TopStart代表子组件从左上角对齐。
[
Stack组件
](
../..
/reference/arkui-ts/ts-container-stack.md
)
是一个堆叠容器,其子组件按照轴方向依次堆叠,后一个子组件覆盖前一个子组件。通过其alignContent接口,可以设置子组件在容器内的对齐方式,如alignContent: Alignment.TopStart代表子组件从左上角对齐。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
@@ -455,7 +455,7 @@ const globalMessageList:any[] = [
...
@@ -455,7 +455,7 @@ const globalMessageList:any[] = [
]
]
```
```
结合
[
栅格组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-container-gridcontainer.md
)
的定义,考虑我们当前的实际场景,GridRow的各参数设置如下。
结合
[
栅格组件
](
../..
/reference/arkui-ts/ts-container-gridcontainer.md
)
的定义,考虑我们当前的实际场景,GridRow的各参数设置如下。
-
columns:栅格组件中的列数,当前场景默认12列即可。
-
columns:栅格组件中的列数,当前场景默认12列即可。
...
@@ -524,9 +524,9 @@ struct Conversation {
...
@@ -524,9 +524,9 @@ struct Conversation {
现在会话详情页面的顶部标题栏、信息列表及底部输入栏都已经准备完毕,将这三部分组合起来即可得到完整的页面。
现在会话详情页面的顶部标题栏、信息列表及底部输入栏都已经准备完毕,将这三部分组合起来即可得到完整的页面。
-
通过
[
Flex组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/arkui-ts/ts-container-flex.md
)
将三个部分组合起来,注意justifyContent: FlexAlign.SpaceBetween配置项是将Flex组件中的元素按照主轴方向均匀分配,其中第一个元素与顶部对齐,最后一个元素与底部对齐。
-
通过
[
Flex组件
](
../..
/reference/arkui-ts/ts-container-flex.md
)
将三个部分组合起来,注意justifyContent: FlexAlign.SpaceBetween配置项是将Flex组件中的元素按照主轴方向均匀分配,其中第一个元素与顶部对齐,最后一个元素与底部对齐。
-
通过
[
List组件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
)
和
[
ForEach语法
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/ui/ts-rending-control-syntax-foreach.md
)
,显示整个消息列表。
-
通过
[
List组件
](
../../reference/arkui-ts/ts-container-list.md
)
和
[
ForEach语法
](
../..
/ui/ts-rending-control-syntax-foreach.md
)
,显示整个消息列表。
| 默认设备 | 平板 |
| 默认设备 | 平板 |
| -------- | -------- |
| -------- | -------- |
...
...
zh-cn/application-dev/key-features/multi-device-app-dev/faq.md
浏览文件 @
5e40cd0f
...
@@ -17,7 +17,7 @@
...
@@ -17,7 +17,7 @@
```
```
2.
在应用开发过程中查询设备类型。
2.
在应用开发过程中查询设备类型。
-
通过js接口查询指定系统参数(const.build.characteristics)进而确定设备类型,详见
[
系统属性
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/apis/js-apis-system-parameter.md
)
。
-
通过js接口查询指定系统参数(const.build.characteristics)进而确定设备类型,详见
[
系统属性
](
../..
/reference/apis/js-apis-system-parameter.md
)
。
```
typescript
```
typescript
import
parameter
from
'
@ohos.systemparameter
'
import
parameter
from
'
@ohos.systemparameter
'
...
@@ -44,7 +44,7 @@
...
@@ -44,7 +44,7 @@
}
}
}
}
```
```
-
通过deviceInfo查询设备类型,deviceInfo中各个字段的含义请参考
[
设备信息
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/apis/js-apis-device-info.md
)
。
-
通过deviceInfo查询设备类型,deviceInfo中各个字段的含义请参考
[
设备信息
](
../..
/reference/apis/js-apis-device-info.md
)
。
```
typescript
```
typescript
import
deviceInfo
from
'
@ohos.deviceInfo
'
import
deviceInfo
from
'
@ohos.deviceInfo
'
...
@@ -71,7 +71,7 @@
...
@@ -71,7 +71,7 @@
## 如何在不同设备上为Ability配置不同的启动模式
## 如何在不同设备上为Ability配置不同的启动模式
应用由一个或多个Ability组成,Ability支持单实例、多实例和指定实例3种
[
启动模式
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/ability/stage-ability.md#%E5%90%AF%E5%8A%A8%E6%A8%A1%E5%BC%8F
)
,启动模式可以在
[
配置文件(module.json5)
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/quick-start/stage-structure.md
)
中通过launchType字段配置。启动模式对应Ability被启动时的行为,对启动模式的详细说明如下:
应用由一个或多个Ability组成,Ability支持单实例、多实例和指定实例3种
[
启动模式
](
../../ability/stage-ability.md#%E5%90%AF%E5%8A%A8%E6%A8%A1%E5%BC%8F
)
,启动模式可以在
[
配置文件(module.json5)
](
../..
/quick-start/stage-structure.md
)
中通过launchType字段配置。启动模式对应Ability被启动时的行为,对启动模式的详细说明如下:
| 启动模式 | 描述 | 说明 |
| 启动模式 | 描述 | 说明 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
...
@@ -147,7 +147,7 @@ hdc shell reboot
...
@@ -147,7 +147,7 @@ hdc shell reboot
自适应布局可以保证窗口尺寸在一定范围内变化时,页面的显示是正常的。当窗口尺寸变化较大时,就需要额外借助响应式布局能力(如断点等)调整页面结构以保证显示正常。通常每个断点都需要开发者精心适配以获得最佳的显示效果,考虑到设计及开发成本等实际因素的限制,应用不可能适配从零到正无穷的所有窗口宽度。
自适应布局可以保证窗口尺寸在一定范围内变化时,页面的显示是正常的。当窗口尺寸变化较大时,就需要额外借助响应式布局能力(如断点等)调整页面结构以保证显示正常。通常每个断点都需要开发者精心适配以获得最佳的显示效果,考虑到设计及开发成本等实际因素的限制,应用不可能适配从零到正无穷的所有窗口宽度。
不同设备或不同设备状态,系统默认的自由窗口尺寸的调节范围可能不同。开发者可以在
[
应用配置文件
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/quick-start/stage-structure.md
)
中限制应用中各个Ability的自由窗口尺寸调节范围,配置文件中影响自由窗口尺寸调节范围的字段如下表所示。
不同设备或不同设备状态,系统默认的自由窗口尺寸的调节范围可能不同。开发者可以在
[
应用配置文件
](
../..
/quick-start/stage-structure.md
)
中限制应用中各个Ability的自由窗口尺寸调节范围,配置文件中影响自由窗口尺寸调节范围的字段如下表所示。
| 配置文件字段 | 数据类型 | 描述 |
| 配置文件字段 | 数据类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录