Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
dd478676
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看板
未验证
提交
dd478676
编写于
8月 15, 2022
作者:
O
openharmony_ci
提交者:
Gitee
8月 15, 2022
浏览文件
操作
浏览文件
下载
差异文件
!8085 卡片注释修改+issue处理
Merge pull request !8085 from LiAn/OpenHarmony-3.1-Release
上级
61d80b93
7047dd4f
变更
17
显示空白变更内容
内联
并排
Showing
17 changed file
with
441 addition
and
448 deletion
+441
-448
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
...application-dev/reference/arkui-ts/ts-container-swiper.md
+2
-0
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
...eference/arkui-ts/ts-universal-attributes-image-effect.md
+16
-15
zh-cn/application-dev/reference/js-service-widget-ui/figures/000000.png
...ion-dev/reference/js-service-widget-ui/figures/000000.png
+0
-0
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-appendix-types.md
.../js-service-widget-ui/js-service-widget-appendix-types.md
+154
-154
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-calendar.md
.../js-service-widget-ui/js-service-widget-basic-calendar.md
+38
-39
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-chart.md
...nce/js-service-widget-ui/js-service-widget-basic-chart.md
+103
-105
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-clock.md
...nce/js-service-widget-ui/js-service-widget-basic-clock.md
+25
-26
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-input.md
...nce/js-service-widget-ui/js-service-widget-basic-input.md
+9
-10
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-common-gradient.md
...js-service-widget-ui/js-service-widget-common-gradient.md
+14
-14
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-config-file.md
...nce/js-service-widget-ui/js-service-widget-config-file.md
+13
-15
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-custom-events.md
...e/js-service-widget-ui/js-service-widget-custom-events.md
+1
-3
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-custom-props.md
...ce/js-service-widget-ui/js-service-widget-custom-props.md
+0
-1
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-hml.md
...ence/js-service-widget-ui/js-service-widget-syntax-hml.md
+45
-46
zh-cn/application-dev/ui/js-framework-syntax-css.md
zh-cn/application-dev/ui/js-framework-syntax-css.md
+17
-17
zh-cn/application-dev/ui/ts-resource-access.md
zh-cn/application-dev/ui/ts-resource-access.md
+3
-0
zh-cn/application-dev/ui/ui-js-components-switch.md
zh-cn/application-dev/ui/ui-js-components-switch.md
+0
-2
zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md
...pplication-dev/ui/ui-ts-basic-resource-file-categories.md
+1
-1
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
浏览文件 @
dd478676
...
...
@@ -28,6 +28,8 @@ Swiper(value:{controller?: SwiperController})
## 属性
不支持
[
Menu控制
](
ts-universal-attributes-menu.md
)
。
| 名称 | 参数类型 | 默认值 | 描述 |
| --------------------------- | ---------------------------------------- | ---------- | ---------------------------------------- |
| index | number | 0 | 设置当前在容器中显示的子组件的索引值。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
浏览文件 @
dd478676
...
...
@@ -13,7 +13,7 @@
| 名称 | 参数类型 | 默认值 | 描述 |
| --------
| -------- | -------- |
-------- |
| --------
--------------------- | ---------------------------------------- | ------ | --------------------------------
-------- |
| blur | number | - | 为当前组件添加内容模糊效果,入参为模糊半径,模糊半径越大越模糊,为0时不模糊。 |
| backdropBlur | number | - | 为当前组件添加背景模糊效果,入参为模糊半径,模糊半径越大越模糊,为0时不模糊。 |
| shadow | {
<br/>
radius:
number,
<br/>
color?:
Color,
<br/>
offsetX?:
number,
<br/>
offsetY?:
number
<br/>
} | - | 为当前组件添加阴影效果,入参为模糊半径(必填)、阴影的颜色(可选,默认为灰色)、X轴的偏移量(可选,默认为0),Y轴的偏移量(可选,默认为0),偏移量单位为px。 |
...
...
@@ -26,9 +26,10 @@
| sepia | number | 0 | 将图像转换为深褐色。入参为图像反转的比例。值为1则完全是深褐色的,值为0图像无变化。
(百分比) |
| hueRotate | number
\|
string | '0deg' | 为当前组件添加色相旋转效果,入参为旋转的角度值,0deg时图像无变化。入参没有最大值,超过360deg时相当于又绕一圈,即,370deg和10deg的色相旋转效果相同。 |
## 示例
示例效果请以真机运行为准,当前IDE预览器不支持
```
ts
// xxx.ets
@
Entry
...
...
zh-cn/application-dev/reference/js-service-widget-ui/figures/
#
000000.png
→
zh-cn/application-dev/reference/js-service-widget-ui/figures/000000.png
浏览文件 @
dd478676
文件已移动
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-appendix-types.md
浏览文件 @
dd478676
...
...
@@ -7,7 +7,7 @@
## 长度类型
| 名称 | 类型定义 | 描述 |
| --------
| -------- |
-------- |
| --------
-- | -------------------------- | --------------------------------
-------- |
| length | string
\|
number | 用于描述尺寸单位,输入为number类型时,使用px单位。输入为string类型时,需要显式指定像素单位,当前支持的像素单位有:
<br/>
-
px:逻辑尺寸单位。
<br/>
-
fp:字体尺寸单位,随系统字体大小设置发生变化,仅支持文本类组件设置相应的字体大小。 |
| percentage | string | 百分比尺寸单位,如“50%”。 |
...
...
@@ -15,13 +15,13 @@
## 颜色类型
| 名称 | 类型定义 | 描述 |
| -----
--- | -------- |
-------- |
| -----
| ------------------ | --------------------------------
-------- |
| color | string
\|
颜色枚举 | 用于描述颜色信息。
<br/>
字符串格式如下:
<br/>
-
'rgb(255,
255,
255)'。
<br/>
-
'rgba(255,
255,
255,
1.0)'。
<br/>
-
HEX格式:'\#rrggbb','\#aarrggbb'。
<br/>
-
枚举格式:'black','white'。
<br/>
JS脚本中不支持颜色枚举格式。 |
**表1**
当前支持的颜色枚举
| 枚举名称 | 对应颜色 | 颜色 |
| --------
| -------- |
-------- |
| --------
------------ | -------- | --------------------------------
-------- |
| aliceblue |
\#
f0f8ff | !
[
aliceblue
](
figures/aliceblue.png
)
|
| antiquewhite |
\#
faebd7 | !
[
antiquewhite
](
figures/antiquewhite.png
)
|
| aqua |
\#
00ffff | !
[
aqua
](
figures/aqua.png
)
|
...
...
@@ -29,7 +29,7 @@
| azure |
\#
f0ffff | !
[
azure
](
figures/azure.png
)
|
| beige |
\#
f5f5dc | !
[
beige
](
figures/beige.png
)
|
| bisque |
\#
ffe4c4 | !
[
bisque
](
figures/bisque.png
)
|
| black
|
\#
000000 | !
[
#000000
](
figures/#000000.png
)
|
| black
|
\#
000000 | !
[
000000
](
figures/000000.png
)
|
| blanchedalmond |
\#
ffebcd | !
[
blanchedalmond
](
figures/blanchedalmond.png
)
|
| blue |
\#
0000ff | !
[
blue
](
figures/blue.png
)
|
| blueviolet |
\#
8a2be2 | !
[
blueviolet
](
figures/blueviolet.png
)
|
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-calendar.md
浏览文件 @
dd478676
...
...
@@ -17,7 +17,7 @@
支持
[
通用属性
](
js-service-widget-common-attributes.md
)
外,还支持如下属性:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
------ | ------ | ----- | ---- | --------------------------------
-------- |
| date | string | 当前日期 | 否 | 当前页面选中的日期,默认是当前日期,格式为年-月-日,如"2019-11-22"。 |
| cardcalendar | bool | false | 否 | 标识当前日历是否为卡片日历。 |
| startdayofweek | int | 6 | 否 | 标识卡片显示的起始天,默认是星期天(取值范围:0-6)。 |
...
...
@@ -28,7 +28,7 @@
**表1**
calendardata的日属性
| 名称 | 类型 | 描述 |
| --------
| -------- |
-------- |
| --------
------ | ------ | -------------------------------
-------- |
| index | int | 数据的索引,表示第几个日期。 |
| day | int | 表示具体哪一天。 |
| month | int | 表示月份。 |
...
...
@@ -43,7 +43,7 @@
calendardata示例:
```
json
```
{
"year":2021,
"month":1,
...
...
@@ -94,21 +94,21 @@ calendardata示例:
## 样式
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- | -
------- |
| --------
-------- | ------------- | ---- | ---- |
------- |
| background-color |
<
color
>
| - | 否 | 设置背景颜色。 |
## 事件
| 名称 | 参数 | 描述 |
| --------
| -------- |
-------- |
| --------
------ | ------------ | -------
-------- |
| selectedchange | changeEvent | 在点击日期和上下月跳转时触发。 |
| requestdata | requestEvent | 请求日期时触发。 |
**表2**
changeEvent
| 名称 | 类型 | 描述 |
| --------
| -------- | --
------ |
| --------
---- | ------ |
------ |
| $event.day | string | 选择的日期。 |
| $event.month | string | 选择的月份。 |
| $event.year | string | 选择的年份。 |
...
...
@@ -116,7 +116,7 @@ calendardata示例:
**表3**
requestEvent
| 名称 | 类型 | 描述 |
| --------
| --
------ | -------- |
| --------
----------- |
------ | -------- |
| $event.month | string | 请求的月份。 |
| $event.year | string | 请求的年份。 |
| $event.currentYear | string | 当前显示的年份。 |
...
...
@@ -160,7 +160,6 @@ calendardata示例:
```
json
//
xxx.json
{
"data"
:
{
"currentDate"
:
""
,
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-chart.md
浏览文件 @
dd478676
...
...
@@ -17,7 +17,7 @@
除支持
[
通用属性
](
js-service-widget-common-attributes.md
)
外,还支持如下属性:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
--------- | ---------------------------------- | ---- | ---- | --------------------------------
-------- |
| type | string | line | 否 | 设置图表类型(不支持动态修改),可选项有:
<br/>
-
bar:柱状图。
<br/>
-
line:线形图。
<br/>
-
gauge:量规图。
<br/>
-
progress:进度类圆形图表。
<br/>
-
loading:加载类圆形图表。
<br/>
-
rainbow:占比类圆形图表。 |
| options | ChartOptions | - | 否 | 图表参数设置,柱状图和线形图必须设置参数设置,量规图不生效。可以设置x轴、y轴的最小值、最大值、刻度数、是否显示,线条宽度、是否平滑等。(不支持动态修改) |
| datasets | Array
\<
ChartDataset> | - | 否 | 数据集合,柱状图和线形图必须设置数据集合,量规图不生效。可以设置多条数据集及其背景色。 |
...
...
@@ -28,7 +28,7 @@
**表1**
ChartOptions
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| ------
-- | -------- | -------- | -------- |
-------- |
| ------
| --------- | ---- | ---- | --------------------------------
-------- |
| xAxis | ChartAxis | - | 是 | x轴参数设置。可以设置x轴最小值、最大值、刻度数以及是否显示。 |
| yAxis | ChartAxis | - | 是 | y轴参数设置。可以设置y轴最小值、最大值、刻度数以及是否显示。 |
| series | ChartAxis | - | 否 | 数据序列参数设置,仅线形图支持。可以设置:
<br>
- 线的样式,如线宽、是否平滑。
<br>
- 线最前端位置白点的样式和大小。 |
...
...
@@ -36,7 +36,7 @@
**表2**
ChartDataset
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
--- | ---------------------------------------- | -------- | ---- | ------------
-------- |
| strokeColor |
<
color
>
|
\#
ff6384 | 否 | 线条颜色,仅线形图支持。 |
| fillColor |
<
color
>
|
\#
ff6384 | 否 | 填充颜色,线形图表示填充的渐变颜色。 |
| data | Array
<
number
>
\|
Array\
<Point
&
gt
;
| - | 是 | 设置绘制线或柱中的点集。 |
...
...
@@ -45,7 +45,7 @@
**表3**
ChartAxis
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| -------- | --------
| -------- | -------- |
-------- |
| -------- | --------
----- | -------- | ---- | --------------------------------
-------- |
| min | number | 0 | 否 | 轴的最小值,不支持负数,仅线形图支持。 |
| max | number | 100 | 否 | 轴的最大值,不支持负数,仅线形图支持。 |
| axisTick | number | 10 | 否 | 轴显示的刻度数量。
<
br
/>
仅支持1~20,且具体显示的效果与如下计算值有关(图的宽度所占的像素/(max-min))。在柱状图中,每组数据显示的柱子数量与刻度数量一致,且柱子显示在刻度处。 |
...
...
@@ -55,7 +55,7 @@
**表4**
ChartSeries
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
--- | -------------- | ---- | ---- | ------------
-------- |
| lineStyle | ChartLineStyle | - | 否 | 线样式设置,如线宽、是否平滑。 |
| headPoint | PointStyle | - | 否 | 线最前端位置白点的样式和大小。 |
| topPoint | PointStyle | - | 否 | 最高点的样式和大小。 |
...
...
@@ -65,14 +65,14 @@
**表5**
ChartLineStyle
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| ------
-- | -------- | -------- | -------- | ---
----- |
| ------
| -------------- | ----- | ---- |
----- |
| width |
<
length
>
| 1px | 否 | 线宽设置。 |
| smooth | boolean | false | 否 | 是否平滑。 |
**表6**
PointStyle
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
--- | -------------- | -------- | ---- | --------------------------------
-------- |
| shape | string | circle | 否 | 高亮点的形状。可选值为:
<br/>
-
circle:圆形。
<br/>
-
square:方形。
<br/>
-
triangle:三角形。 |
| size |
<
length
>
| 5px | 否 | 高亮点的大小。 |
| strokeWidth |
<
length
>
| 1px | 否 | 边框宽度。 |
...
...
@@ -82,14 +82,14 @@
**表7**
ChartLoop
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| -------- | --------
| -------- | -------- |
-------- |
| -------- | --------
------ | ----- | ---- | --------------------------------
-------- |
| margin |
<
length
>
| 1 | 否 | 擦除点的个数(最新绘制的点与最老的点之间的横向距离)。
<br>
margin和topPoint/bottomPoint/headPoint同时使用时,有概率出现point正好位于擦除区域的情况,导致point不可见,因此不建议同时使用。 |
| gradient | boolean | false | 否 | 是否需要渐变擦除。 |
**表8**
Point
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
---- | ------------- | -------- | ---- | --------------------------------
-------- |
| value | number | 0 | 是 | 表示绘制点的Y轴坐标。 |
| pointStyle | PointStyle | - | 否 | 表示当前数据点的绘制样式。 |
| description | string | - | 否 | 表示当前点的注释内容。 |
...
...
@@ -101,14 +101,14 @@
**表9**
DataSegment
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
-- | ------ | ---- | ---- | --------------------------------
-------- |
| startColor | Color | - | 否 | 起始位置的颜色,设置startColor必须设置endColor。不设置startColor时,会使用系统默认预置的颜色数组,具体颜色值见下表。 |
| endColor | Color | - | 否 | 终止位置的颜色,设置endColor必须设置startColor。
<br/>
不设置startColor时,会使用系统默认预置的颜色数组。 |
| value | number | 0 | 是 | 占比数据的所占份额,最大100。 |
| name | string | - | 否 | 此类数据的名称。 |
| 数据组 | 主题 | 深色主题 |
| ----
---- | -------- |
-------- |
| ----
| --------------------------- | -------------------
-------- |
| 0 | 起始颜色:
\#
f7ce00,结束颜色:
\#
f99b11 | 起始颜色:
\#
d1a738,结束颜色:
\#
eb933d |
| 1 | 起始颜色:
\#
f76223,结束颜色:
\#
f2400a | 起始颜色:
\#
e67d50,结束颜色:
\#
d9542b |
| 2 | 起始颜色:
\#
f772ac,结束颜色:
\#
e65392 | 起始颜色:
\#
d5749e,结束颜色:
\#
d6568d |
...
...
@@ -122,7 +122,7 @@
当类型为量规图时,还支持如下属性:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| -------
- | -------- | -------- | -------- |
-------- |
| -------
| ------ | ---- | ---- | --------------
-------- |
| percent | number | 0 | 否 | 当前值占整体的百分比,取值范围为0-100。 |
...
...
@@ -131,7 +131,7 @@
除支持
[
通用样式
](
js-service-widget-common-styles.md
)
外,还支持如下样式:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
---- | -------------- | -------------------------- | ---- | --------------------------------
-------- |
| stroke-width |
<
length
>
| 32px(量规)
<br/>
24px(占比类圆形图表) | 否 | 量规、占比类圆形图表组件刻度条的宽度。 |
| start-angle |
<
deg
>
| 240(量规)
<br/>
0(占比类圆形图表) | 否 | 量规、占比类圆形图表组件刻度条起始角度,以时钟0点为基线。范围为0到360。 |
| total-angle |
<
deg
>
| 240(量规)
<br/>
360(占比类圆形图表) | 否 | 量规、占比类圆形图表组件刻度条总长度,范围为-360到360,负数标识起点到终点为逆时针。 |
...
...
@@ -186,7 +186,6 @@
```
json
//
xxx.json
{
"data"
:
{
"lineData"
:
[
...
...
@@ -251,7 +250,7 @@
}
}
```
**4*4卡片**
**4*4卡片**

...
...
@@ -290,7 +289,6 @@
```
json
//
xxx.json
{
"data"
:
{
"barData"
:
[
...
...
@@ -323,7 +321,7 @@
}
}
```
**4*4卡片**
**4*4卡片**

...
...
@@ -356,6 +354,6 @@
weights
:
4
,
2
,
1
;
}
```
**4*4卡片**
**4*4卡片**

zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-clock.md
浏览文件 @
dd478676
...
...
@@ -17,7 +17,7 @@
除支持
[
通用属性
](
js-service-widget-common-attributes.md
)
外,还支持如下属性:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
--- | ----------- | ---- | ---- | --------------------------------
-------- |
| clockconfig | ClockConfig | - | 是 | Clock的图片资源和样式设置,包括日间时段(6:00-18:00)和夜间时段(18:00-次日6:00)两套资源和样式设置。
<br/>
其中每套资源和样式包括表盘资源、时针指针资源、分针指针资源、秒针指针资源四张图和相应时间段的表盘数字颜色。
<br/>
日间资源为必填项。夜间资源可不填,不填时默认会复用日间资源用作夜间时段的显示。
<br/>
仅支持动态更新整个Object,不支持动态更新Object里的内容。
<br/>
建议使用PNG资源作为Clock组件的图片资源。
<br/>
不支持使用SVG资源作为Clock组件的图片资源。 |
| showdigit | boolean | true | 否 | 是否由Clock组件绘制表盘数字。
<br/>
该属性为true时,请留意clockconfig中digitRadiusRatio和digitSizeRatio参数与表盘的匹配情况。
<br/>
由Clock组件绘制的表盘数字支持国际化。 |
| hourswest | number | - | 否 | 时钟的时区偏移值,时区为标准时区减去hourswest。
<br/>
有效范围为[-12,
12],其中负值范围表示东时区,比如东八区对应的是-8。不设置默认采用系统时间所在的时区。 |
...
...
@@ -25,7 +25,7 @@
**表1**
ClockConfig
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
-------- | -------------- | --------------- | ---- | --------------------------------
-------- |
| face |
<
string
>
| - | 是 | 日间时段的表盘资源路径。
<br/>
表盘资源须为包含时钟刻度的正方形图片,表盘区域(圆形)为该图片的内切圆或内切圆的同心圆。如果表盘区域为表盘资源内切圆的同心圆的话,请相应调整digitRadiusRatio和digitSizeRatio参数。 |
| hourHand |
<
string
>
| - | 是 | 日间时段的时针资源路径。
<br/>
- 时针图片的高度须与表盘资源高度相同。
<br/>
- 时针图片的宽高比建议在0.062。
<br/>
- 时针图片上指针的旋转中心须处于时针图片的中心(对角线交点)。
<br/>
- 夜间时段的时针资源请调整hourHandNight参数。 |
| minuteHand |
<
string
>
| - | 是 | 日间时段的分针资源路径。
<br/>
- 分针图片的高度须与表盘资源高度相同。
<br/>
- 分针图片的宽高比建议在0.062。
<br/>
- 分针图片上指针的旋转中心须处于分针图片的中心(对角线交点)。
<br/>
-
夜间时段的分针资源请调整minuteHandNight参数。 |
...
...
@@ -47,7 +47,7 @@
除支持
[
通用样式
](
js-service-widget-common-styles.md
)
之外,还支持如下样式:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
--- | -------------- | ---------- | ---- | --------------------------------
-------- |
| font-family |
<
string
>
| sans-serif | 否 | 表盘数字的字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过2.1.6
自定义字体样式指定的字体,会被选中作为文本的字体。 |
> **说明:**
...
...
@@ -58,7 +58,7 @@
## 事件
| 名称 | 参数 | 描述 |
| ----
---- | -------- |
-------- |
| ----
| ------------------- | -
-------- |
| hour | {hour:
number} | 每个整点触发该事件 |
...
...
@@ -101,7 +101,6 @@
```
json
//
xxx.json
{
"data"
:
{
"clockconfig"
:
{
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-input.md
浏览文件 @
dd478676
...
...
@@ -12,7 +12,7 @@
除支持
[
通用属性
](
js-service-widget-common-attributes.md
)
外,还支持如下属性:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| -------
- | -------- | -------- | -------- |
-------- |
| -------
| ------- | ----- | ---- | --------------------------------
-------- |
| type | string | radio | 是 | input组件类型,当前仅支持radio类型:
<br/>
-
"radio":定义单选按钮,允许在多个拥有相同name值的选项中选中其中一个; |
| checked | boolean | false | 否 | 当前组件是否选中。 |
| name | string | - | 否 | input组件的名称。 |
...
...
@@ -27,7 +27,7 @@
## 事件
| 名称 | 参数 | 描述 |
| ------
-- | -------- |
-------- |
| ------
| ------------------ | --------------------------------
-------- |
| change | $event.checkedItem | radio单选框的checked状态发生变化时触发该事件,返回选中的组件value值。 |
| click | - | 点击动作触发该事件。 |
...
...
@@ -57,7 +57,6 @@
```
json
//
xxx.json
{
"actions"
:
{
"onRadioChange"
:{
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-common-gradient.md
浏览文件 @
dd478676
...
...
@@ -4,7 +4,7 @@
> **说明:**
>
>从API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
从API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
开发框架支持线性渐变 (linear-gradient)和重复线性渐变 (repeating-linear-gradient)两种渐变效果。
...
...
@@ -36,7 +36,7 @@ background: repeating-linear-gradient(direction/angle, color, color, ...);
-
参数
| 名称 | 类型 | 默认值 | 必填 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
- | ---------------------------------------- | ---------------------------- | ---- | --------------------------------
-------- |
| direction | to
<
side-or-corner
> <
side-or-corner
>
=
[left
\|
right]
\|\|
[top
\|
bottom] | to
bottom
(由上到下渐变) | 否 | 指定过渡方向,如:to
left
(从右向左渐变)
,或者to
bottom
right
(从左上角到右下角)。 |
| angle |
<
deg
>
| 180deg | 否 | 指定过渡方向,以元素几何中心为坐标原点,水平方向为X轴,angle指定了渐变线与Y轴的夹角(顺时针方向)。 |
| color |
<
color
>
[
<
length
>
\|
<
percentage
>
] | - | 是 | 定义使用渐变样式区域内颜色的渐变效果。 |
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-config-file.md
浏览文件 @
dd478676
...
...
@@ -5,7 +5,7 @@ js标签中包含了实例名称、窗口样式和卡片页面信息。
| 标签 | 类型 | 默认值 | 必填 | 描述 |
| ------
-- | -------- | -------- | -------- |
-------- |
| ------
| ------ | ------- | ---- | -------------------
-------- |
| name | String | default | 是 | 标识JS实例的名字。 |
| pages | Array | - | 是 | 路由信息,详见“
[
pages
](
#pages
)
”。 |
| window | Object | - | 否 | 窗口信息,详见“
[
window
](
#window
)
”。 |
...
...
@@ -47,12 +47,11 @@ window用于定义与显示窗口相关的配置。对于卡片尺寸适配问
> - autoDesignWidth、designWidth的设置不影响默认值计算方式和绘制结果。
| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --------
| -------- | -------- | -------- |
-------- |
| --------
------- | ------- | ---- | ----- | --------------------------------
-------- |
| designWidth | number | 否 | 150px | 页面显示设计时的参考值,实际显示效果基于设备宽度与参考值之间的比例进行缩放。 |
| autoDesignWidth | boolean | 否 | false | 页面设计基准宽度是否自动计算,当设为true时,designWidth将会被忽略,设计基准宽度由设备宽度与屏幕密度计算得出。 |
示例如下:
```
{
...
"window": {
...
...
@@ -60,7 +59,6 @@ window用于定义与显示窗口相关的配置。对于卡片尺寸适配问
}
...
}
```
## 示例
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-custom-events.md
浏览文件 @
dd478676
...
...
@@ -43,7 +43,6 @@
```
json
//
comp.json
{
"data"
:
{
},
...
...
@@ -84,7 +83,6 @@
```
json
//
xxx.json
{
"data"
:
{
},
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-custom-props.md
浏览文件 @
dd478676
...
...
@@ -35,7 +35,6 @@
```
json
//
comp.json
{
"data"
:
{
"progress"
:
{
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-hml.md
浏览文件 @
dd478676
...
...
@@ -35,7 +35,6 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
```
json
//
xxx.json
{
"data"
:
{
"content"
:
"Hello World!"
,
...
...
@@ -74,7 +73,7 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
通过定义ability名称和携带的参数字段params直接跳转,可用"params"作为key提取到跳转事件定义的params字段值。
| 选择器 | 样例 | 默认值 | 样例描述 |
| --------
| -------- | -------- |
-------- |
| --------
--- | ------ | -------- | --------------------------------
-------- |
| action | string | "router" | 事件类型。
<br/>
- "router":用于应用跳转。
<br/>
- "message":自定义点击事件。 |
| abilityName | string | - | 跳转ability名。 |
| params | Object | - | 跳转应用携带的额外参数。 |
...
...
@@ -99,14 +98,14 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
也可以使用want格式绑定参数跳转到目标应用,want定义了ability名称、包名、携带的参数字段等。
| 选择器 | 类型 | 默认值 | 样例描述 |
| ------ | ------ | -------- | ----------------------------------------
--------------------
|
| ------ | ------ | -------- | ---------------------------------------- |
| action | string | "router" | 事件类型。
<br>
- "router":用于应用跳转。
<br>
- "message":自定义点击事件。 |
| want | Object | - | 跳转目标应用的信息,参考want格式表。 |
**表1** want格式
| 选择器 | 类型 | 默认值 | 样例描述 |
| ----------- | -------------------- | ------------ | ----------------------------------------
--------------------
|
| ----------- | -------------------- | ------------ | ---------------------------------------- |
| bundleName | string | - | 表示包描述。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| abilityName | string | - | 表示待启动的Ability名称。 |
| action | string | - | 表示action选项描述。 |
...
...
@@ -147,7 +146,7 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
-
消息事件格式
| 选择器 | 样例 | 默认值 | 样例描述 |
| ------
-- | -------- | -------- |
-------- |
| ------
| ------ | ------- | ----
-------- |
| action | string | message | 表示事件类型。 |
| params | Object | - | 跳转应用携带的额外参数。 |
...
...
zh-cn/application-dev/ui/js-framework-syntax-css.md
浏览文件 @
dd478676
...
...
@@ -58,7 +58,7 @@ CSS是描述HML页面结构的样式语言。所有组件均存在系统默认
css选择器用于选择需要添加样式的元素,支持的选择器如下表所示:
| 选择器 | 样例 | 样例描述 |
| --------
| -------- |
-------- |
| --------
----------------- | ------------------------------------- | --------------------------------
-------- |
| .class | .container | 用于选择class="container"的组件。 |
|
\#
id |
\#
titleId | 用于选择id="titleId"的组件。 |
| tag | text | 用于选择text组件。 |
...
...
@@ -79,7 +79,7 @@ css选择器用于选择需要添加样式的元素,支持的选择器如下
```
/* 页面样式xxx.css */
/
\* 对所有div组件设置样式 \
*/
/
* 对所有div组件设置样式
*/
div {
flex-direction: column;
}
...
...
@@ -95,13 +95,13 @@ div {
.title, .content {
padding: 5px;
}
/
\* 对class="container"的组件下的所有text设置样式 \
*/
/
* 对class="container"的组件下的所有text设置样式
*/
.container text {
color:
\
#007dff;
color: #007dff;
}
/
\* 对class="container"的组件下的直接后代text设置样式 \
*/
/
* 对class="container"的组件下的直接后代text设置样式
*/
.container > text {
color:
\
#fa2a2d;
color: #fa2a2d;
}
```
...
...
@@ -125,7 +125,7 @@ css伪类是选择器中的关键字,用于指定要选择元素的特殊状
除了单个伪类之外,还支持伪类的组合,例如,:focus:checked状态可以用来设置元素的focus属性和checked属性同时为true时的样式。支持的单个伪类如下表所示,按照优先级降序排列:
| 名称 | 支持组件 | 描述 |
| --------
| -------- |
-------- |
| --------
- | ---------------------------------------- | --------------------------------
-------- |
| :disabled | 支持disabled属性的组件 | 表示disabled属性变为true时的元素(不支持动画样式的设置)。 |
| :active | 支持click事件的组件
<br/>
| 表示被用户激活的元素,如:被用户按下的按钮、被激活的tab-bar页签(不支持动画样式的设置)。 |
| :waiting | button | 表示waiting属性为true的元素(不支持动画样式的设置)。 |
...
...
zh-cn/application-dev/ui/ts-resource-access.md
浏览文件 @
dd478676
...
...
@@ -8,7 +8,10 @@
引用rawfile下资源时使用
```"$rawfile('filename')"```
的形式,当前$rawfile仅支持Image控件引用图片资源,filename需要表示为rawfile目录下的文件相对路径,文件名需要包含后缀,路径开头不可以以"/"开头。
> **说明:**
>
> 资源描述符不能拼接使用,仅支持普通字符串如`'app.type.name'`。
>
> `$r`返回值为Resource对象,可通过[getString](../../reference/apis/js-apis-resource-manager.md#getstring) 方法获取对应的字符串。
在xxx.ets文件中,可以使用在resources目录中定义的资源。
...
...
zh-cn/application-dev/ui/ui-js-components-switch.md
浏览文件 @
dd478676
...
...
@@ -52,9 +52,7 @@ Switch为开关选择器,切换开启或关闭状态。具体用法请参考[S
background-color: #F1F3F5;
}
switch{
// 选中时的字体颜色
texton-color: #002aff;
// 未选中时的字体颜色
textoff-color: silver;
text-padding: 20px;
font-size: 50px;
...
...
zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md
浏览文件 @
dd478676
...
...
@@ -75,7 +75,7 @@ base目录与限定词目录下面可以创建资源组目录(包括element、
| ------- | ---------------------------------------- | ---------------------------------------- |
| element | 表示元素资源,以下每一类数据都采用相应的JSON文件来表征。
<br/>
-
boolean,布尔型
<br/>
-
color,颜色
<br/>
-
float,浮点型
<br/>
-
intarray,整型数组
<br/>
-
integer,整型
<br/>
-
pattern,样式
<br/>
-
plural,复数形式
<br/>
-
strarray,字符串数组
<br/>
-
string,字符串 | element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。
<br/>
-
boolean.json
<br/>
-
color.json
<br/>
-
float.json
<br/>
-
intarray.json
<br/>
-
integer.json
<br/>
-
pattern.json
<br/>
-
plural.json
<br/>
-
strarray.json
<br/>
-
string.json |
| media | 表示媒体资源,包括图片、音频、视频等非文本格式的文件。 | 文件名可自定义,例如:icon.png。 |
|
profile | 表示其他类型文件,以原始文件形式保存。
| 文件名可自定义。 |
|
rawfile | 表示其他类型文件,在应用构建为hap包后,以原始文件形式保存,不会被集成到resources.index文件中。
| 文件名可自定义。 |
### 媒体资源类型说明
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录