Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
3bd55d12
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看板
未验证
提交
3bd55d12
编写于
1月 11, 2023
作者:
O
openharmony_ci
提交者:
Gitee
1月 11, 2023
浏览文件
操作
浏览文件
下载
差异文件
!13412 卡片资料优化
Merge pull request !13412 from chenyuyan/applicationForminfo
上级
aaf971a1
52831925
变更
7
隐藏空白更改
内联
并排
Showing
7 changed file
with
489 addition
and
285 deletion
+489
-285
zh-cn/application-dev/reference/apis/js-apis-app-form-formBindingData.md
...on-dev/reference/apis/js-apis-app-form-formBindingData.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md
...plication-dev/reference/apis/js-apis-app-form-formHost.md
+154
-78
zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md
...dev/reference/apis/js-apis-application-formBindingData.md
+10
-9
zh-cn/application-dev/reference/apis/js-apis-application-formError.md
...ation-dev/reference/apis/js-apis-application-formError.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-application-formHost.md
...cation-dev/reference/apis/js-apis-application-formHost.md
+211
-92
zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md
...cation-dev/reference/apis/js-apis-application-formInfo.md
+9
-20
zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md
...on-dev/reference/apis/js-apis-application-formProvider.md
+102
-83
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-app-form-formBindingData.md
浏览文件 @
3bd55d12
...
@@ -59,6 +59,6 @@ try {
...
@@ -59,6 +59,6 @@ try {
};
};
formBindingData
.
createFormBindingData
(
obj
);
formBindingData
.
createFormBindingData
(
obj
);
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md
浏览文件 @
3bd55d12
...
@@ -40,17 +40,19 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -40,17 +40,19 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
deleteForm
(
formId
,
(
error
)
=>
{
formHost
.
deleteForm
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
else
{
}
else
{
console
.
log
(
'
formHost deleteForm success
'
);
console
.
log
(
'
formHost deleteForm success
'
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -87,15 +89,17 @@ deleteForm(formId: string): Promise<void>
...
@@ -87,15 +89,17 @@ deleteForm(formId: string): Promise<void>
**参数:**
**参数:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
deleteForm
(
formId
).
then
(()
=>
{
formHost
.
deleteForm
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost deleteForm success
'
);
console
.
log
(
'
formHost deleteForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -126,15 +130,17 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -126,15 +130,17 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
releaseForm
(
formId
,
(
error
)
=>
{
formHost
.
releaseForm
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -166,15 +172,17 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<
...
@@ -166,15 +172,17 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
releaseForm
(
formId
,
true
,
(
error
)
=>
{
formHost
.
releaseForm
(
formId
,
true
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -211,15 +219,17 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>
...
@@ -211,15 +219,17 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
releaseForm
(
formId
,
true
).
then
(()
=>
{
formHost
.
releaseForm
(
formId
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost releaseForm success
'
);
console
.
log
(
'
formHost releaseForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -250,15 +260,17 @@ requestForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -250,15 +260,17 @@ requestForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
requestForm
(
formId
,
(
error
)
=>
{
formHost
.
requestForm
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -294,15 +306,17 @@ requestForm(formId: string): Promise<void>
...
@@ -294,15 +306,17 @@ requestForm(formId: string): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
requestForm
(
formId
).
then
(()
=>
{
formHost
.
requestForm
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost requestForm success
'
);
console
.
log
(
'
formHost requestForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -334,15 +348,17 @@ castToNormalForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -334,15 +348,17 @@ castToNormalForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
castToNormalForm
(
formId
,
(
error
)
=>
{
formHost
.
castToNormalForm
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -378,15 +394,17 @@ castToNormalForm(formId: string): Promise<void>
...
@@ -378,15 +394,17 @@ castToNormalForm(formId: string): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
formHost
.
castToNormalForm
(
formId
).
then
(()
=>
{
formHost
.
castToNormalForm
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost castTempForm success
'
);
console
.
log
(
'
formHost castTempForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -417,15 +435,17 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void
...
@@ -417,15 +435,17 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyVisibleForms
(
formId
,
(
error
)
=>
{
formHost
.
notifyVisibleForms
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -461,15 +481,17 @@ notifyVisibleForms(formIds: Array<string>): Promise<void>
...
@@ -461,15 +481,17 @@ notifyVisibleForms(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyVisibleForms
(
formId
).
then
(()
=>
{
formHost
.
notifyVisibleForms
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost notifyVisibleForms success
'
);
console
.
log
(
'
formHost notifyVisibleForms success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -500,15 +522,17 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo
...
@@ -500,15 +522,17 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyInvisibleForms
(
formId
,
(
error
)
=>
{
formHost
.
notifyInvisibleForms
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -544,15 +568,17 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void>
...
@@ -544,15 +568,17 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyInvisibleForms
(
formId
).
then
(()
=>
{
formHost
.
notifyInvisibleForms
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost notifyInvisibleForms success
'
);
console
.
log
(
'
formHost notifyInvisibleForms success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -583,15 +609,17 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void&
...
@@ -583,15 +609,17 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void&
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
enableFormsUpdate
(
formId
,
(
error
)
=>
{
formHost
.
enableFormsUpdate
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -627,15 +655,17 @@ enableFormsUpdate(formIds: Array<string>): Promise<void>
...
@@ -627,15 +655,17 @@ enableFormsUpdate(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
enableFormsUpdate
(
formId
).
then
(()
=>
{
formHost
.
enableFormsUpdate
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost enableFormsUpdate success
'
);
console
.
log
(
'
formHost enableFormsUpdate success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -666,15 +696,17 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void
...
@@ -666,15 +696,17 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
disableFormsUpdate
(
formId
,
(
error
)
=>
{
formHost
.
disableFormsUpdate
(
formId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -710,15 +742,17 @@ disableFormsUpdate(formIds: Array<string>): Promise<void>
...
@@ -710,15 +742,17 @@ disableFormsUpdate(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formId
=
[
"
12400633174999288
"
];
let
formId
=
[
"
12400633174999288
"
];
formHost
.
disableFormsUpdate
(
formId
).
then
(()
=>
{
formHost
.
disableFormsUpdate
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost disableFormsUpdate success
'
);
console
.
log
(
'
formHost disableFormsUpdate success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -739,14 +773,16 @@ isSystemReady(callback: AsyncCallback<void>): void
...
@@ -739,14 +773,16 @@ isSystemReady(callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
isSystemReady
((
error
,
data
)
=>
{
formHost
.
isSystemReady
((
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -767,14 +803,16 @@ isSystemReady(): Promise<void>
...
@@ -767,14 +803,16 @@ isSystemReady(): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
isSystemReady
().
then
(()
=>
{
formHost
.
isSystemReady
().
then
(()
=>
{
console
.
log
(
'
formHost isSystemReady success
'
);
console
.
log
(
'
formHost isSystemReady success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -797,16 +835,18 @@ getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>):
...
@@ -797,16 +835,18 @@ getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>):
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
getAllFormsInfo
((
error
,
data
)
=>
{
formHost
.
getAllFormsInfo
((
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
else
{
}
else
{
console
.
log
(
'
formHost getAllFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getAllFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -829,14 +869,16 @@ getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>
...
@@ -829,14 +869,16 @@ getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
getAllFormsInfo
().
then
((
data
)
=>
{
formHost
.
getAllFormsInfo
().
then
((
data
)
=>
{
console
.
log
(
'
formHost getAllFormsInfo data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getAllFormsInfo data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -867,16 +909,18 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
...
@@ -867,16 +909,18 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
(
error
,
data
)
=>
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
else
{
}
else
{
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -908,16 +952,18 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
...
@@ -908,16 +952,18 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
,
(
error
,
data
)
=>
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
else
{
}
else
{
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -954,14 +1000,16 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
...
@@ -954,14 +1000,16 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
).
then
((
data
)
=>
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
).
then
((
data
)
=>
{
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -985,17 +1033,19 @@ deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<numb
...
@@ -985,17 +1033,19 @@ deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<numb
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
deleteInvalidForms
(
formIds
,
(
error
,
data
)
=>
{
formHost
.
deleteInvalidForms
(
formIds
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
else
{
}
else
{
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1024,15 +1074,17 @@ deleteInvalidForms(formIds: Array<string>): Promise<number>
...
@@ -1024,15 +1074,17 @@ deleteInvalidForms(formIds: Array<string>): Promise<number>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
try
{
try
{
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
deleteInvalidForms
(
formIds
).
then
((
data
)
=>
{
formHost
.
deleteInvalidForms
(
formIds
).
then
((
data
)
=>
{
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1063,7 +1115,9 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
...
@@ -1063,7 +1115,9 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
**示例:**
**示例:**
```
ts
```
ts
var
want
=
{
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
want
=
{
"
deviceId
"
:
""
,
"
deviceId
"
:
""
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
abilityName
"
:
"
FormAbility
"
,
"
abilityName
"
:
"
FormAbility
"
,
...
@@ -1076,13 +1130,13 @@ var want = {
...
@@ -1076,13 +1130,13 @@ var want = {
try
{
try
{
formHost
.
acquireFormState
(
want
,
(
error
,
data
)
=>
{
formHost
.
acquireFormState
(
want
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
else
{
}
else
{
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1118,7 +1172,9 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>
...
@@ -1118,7 +1172,9 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>
**示例:**
**示例:**
```
ts
```
ts
var
want
=
{
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
want
=
{
"
deviceId
"
:
""
,
"
deviceId
"
:
""
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
abilityName
"
:
"
FormAbility
"
,
"
abilityName
"
:
"
FormAbility
"
,
...
@@ -1132,10 +1188,10 @@ try {
...
@@ -1132,10 +1188,10 @@ try {
formHost
.
acquireFormState
(
want
).
then
((
data
)
=>
{
formHost
.
acquireFormState
(
want
).
then
((
data
)
=>
{
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1157,6 +1213,8 @@ on(type: "formUninstall", callback: Callback<string>): void
...
@@ -1157,6 +1213,8 @@ on(type: "formUninstall", callback: Callback<string>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
callback
=
function
(
formId
)
{
let
callback
=
function
(
formId
)
{
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
}
}
...
@@ -1181,6 +1239,8 @@ off(type: "formUninstall", callback?: Callback<string>): void
...
@@ -1181,6 +1239,8 @@ off(type: "formUninstall", callback?: Callback<string>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
callback
=
function
(
formId
)
{
let
callback
=
function
(
formId
)
{
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
}
}
...
@@ -1215,15 +1275,17 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A
...
@@ -1215,15 +1275,17 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
try
{
formHost
.
notifyFormsVisible
(
formIds
,
true
,
(
error
)
=>
{
formHost
.
notifyFormsVisible
(
formIds
,
true
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1260,15 +1322,17 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<
...
@@ -1260,15 +1322,17 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
try
{
formHost
.
notifyFormsVisible
(
formIds
,
true
).
then
(()
=>
{
formHost
.
notifyFormsVisible
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost notifyFormsVisible success
'
);
console
.
log
(
'
formHost notifyFormsVisible success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1300,15 +1364,17 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c
...
@@ -1300,15 +1364,17 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
try
{
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
,
(
error
)
=>
{
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1345,15 +1411,17 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
...
@@ -1345,15 +1411,17 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
try
{
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
).
then
(()
=>
{
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost notifyFormsEnableUpdate success
'
);
console
.
log
(
'
formHost notifyFormsEnableUpdate success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
## shareForm
## shareForm
...
@@ -1384,16 +1452,18 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
...
@@ -1384,16 +1452,18 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
var
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
let
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
try
{
try
{
formHost
.
shareForm
(
formId
,
deviceId
,
(
error
)
=>
{
formHost
.
shareForm
(
formId
,
deviceId
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1430,16 +1500,18 @@ shareForm(formId: string, deviceId: string): Promise<void>
...
@@ -1430,16 +1500,18 @@ shareForm(formId: string, deviceId: string): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formId
=
"
12400633174999288
"
;
let
formId
=
"
12400633174999288
"
;
var
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
let
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
try
{
try
{
formHost
.
shareForm
(
formId
,
deviceId
).
then
(()
=>
{
formHost
.
shareForm
(
formId
,
deviceId
).
then
(()
=>
{
console
.
log
(
'
formHost shareForm success
'
);
console
.
log
(
'
formHost shareForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1471,15 +1543,17 @@ notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callb
...
@@ -1471,15 +1543,17 @@ notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callb
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
try
{
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
,
(
error
)
=>
{
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
...
@@ -1514,15 +1588,17 @@ function notifyFormsPrivacyProtected(formIds: Array\<string\>, isProtected: bool
...
@@ -1514,15 +1588,17 @@ function notifyFormsPrivacyProtected(formIds: Array\<string\>, isProtected: bool
| 以上错误码的详细介绍请参见
[
卡片错误码
](
../errorcodes/errorcode-form.md
)
。 | |
| 以上错误码的详细介绍请参见
[
卡片错误码
](
../errorcodes/errorcode-form.md
)
。 | |
```
ts
```
ts
import
formHost
from
'
@ohos.app.form.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
try
{
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
).
then
(()
=>
{
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost notifyFormsPrivacyProtected success
'
);
console
.
log
(
'
formHost notifyFormsPrivacyProtected success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
});
});
}
catch
(
error
)
{
}
catch
(
error
)
{
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
)
`
);
console
.
log
(
`catch error, code:
${
error
.
code
}
, message:
${
error
.
message
}
`
);
}
}
```
```
zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md
浏览文件 @
3bd55d12
...
@@ -48,16 +48,17 @@ createFormBindingData(obj?: Object | string): FormBindingData
...
@@ -48,16 +48,17 @@ createFormBindingData(obj?: Object | string): FormBindingData
**示例:**
**示例:**
```
ts
```
ts
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
import
formBindingData
from
@
ohos
.
application
.
formBindingData
;
import
fileio
from
'
@ohos.fileio
'
;
import
fs
from
'
@ohos.file.fs
'
;
let
context
=
featureAbility
.
getContext
();
context
.
getOrCreateLocalDir
((
err
,
data
)
=>
{
try
{
let
path
=
data
+
"
/xxx.jpg
"
;
let
fd
=
fs
.
openSync
(
'
/path/to/form.png
'
)
let
fd
=
fileio
.
openSync
(
path
);
let
obj
=
{
let
obj
=
{
"
temperature
"
:
"
21°
"
,
"
temperature
"
:
"
21°
"
,
"
formImages
"
:
{
"
image
"
:
fd
}
"
formImages
"
:
{
"
image
"
:
fd
}
};
};
let
formBindingDataObj
=
formBindingData
.
createFormBindingData
(
obj
);
formBindingData
.
createFormBindingData
(
obj
);
})
}
catch
(
error
.
code
)
{
console
.
log
(
'
catch error, error:
'
+
JSON
.
stringify
(
error
));
}
```
```
zh-cn/application-dev/reference/apis/js-apis-application-formError.md
浏览文件 @
3bd55d12
# @ohos.application.formError (
F
ormError)
# @ohos.application.formError (
f
ormError)
F
ormError模块提供获取卡片错误码的能力。
f
ormError模块提供获取卡片错误码的能力。
> **说明:**
> **说明:**
>
>
...
...
zh-cn/application-dev/reference/apis/js-apis-application-formHost.md
浏览文件 @
3bd55d12
# @ohos.application.formHost (
F
ormHost)
# @ohos.application.formHost (
f
ormHost)
F
ormHost模块提供了卡片使用方相关接口的能力,包括对使用方同一用户下安装的卡片进行删除、释放、请求更新,获取信息、状态等操作。
f
ormHost模块提供了卡片使用方相关接口的能力,包括对使用方同一用户下安装的卡片进行删除、释放、请求更新,获取信息、状态等操作。
> **说明:**
> **说明:**
>
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 从API version 9 开始不再维护,建议使用[
F
ormHost](js-apis-app-form-formHost.md)替代。
> 从API version 9 开始不再维护,建议使用[
f
ormHost](js-apis-app-form-formHost.md)替代。
> 本模块接口均为系统接口。
> 本模块接口均为系统接口。
## 导入模块
## 导入模块
...
@@ -34,10 +34,12 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -34,10 +34,12 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
deleteForm
(
formId
,
(
error
,
data
)
=>
{
formHost
.
deleteForm
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost deleteForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost deleteForm, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -67,11 +69,13 @@ deleteForm(formId: string): Promise<void>
...
@@ -67,11 +69,13 @@ deleteForm(formId: string): Promise<void>
**参数:**
**参数:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
deleteForm
(
formId
).
then
(()
=>
{
formHost
.
deleteForm
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost deleteForm success
'
);
console
.
log
(
'
formHost deleteForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost deleteForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost deleteForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -95,10 +99,14 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -95,10 +99,14 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
releaseForm
(
formId
,
(
error
,
data
)
=>
{
formHost
.
releaseForm
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost releaseForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost releaseForm, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
console
.
log
(
'
formHost releaseForm success
'
);
}
}
});
});
```
```
...
@@ -124,10 +132,14 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<
...
@@ -124,10 +132,14 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
releaseForm
(
formId
,
true
,
(
error
,
data
)
=>
{
formHost
.
releaseForm
(
formId
,
true
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost releaseForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost releaseForm, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
console
.
log
(
'
formHost releaseForm success
'
);
}
}
});
});
```
```
...
@@ -158,11 +170,13 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>
...
@@ -158,11 +170,13 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
releaseForm
(
formId
,
true
).
then
(()
=>
{
formHost
.
releaseForm
(
formId
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost releaseForm success
'
);
console
.
log
(
'
formHost releaseForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost releaseForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost releaseForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -186,10 +200,12 @@ requestForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -186,10 +200,12 @@ requestForm(formId: string, callback: AsyncCallback<void>): void
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
requestForm
(
formId
,
(
error
,
data
)
=>
{
formHost
.
requestForm
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost requestForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost requestForm, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -219,11 +235,13 @@ requestForm(formId: string): Promise<void>
...
@@ -219,11 +235,13 @@ requestForm(formId: string): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
requestForm
(
formId
).
then
(()
=>
{
formHost
.
requestForm
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost requestForm success
'
);
console
.
log
(
'
formHost requestForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost requestForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost requestForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -242,15 +260,17 @@ castTempForm(formId: string, callback: AsyncCallback<void>): void
...
@@ -242,15 +260,17 @@ castTempForm(formId: string, callback: AsyncCallback<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formId | string | 是 | 卡片标识。 |
| formId | string | 是 | 卡片标识。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当将指定的临时卡片转换为普通卡片成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当将指定的临时卡片转换为普通卡片成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
castTempForm
(
formId
,
(
error
,
data
)
=>
{
formHost
.
castTempForm
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost castTempForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost castTempForm, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -280,11 +300,13 @@ castTempForm(formId: string): Promise<void>
...
@@ -280,11 +300,13 @@ castTempForm(formId: string): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
castTempForm
(
formId
).
then
(()
=>
{
formHost
.
castTempForm
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost castTempForm success
'
);
console
.
log
(
'
formHost castTempForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost castTempForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost castTempForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -303,15 +325,17 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void
...
@@ -303,15 +325,17 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片可见成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片可见成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyVisibleForms
(
formId
,
(
error
,
data
)
=>
{
formHost
.
notifyVisibleForms
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost notifyVisibleForms, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyVisibleForms, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -341,11 +365,13 @@ notifyVisibleForms(formIds: Array<string>): Promise<void>
...
@@ -341,11 +365,13 @@ notifyVisibleForms(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyVisibleForms
(
formId
).
then
(()
=>
{
formHost
.
notifyVisibleForms
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost notifyVisibleForms success
'
);
console
.
log
(
'
formHost notifyVisibleForms success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost notifyVisibleForms, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyVisibleForms, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -364,15 +390,17 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo
...
@@ -364,15 +390,17 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。|
| formIds | Array
<
string
>
| 是 | 卡片标识列表。|
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片不可见成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片不可见成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyInvisibleForms
(
formId
,
(
error
,
data
)
=>
{
formHost
.
notifyInvisibleForms
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost notifyInvisibleForms, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyInvisibleForms, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -402,11 +430,13 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void>
...
@@ -402,11 +430,13 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
notifyInvisibleForms
(
formId
).
then
(()
=>
{
formHost
.
notifyInvisibleForms
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost notifyInvisibleForms success
'
);
console
.
log
(
'
formHost notifyInvisibleForms success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost notifyInvisibleForms, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyInvisibleForms, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -425,15 +455,17 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void&
...
@@ -425,15 +455,17 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void&
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片可以更新成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片可以更新成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
enableFormsUpdate
(
formId
,
(
error
,
data
)
=>
{
formHost
.
enableFormsUpdate
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost enableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost enableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -463,11 +495,13 @@ enableFormsUpdate(formIds: Array<string>): Promise<void>
...
@@ -463,11 +495,13 @@ enableFormsUpdate(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
enableFormsUpdate
(
formId
).
then
(()
=>
{
formHost
.
enableFormsUpdate
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost enableFormsUpdate success
'
);
console
.
log
(
'
formHost enableFormsUpdate success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost enableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost enableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -486,15 +520,17 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void
...
@@ -486,15 +520,17 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片不可以更新成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当向卡片框架发送通知以使指定的卡片不可以更新成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
disableFormsUpdate
(
formId
,
(
error
,
data
)
=>
{
formHost
.
disableFormsUpdate
(
formId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost disableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost disableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -524,11 +560,13 @@ disableFormsUpdate(formIds: Array<string>): Promise<void>
...
@@ -524,11 +560,13 @@ disableFormsUpdate(formIds: Array<string>): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
[
"
12400633174999288
"
];
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
[
"
12400633174999288
"
];
formHost
.
disableFormsUpdate
(
formId
).
then
(()
=>
{
formHost
.
disableFormsUpdate
(
formId
).
then
(()
=>
{
console
.
log
(
'
formHost disableFormsUpdate success
'
);
console
.
log
(
'
formHost disableFormsUpdate success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost disableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost disableFormsUpdate, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -544,15 +582,17 @@ isSystemReady(callback: AsyncCallback<void>): void
...
@@ -544,15 +582,17 @@ isSystemReady(callback: AsyncCallback<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当检查系统是否准备好成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当检查系统是否准备好成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
isSystemReady
((
error
,
data
)
=>
{
formHost
.
isSystemReady
((
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost isSystemReady, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost isSystemReady, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -574,11 +614,13 @@ isSystemReady(): Promise<void>
...
@@ -574,11 +614,13 @@ isSystemReady(): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
let
formId
=
"
12400633174999288
"
;
formHost
.
isSystemReady
().
then
(()
=>
{
formHost
.
isSystemReady
().
then
(()
=>
{
console
.
log
(
'
formHost isSystemReady success
'
);
console
.
log
(
'
formHost isSystemReady success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost isSystemReady, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost isSystemReady, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -596,14 +638,16 @@ getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>):
...
@@ -596,14 +638,16 @@ getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>):
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| callback | AsyncCallback
<
Array
<
[
FormInfo](js-apis-application-formInfo.md)
>>
| 是 | 回调函数。当获取设备上所有应用提供的卡片信息成功,er
r为undefined,data为查询到的卡片信息;否则为错误对象。 |
| callback | AsyncCallback
<
Array
<
[
formInfo.FormInfo](js-apis-application-formInfo.md)
>>
| 是 | 回调函数。当获取设备上所有应用提供的卡片信息成功,erro
r为undefined,data为查询到的卡片信息;否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
formHost
.
getAllFormsInfo
((
error
,
data
)
=>
{
formHost
.
getAllFormsInfo
((
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost getAllFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost getAllFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formHost getAllFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getAllFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
...
@@ -624,15 +668,17 @@ getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>
...
@@ -624,15 +668,17 @@ getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>
| 类型 | 说明 |
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| :------------ | :---------------------------------- |
| Promise
<
Array
<
[FormInfo](js-apis-application-formInfo.md)
>>
| Promise对象,返回查询到的卡片信息。 |
| Promise
<
Array
<
[
formInfo.
FormInfo](js-apis-application-formInfo.md)
>>
| Promise对象,返回查询到的卡片信息。 |
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
formHost
.
getAllFormsInfo
().
then
((
data
)
=>
{
formHost
.
getAllFormsInfo
().
then
((
data
)
=>
{
console
.
log
(
'
formHost getAllFormsInfo data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getAllFormsInfo data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost getAllFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost getAllFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -651,14 +697,16 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
...
@@ -651,14 +697,16 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| callback | AsyncCallback
<
Array
<
[
FormInfo](js-apis-application-formInfo.md)
>>
| 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,er
r为undefined,data为查询到的卡片信息;否则为错误对象。 |
| callback | AsyncCallback
<
Array
<
[
formInfo.FormInfo](js-apis-application-formInfo.md)
>>
| 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,erro
r为undefined,data为查询到的卡片信息;否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
(
error
,
data
)
=>
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
...
@@ -681,16 +729,18 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
...
@@ -681,16 +729,18 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序Bundle名称。 |
| bundleName | string | 是 | 要查询的应用程序Bundle名称。 |
| moduleName | string | 是 | 要查询的模块名称。 |
| moduleName | string | 是 | 要查询的模块名称。 |
| callback | AsyncCallback
<
Array
<
[
FormInfo](js-apis-application-formInfo.md)
>>
| 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,er
r为undefined,data为查询到的卡片信息;否则为错误对象。 |
| callback | AsyncCallback
<
Array
<
[
formInfo.FormInfo](js-apis-application-formInfo.md)
>>
| 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,erro
r为undefined,data为查询到的卡片信息;否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
,
(
error
,
data
)
=>
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
```
```
...
@@ -716,15 +766,17 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
...
@@ -716,15 +766,17 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
| 类型 | 说明 |
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| :------------ | :---------------------------------- |
| Promise
<
Array
<
[FormInfo](js-apis-application-formInfo.md)
>>
| Promise对象,返回查询到的卡片信息。 |
| Promise
<
Array
<
[
formInfo.
FormInfo](js-apis-application-formInfo.md)
>>
| Promise对象,返回查询到的卡片信息。 |
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
).
then
((
data
)
=>
{
formHost
.
getFormsInfo
(
"
com.example.ohos.formjsdemo
"
,
"
entry
"
).
then
((
data
)
=>
{
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -743,15 +795,17 @@ deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<numb
...
@@ -743,15 +795,17 @@ deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<numb
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 有效卡片标识列表。 |
| formIds | Array
<
string
>
| 是 | 有效卡片标识列表。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数。当根据列表删除应用程序的无效卡片成功,err为undefined,data为删除的卡片个数;否则为错误对象。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数。当根据列表删除应用程序的无效卡片成功,err
or
为undefined,data为删除的卡片个数;否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
deleteInvalidForms
(
formIds
,
(
error
,
data
)
=>
{
formHost
.
deleteInvalidForms
(
formIds
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost deleteInvalidForms, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost deleteInvalidForms, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
}
}
...
@@ -783,11 +837,13 @@ deleteInvalidForms(formIds: Array<string>): Promise<number>
...
@@ -783,11 +837,13 @@ deleteInvalidForms(formIds: Array<string>): Promise<number>
**示例:**
**示例:**
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
deleteInvalidForms
(
formIds
).
then
((
data
)
=>
{
formHost
.
deleteInvalidForms
(
formIds
).
then
((
data
)
=>
{
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost deleteInvalidForms, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost deleteInvalidForms, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost deleteInvalidForms, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -805,13 +861,15 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
...
@@ -805,13 +861,15 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 查询卡片状态时携带的want信息。 |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 查询卡片状态时携带的want信息。
需要包含bundle名、ability名、module名、卡片名、卡片规格等。
|
| callback | AsyncCallback
<
[
FormStateInfo](js-apis-application-formInfo.md#formstateinfo)
>
| 是 | 回调函数。当获取卡片状态成功,er
r为undefined,data为获取到的卡片状态;否则为错误对象。 |
| callback | AsyncCallback
<
[
formInfo.FormStateInfo](js-apis-application-formInfo.md#formstateinfo)
>
| 是 | 回调函数。当获取卡片状态成功,erro
r为undefined,data为获取到的卡片状态;否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
want
=
{
import
formHost
from
'
@ohos.application.formHost
'
;
let
want
=
{
"
deviceId
"
:
""
,
"
deviceId
"
:
""
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
abilityName
"
:
"
FormAbility
"
,
"
abilityName
"
:
"
FormAbility
"
,
...
@@ -823,7 +881,7 @@ var want = {
...
@@ -823,7 +881,7 @@ var want = {
};
};
formHost
.
acquireFormState
(
want
,
(
error
,
data
)
=>
{
formHost
.
acquireFormState
(
want
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost acquireFormState, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost acquireFormState, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
}
}
...
@@ -855,7 +913,9 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>
...
@@ -855,7 +913,9 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>
**示例:**
**示例:**
```
ts
```
ts
var
want
=
{
import
formHost
from
'
@ohos.application.formHost
'
;
let
want
=
{
"
deviceId
"
:
""
,
"
deviceId
"
:
""
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
bundleName
"
:
"
ohos.samples.FormApplication
"
,
"
abilityName
"
:
"
FormAbility
"
,
"
abilityName
"
:
"
FormAbility
"
,
...
@@ -868,7 +928,7 @@ var want = {
...
@@ -868,7 +928,7 @@ var want = {
formHost
.
acquireFormState
(
want
).
then
((
data
)
=>
{
formHost
.
acquireFormState
(
want
).
then
((
data
)
=>
{
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formHost acquireFormState, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost acquireFormState, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost acquireFormState, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -890,6 +950,8 @@ on(type: "formUninstall", callback: Callback<string>): void
...
@@ -890,6 +950,8 @@ on(type: "formUninstall", callback: Callback<string>): void
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
let
callback
=
function
(
formId
)
{
let
callback
=
function
(
formId
)
{
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
}
}
...
@@ -909,11 +971,13 @@ off(type: "formUninstall", callback?: Callback<string>): void
...
@@ -909,11 +971,13 @@ off(type: "formUninstall", callback?: Callback<string>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| type | string | 是 | 填写"formUninstall",表示卡片卸载事件。 |
| type | string | 是 | 填写"formUninstall",表示卡片卸载事件。 |
| callback | Callback
<
string
>
| 否 | 回调函数。返回卡片标识。缺省时,表示注销所有已注册事件回调。
|
| callback | Callback
<
string
>
| 否 | 回调函数。返回卡片标识。缺省时,表示注销所有已注册事件回调。
<br>
需与对应on("formUninstall")的callback一致。
|
**示例:**
**示例:**
```
ts
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
let
callback
=
function
(
formId
)
{
let
callback
=
function
(
formId
)
{
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
console
.
log
(
'
formHost on formUninstall, formId:
'
+
formId
);
}
}
...
@@ -936,15 +1000,17 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A
...
@@ -936,15 +1000,17 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| isVisible | boolean | 是 | 是否可见。 |
| isVisible | boolean | 是 | 是否可见。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当通知卡片是否可见成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当通知卡片是否可见成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
notifyFormsVisible
(
formIds
,
true
,
(
error
,
data
)
=>
{
formHost
.
notifyFormsVisible
(
formIds
,
true
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost notifyFormsVisible, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyFormsVisible, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -975,11 +1041,13 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<
...
@@ -975,11 +1041,13 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<
**示例:**
**示例:**
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
notifyFormsVisible
(
formIds
,
true
).
then
(()
=>
{
formHost
.
notifyFormsVisible
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost notifyFormsVisible success
'
);
console
.
log
(
'
formHost notifyFormsVisible success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost notifyFormsVisible, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyFormsVisible, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -999,15 +1067,17 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c
...
@@ -999,15 +1067,17 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| formIds | Array
<
string
>
| 是 | 卡片标识列表。 |
| isEnableUpdate | boolean | 是 | 是否使能更新。 |
| isEnableUpdate | boolean | 是 | 是否使能更新。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当通知卡片是否启用更新状态成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当通知卡片是否启用更新状态成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
,
(
error
,
data
)
=>
{
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost notifyFormsEnableUpdate, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyFormsEnableUpdate, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -1038,11 +1108,13 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
...
@@ -1038,11 +1108,13 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
**示例:**
**示例:**
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
).
then
(()
=>
{
formHost
.
notifyFormsEnableUpdate
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost notifyFormsEnableUpdate success
'
);
console
.
log
(
'
formHost notifyFormsEnableUpdate success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost notifyFormsEnableUpdate, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost notifyFormsEnableUpdate, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
## shareForm<sup>9+</sup>
## shareForm<sup>9+</sup>
...
@@ -1051,7 +1123,7 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
...
@@ -1051,7 +1123,7 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
指定formId和远程设备Id进行卡片分享。使用callback异步回调。
指定formId和远程设备Id进行卡片分享。使用callback异步回调。
**需要权限**
:ohos.permission.REQUIRE_FORM
**需要权限**
:ohos.permission.REQUIRE_FORM
和 ohos.permission.DISTRIBUTED_DATASYNC
**系统能力**
:SystemCapability.Ability.Form
**系统能力**
:SystemCapability.Ability.Form
...
@@ -1061,16 +1133,18 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
...
@@ -1061,16 +1133,18 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>)
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| formId | string | 是 | 卡片标识。 |
| formId | string | 是 | 卡片标识。 |
| deviceId | string | 是 | 远程设备标识。 |
| deviceId | string | 是 | 远程设备标识。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当指定formId和远程设备Id进行卡片分享成功,err为undefined,否则为错误对象。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当指定formId和远程设备Id进行卡片分享成功,err
or
为undefined,否则为错误对象。 |
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
var
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
let
formId
=
"
12400633174999288
"
;
let
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
formHost
.
shareForm
(
formId
,
deviceId
,
(
error
,
data
)
=>
{
formHost
.
shareForm
(
formId
,
deviceId
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formHost shareForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost shareForm, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -1101,18 +1175,22 @@ shareForm(formId: string, deviceId: string): Promise<void>
...
@@ -1101,18 +1175,22 @@ shareForm(formId: string, deviceId: string): Promise<void>
**参数:**
**参数:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formHost
from
'
@ohos.application.formHost
'
;
var
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
let
formId
=
"
12400633174999288
"
;
let
deviceId
=
"
EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2
"
;
formHost
.
shareForm
(
formId
,
deviceId
).
then
(()
=>
{
formHost
.
shareForm
(
formId
,
deviceId
).
then
(()
=>
{
console
.
log
(
'
formHost shareForm success
'
);
console
.
log
(
'
formHost shareForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost shareForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost shareForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
## notifyFormsPrivacyProtected<sup>9+</sup>
## notifyFormsPrivacyProtected<sup>9+</sup>
notifyFormsPrivacyProtected(formIds: Array
\<
string>, isProtected: boolean, callback: AsyncCallback
\<
void>): void
notifyFormsPrivacyProtected(formIds: Array
<
string
>
, isProtected: boolean, callback: AsyncCallback
<
void
>
): void
通知指定卡片隐私保护状态改变。使用callback异步回调。
**需要权限**
:ohos.permission.REQUIRE_FORM
**需要权限**
:ohos.permission.REQUIRE_FORM
...
@@ -1126,10 +1204,51 @@ notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callb
...
@@ -1126,10 +1204,51 @@ notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callb
| deviceId | string | 是 | 远程设备标识。 |
| deviceId | string | 是 | 远程设备标识。 |
```
ts
```
ts
var
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
).
then
(()
=>
{
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost shareForm success
'
);
console
.
log
(
'
formHost shareForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost shareForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
formHost shareForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
## notifyFormsPrivacyProtected
function notifyFormsPrivacyProtected(formIds: Array
<
string
>
, isProtected: boolean): Promise
<
void
>
;
通知指定卡片隐私保护状态改变。使用Promise异步回调。
**需要权限**
:ohos.permission.REQUIRE_FORM
**系统能力**
:SystemCapability.Ability.Form
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------- | ---- | -------------------------------- |
| formIds | Array
<
string
>
| 是 | 需要修改隐私保护的卡片标识列表。 |
| isProtected | boolean | 是 | 是否进行隐私保护。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------------------- |
| Promise
<
void
>
| 无返回结果的Promise对象。 |
```
ts
import
formHost
from
'
@ohos.application.formHost
'
;
let
formIds
=
new
Array
(
"
12400633174999288
"
,
"
12400633174999289
"
);
try
{
formHost
.
notifyFormsPrivacyProtected
(
formIds
,
true
).
then
(()
=>
{
console
.
log
(
'
formHost notifyFormsPrivacyProtected success
'
);
}).
catch
((
error
)
=>
{
console
.
log
(
'
formHost notifyFormsPrivacyProtected, error:
'
+
JSON
.
stringify
(
error
));
});
}
catch
(
error
)
{
console
.
log
(
'
formHost notifyFormsPrivacyProtected, error:
'
+
JSON
.
stringify
(
error
));
}
```
zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md
浏览文件 @
3bd55d12
# @ohos.application.formInfo (
F
ormInfo)
# @ohos.application.formInfo (
f
ormInfo)
FormInfo模块提供对卡片的相关卡片信息和状态进行设置和查询的能力
。
formInfo模块提供了卡片信息和状态等相关类型和枚举
。
> **说明:**
> **说明:**
>
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 从API version 9 开始不再维护,建议使用[
F
ormInfo](js-apis-app-form-formInfo.md)替代。
> 从API version 9 开始不再维护,建议使用[
f
ormInfo](js-apis-app-form-formInfo.md)替代。
## 导入模块
## 导入模块
...
@@ -31,11 +31,11 @@ import formInfo from '@ohos.application.formInfo';
...
@@ -31,11 +31,11 @@ import formInfo from '@ohos.application.formInfo';
| colorMode |
[
ColorMode
](
#colormode
)
| 是 | 否 | 表示卡片颜色模式。 |
| colorMode |
[
ColorMode
](
#colormode
)
| 是 | 否 | 表示卡片颜色模式。 |
| isDefault | boolean | 是 | 否 | 表示是否是默认卡片。 |
| isDefault | boolean | 是 | 否 | 表示是否是默认卡片。 |
| updateEnabled | boolean | 是 | 否 | 表示卡片是否使能更新。 |
| updateEnabled | boolean | 是 | 否 | 表示卡片是否使能更新。 |
| formVisibleNotify |
string
| 是 | 否 | 表示卡片是否使能可见通知。 |
| formVisibleNotify |
boolean
| 是 | 否 | 表示卡片是否使能可见通知。 |
| relatedBundleName | string | 是 | 否 | 表示卡片所属的相关联Bundle名称。 |
| relatedBundleName | string | 是 | 否 | 表示卡片所属的相关联Bundle名称。 |
| scheduledUpdateTime | string | 是 | 否 | 表示卡片更新时间。 |
| scheduledUpdateTime | string | 是 | 否 | 表示卡片更新时间。 |
| formConfigAbility | string | 是 | 否 | 表示卡片配置ability。 |
| formConfigAbility | string | 是 | 否 | 表示卡片配置ability。 |
| updateDuration |
string
| 是 | 否 | 表示卡片更新周期。 |
| updateDuration |
number
| 是 | 否 | 表示卡片更新周期。 |
| defaultDimension | number | 是 | 否 | 表示卡片规格 |
| defaultDimension | number | 是 | 否 | 表示卡片规格 |
| supportDimensions | Array
<
number
>
| 是 | 否 | 表示卡片支持的规格。 |
| supportDimensions | Array
<
number
>
| 是 | 否 | 表示卡片支持的规格。 |
| customizeData | {[key: string]: [value: string]} | 是 | 否 | 表示卡片用户数据。 |
| customizeData | {[key: string]: [value: string]} | 是 | 否 | 表示卡片用户数据。 |
...
@@ -101,8 +101,8 @@ import formInfo from '@ohos.application.formInfo';
...
@@ -101,8 +101,8 @@ import formInfo from '@ohos.application.formInfo';
| WIDTH_KEY | "ohos.extra.param.key.form_width" | 卡片宽度。 |
| WIDTH_KEY | "ohos.extra.param.key.form_width" | 卡片宽度。 |
| HEIGHT_KEY | "ohos.extra.param.key.form_height" | 卡片高度。 |
| HEIGHT_KEY | "ohos.extra.param.key.form_height" | 卡片高度。 |
| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片。 |
| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片。 |
| ABILITY_NAME_KEY
<sup>
9+
</sup>
| "ohos.extra.param.key.ability_name" | ability名称 |
| ABILITY_NAME_KEY
<sup>
9+
</sup>
| "ohos.extra.param.key.ability_name" | ability名称
。
|
| DEVICE_ID_KEY
<sup>
9+
</sup>
| "ohos.extra.param.key.device_id" | 设备标识。
<br/>
**系统接口**
: 此接口为系统接口。
|
| DEVICE_ID_KEY
<sup>
9+
</sup>
| "ohos.extra.param.key.device_id" | 设备标识。 |
| BUNDLE_NAME_KEY
<sup>
9+
</sup>
| "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑包名称的键。|
| BUNDLE_NAME_KEY
<sup>
9+
</sup>
| "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑包名称的键。|
## FormDimension<sup>9+</sup>
## FormDimension<sup>9+</sup>
...
@@ -117,18 +117,7 @@ import formInfo from '@ohos.application.formInfo';
...
@@ -117,18 +117,7 @@ import formInfo from '@ohos.application.formInfo';
| Dimension_2_2
<sup>
9+
</sup>
| 2 | 2 x 2 form。 |
| Dimension_2_2
<sup>
9+
</sup>
| 2 | 2 x 2 form。 |
| Dimension_2_4
<sup>
9+
</sup>
| 3 | 2 x 4 form。 |
| Dimension_2_4
<sup>
9+
</sup>
| 3 | 2 x 4 form。 |
| Dimension_4_4
<sup>
9+
</sup>
| 4 | 4 x 4 form。 |
| Dimension_4_4
<sup>
9+
</sup>
| 4 | 4 x 4 form。 |
| Dimension_2_1
<sup>
9+
</sup>
| 5 | 2 x 1 form。 |
| Dimension_2_1
<sup>
9+
</sup>
| 5 | 2 x 1 form。 |
## VisibilityType
卡片可见性。
**系统能力**
:SystemCapability.Ability.Form
| 名称 | 值 | 说明 |
| ----------- | ---- | ------------ |
| FORM_VISIBLE
<sup>
9+
<sup>
| 1 | 卡片状态为可见。 |
| FORM_INVISIBLE
<sup>
9+
<sup>
| 2 | 卡片状态为不可见。 |
## FormInfoFilter<sup>9+</sup>
## FormInfoFilter<sup>9+</sup>
...
@@ -138,7 +127,7 @@ import formInfo from '@ohos.application.formInfo';
...
@@ -138,7 +127,7 @@ import formInfo from '@ohos.application.formInfo';
| 名称 | 说明 |
| 名称 | 说明 |
| ----------- | ------------ |
| ----------- | ------------ |
| moduleName
<sup>
9+
</sup>
|
仅保留moduleName与提供值相符的卡片信息
。 |
| moduleName
<sup>
9+
</sup>
|
选填。仅保留moduleName与提供值相符的卡片信息。
<br>
未填写时则不通过moduleName进行过滤
。 |
## VisibilityType<sup>9+</sup>
## VisibilityType<sup>9+</sup>
...
...
zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md
浏览文件 @
3bd55d12
# @ohos.application.formProvider (
F
ormProvider)
# @ohos.application.formProvider (
f
ormProvider)
FormProvider模块提供了卡片提供方相关接口的能力,开发者在开发卡片时,可通过该模块提供接口实现更新卡片,设置卡片更新时间,获取卡片信息,请求发布卡片等。
FormProvider模块提供了卡片提供方相关接口的能力,开发者在开发卡片时,可通过该模块提供接口实现更新卡片,设置卡片更新时间,获取卡片信息,请求发布卡片等。
> **说明:**
> **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 从API version 9 开始不再维护,建议使用[
F
ormProvider](js-apis-app-form-formProvider.md)替代。
> 从API version 9 开始不再维护,建议使用[
f
ormProvider](js-apis-app-form-formProvider.md)替代。
## 导入模块
## 导入模块
...
@@ -31,11 +31,13 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l
...
@@ -31,11 +31,13 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
let
formId
=
"
12400633174999288
"
;
formProvider
.
setFormNextRefreshTime
(
formId
,
5
,
(
error
,
data
)
=>
{
formProvider
.
setFormNextRefreshTime
(
formId
,
5
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formProvider setFormNextRefreshTime, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider setFormNextRefreshTime, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -63,11 +65,13 @@ setFormNextRefreshTime(formId: string, minute: number): Promise<void>
...
@@ -63,11 +65,13 @@ setFormNextRefreshTime(formId: string, minute: number): Promise<void>
**示例:**
**示例:**
```
ts
```
ts
var
formId
=
"
12400633174999288
"
;
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
let
formId
=
"
12400633174999288
"
;
formProvider
.
setFormNextRefreshTime
(
formId
,
5
).
then
(()
=>
{
formProvider
.
setFormNextRefreshTime
(
formId
,
5
).
then
(()
=>
{
console
.
log
(
'
formProvider setFormNextRefreshTime success
'
);
console
.
log
(
'
formProvider setFormNextRefreshTime success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formProvider setFormNextRefreshTime, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider setFormNextRefreshTime, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -84,19 +88,21 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
...
@@ -84,19 +88,21 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 |
| formId | string | 是 | 请求更新的卡片标识。 |
| formBindingData
.FormBindingData |
[
FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 是 | 用于更新的数据。 |
| formBindingData
|
[
formBindingData.
FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 是 | 用于更新的数据。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
**示例:**
```
ts
```
ts
import
formBindingData
from
'
@ohos.application.formBindingData
'
;
import
formBindingData
from
'
@ohos.application.formBindingData
'
;
var
formId
=
"
12400633174999288
"
;
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
let
formId
=
"
12400633174999288
"
;
let
obj
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
let
obj
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
formProvider
.
updateForm
(
formId
,
obj
,
(
error
,
data
)
=>
{
formProvider
.
updateForm
(
formId
,
obj
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formProvider updateForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider updateForm, error:
'
+
JSON
.
stringify
(
error
));
}
}
});
});
```
```
...
@@ -113,7 +119,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
...
@@ -113,7 +119,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| formId | string | 是 | 请求更新的卡片标识。 |
| formId | string | 是 | 请求更新的卡片标识。 |
| formBindingData
.FormBindingData |
[
FormBindingData
](
js-apis-application-formBindingData.md#formbindingdat
)
| 是 | 用于更新的数据。 |
| formBindingData
|
[
formBindingData.FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 是 | 用于更新的数据。 |
**返回值:**
**返回值:**
...
@@ -125,12 +131,14 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
...
@@ -125,12 +131,14 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
```
ts
```
ts
import
formBindingData
from
'
@ohos.application.formBindingData
'
;
import
formBindingData
from
'
@ohos.application.formBindingData
'
;
var
formId
=
"
12400633174999288
"
;
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
let
formId
=
"
12400633174999288
"
;
let
obj
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
let
obj
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
formProvider
.
updateForm
(
formId
,
obj
).
then
(()
=>
{
formProvider
.
updateForm
(
formId
,
obj
).
then
(()
=>
{
console
.
log
(
'
formProvider updateForm success
'
);
console
.
log
(
'
formProvider updateForm success
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formProvider updateForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider updateForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -146,17 +154,19 @@ getFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): voi
...
@@ -146,17 +154,19 @@ getFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): voi
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| callback | AsyncCallback
<
Array
<
[FormInfo](./js-apis-application-formInfo.md#forminfo-1)
>>
| 是 | 回调函数。返回查询到的卡片信息。 |
| callback | AsyncCallback
<
Array
<
[
formInfo.
FormInfo](./js-apis-application-formInfo.md#forminfo-1)
>>
| 是 | 回调函数。返回查询到的卡片信息。 |
**示例:**
**示例:**
```
ts
```
ts
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
formProvider
.
getFormsInfo
((
error
,
data
)
=>
{
formProvider
.
getFormsInfo
((
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formProvider getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formProvider getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
```
```
## getFormsInfo<sup>9+</sup>
## getFormsInfo<sup>9+</sup>
...
@@ -172,22 +182,24 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array&l
...
@@ -172,22 +182,24 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array&l
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| ------ | ------ | ---- | ------- |
| filter |
[
formInfo.FormInfoFilter
](
./js-apis-application-formInfo.md#forminfofilter
)
| 是 | 卡片信息过滤器。 |
| filter |
[
formInfo.FormInfoFilter
](
./js-apis-application-formInfo.md#forminfofilter
)
| 是 | 卡片信息过滤器。 |
| callback | AsyncCallback
<
Array
<
[FormInfo](./js-apis-application-formInfo.md#forminfo-1)
>>
| 是 | 回调函数。返回查询到符合条件的卡片信息。 |
| callback | AsyncCallback
<
Array
<
[
formInfo.
FormInfo](./js-apis-application-formInfo.md#forminfo-1)
>>
| 是 | 回调函数。返回查询到符合条件的卡片信息。 |
**示例:**
**示例:**
```
ts
```
ts
import
formInfo
from
'
@ohos.application.formInfo
'
;
import
formInfo
from
'
@ohos.application.formInfo
'
;
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
const
filter
:
formInfo
.
FormInfoFilter
=
{
const
filter
:
formInfo
.
FormInfoFilter
=
{
// get info of forms belong to module entry.
// get info of forms belong to module entry.
moduleName
:
"
entry
"
moduleName
:
"
entry
"
};
};
formProvider
.
getFormsInfo
(
filter
,
(
error
,
data
)
=>
{
formProvider
.
getFormsInfo
(
filter
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formProvider getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formProvider getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
```
```
...
@@ -209,20 +221,22 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.For
...
@@ -209,20 +221,22 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.For
| 类型 | 说明 |
| 类型 | 说明 |
| :------------ | :---------------------------------- |
| :------------ | :---------------------------------- |
| Promise
<
Array
<
[FormInfo](./js-apis-application-formInfo.md#forminfo-1)
>>
| Promise对象。返回查询到符合条件的卡片信息。 |
| Promise
<
Array
<
[
formInfo.
FormInfo](./js-apis-application-formInfo.md#forminfo-1)
>>
| Promise对象。返回查询到符合条件的卡片信息。 |
**示例:**
**示例:**
```
ts
```
ts
import
formInfo
from
'
@ohos.application.formInfo
'
;
import
formInfo
from
'
@ohos.application.formInfo
'
;
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
const
filter
:
formInfo
.
FormInfoFilter
=
{
const
filter
:
formInfo
.
FormInfoFilter
=
{
// get info of forms belong to module entry.
// get info of forms belong to module entry.
moduleName
:
"
entry
"
moduleName
:
"
entry
"
};
};
formProvider
.
getFormsInfo
(
filter
).
then
((
data
)
=>
{
formProvider
.
getFormsInfo
(
filter
).
then
((
data
)
=>
{
console
.
log
(
'
formProvider getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider getFormsInfo, data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formProvider getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider getFormsInfo, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -241,28 +255,29 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData,
...
@@ -241,28 +255,29 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData,
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 发布请求。需包含以下字段。
<br>
abilityName: 目标卡片ability
<br>
parameters:
<br>
"ohos.extra.param.key.form_dimension"
<br>
"ohos.extra.param.key.form_name"
<br>
"ohos.extra.param.key.module_name" |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 发布请求。需包含以下字段。
<br>
abilityName: 目标卡片ability
<br>
parameters:
<br>
"ohos.extra.param.key.form_dimension"
<br>
"ohos.extra.param.key.form_name"
<br>
"ohos.extra.param.key.module_name" |
| formBindingData
.FormBindingData |
[
FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 是 | 创建卡片的数据。 |
| formBindingData
|
[
formBindingData.
FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 是 | 创建卡片的数据。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数。返回卡片标识。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数。返回卡片标识。 |
**示例:**
**示例:**
```
ts
```
ts
import
formBindingData
from
'
@ohos.application.formBindingData
'
;
import
formBindingData
from
'
@ohos.application.formBindingData
'
;
var
want
=
{
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
abilityName
:
"
FormAbility
"
,
let
want
=
{
parameters
:
{
abilityName
:
"
FormAbility
"
,
"
ohos.extra.param.key.form_dimension
"
:
2
,
parameters
:
{
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.form_dimension
"
:
2
,
"
ohos.extra.param.key.module_name
"
:
"
entry
"
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
}
"
ohos.extra.param.key.module_name
"
:
"
entry
"
}
};
};
let
obj
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
let
obj
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
formProvider
.
requestPublishForm
(
want
,
obj
,
(
error
,
data
)
=>
{
formProvider
.
requestPublishForm
(
want
,
obj
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formProvider requestPublishForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider requestPublishForm, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formProvider requestPublishForm, form ID is:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider requestPublishForm, form ID is:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
```
```
...
@@ -286,20 +301,22 @@ requestPublishForm(want: Want, callback: AsyncCallback<string>): void
...
@@ -286,20 +301,22 @@ requestPublishForm(want: Want, callback: AsyncCallback<string>): void
**示例:**
**示例:**
```
ts
```
ts
var
want
=
{
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
abilityName
:
"
FormAbility
"
,
parameters
:
{
let
want
=
{
"
ohos.extra.param.key.form_dimension
"
:
2
,
abilityName
:
"
FormAbility
"
,
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
parameters
:
{
"
ohos.extra.param.key.module_name
"
:
"
entry
"
"
ohos.extra.param.key.form_dimension
"
:
2
,
}
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.module_name
"
:
"
entry
"
}
};
};
formProvider
.
requestPublishForm
(
want
,
(
error
,
data
)
=>
{
formProvider
.
requestPublishForm
(
want
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
console
.
log
(
'
formProvider requestPublishForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider requestPublishForm, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
console
.
log
(
'
formProvider requestPublishForm, form ID is:
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider requestPublishForm, form ID is:
'
+
JSON
.
stringify
(
data
));
}
}
});
});
```
```
...
@@ -318,7 +335,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
...
@@ -318,7 +335,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 发布请求。需包含以下字段。
<br>
abilityName: 目标卡片ability
<br>
parameters:
<br>
"ohos.extra.param.key.form_dimension"
<br>
"ohos.extra.param.key.form_name"
<br>
"ohos.extra.param.key.module_name" |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 发布请求。需包含以下字段。
<br>
abilityName: 目标卡片ability
<br>
parameters:
<br>
"ohos.extra.param.key.form_dimension"
<br>
"ohos.extra.param.key.form_name"
<br>
"ohos.extra.param.key.module_name" |
| formBindingData
.FormBindingData |
[
FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 否 | 创建卡片的数据。
|
| formBindingData
|
[
formBindingData.FormBindingData
](
js-apis-application-formBindingData.md#formbindingdata
)
| 是 | 创建卡片的数据。
|
**返回值:**
**返回值:**
...
@@ -329,18 +346,20 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
...
@@ -329,18 +346,20 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
**示例:**
**示例:**
```
ts
```
ts
var
want
=
{
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
abilityName
:
"
FormAbility
"
,
parameters
:
{
let
want
=
{
"
ohos.extra.param.key.form_dimension
"
:
2
,
abilityName
:
"
FormAbility
"
,
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
parameters
:
{
"
ohos.extra.param.key.module_name
"
:
"
entry
"
"
ohos.extra.param.key.form_dimension
"
:
2
,
}
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.module_name
"
:
"
entry
"
}
};
};
formProvider
.
requestPublishForm
(
want
).
then
((
data
)
=>
{
formProvider
.
requestPublishForm
(
want
).
then
((
data
)
=>
{
console
.
log
(
'
formProvider requestPublishForm success, form ID is :
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider requestPublishForm success, form ID is :
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
formProvider requestPublishForm, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider requestPublishForm, error:
'
+
JSON
.
stringify
(
error
));
});
});
```
```
...
@@ -368,13 +387,13 @@ formProvider.isRequestPublishFormSupported((error, isSupported) => {
...
@@ -368,13 +387,13 @@ formProvider.isRequestPublishFormSupported((error, isSupported) => {
console
.
log
(
'
formProvider isRequestPublishFormSupported, error:
'
+
JSON
.
stringify
(
error
));
console
.
log
(
'
formProvider isRequestPublishFormSupported, error:
'
+
JSON
.
stringify
(
error
));
}
else
{
}
else
{
if
(
isSupported
)
{
if
(
isSupported
)
{
var
want
=
{
let
want
=
{
abilityName
:
"
FormAbility
"
,
abilityName
:
"
FormAbility
"
,
parameters
:
{
parameters
:
{
"
ohos.extra.param.key.form_dimension
"
:
2
,
"
ohos.extra.param.key.form_dimension
"
:
2
,
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.module_name
"
:
"
entry
"
"
ohos.extra.param.key.module_name
"
:
"
entry
"
}
}
};
};
formProvider
.
requestPublishForm
(
want
,
(
error
,
data
)
=>
{
formProvider
.
requestPublishForm
(
want
,
(
error
,
data
)
=>
{
if
(
error
.
code
)
{
if
(
error
.
code
)
{
...
@@ -409,13 +428,13 @@ isRequestPublishFormSupported(): Promise<boolean>
...
@@ -409,13 +428,13 @@ isRequestPublishFormSupported(): Promise<boolean>
```
ts
```
ts
formProvider
.
isRequestPublishFormSupported
().
then
((
isSupported
)
=>
{
formProvider
.
isRequestPublishFormSupported
().
then
((
isSupported
)
=>
{
if
(
isSupported
)
{
if
(
isSupported
)
{
var
want
=
{
let
want
=
{
abilityName
:
"
FormAbility
"
,
abilityName
:
"
FormAbility
"
,
parameters
:
{
parameters
:
{
"
ohos.extra.param.key.form_dimension
"
:
2
,
"
ohos.extra.param.key.form_dimension
"
:
2
,
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.form_name
"
:
"
widget
"
,
"
ohos.extra.param.key.module_name
"
:
"
entry
"
"
ohos.extra.param.key.module_name
"
:
"
entry
"
}
}
};
};
formProvider
.
requestPublishForm
(
want
).
then
((
data
)
=>
{
formProvider
.
requestPublishForm
(
want
).
then
((
data
)
=>
{
console
.
log
(
'
formProvider requestPublishForm success, form ID is :
'
+
JSON
.
stringify
(
data
));
console
.
log
(
'
formProvider requestPublishForm success, form ID is :
'
+
JSON
.
stringify
(
data
));
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录