Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
80a692e4
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看板
未验证
提交
80a692e4
编写于
3月 28, 2023
作者:
O
openharmony_ci
提交者:
Gitee
3月 28, 2023
浏览文件
操作
浏览文件
下载
差异文件
!15693 Picker组件UX规格与特征动效整改
Merge pull request !15693 from chensi10/picker_docs_0308
上级
06689e79
c45d1f8c
变更
6
隐藏空白更改
内联
并排
Showing
6 changed file
with
39 addition
and
6 deletion
+39
-6
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md
...-dev/reference/arkui-ts/ts-basic-components-datepicker.md
+9
-0
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
...-dev/reference/arkui-ts/ts-basic-components-textpicker.md
+14
-4
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-timepicker.md
...-dev/reference/arkui-ts/ts-basic-components-timepicker.md
+3
-0
zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
...on-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
+5
-0
zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
...on-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
+5
-2
zh-cn/application-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md
...on-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md
+3
-0
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md
浏览文件 @
80a692e4
...
@@ -32,7 +32,16 @@ DatePicker(options?: {start?: Date, end?: Date, selected?: Date})
...
@@ -32,7 +32,16 @@ DatePicker(options?: {start?: Date, end?: Date, selected?: Date})
| 名称 | 参数类型 | 描述 |
| 名称 | 参数类型 | 描述 |
| ------| -------------- | -------- |
| ------| -------------- | -------- |
| lunar | boolean | 日期是否显示农历。
<br/>
-
true:展示农历。
<br/>
-
false:不展示农历。
<br/>
默认值:false |
| lunar | boolean | 日期是否显示农历。
<br/>
-
true:展示农历。
<br/>
-
false:不展示农历。
<br/>
默认值:false |
| disappearTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
#pickertextstyle10类型说明
)
| 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 |
| textStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
#pickertextstyle10类型说明
)
| 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 |
| selectedTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
#pickertextstyle10类型说明
)
| 设置选中项的文本颜色、字号、字体粗细。 |
## PickerTextStyle<sup>10+</sup>类型说明
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------ | ------------------------------------------ | ---- | -------------------------------------------- |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 文本颜色。 |
| font |
[
Font
](
ts-types.md#font
)
| 否 | 文本样式,picker只支持字号、字体粗细的设置。 |
## 事件
## 事件
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
浏览文件 @
80a692e4
...
@@ -14,7 +14,7 @@
...
@@ -14,7 +14,7 @@
## 接口
## 接口
TextPicker(options?: {range: string[]|Resource, selected?: number, value?: string})
TextPicker(options?: {range: string[]|Resource
|TextPickerRangeContent[]
, selected?: number, value?: string})
根据range指定的选择范围创建文本选择器。
根据range指定的选择范围创建文本选择器。
...
@@ -22,15 +22,25 @@ TextPicker(options?: {range: string[]|Resource, selected?: number, value?: strin
...
@@ -22,15 +22,25 @@ TextPicker(options?: {range: string[]|Resource, selected?: number, value?: strin
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| range | string
[
] \| [Resource
](
ts-types.md#resource类型
)
| 是 | 选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。 |
| range | string
[
] \| [Resource
](
ts-types.md#resource类型
)
\|
[
TextPickerRangeContent
](
#textpickerrangecontent10类型说明
)[]
<sup>
10+
</sup>
| 是 | 选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。 |
| selected | number | 否 | 设置默认选中项在数组中的索引值。
<br/>
默认值:0 |
| selected | number | 否 | 设置默认选中项在数组中的索引值。
<br/>
默认值:0 |
| value | string | 否 | 设置默认选中项的值,优先级低于selected。
<br/>
默认值:第一个元素值 |
| value | string | 否 | 设置默认选中项的值,优先级低于selected。
<br/>
默认值:第一个元素值
<br/>
**说明**
:只有显示文本列表时该值有效。显示图片或图片加文本的列表时,该值无效。 |
## TextPickerRangeContent<sup>10+</sup>类型说明
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------ | -------------------------------------------------------- | ---- | ---------- |
| icon | string
\|
[
Resource
](
ts-types.md#resource
)
| 是 | 图片资源。 |
| text | string
\|
[
Resource
](
ts-types.md#resource
)
| 否 | 文本信息。 |
## 属性
## 属性
| 名称 | 参数类型 | 描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| defaultPickerItemHeight | number
\|
string | 设置Picker各选择项的高度。 |
| defaultPickerItemHeight | number
\|
string | 设置Picker各选择项的高度。 |
| disappearTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 |
| textStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 |
| selectedTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 设置选中项的文本颜色、字号、字体粗细。 |
## 事件
## 事件
...
@@ -38,7 +48,7 @@ TextPicker(options?: {range: string[]|Resource, selected?: number, value?: strin
...
@@ -38,7 +48,7 @@ TextPicker(options?: {range: string[]|Resource, selected?: number, value?: strin
| 名称 | 描述 |
| 名称 | 描述 |
| -------- | -------- |
| -------- | -------- |
| onChange(callback:
(value:
string,
index:
number)
=
>
void) | 滑动选中TextPicker文本内容后,触发该回调。
<br/>
-
value:
当前选中项的文本。
<br/>
-
index:
当前选中项的索引值。 |
| onChange(callback:
(value:
string,
index:
number)
=
>
void) | 滑动选中TextPicker文本内容后,触发该回调。
<br/>
-
value:
当前选中项的文本。
<br/>
**说明**:当显示文本或图片加文本列表时,value值为选中项中的文本值,当显示图片列表时,value值为空。
<br/>
-
index:
当前选中项的索引值。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-timepicker.md
浏览文件 @
80a692e4
...
@@ -30,6 +30,9 @@ TimePicker(options?: {selected?: Date})
...
@@ -30,6 +30,9 @@ TimePicker(options?: {selected?: Date})
| 名称 | 参数类型 | 描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| useMilitaryTime | boolean | 展示时间是否为24小时制,不支持动态修改。
<br/>
默认值:false |
| useMilitaryTime | boolean | 展示时间是否为24小时制,不支持动态修改。
<br/>
默认值:false |
| disappearTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 |
| textStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 |
| selectedTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 设置选中项的文本颜色、字号、字体粗细。 |
## 事件
## 事件
...
...
zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
浏览文件 @
80a692e4
...
@@ -21,6 +21,11 @@ show(options?: DatePickerDialogOptions)
...
@@ -21,6 +21,11 @@ show(options?: DatePickerDialogOptions)
| end | Date | 否 | Date('2100-12-31') | 设置选择器的结束日期。 |
| end | Date | 否 | Date('2100-12-31') | 设置选择器的结束日期。 |
| selected | Date | 否 | 当前系统日期 | 设置当前选中的日期。 |
| selected | Date | 否 | 当前系统日期 | 设置当前选中的日期。 |
| lunar | boolean | 否 | false | 日期是否显示为农历。 |
| lunar | boolean | 否 | false | 日期是否显示为农历。 |
| showTime
<sup>
10+
</sup>
| boolean | 否 | false | 是否展示时间项。 |
| useMilitaryTime
<sup>
10+
</sup>
| boolean | 否 | false | 展示时间是否为24小时制。 |
| disappearTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | - | 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 |
| textStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | - | 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 |
| selectedTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | - | 设置选中项的文本颜色、字号、字体粗细。 |
| onAccept | (value:
[
DatePickerResult
](
ts-basic-components-datepicker.md#DatePickerResult对象说明
)
) => void | 否 | - | 点击弹窗中的“确定”按钮时触发该回调。 |
| onAccept | (value:
[
DatePickerResult
](
ts-basic-components-datepicker.md#DatePickerResult对象说明
)
) => void | 否 | - | 点击弹窗中的“确定”按钮时触发该回调。 |
| onCancel | () => void | 否 | - | 点击弹窗中的“取消”按钮时触发该回调。 |
| onCancel | () => void | 否 | - | 点击弹窗中的“取消”按钮时触发该回调。 |
| onChange | (value:
[
DatePickerResult
](
ts-basic-components-datepicker.md#DatePickerResult对象说明
)
) => void | 否 | - | 滑动弹窗中的滑动选择器使当前选中项改变时触发该回调。 |
| onChange | (value:
[
DatePickerResult
](
ts-basic-components-datepicker.md#DatePickerResult对象说明
)
) => void | 否 | - | 滑动弹窗中的滑动选择器使当前选中项改变时触发该回调。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
浏览文件 @
80a692e4
...
@@ -17,10 +17,13 @@ show(options?: TextPickerDialogOptions)
...
@@ -17,10 +17,13 @@ show(options?: TextPickerDialogOptions)
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| range | string
[
] \| [Resource
](
ts-types.md#resource
)
| 是 | 设置文本选择器的选择范围。不可设置为空数组,若设置为空数组,则不弹出弹窗。 |
| range | string
[
] \| [Resource
](
ts-types.md#resource
)
\|
[
TextPickerRangeContent
](
ts-basic-components-textpicker.md#textpickerrangecontent10类型说明
)[]
<sup>
10+
</sup>
| 是 | 设置文本选择器的选择范围。不可设置为空数组,若设置为空数组,则不弹出弹窗。 |
| selected | number | 否 | 设置选中项的索引值。
<br>
默认值:0 |
| selected | number | 否 | 设置选中项的索引值。
<br>
默认值:0 |
| value | string | 否 | 设置选中项的文本内容。当设置了selected参数时,该参数不生效。如果设置的value值不在range范围内,则默认取range第一个元素。|
| value | string | 否 | 设置选中项的文本内容。当设置了selected参数时,该参数不生效。如果设置的value值不在range范围内,则默认取range第一个元素。|
| defaultPickerItemHeight | number
\|
string | 否 | 设置选择器中选项的高度。 |
| defaultPickerItemHeight | number
\|
string | 否 | 设置选择器中选项的高度。 |
| disappearTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 |
| textStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 |
| selectedTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | 设置选中项的文本颜色、字号、字体粗细。 |
| onAccept | (value:
[
TextPickerResult
](
#textpickerresult对象说明
)
) => void | 否 | 点击弹窗中的“确定”按钮时触发该回调。 |
| onAccept | (value:
[
TextPickerResult
](
#textpickerresult对象说明
)
) => void | 否 | 点击弹窗中的“确定”按钮时触发该回调。 |
| onCancel | () => void | 否 | 点击弹窗中的“取消”按钮时触发该回调。 |
| onCancel | () => void | 否 | 点击弹窗中的“取消”按钮时触发该回调。 |
| onChange | (value:
[
TextPickerResult
](
#textpickerresult对象说明
)
) => void | 否 | 滑动弹窗中的选择器使当前选中项改变时触发该回调。 |
| onChange | (value:
[
TextPickerResult
](
#textpickerresult对象说明
)
) => void | 否 | 滑动弹窗中的选择器使当前选中项改变时触发该回调。 |
...
@@ -29,7 +32,7 @@ show(options?: TextPickerDialogOptions)
...
@@ -29,7 +32,7 @@ show(options?: TextPickerDialogOptions)
| 名称 | 类型 | 描述 |
| 名称 | 类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| value | string | 选中项的文本内容。 |
| value | string | 选中项的文本内容。
<br/>
**说明**
:当显示文本或图片加文本列表时,value值为选中项中的文本值,
<br/>
当显示图片列表时,value值为空。
|
| index | number | 选中项在选择范围数组中的索引值。 |
| index | number | 选中项在选择范围数组中的索引值。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md
浏览文件 @
80a692e4
...
@@ -19,6 +19,9 @@ show(options?: TimePickerDialogOptions)
...
@@ -19,6 +19,9 @@ show(options?: TimePickerDialogOptions)
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| selected | Date | 否 | 设置当前选中的时间。
<br/>
默认值:当前系统时间 |
| selected | Date | 否 | 设置当前选中的时间。
<br/>
默认值:当前系统时间 |
| useMilitaryTime | boolean | 否 | 展示时间是否为24小时制,默认为12小时制。
<br/>
默认值:false |
| useMilitaryTime | boolean | 否 | 展示时间是否为24小时制,默认为12小时制。
<br/>
默认值:false |
| disappearTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 |
| textStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 |
| selectedTextStyle
<sup>
10+
</sup>
|
[
PickerTextStyle
](
ts-basic-components-datepicker.md#pickertextstyle10类型说明
)
| 否 | 设置选中项的文本颜色、字号、字体粗细。 |
| onAccept | (value:
[
TimePickerResult
](
ts-basic-components-timepicker.md#TimePickerResult对象说明
)
) => void | 否 | 点击弹窗中的“确定”按钮时触发该回调。 |
| onAccept | (value:
[
TimePickerResult
](
ts-basic-components-timepicker.md#TimePickerResult对象说明
)
) => void | 否 | 点击弹窗中的“确定”按钮时触发该回调。 |
| onCancel | () => void | 否 | 点击弹窗中的“取消”按钮时触发该回调。 |
| onCancel | () => void | 否 | 点击弹窗中的“取消”按钮时触发该回调。 |
| onChange | (value:
[
TimePickerResult
](
ts-basic-components-timepicker.md#TimePickerResult对象说明
)
) => void | 否 | 滑动弹窗中的选择器使当前选中时间改变时触发该回调。 |
| onChange | (value:
[
TimePickerResult
](
ts-basic-components-timepicker.md#TimePickerResult对象说明
)
) => void | 否 | 滑动弹窗中的选择器使当前选中时间改变时触发该回调。 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录