Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
9f8b7196
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
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看板
体验新版 GitCode,发现更多精彩内容 >>
提交
9f8b7196
编写于
8月 11, 2023
作者:
H
HelloCrease
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs
Signed-off-by:
N
HelloCrease
<
lian15@huawei.com
>
上级
13d4de5c
变更
9
展开全部
显示空白变更内容
内联
并排
Showing
9 changed file
with
193 addition
and
190 deletion
+193
-190
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-webview.md
zh-cn/application-dev/reference/apis/js-apis-webview.md
+5
-5
zh-cn/application-dev/reference/arkui-ts/figures/list-alignListItem.gif
...ion-dev/reference/arkui-ts/figures/list-alignListItem.gif
+0
-0
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md
...-dev/reference/arkui-ts/ts-basic-components-navigation.md
+118
-115
zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
...n/application-dev/reference/arkui-ts/ts-container-list.md
+34
-34
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
...eference/arkui-ts/ts-universal-attributes-image-effect.md
+29
-29
zh-cn/application-dev/ui/arkts-layout-development-create-list.md
...pplication-dev/ui/arkts-layout-development-create-list.md
+3
-3
zh-cn/application-dev/ui/ui-js-components-text.md
zh-cn/application-dev/ui/ui-js-components-text.md
+1
-1
zh-cn/application-dev/website.md
zh-cn/application-dev/website.md
+1
-1
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
9f8b7196
...
...
@@ -382,6 +382,7 @@
-
[
console (控制台)
](
js-apis-logs.md
)
-
[
Timer (定时器)
](
js-apis-timer.md
)
-
[
syscap (系统能力)
](
js-apis-syscap.md
)
-
[
@system.app (应用上下文)
](
js-apis-system-app.md
)
-
application
-
[
AccessibilityExtensionContext (辅助功能扩展上下文)
](
js-apis-inner-application-accessibilityExtensionContext.md
)
...
...
@@ -504,7 +505,6 @@
-
[
@ohos.systemParameter (系统属性)
](
js-apis-system-parameter.md
)
-
[
@ohos.systemTime (系统时间、时区)
](
js-apis-system-time.md
)
-
[
@ohos.usb (USB管理)
](
js-apis-usb-deprecated.md
)
-
[
@system.app (应用上下文)
](
js-apis-system-app.md
)
-
[
@system.battery (电量信息)
](
js-apis-system-battery.md
)
-
[
@system.bluetooth (蓝牙)
](
js-apis-system-bluetooth.md
)
-
[
@system.brightness (屏幕亮度)
](
js-apis-system-brightness.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-webview.md
浏览文件 @
9f8b7196
...
...
@@ -254,20 +254,20 @@ struct WebComponent {
.
onClick
(()
=>
{
// 使用本侧端口发送消息给HTML5
try
{
console
.
log
(
"
In
e
TS side send true start
"
);
console
.
log
(
"
In
Ark
TS side send true start
"
);
if
(
this
.
nativePort
)
{
this
.
message
.
setString
(
"
helloFromEts
"
);
this
.
nativePort
.
postMessageEventExt
(
this
.
message
);
}
}
catch
(
error
)
{
console
.
log
(
"
In
e
TS side send message catch error:
"
+
error
.
code
+
"
, msg:
"
+
error
.
message
);
console
.
log
(
"
In
Ark
TS side send message catch error:
"
+
error
.
code
+
"
, msg:
"
+
error
.
message
);
}
})
Web
({
src
:
$rawfile
(
'
index.html
'
),
controller
:
this
.
controller
})
.
onPageEnd
((
e
)
=>
{
console
.
log
(
"
In
e
TS side message onPageEnd init mesaage channel
"
);
console
.
log
(
"
In
Ark
TS side message onPageEnd init mesaage channel
"
);
// 1. 创建消息端口
this
.
ports
=
this
.
controller
.
createWebMessagePorts
(
true
);
// 2. 发送端口1到HTML5
...
...
@@ -276,10 +276,10 @@ struct WebComponent {
this
.
nativePort
=
this
.
ports
[
0
];
// 4. 设置回调函数
this
.
nativePort
.
onMessageEventExt
((
result
)
=>
{
console
.
log
(
"
In
e
TS side got message
"
);
console
.
log
(
"
In
Ark
TS side got message
"
);
try
{
var
type
=
result
.
getType
();
console
.
log
(
"
In
e
TS side getType:
"
+
type
);
console
.
log
(
"
In
Ark
TS side getType:
"
+
type
);
switch
(
type
)
{
case
web_webview
.
WebMessageType
.
STRING
:
{
this
.
msg1
=
"
result type:
"
+
typeof
(
result
.
getString
());
...
...
zh-cn/application-dev/reference/arkui-ts/figures/list
1
.gif
→
zh-cn/application-dev/reference/arkui-ts/figures/list
-alignListItem
.gif
浏览文件 @
9f8b7196
文件已移动
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md
浏览文件 @
9f8b7196
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
浏览文件 @
9f8b7196
...
...
@@ -50,7 +50,7 @@ List(value?:{space?: number | string, initialIndex?: number, scroller?
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
| 名称 | 参数类型 | 描述 |
| -----------------------------------
| ------------------------------------------------------------ | --------------------
---------------------------------------- |
| -----------------------------------
-- | ---------------------------------------- |
---------------------------------------- |
| listDirection |
[
Axis
](
ts-appendix-enums.md#axis
)
| 设置List组件排列方向。
<br/>
默认值:Axis.Vertical
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| divider | {
<br/>
strokeWidth:
[Length](ts-types.md#length),
<br/>
color?:[ResourceColor](ts-types.md#resourcecolor),
<br/>
startMargin?:
Length,
<br/>
endMargin?:
Length
<br/>
}
\|
null | 设置ListItem分割线样式,默认无分割线。
<br/>
- strokeWidth:
分割线的线宽。
<br/>
- color:
分割线的颜色。
<br/>
- startMargin:
分割线与列表侧边起始端的距离。
<br/>
- endMargin:
分割线与列表侧边结束端的距离。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。
<br/>
endMargin +startMargin 不能超过列宽度。
<br/>
startMargin和endMargin不支持设置百分比。
<br/>
List的分割线画在主轴方向两个子组件之间,第一个子组件上方和最后一个子组件下方不会绘制分割线。
<br/>
多列模式下,ListItem与ListItem之间的分割线起始边距从每一列的交叉轴方向起始边开始计算,其他情况从List交叉轴方向起始边开始计算。 |
| scrollBar |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 设置滚动条状态。
<br/>
默认值:BarState.Off
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。
<br/>
**说明:**
<br/>
API version 9及以下版本默认值为BarState.Off,API version 10的默认值为BarState.Auto。 |
...
...
@@ -128,7 +128,7 @@ List(value?:{space?: number | string, initialIndex?: number, scroller?
只支持item等高场景限位,不等高场景可能存在不准确的情况。
| 名称 | 描述 |
| ------ | ----------------------------------------
--------------------
|
| ------ | ---------------------------------------- |
| NONE | 默认无项目滚动对齐效果。滚动结束列表项何时将无限制地停止。 |
| START | 视图中的第一项将在列表的开头对齐。
<br/>
**说明:**
<br/>
当列表位移至末端,需要将末端的item完整显示,可能出现开头不对齐的情况。 |
| CENTER | 视图中的中间项将在列表中心对齐。
<br/>
**说明:**
<br/>
顶端和末尾的item都可以在列表中心对齐,列表显示可能露出空白,第一个或最后一个item会对齐到中间位置。 |
...
...
@@ -157,15 +157,15 @@ List(value?:{space?: number | string, initialIndex?: number, scroller?
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ------------------------------ |
| ------ | ------------------------------
----------
|
| Idle | 空闲状态。使用控制器提供的方法控制滚动时触发,拖动滚动条滚动时触发。
<br/>
**说明:**
<br/>
从API version 10开始,调整为滚动状态回归空闲时触发,控制器提供的无动画方法控制滚动时触发。 |
| Scroll | 滚动状态。使用手指拖动List滚动时触发。
<br/>
**说明:**
<br/>
从API version 10开始,拖动滚动条滚动和滚动鼠标滚轮时也会触发。 |
| Fling | 惯性滚动状态。快速划动松手后进行惯性滚动和划动到边缘回弹时触发。
<br/>
**说明:**
<br/>
从API version 10开始,由动画控制的滚动都触发。包括快速划动松手后的惯性滚动,划动到边缘回弹的滚动,快速拖动内置滚动条松手后的惯性滚动,使用滚动控制器提供的带动画的方法控制的滚动。 |
ScrollState枚举变更如下。
| 场景
| API version 9及以下 |API version 10开始
|
| ------
| ------------------------------ |--------------
---------------- |
| 场景
| API version 9及以下 | API version 10开始
|
| ------
------- | ---------------- |
---------------- |
| 手指拖动滑动 | Scroll | Scroll |
| 惯性滚动 | Fling | Fling |
| 过界回弹 | Fling | Fling |
...
...
@@ -286,7 +286,7 @@ struct ListLanesExample {
}
```
![
list
](
figures/list
1
.gif
)
![
list
](
figures/list
-alignListItem
.gif
)
### 示例3
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
浏览文件 @
9f8b7196
...
...
@@ -11,7 +11,7 @@
| 名称 | 参数类型 | 默认值 | 描述 |
| -------------------------------- | ----------------------------------------
-------------------- | ------ | --------------------
---------------------------------------- |
| -------------------------------- | ----------------------------------------
| ------ |
---------------------------------------- |
| blur | number | - | 为当前组件添加内容模糊效果,入参为模糊半径,模糊半径越大越模糊,为0时不模糊。
<br/>
取值范围:
[
0, +∞)<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| backdropBlur | number | - | 为当前组件添加背景模糊效果,入参为模糊半径,模糊半径越大越模糊,为0时不模糊。<br/>取值范围:[0, +∞)<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| shadow | [ShadowOptions
](
#shadowoptions对象说明
)
\|
[
ShadowStyle
](
#shadowstyle10枚举说明
)
<sup>
10+
</sup>
| - | 为当前组件添加阴影效果。
<br/>
入参类型为ShadowOptions时,可以指定模糊半径、阴影的颜色、X轴和Y轴的偏移量。
<br/>
入参类型为ShadowStyle时,可指定不同阴影样式。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用,ArkTS卡片上不支持参数为
[
ShadowStyle
](
#shadowstyle10枚举说明
)
类型。 |
...
...
@@ -23,9 +23,9 @@
| sepia | number | 0 | 将图像转换为深褐色。入参为图像反转的比例,值为1则完全是深褐色的,值为0图像无变化。
(百分比)
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| hueRotate | number
\|
string | '0deg' | 色相旋转效果,输入参数为旋转角度。
<br/>
取值范围:(-∞, +∞)
<br/>
**说明:**
<br/>
色调旋转360度会显示原始颜色。先将色调旋转180 度,然后再旋转-180度会显示原始颜色。数据类型为number时,值为90和'90deg'效果一致。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| colorBlend
<sup>
8+
</sup>
|
[
Color
](
ts-appendix-enums.md#color
)
\|
string
\|
[
Resource
](
ts-types.md#resource
)
| - | 为当前组件添加颜色叠加效果,入参为叠加的颜色。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| sphericalEffect
<sup>
10+
</sup>
| number
| - | 设置组件的图像球面化程度。
<br/>
取值范围:[0,1]。
<br/>
**说明:**
<br/>
1. 如果value等于0则图像保持原样,如果value等于1则图像为完全球面化效果。在0和1之间,数值越大,则球面化程度越高。
<br/>
`value < 0 `
或者
` value > 1`
为异常情况,
`value < 0`
按0处理,
`value > 1`
按1处理。
<br/>
2. 如果组件的图像使用异步加载,则不支持球面效果。例如Image组件默认使用异步加载,如果要使用球面效果,就要设置
`syncLoad`
为
`true`
,但是这种做法不推荐。
`backgroundImage`
也是使用异步加载,所以如果设置了
`backgroundImage`
,不支持球面效果。
<br/>
3. 如果组件设置了阴影,不支持球面效果。
<br>
此接口为系统接口。 |
| lightUpEffect
<sup>
10+
</sup>
| number
| - | 设置组件图像亮起程度。
<br/>
取值范围:[0,1]。
<br/>
如果value等于0则图像为全黑,如果value等于1则图像为全亮效果。0到1之间数值越大,表示图像亮度越高。
`value < 0`
或者
`value > 1`
为异常情况,
`value < 0`
按0处理,
`value > 1`
按1处理。
<br>
此接口为系统接口。
|
| pixelStretchEffect
<sup>
10+
</sup>
|
[
PixelStretchEffectOptions
](
ts-types.md#pixelstretcheffectoptions10
)
| - | 设置组件的图像边缘像素扩展距离。
<br/>
参数
`options`
包括上下左右四个方向的边缘像素扩展距离。
<br/>
**说明:**
<br/>
1. 如果距离为正值,表示向外扩展,放大原来图像大小。上下左右四个方向分别用边缘像素填充,填充的距离即为设置的边缘扩展的距离。
<br/>
2. 如果距离为负值,表示内缩,但是最终图像大小不变。
<br/>
内缩方式:
<br/>
图像根据
`options`
的设置缩小,缩小大小为四个方向边缘扩展距离的绝对值。
<br/>
图像用边缘像素扩展到原来大小。
<br/>
3. 对
`options`
的输入约束:
<br/>
上下左右四个方向的扩展统一为非正值或者非负值。即四个边同时向外扩或者内缩,方向一致。
<br/>
所有方向的输入均为百分比或者具体值,不支持百分比和具体值混用。
<br/>
所有异常情况下,显示为{0,0,0,0}效果,即跟原图保持一致。
<br>
此接口为系统接口。 |
| sphericalEffect
<sup>
10+
</sup>
| number
| - | 设置组件的图像球面化程度。
<br/>
取值范围:[0,1]。
<br/>
**说明:**
<br/>
1. 如果value等于0则图像保持原样,如果value等于1则图像为完全球面化效果。在0和1之间,数值越大,则球面化程度越高。
<br/>
`value < 0 `
或者
` value > 1`
为异常情况,
`value < 0`
按0处理,
`value > 1`
按1处理。
<br/>
2. 如果组件的图像使用异步加载,则不支持球面效果。例如Image组件默认使用异步加载,如果要使用球面效果,就要设置
`syncLoad`
为
`true`
,但是这种做法不推荐。
`backgroundImage`
也是使用异步加载,所以如果设置了
`backgroundImage`
,不支持球面效果。
<br/>
3. 如果组件设置了阴影,不支持球面效果。
<br>
**系统接口:**
此接口为系统接口。 |
| lightUpEffect
<sup>
10+
</sup>
| number
| - | 设置组件图像亮起程度。
<br/>
取值范围:[0,1]。
<br/>
如果value等于0则图像为全黑,如果value等于1则图像为全亮效果。0到1之间数值越大,表示图像亮度越高。
`value < 0`
或者
`value > 1`
为异常情况,
`value < 0`
按0处理,
`value > 1`
按1处理。
<br>
**系统接口:**
此接口为系统接口。
|
| pixelStretchEffect
<sup>
10+
</sup>
|
[
PixelStretchEffectOptions
](
ts-types.md#pixelstretcheffectoptions10
)
| - | 设置组件的图像边缘像素扩展距离。
<br/>
参数
`options`
包括上下左右四个方向的边缘像素扩展距离。
<br/>
**说明:**
<br/>
1. 如果距离为正值,表示向外扩展,放大原来图像大小。上下左右四个方向分别用边缘像素填充,填充的距离即为设置的边缘扩展的距离。
<br/>
2. 如果距离为负值,表示内缩,但是最终图像大小不变。
<br/>
内缩方式:
<br/>
图像根据
`options`
的设置缩小,缩小大小为四个方向边缘扩展距离的绝对值。
<br/>
图像用边缘像素扩展到原来大小。
<br/>
3. 对
`options`
的输入约束:
<br/>
上下左右四个方向的扩展统一为非正值或者非负值。即四个边同时向外扩或者内缩,方向一致。
<br/>
所有方向的输入均为百分比或者具体值,不支持百分比和具体值混用。
<br/>
所有异常情况下,显示为{0,0,0,0}效果,即跟原图保持一致。
<br>
**系统接口:**
此接口为系统接口。 |
| linearGradientBlur
<sup>
10+
</sup>
|
<br/>
value: number,
<br/>
{
<br/>
fractionStops:Array
<FractionStop>
,
<br/>
direction:
[
GradientDirection
](
ts-appendix-enums.md#gradientdirection
)
<br/>
}
<br/>
| - | 为当前组件添加内容线性渐变模糊效果,
<br/>
-value为模糊半径,模糊半径越大越模糊,为0时不模糊。取值范围:
[
0, 60]<br/>线性梯度模糊包含两个部分fractionStops和direction<br/>-fractionStops数组中保存的每一个二元数组(取值0-1,小于0则为0,大于0则为1)表示[模糊程度, 模糊位置];模糊位置需严格递增,开发者传入的数据不符合规范会记录日志,渐变模糊数组中二元数组个数必须大于等于2,否则渐变模糊不生效 <br/> -direction为渐变模糊方向,默认值为[GradientDirection
](
ts-appendix-enums.md#gradientdirection
)
.Bottom
<br/>
从API version 10开始,该接口支持在ArkTS卡片中使用。 |
## ShadowOptions对象说明
...
...
@@ -35,7 +35,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 类型 | 必填 | 说明 |
| ------
| ------ | ---- |
--------------- |
| ------
- | ---------------------------------------- | ---- | -------------------------
--------------- |
| radius | number
\|
[
Resource
](
ts-types.md#resource
)
| 是 | 阴影模糊半径。
<br/>
取值范围:
[
0, +∞)<br/>**说明:** <br/>设置小于0的值时,按值为0处理。 |
| color | [Color
](
ts-appendix-enums.md#color
)
\|
string
\|
[
Resource
](
ts-types.md#resource
)
| 否 | 阴影的颜色。
<br/>
默认为黑色。 |
| offsetX | number
\|
[
Resource
](
ts-types.md#resource
)
| 否 | 阴影的X轴偏移量。
<br/>
默认为0。 |
...
...
@@ -44,7 +44,7 @@
## ShadowStyle<sup>10+</sup>枚举说明
| 名称 | 描述 |
| ------
| --------------------------------
------ |
| ------
----------- |
------ |
| OUTER_DEFAULT_XS | 超小阴影。 |
| OUTER_DEFAULT_SM | 小阴影。 |
| OUTER_DEFAULT_MD | 中阴影。 |
...
...
zh-cn/application-dev/ui/arkts-layout-development-create-list.md
浏览文件 @
9f8b7196
...
...
@@ -653,8 +653,6 @@ Badge({
3.
监听手指抬起事件,若此时移动达到最大值,则触发数据加载并显示刷新视图,加载完成后将此视图隐藏。
下拉刷新与上拉加载的具体实现可参考Codelab:
[
新闻数据加载
](
https://gitee.com/openharmony/codelabs/tree/master/NetworkManagement/NewsDataArkTS
)
。若开发者希望快速实现此功能,也可使用三方组件
[
PullToRefresh
](
https://gitee.com/openharmony-sig/PullToRefresh
)
。
## 编辑列表
...
...
@@ -847,3 +845,5 @@ List() {
-
[
List组件的使用之商品列表(ArkTS)(API9)
](
https://gitee.com/openharmony/codelabs/tree/master/ETSUI/List
)
-
[
List组件的使用之设置项(ArkTS)(API9)
](
https://gitee.com/openharmony/codelabs/tree/master/ETSUI/List_HDC
)
-
[
PullToRefresh
](
https://gitee.com/openharmony-sig/PullToRefresh
)
\ No newline at end of file
zh-cn/application-dev/ui/ui-js-components-text.md
浏览文件 @
9f8b7196
...
...
@@ -65,7 +65,7 @@ text是文本组件,用于呈现一段文本信息。具体用法请参考[tex
-
添加划线
设置text-decoration和text-decoration-colo属性为文本添加划线和划线颜色,text-decoration枚举值请参考 text自有样式。
设置text-decoration和text-decoration-colo
r
属性为文本添加划线和划线颜色,text-decoration枚举值请参考 text自有样式。
```
html
<!-- xxx.hml -->
...
...
zh-cn/application-dev/website.md
浏览文件 @
9f8b7196
...
...
@@ -1134,6 +1134,7 @@
-
[
console (控制台)
](
reference/apis/js-apis-logs.md
)
-
[
Timer (定时器)
](
reference/apis/js-apis-timer.md
)
-
[
syscap (系统能力)
](
reference/apis/js-apis-syscap.md
)
-
[
@system.app (应用上下文)
](
reference/apis/js-apis-system-app.md
)
-
application
-
[
AccessibilityExtensionContext (辅助功能扩展上下文)
](
reference/apis/js-apis-inner-application-accessibilityExtensionContext.md
)
-
设备管理
...
...
@@ -1246,7 +1247,6 @@
-
[
@ohos.systemParameter (系统属性)
](
reference/apis/js-apis-system-parameter.md
)
-
[
@ohos.systemTime (系统时间、时区)
](
reference/apis/js-apis-system-time.md
)
-
[
@ohos.usb (USB管理)
](
reference/apis/js-apis-usb-deprecated.md
)
-
[
@system.app (应用上下文)
](
reference/apis/js-apis-system-app.md
)
-
[
@system.battery (电量信息)
](
reference/apis/js-apis-system-battery.md
)
-
[
@system.bluetooth (蓝牙)
](
reference/apis/js-apis-system-bluetooth.md
)
-
[
@system.brightness (屏幕亮度)
](
reference/apis/js-apis-system-brightness.md
)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录