Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
834d2367
D
Docs
项目概览
OpenHarmony
/
Docs
接近 2 年 前同步成功
通知
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看板
提交
834d2367
编写于
5月 25, 2023
作者:
S
sunjiakun
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
textPicker Doc
Signed-off-by:
N
sunjiakun
<
sunjiakun3@huawei.com
>
上级
0ff783a4
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
15 addition
and
7 deletion
+15
-7
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
...-dev/reference/arkui-ts/ts-basic-components-textpicker.md
+13
-5
zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
...on-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
+2
-2
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
100644 → 100755
浏览文件 @
834d2367
...
...
@@ -14,7 +14,7 @@
## 接口
TextPicker(options?: {range: string[]
|Resource|Text
PickerRangeContent[], selected?: number, value?: string})
TextPicker(options?: {range: string
[
]
| string[
][]
| Resource | TextPickerRangeContent[] | TextCascade
PickerRangeContent[], selected?: number, value?: string})
根据range指定的选择范围创建文本选择器。
...
...
@@ -22,9 +22,9 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| range | string
[
] \|
[Resource
](
ts-types.md#resource类型
)
\|
[
TextPickerRangeContent
](
#textpickerrangecontent10类型说明
)[]
<sup>
10+
</sup>
| 是 | 选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。
|
| selected | number
| 否 | 设置默认选中项在数组中的索引值。
<br/>
默认值:0
<br
/>
从API version 10开始,该参数支持
[
$$
](
../../quick-start/arkts-two-way-sync.md
)
双向绑定变量。
|
| value | string
| 否 | 设置默认选中项的值,优先级低于selected。
<br/>
默认值:第一个元素值
<br/>
**说明**
:只有显示文本列表时该值有效。显示图片或图片加文本的列表时,该值无效。
<br
/>
从API version 10开始,该参数支持
[
$$
](
../../quick-start/arkts-two-way-sync.md
)
双向绑定变量。
|
| range | string
[
] \|
string[
][]
<sup>
10+
</sup>
[][]
\|
[Resource](ts-types.md#resource类型)
\|
<br/>
[TextPickerRangeContent](#textpickerrangecontent10类型说明)[]
<sup>
10+
</sup>
\|
[
TextCascadePickerRangeContent
](
#textcascadepickerrangecontent10类型说明
)[]
<sup>
10+
</sup>
| 是 | 选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。
<br/>
**说明**
:单列数据选择器使用string
[
],Resource,TextPickerRangeContent[]类型。<br/>多列数据选择器使用string[
][]
类型。
<br/>
多列联动数据选择器使用TextCascadePickerRangeContent[]类型。
|
| selected | number
\|
number
[
]<sup>10+</sup> | 否 | 设置默认选中项在数组中的索引值。<br/>默认值:0 <br/>**说明**:单列数据选择器使用number类型。<br/>多列、多列联动数据选择器使用number[]类型。<br />从API version 10开始,该参数支持[$$
](
../../quick-start/arkts-two-way-sync.md
)
双向绑定变量。
|
| value | string
\|
string
[
]<sup>10+</sup> | 否 | 设置默认选中项的值,优先级低于selected。<br/>默认值:第一个元素值<br/>**说明**:只有显示文本列表时该值有效。显示图片或图片加文本的列表时,该值无效。 <br/>单列数据选择器使用string类型。<br/>多列、多列联动数据选择器使用string[]类型。<br />从API version 10开始,该参数支持[$$
](
../../quick-start/arkts-two-way-sync.md
)
双向绑定变量。
|
## TextPickerRangeContent<sup>10+</sup>类型说明
...
...
@@ -33,6 +33,13 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte
| icon | string
\|
[
Resource
](
ts-types.md#resource
)
| 是 | 图片资源。 |
| text | string
\|
[
Resource
](
ts-types.md#resource
)
| 否 | 文本信息。 |
## TextCascadePickerRangeContent<sup>10+</sup>类型说明
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------ | -------------------------------------------------------- | ---- | ---------- |
| text | string
\|
[
Resource
](
ts-types.md#resource
)
| 是 | 文本信息。 |
| children |
[
TextCascadePickerRangeContent
](
#textcascadepickerrangecontent10类型说明
)[]
| 否 | 联动数据。 |
## 属性
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
...
...
@@ -43,6 +50,7 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte
| 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类型说明
)
| 设置选中项的文本颜色、字号、字体粗细。 |
| selectedIndex
<sup>
10+
</sup>
| number
\|
number[] | 设置默认选中项在数组中的索引值,优先级高于options中的选中值。
<br/>
**说明**
:单列数据选择器使用number类型。多列、多列联动数据选择器使用number[]类型。 |
## 事件
...
...
@@ -52,7 +60,7 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte
| -------- | -------- |
| onAccept(callback: (value: string, index: number) => void) | 点击弹窗中的“确定”按钮时触发该回调。
<br/><br/>
-
value:
当前选中项的文本。
<br/>
-
index:
当前选中项的索引值。
<br/>
**说明:**
<br/>
该事件仅在
[
文本滑动选择器弹窗
](
ts-methods-textpicker-dialog.md
)
中生效。 |
| onCancel(callback: () => void) | 点击弹窗中的“取消”按钮时触发该回调。
<br/>
**说明:**
<br/>
该事件仅在
[
文本滑动选择器弹窗
](
ts-methods-textpicker-dialog.md
)
中生效。 |
| onChange(callback:
(value:
string
,
index:
number)
=
>
void) | 滑动选中TextPicker文本内容后,触发该回调。
<br/>
-
value:
当前选中项的文本。
<br/>
**说明**:当显示文本或图片加文本列表时,value值为选中项中的文本值,当显示图片列表时,value值为空。
<br/>
-
index:
当前选中项的索引值
。 |
| onChange(callback:
(value:
string
\|
string[]
<sup>
10+
</sup>
,
index:
number
\|
number[]
<sup>
10+
</sup>
)
=
>
void) | 滑动选中TextPicker文本内容后,触发该回调。
<br/>
-
value:
当前选中项的文本。(多列的情况,value为数组类型。)
<br/>
-
index:
当前选中项的索引值。(多列的情况,index为数组类型。)
<br/>
**说明**
:当显示文本或图片加文本列表时,value值为选中项中的文本值,当显示图片列表时,value值为空
。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
浏览文件 @
834d2367
...
...
@@ -32,8 +32,8 @@ show(options?: TextPickerDialogOptions)
| 名称 | 类型 | 描述 |
| -------- | -------- | -------- |
| value | string
| 选中项的文本内容。
<br/>
**说明**
:当显示文本或图片加文本列表时,value值为选中项中的文本值,
<br/>
当显示图片列表时,value值为空。 |
| index | number
| 选中项在选择范围数组中的索引值。
|
| value | string
\|
string []
<sup>
10+
</sup>
| 选中项的文本内容。
<br/>
**说明**
:当显示文本或图片加文本列表时,value值为选中项中的文本值。(多列的情况,value为数组类型。)
<br/>
当显示图片列表时,value值为空。 |
| index | number
\|
number []
<sup>
10+
</sup>
| 选中项在选择范围数组中的索引值。(多列的情况,index为数组类型。)
|
## 示例
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录