• Home
Name Date Size #Lines LOC

..--

AppScope/06-May-2025-3532

entry/06-May-2025-1,7431,512

hvigor/06-May-2025-3836

screenshots/06-May-2025-

.gitignoreD06-May-2025133 1212

README.mdD06-May-202511.6 KiB315194

build-profile.json5D06-May-20251.3 KiB5251

code-linter.json5D06-May-2025958 3534

hvigorfile.tsD06-May-2025843 225

oh-package.json5D06-May-2025834 2624

ohosTest.mdD06-May-20256.1 KiB8556

README.md

1# 使用隐私模式
2
3### 介绍
4
51. 实现对以下指南文档中 https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/web/web-incognito-mode.md 示例代码片段的工程化,保证指南中示例代码与sample工程文件同源。
6
7### AllowGeolocation
8
9#### 介绍
10
111. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过allowGeolocation设置隐私模式下的Web组件允许指定来源使用地理位置。
12
13#### 效果预览
14
15| 主页                                                        |
16| ----------------------------------------------------------- |
17| <img src="screenshots\AllowGeolocation.png" width="360;" /> |
18
19使用说明
20
211. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式
222. 点击按钮通过allowGeolocation设置隐私模式下的Web组件允许指定来源使用地理位置。
23
24### ClearAllCookiesSync
25
26#### 介绍
27
281. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过clearAllCookiesSync清除隐私模式下所有cookie。
29
30#### 效果预览
31
32| 主页                                                         |
33| ------------------------------------------------------------ |
34| <img src="screenshots\ClearAllCookiesSync.png" width="360;" /> |
35
36使用说明
37
381. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
391. 点击按钮通过clearAllCookiesSync清除隐私模式下所有cookie。
40
41### ConfigCookieSync
42
43#### 介绍
44
451. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过configCookieSync设置隐私模式下指定url的单个cookie的值。
46
47#### 效果预览
48
49| 主页                                                        |
50| ----------------------------------------------------------- |
51| <img src="screenshots\ConfigCookieSync.png" width="360;" /> |
52
53使用说明
54
551. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
562. 点击按钮通过configCookieSync设置隐私模式下指定url的单个cookie的值。
57
58### DeleteAllData
59
60#### 介绍
61
621. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过deleteAllData清除隐私模式下Web SQL当前使用的所有存储。
63
64#### 效果预览
65
66| 主页                                                     |
67| -------------------------------------------------------- |
68| <img src="screenshots\DeleteAllData.png" width="360;" /> |
69
70使用说明
71
721,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
73
742 ,  点击按钮通过deleteAllData清除隐私模式下Web SQL当前使用的所有存储。
75
76### DeleteGeolocation
77
78#### 介绍
79
801. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过deleteGeolocation清除隐私模式下指定来源的地理位置权限状态。
81
82#### 效果预览
83
84| 主页                                                         |
85| ------------------------------------------------------------ |
86| <img src="screenshots\DeleteGeolocation.png" width="360;" /> |
87
88使用说明
89
901. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
912. 点击按钮通过deleteGeolocation清除隐私模式下指定来源的地理位置权限状态。
92
93### ExistCookie
94
95#### 介绍
96
971. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过existCookie查询隐私模式下是否存在cookie。
98
99#### 效果预览
100
101| 主页                                                   |
102| ------------------------------------------------------ |
103| <img src="screenshots\ExistCookie.png" width="360;" /> |
104
105使用说明
106
1071. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
1082. 点击按钮通过existCookie查询隐私模式下是否存在cookie。
109
110### FetchCookieSync
111
112#### 介绍
113
1141. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过fetchCookieSync获取隐私模式下指定url对应cookie的值。
115
116#### 效果预览
117
118| 主页                                                       |
119| ---------------------------------------------------------- |
120| <img src="screenshots\FetchCookieSync.png" width="360;" /> |
121
122使用说明
123
1241. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
1252. 点击按钮通过fetchCookieSync获取隐私模式下指定url对应cookie的值。
126
127### GetAccessibleGeolocation
128
129#### 介绍
130
1311. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,通过getAccessibleGeolocation以回调方式异步获取隐私模式下指定源的地理位置权限状态。
132
133#### 效果预览
134
135| 主页                                                         |
136| ------------------------------------------------------------ |
137| <img src="screenshots\GetAccessibleGeolocation.png" width="360;" /> |
138
139使用说明
140
1411. 将可选参数incognitoMode设置为true,来开启Web组件的隐私模式。
1422. 点击按钮通过getAccessibleGeolocation以回调方式异步获取隐私模式下指定源的地理位置权限状态。
143
144### IncognitoMode_one
145
146#### 介绍
147
1481. 本示例主要介绍使用隐私模式,将可选参数incognitoMode设置为true,来开启Web组件的隐私模式,当使用隐私模式时,浏览网页时的Cookie、 Cache Data等数据不会保存在本地的持久化文件,当隐私模式的Web组件被销毁时,Cookie、 Cache Data等数据将不被记录下来。
149
150#### 效果预览
151
152| 主页                                                         |
153| ------------------------------------------------------------ |
154| <img src="screenshots\IncognitoMode_one.png" width="360;" /> |
155
156使用说明
157
1581. 将可选参数incognitoMode设置为true,创建隐私模式的Web组件。
159
160### IncognitoMode_two
161
162#### 介绍
163
1641. 本示例主要介绍使用隐私模式,通过isIncogntoMode判断当前Web组件是否是隐私模式。
165
166#### 效果预览
167
168| 主页                                                         |
169| ------------------------------------------------------------ |
170| <img src="screenshots\IncognitoMode_two.png" width="360;" /> |
171
172使用说明
173
1741. 点击按钮通过isIncogntoMode判断当前Web组件是否是隐私模式。
175
176# 在新窗口中打开页面
177
178### OpenPageNewWin
179
180#### 介绍
181
1821. 本示例主要介绍在新窗口中打开页面,通过multiWindowAccess()接口来设置是否允许网页在新窗口打开。
1832. 实现对以下指南文档中 https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/web/web-open-in-new-window.md 示例代码片段的工程化,保证指南中示例代码与sample工程文件同源。
184
185#### 效果预览
186
187| 主页                                                        | 新窗口页面                                                  |
188| ----------------------------------------------------------- | ----------------------------------------------------------- |
189| <img src="screenshots\OpenPageNewWin_1.png" width="360;" /> | <img src="screenshots\OpenPageNewWin_2.png" width="360;" /> |
190
191使用说明
192
1931. 通过multiWindowAccess()接口来设置是否允许网页在新窗口打开。
1941. 点击按钮在新窗口打开网页。
195
196#  管理位置权限
197
198### ManageLocPerms
199
200#### 介绍
201
2021. 本示例主要介绍管理位置权限,可以通过onGeolocationShow()接口对某个网站进行位置权限管理。Web组件根据接口响应结果,决定是否赋予前端页面权限。
2032. 实现对以下指南文档中 https://gitee.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/web/web-geolocation-permission.md 示例代码片段的工程化,保证指南中示例代码与sample工程文件同源。
204
205#### 效果预览
206
207| 主页                                                        | 提示框                                                      |
208| ----------------------------------------------------------- | ----------------------------------------------------------- |
209| <img src="screenshots\ManageLocPerms_1.png" width="360;" /> | <img src="screenshots\ManageLocPerms_2.png" width="360;" /> |
210
211使用说明
212
2131. 通过onGeolocationShow()接口对某个网站进行位置权限管理。
2141. 点击按钮,Web组件通过弹窗的形式通知应用侧位置权限请求消息。
215
216#  设置深色模式
217
218### 介绍
219
2201. 实现对以下指南文档中 https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/web/web-set-dark-mode.md 示例代码片段的工程化,保证指南中示例代码与sample工程文件同源。
221
222### DarkMode_one
223
224#### 介绍
225
2261. 本示例主要介绍对前端页面进行深色模式配置,使用darkMode()接口可以配置不同的深色模式。
227
228#### 效果预览
229
230| 主页                                                    |
231| ------------------------------------------------------- |
232| <img src="screenshots\DarkMode_one.png" width="360;" /> |
233
234使用说明
235
2361. 使用darkMode()接口将页面深色模式配置为跟随系统。
237
238### DarkMode_two
239
240#### 介绍
241
2421. 本示例主要介绍对前端页面进行深色模式配置,通过forceDarkAccess()接口可将前端页面强制配置深色模式。
243
244#### 效果预览
245
246| 主页                                                    |
247| ------------------------------------------------------- |
248| <img src="screenshots\DarkMode_two.png" width="360;" /> |
249
250使用说明
251
2521. 将深色模式配置成WebDarkMode.On,并通过forceDarkAccess()接口将页面强制配置为深色模式。
253
254## 工程目录
255
256```
257entry/src/main/
258|---ets
259|---|---entryability
260|---|---|---EntryAbility.ets
261|---|---pages
262|---|---|---Index.ets						// 首页
263|---|---|---DarkMode_one.ets
264|---|---|---DarkMode_two.ets
265|---|---|---AllowGeolocation
266|---|---|---ClearAllCookiesSync
267|---|---|---ConfigCookieSync
268|---|---|---DeleteAllData
269|---|---|---DeleteGeolocation
270|---|---|---ExistCookie
271|---|---|---FetchCookieSync
272|---|---|---GetAccessibleGeolocation
273|---|---|---IncognitoMode_one
274|---|---|---IncognitoMode_two
275|---|---|---OpenPageNewWin.ets
276|---|---|---ManageLocPerms.ets
277|---resources								// 静态资源
278|---ohosTest
279|---|---ets
280|---|---|---tests
281|---|---|---|---Ability.test.ets            // 自动化测试用例
282```
283
284## 相关权限
285
286[ohos.permission.INTERNET](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissioninternet)
287
288[ohos.permission.LOCATION](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionlocation)
289
290[ohos.permission.APPROXIMATELY_LOCATION](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionapproximatelylocation)
291
292[ohos.permission.LOCATION_IN_BACKGROUND](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionlocationinbackground)
293
294## 依赖
295
296不涉及。
297
298## 约束与限制
299
3001. 本示例仅支持标准系统上运行,支持设备:RK3568。
3012. 本示例支持API14版本SDK,SDK版本号(API Version 14 Release)。
3023. 本示例需要使用DevEco Studio 版本号(5.0.1Release)才可编译运行。
303
304## 下载
305
306如需单独下载本工程,执行如下命令:
307
308```
309git init
310git config core.sparsecheckout true
311echo code/DocsSample/ArkWeb/SetBasicAttrsEvts/SetBasicAttrsEvtsOne > .git/info/sparse-checkout
312git remote add origin https://gitee.com/openharmony/applications_app_samples.git
313git pull origin master
314```
315