Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
abc36af9
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看板
未验证
提交
abc36af9
编写于
7月 05, 2023
作者:
O
openharmony_ci
提交者:
Gitee
7月 05, 2023
浏览文件
操作
浏览文件
下载
差异文件
!20287 补充组件双向绑定能力文档说明
Merge pull request !20287 from limeng/double_dollar_doc
上级
a11ed624
2bbac3ab
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
72 addition
and
47 deletion
+72
-47
zh-cn/application-dev/quick-start/arkts-two-way-sync.md
zh-cn/application-dev/quick-start/arkts-two-way-sync.md
+72
-47
未找到文件。
zh-cn/application-dev/quick-start/arkts-two-way-sync.md
浏览文件 @
abc36af9
# $$语法:内置组件双向同步
$$运算符为系统内置组件提供TS变量的引用,使得TS变量和系统内置组件的内部状态保持同步。
内部状态具体指什么取决于组件。例如,
[
bindPopup
](
../reference/arkui-ts/ts-universal-attributes-popup.md
)
属性方法的show参数。
## 使用规则
-
当前$$支持基础类型变量,以及
\@
State、
\@
Link和
\@
Prop装饰的变量。
-
当前$$仅支持
[
bindPopup
](
../reference/arkui-ts/ts-universal-attributes-popup.md
)
属性方法的show参数,
[
Radio
](
../reference/arkui-ts/ts-basic-components-radio.md
)
组件的checked属性,
[
Refresh
](
../reference/arkui-ts/ts-container-refresh.md
)
组件的refreshing参数。
-
$$绑定的变量变化时,会触发UI的同步刷新。
## 使用示例
以
[
bindPopup
](
../reference/arkui-ts/ts-universal-attributes-popup.md
)
属性方法的show参数为例:
```
ts
// xxx.ets
@
Entry
@
Component
struct
bindPopupPage
{
@
State
customPopup
:
boolean
=
false
;
build
()
{
Column
()
{
Button
(
'
Popup
'
)
.
margin
(
20
)
.
onClick
(()
=>
{
this
.
customPopup
=
!
this
.
customPopup
})
.
bindPopup
(
$$this
.
customPopup
,
{
message
:
'
showPopup
'
})
}
}
}
```
![
popup
](
figures/popup.gif
)
# $$语法:内置组件双向同步
$$运算符为系统内置组件提供TS变量的引用,使得TS变量和系统内置组件的内部状态保持同步。
内部状态具体指什么取决于组件。例如,
[
bindPopup
](
../reference/arkui-ts/ts-universal-attributes-popup.md
)
属性方法的show参数。
## 使用规则
-
当前$$支持基础类型变量,以及
\@
State、
\@
Link和
\@
Prop装饰的变量。
-
当前$$支持的组件
| 组件 | 支持的参数/属性 | 起始API版本 |
| ------------------------------------------------------------ | --------------- | ----------- |
|
[
bindPopup
](
../reference/arkui-ts/ts-universal-attributes-popup.md
)
| show | 8 |
|
[
Checkbox
](
../reference/arkui-ts/ts-basic-components-checkbox.md
)
| select | 10 |
|
[
CheckboxGroup
](
../reference/arkui-ts/ts-basic-components-checkboxgroup.md
)
| selectAll | 10 |
|
[
DatePicker
](
../reference/arkui-ts/ts-basic-components-datepicker.md
)
| selected | 10 |
|
[
TimePicker
](
../reference/arkui-ts/ts-basic-components-timepicker.md
)
| selected | 10 |
|
[
MenuItem
](
../reference/arkui-ts/ts-basic-components-menuitem.md
)
| selected | 10 |
|
[
Panel
](
../reference/arkui-ts/ts-container-panel.md
)
| mode | 10 |
|
[
Radio
](
../reference/arkui-ts/ts-basic-components-radio.md
)
| checked | 10 |
|
[
Rating
](
../reference/arkui-ts/ts-basic-components-rating.md
)
| rating | 10 |
|
[
Refresh
](
../reference/arkui-ts/ts-container-refresh.md
)
| refreshing | 8 |
|
[
Search
](
../reference/arkui-ts/ts-basic-components-search.md
)
| value | 10 |
|
[
SideBarContainer
](
../reference/arkui-ts/ts-container-sidebarcontainer.md
)
| showSideBar | 10 |
|
[
Slider
](
../reference/arkui-ts/ts-basic-components-slider.md
)
| value | 10 |
|
[
Stepper
](
../reference/arkui-ts/ts-basic-components-stepper.md
)
| index | 10 |
|
[
Swiper
](
../reference/arkui-ts/ts-container-swiper.md
)
| isOn | 10 |
|
[
Tabs
](
../reference/arkui-ts/ts-container-tabs.md
)
| index | 10 |
|
[
TextArea
](
../reference/arkui-ts/ts-basic-components-textarea.md
)
| text | 10 |
|
[
TextInput
](
../reference/arkui-ts/ts-basic-components-textinput.md
)
| text | 10 |
|
[
TextPicker
](
../reference/arkui-ts/ts-basic-components-textpicker.md
)
| selected、value | 10 |
|
[
Toggle
](
../reference/arkui-ts/ts-basic-components-toggle.md
)
| isOn | 10 |
|
[
AlphabetIndexer
](
../reference/arkui-ts/ts-container-alphabet-indexer.md
)
| selected | 10 |
|
[
Select
](
../reference/arkui-ts/ts-basic-components-select.md
)
| selected、value | 10 |
-
$$绑定的变量变化时,会触发UI的同步刷新。
## 使用示例
以
[
bindPopup
](
../reference/arkui-ts/ts-universal-attributes-popup.md
)
属性方法的show参数为例:
```
ts
// xxx.ets
@
Entry
@
Component
struct
bindPopupPage
{
@
State
customPopup
:
boolean
=
false
;
build
()
{
Column
()
{
Button
(
'
Popup
'
)
.
margin
(
20
)
.
onClick
(()
=>
{
this
.
customPopup
=
!
this
.
customPopup
})
.
bindPopup
(
$$this
.
customPopup
,
{
message
:
'
showPopup
'
})
}
}
}
```
![
popup
](
figures/popup.gif
)
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录