未验证 提交 aca19f3d 编写于 作者: O openharmony_ci 提交者: Gitee

!7484 文档修改

Merge pull request !7484 from LiAn/cherry-pick-1659176237
......@@ -7,10 +7,10 @@
​ OpenHarmony的应用框架分为FA模型和Stage两种模型。对应存在两套Context机制适配两种应用框架模型,其中application/BaseContext属于通用的Context基类,里面包含一个属性stageMode,用来区分开发模型是FA还是Stage。
- FA模型
只有app/Context中的方法属于FA模型对应的Context。该模式下,应用级别的Context和Ability级别的Context都是该类型的实例,如果在应用级别的Context里面调用了Ability级别的方法,会产生错误。所以开发者需要注意Context实例所代表的实际含义。
只有app/Context中的方法属于FA模型对应的Context。该模式下,应用级别的Context和Ability级别的Context都是该类型的实例,如果在应用级别的Context里面调用了Ability级别的方法,会产生错误。所以开发者需要注意Context实例所代表的实际含义。
- Stage模型
除了app/Context之外的Context都属于Stage模型,分别有application/Context、application/ApplicationContext、application/AbilityStageContext、application/ExtensionContext、application/AbilityContext、application/FormExtensionContext等Context。这些Context的介绍及使用方式将会在[Stage模型和Context详细介绍](#stage模型和context详细介绍)种进行说明。
除了app/Context之外的Context都属于Stage模型,分别有application/Context、application/ApplicationContext、application/AbilityStageContext、application/ExtensionContext、application/AbilityContext、application/FormExtensionContext等Context。这些Context的介绍及使用方式将会在[Stage模型和Context详细介绍](#stage模型和context详细介绍)种进行说明。
![contextIntroduction](figures/contextIntroduction.png)
......@@ -225,20 +225,21 @@ export default class MainAbility extends Ability {
[FormExtensionContext](/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md)
### 在ets页面中访问Context
### 在eTS页面中访问Context
​ Stage模型下,在Ability的`onWindowStageCreate`生命周期中,可以通过WindowStage的`SetUIContent`方法加载一个ets页面。在一些场景中,需要在页面内获取Context调用相关API。
Stage模型下,在Ability的`onWindowStageCreate`生命周期中,可以通过WindowStage的`SetUIContent`方法加载一个eTS页面。在一些场景中,需要在页面内获取Context调用相关API。
**获取方法**
​ 在ets页面中通过以下全局方法获取当前页面关联的Context。
|接口名|描述|
|:------|:------|
|getContext(component: Object): Object|获取页面中component所关联的Context对象。|
在eTS页面中通过以下全局方法获取当前页面关联的Context。
| 接口名 | 描述 |
| :------------------------------------ | :--------------------------- |
| getContext(component: Object): Object | 获取页面中component所关联的Context对象。 |
**示例**
```typescript
```ts
// MainAbility.ts
import Ability from '@ohos.application.Ability'
......@@ -264,7 +265,7 @@ export default class MainAbility extends Ability {
};
```
```typescript
```ts
// pages/index.ets
import context from '@ohos.application.context'
......@@ -290,7 +291,6 @@ struct Index {
.height('100%')
}
}
```
## 常见错误使用方式
......
# Web
> **说明:**
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> - 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> - 示例效果请以真机运行为准,当前IDE预览器不支持。
提供具有网页显示能力的Web组件。
......@@ -81,7 +83,7 @@ fileAccess(fileAccess: boolean)
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ---------- | ------- | ---- | ---- | ---------------------------------------- |
| fileAccess | boolean | 是 | - | 设置是否开启通过[$rawfile(filepath/filename)](../../ui/ts-resource-access.md)访问应用中rawfile路径的文件。 |
| fileAccess | boolean | 是 | true | 设置是否开启通过[$rawfile(filepath/filename)](../../ui/ts-resource-access.md)访问应用中rawfile路径的文件,默认启用。 |
**示例:**
```ts
......@@ -106,9 +108,9 @@ fileFromUrlAccess(fileFromUrlAccess: boolean)
设置是否允许通过网页中的JavaScript脚本访问[$rawfile(filepath/filename)](../../ui/ts-resource-access.md)的内容,默认未启用。
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ----------------- | ------- | ---- | ---- | ---------------------------------------- |
| fileFromUrlAccess | boolean | 是 | - | 设置是否允许通过网页中的JavaScript脚本访问[$rawfile(filepath/filename)](../../ui/ts-resource-access.md)的内容。 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ----------------- | ------- | ---- | ----- | ---------------------------------------- |
| fileFromUrlAccess | boolean | 是 | false | 设置是否允许通过网页中的JavaScript脚本访问[$rawfile(filepath/filename)](../../ui/ts-resource-access.md)的内容,默认未启用。 |
**示例:**
```ts
......@@ -2849,9 +2851,9 @@ static getOriginQuota(origin : string, callback : AsyncCallback\<number>) : void
使用callback回调异步获取指定源的Web SQL数据库的存储配额,配额以字节为单位。
**参数:**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | --------- |
| origin | string | 是 | 指定源的字符串索引 |
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | --------- |
| origin | string | 是 | 指定源的字符串索引 |
| callback | AsyncCallback\<number> | 是 | 指定源的存储配额。 |
**示例:**
......@@ -2893,8 +2895,8 @@ static getOriginQuota(origin : string) : Promise\<number>
| origin | string | 是 | 指定源的字符串索引。 |
**返回值:**
| 类型 | 说明 |
| --------------- | ----------------------- |
| 类型 | 说明 |
| ---------------- | ----------------------- |
| Promise\<number> | Promise实例,用于获取指定源的存储配额。 |
**示例:**
......@@ -2931,9 +2933,9 @@ static getOriginUsage(origin : string, callback : AsyncCallback\<number>) : void
以回调方式异步获取指定源的Web SQL数据库的存储量,存储量以字节为单位。
**参数:**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ---------- |
| origin | string | 是 | 指定源的字符串索引。 |
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------- |
| origin | string | 是 | 指定源的字符串索引。 |
| callback | AsyncCallback\<number> | 是 | 指定源的存储量。 |
**示例:**
......@@ -2975,8 +2977,8 @@ static getOriginUsage(origin : string) : Promise\<number>
| origin | string | 是 | 指定源的字符串索引。 |
**返回值:**
| 类型 | 说明 |
| --------------- | ---------------------- |
| 类型 | 说明 |
| ---------------- | ---------------------- |
| Promise\<number> | Promise实例,用于获取指定源的存储量。 |
**示例:**
......
# 事件配置
通过事件方法可以配置组件支持的事件。
通过事件方法可以配置组件支持的事件。从API Version 9开始,可以在回调函数中获取当前component关联的Context,具体用法请参考[在eTS页面中访问Context](../ability/context-userguide.md)
- 使用lambda表达式配置组件的事件方法:
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册