@uni-helper/pages-json-schema 0.2.14 → 0.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/schema.json +2411 -288
package/schema.json CHANGED
@@ -2,87 +2,1131 @@
2
2
  "$ref": "#/definitions/PagesConfig",
3
3
  "$schema": "http://json-schema.org/draft-07/schema#",
4
4
  "definitions": {
5
+ "AnimationType": {
6
+ "description": "窗口动画,详见 [窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)",
7
+ "enum": [
8
+ "slide-in-right",
9
+ "slide-in-left",
10
+ "slide-in-top",
11
+ "slide-in-bottom",
12
+ "pop-in",
13
+ "fade-in",
14
+ "zoom-out",
15
+ "zoom-fade-out",
16
+ "none"
17
+ ],
18
+ "type": "string"
19
+ },
5
20
  "AppPlus": {
6
21
  "properties": {
7
22
  "animationDuration": {
8
- "default": "300",
9
- "description": "窗口显示动画的持续时间,单位为 ms。",
23
+ "default": 300,
24
+ "description": "窗口显示动画的持续时间,单位为 ms",
10
25
  "type": "number"
11
26
  },
12
27
  "animationType": {
28
+ "$ref": "#/definitions/AnimationType",
13
29
  "default": "pop-in",
14
- "description": "窗口显示的动画效果,详见:窗口动画。",
15
- "type": "string"
30
+ "description": "窗口显示的动画效果,详见 [窗口动画](https://uniapp.dcloud.net.cn/api/router#animation)"
16
31
  },
17
32
  "background": {
18
33
  "$ref": "#/definitions/HEXColor",
19
34
  "default": "#FFFFFF",
20
- "description": "窗体背景色。无论vue页面还是nvue页面,在App上都有一个父级原生窗体,该窗体的背景色生效时间快于页面里的css生效时间"
35
+ "description": "窗体背景色,支持 HEX 颜色\n\n无论 vue 页面还是 nvue 页面,在 App 上都有一个父级原生窗体,该窗体的背景色生效时间快于页面里的 css 生效时间",
36
+ "format": "color"
21
37
  },
22
38
  "bounce": {
23
- "description": "页面回弹效果,设置为 \"none\" 时关闭效果。",
39
+ "description": "页面回弹效果,设置为 \"none\" 时关闭效果",
24
40
  "type": "string"
25
41
  },
26
42
  "popGesture": {
27
43
  "default": "close",
28
- "description": "侧滑返回功能,可选值:\"close\"(启用侧滑返回)、\"none\"(禁用侧滑返回)",
44
+ "description": "侧滑返回功能,仅支持 \"close\" / \"none\"\n\n\"close\" 启用侧滑返回\n\n\"none\" 禁用侧滑返回",
45
+ "enum": [
46
+ "close",
47
+ "none"
48
+ ],
29
49
  "type": "string"
30
50
  },
31
51
  "pullToRefresh": {
32
52
  "description": "下拉刷新",
53
+ "properties": {
54
+ "color": {
55
+ "$ref": "#/definitions/HEXColor",
56
+ "default": "#2BD009",
57
+ "description": "下拉刷新控件颜色,仅 style 为 \"circle\" 时有效,支持 HEX 颜色",
58
+ "format": "color"
59
+ },
60
+ "contentdown": {
61
+ "description": "下拉可刷新状态时配置,仅 style 为 \"default\" 时有效",
62
+ "properties": {
63
+ "caption": {
64
+ "description": "下拉可刷新状态时下拉刷新控件标题内容",
65
+ "type": "string"
66
+ }
67
+ },
68
+ "type": "object"
69
+ },
70
+ "contentover": {
71
+ "description": "释放可刷新状态时配置,仅 style 为 \"default\" 时有效",
72
+ "properties": {
73
+ "caption": {
74
+ "description": "释放可刷新状态时下拉刷新控件标题内容",
75
+ "type": "string"
76
+ }
77
+ },
78
+ "type": "object"
79
+ },
80
+ "contentrefresh": {
81
+ "description": "正在刷新状态时配置,仅 style 为 \"default\" 时有效",
82
+ "properties": {
83
+ "caption": {
84
+ "description": "正在刷新状态时下拉刷新控件标题内容",
85
+ "type": "string"
86
+ }
87
+ },
88
+ "type": "object"
89
+ },
90
+ "height": {
91
+ "anyOf": [
92
+ {
93
+ "$ref": "#/definitions/PxSize"
94
+ },
95
+ {
96
+ "$ref": "#/definitions/PercentageSize"
97
+ }
98
+ ],
99
+ "description": "下拉刷新控件进入刷新状态的拉拽高度,支持以 px 为单位的逻辑像素值或百分比"
100
+ },
101
+ "offset": {
102
+ "anyOf": [
103
+ {
104
+ "$ref": "#/definitions/PxSize"
105
+ },
106
+ {
107
+ "$ref": "#/definitions/PercentageSize"
108
+ }
109
+ ],
110
+ "description": "下拉刷新控件的起始位置,仅 style 为 \"circle\" 时有效,用于定义刷新控件下拉时的起始位置,支持以 px 为单位的逻辑像素值或百分比\n\n如使用了非原生 title 且需要原生下拉刷新,一般都设置 style 为 \"circle\" 并将 offset 设置为自定义 title 的高度"
111
+ },
112
+ "range": {
113
+ "anyOf": [
114
+ {
115
+ "$ref": "#/definitions/PxSize"
116
+ },
117
+ {
118
+ "$ref": "#/definitions/PercentageSize"
119
+ }
120
+ ],
121
+ "description": "窗口可下拉拖拽的范围,支持以 px 为单位的逻辑像素值或百分比"
122
+ },
123
+ "style": {
124
+ "default": "Android 为 \"circle\",iOS 为 \"default\"",
125
+ "description": "下拉刷新控件样式\n\n\"default\" 下拉拖动时页面内容跟随\n\n\"circle\" 下拉拖动时仅刷新控件跟随",
126
+ "enum": [
127
+ "default",
128
+ "circle"
129
+ ],
130
+ "type": "string"
131
+ },
132
+ "support": {
133
+ "default": false,
134
+ "description": "是否开启窗口下拉刷新",
135
+ "type": "boolean"
136
+ }
137
+ },
33
138
  "type": "object"
34
139
  },
35
140
  "scrollIndicator": {
36
- "description": "滚动条显示策略,设置为 \"none\" 时不显示滚动条。",
141
+ "description": "滚动条显示策略,设置为 \"none\" 时不显示滚动条",
37
142
  "type": "string"
38
143
  },
39
144
  "softInputMode": {
40
145
  "default": "adjustPan",
41
- "description": "软键盘弹出模式,支持 adjustResize、adjustPan 两种模式",
146
+ "description": "软键盘弹出模式,仅支持 \"adjustResize\" / \"adjustPan\"",
147
+ "enum": [
148
+ "adjustResize",
149
+ "adjustPan"
150
+ ],
42
151
  "type": "string"
43
152
  },
44
153
  "softInputNavBar": {
45
154
  "default": "auto",
46
- "description": "iOS软键盘上完成工具栏的显示模式,设置为 \"none\" 时关闭工具栏。",
155
+ "description": "iOS 软键盘上完成工具栏的显示模式,设置为 \"none\" 时关闭工具栏",
156
+ "enum": [
157
+ "auto",
158
+ "none"
159
+ ],
47
160
  "type": "string"
48
161
  },
49
162
  "subNVues": {
50
- "description": "原生子窗体,详见?:原生子窗体",
51
- "type": "object"
163
+ "description": "原生子窗体,详见 [原生子窗体](https://uniapp.dcloud.net.cn/collocation/pages#app-subNVues)",
164
+ "items": {
165
+ "properties": {
166
+ "id": {
167
+ "description": "原生子窗体的标识",
168
+ "type": "string"
169
+ },
170
+ "path": {
171
+ "description": "配置 nvue 文件路径,nvue 文件需放置到使用 subNVue 的页面文件目录下,cli 项目需要去掉 .nvue 后缀,只保留文件名",
172
+ "type": "string"
173
+ },
174
+ "style": {
175
+ "description": "原生子窗体的样式",
176
+ "properties": {
177
+ "background": {
178
+ "anyOf": [
179
+ {
180
+ "$ref": "#/definitions/HEXColor"
181
+ },
182
+ {
183
+ "const": "transparent",
184
+ "type": "string"
185
+ }
186
+ ],
187
+ "default": "#FFFFFF",
188
+ "description": "窗口的背景颜色,支持 Hex 颜色\n\nAndroid 平台 4.0 以上系统支持 \"transparent\" 背景透明样式,比如 subNVue 为圆角时需要设置为 \"transparent\" 才能看到正确的效果",
189
+ "format": "color"
190
+ },
191
+ "bottom": {
192
+ "anyOf": [
193
+ {
194
+ "$ref": "#/definitions/PxSize"
195
+ },
196
+ {
197
+ "$ref": "#/definitions/PercentageSize"
198
+ }
199
+ ],
200
+ "default": "根据 top 和 height 属性值自动计算",
201
+ "description": "原生子窗体垂直向上的偏移量,支持以 px 为单位的逻辑像素值或百分比\n\n同时设置了 top 和 height 值时,忽略此属性值\n\n未设置 height 时,通过 top 和 bottom 属性值来确定原生子窗体的高度"
202
+ },
203
+ "dock": {
204
+ "default": "bottom",
205
+ "description": "原生子窗体停靠位置,仅 position 为 \"dock\" 时生效\n\n\"top\" 原生子窗体停靠在页面顶部\n\n\"bottom\" 原生子窗体停靠在页面底部\n\n\"right\" 原生子窗体停靠在页面右侧\n\n\"left\" 原生子窗体停靠在页面左侧",
206
+ "enum": [
207
+ "top",
208
+ "bottom",
209
+ "right",
210
+ "left"
211
+ ],
212
+ "type": "string"
213
+ },
214
+ "height": {
215
+ "anyOf": [
216
+ {
217
+ "$ref": "#/definitions/PxSize"
218
+ },
219
+ {
220
+ "$ref": "#/definitions/PercentageSize"
221
+ }
222
+ ],
223
+ "default": "100%",
224
+ "description": "原生子窗体的高度,支持以 px 为单位的逻辑像素值或百分比\n\n未设置时,可同时设置 top 和 bottom 属性值改变窗口的默认高度"
225
+ },
226
+ "left": {
227
+ "anyOf": [
228
+ {
229
+ "$ref": "#/definitions/PxSize"
230
+ },
231
+ {
232
+ "$ref": "#/definitions/PercentageSize"
233
+ }
234
+ ],
235
+ "default": "0px",
236
+ "description": "原生子窗体水平向左的偏移量,支持以 px 为单位的逻辑像素值或百分比\n\n未设置 left 属性值时,优先通过 right 和 width 属性值来计算原生子窗体的 left 位置"
237
+ },
238
+ "margin": {
239
+ "description": "原生子窗体的边距,用于定位原生子窗体的位置,若设置了 left、right、top、bottom 则对应的边距值失效\n\n\"auto\" 居中",
240
+ "type": "string"
241
+ },
242
+ "mask": {
243
+ "$ref": "#/definitions/RGBAColor",
244
+ "default": "rgba(0,0,0,0.5)",
245
+ "description": "原生子窗体的遮罩层,仅当原生子窗体 type 为 \"popup\" 时生效,支持 RGBA 颜色",
246
+ "format": "color"
247
+ },
248
+ "position": {
249
+ "default": "absolute",
250
+ "description": "原生子窗体的排版位置,排版位置决定原生子窗体在父窗口中的定位方式\n\n\"static\" 原生子窗体在页面中正常定位,如果页面存在滚动条则随窗口内容滚动\n\n\"absolute\" 原生子窗体在页面中绝对定位,如果页面存在滚动条不随窗口内容滚动\n\n\"dock\" 原生子窗体在页面中停靠,停靠位置由 dock 属性值决定",
251
+ "enum": [
252
+ "static",
253
+ "absolute",
254
+ "dock"
255
+ ],
256
+ "type": "string"
257
+ },
258
+ "right": {
259
+ "anyOf": [
260
+ {
261
+ "$ref": "#/definitions/PxSize"
262
+ },
263
+ {
264
+ "$ref": "#/definitions/PercentageSize"
265
+ }
266
+ ],
267
+ "default": "根据 left 和 width 属性值来自动计算",
268
+ "description": "原生子窗体水平向右的偏移量,支持以 px 为单位的逻辑像素值或百分比\n\n同时设置了 left 和 height 值时,忽略此属性值\n\n未设置 width 时,通过 left 和 bottom 属性值来确定原生子窗体的宽度"
269
+ },
270
+ "top": {
271
+ "anyOf": [
272
+ {
273
+ "$ref": "#/definitions/PxSize"
274
+ },
275
+ {
276
+ "$ref": "#/definitions/PercentageSize"
277
+ }
278
+ ],
279
+ "default": "0px",
280
+ "description": "原生子窗体垂直向下的偏移量,支持以 px 为单位的逻辑像素值或百分比\n\n未设置 top 属性值时,优先通过 bottom 和 height 属性值来计算原生子窗体的 top 位置"
281
+ },
282
+ "width": {
283
+ "anyOf": [
284
+ {
285
+ "$ref": "#/definitions/PxSize"
286
+ },
287
+ {
288
+ "$ref": "#/definitions/PercentageSize"
289
+ }
290
+ ],
291
+ "default": "100%",
292
+ "description": "原生子窗体的宽度,支持以 px 为单位的逻辑像素值或百分比\n\n未设置时,可同时设置 left 和 right 属性值改变窗口的默认宽度"
293
+ },
294
+ "zindex": {
295
+ "description": "原生子窗体的窗口的堆叠顺序值,拥有更高堆叠顺序的窗口总是会处于堆叠顺序较低的窗口的前面,拥有相同堆叠顺序的窗口后调用 show 方法则在前面",
296
+ "type": "number"
297
+ }
298
+ },
299
+ "type": "object"
300
+ },
301
+ "type": {
302
+ "description": "原生子窗口内置样式\n\n\"popup\" 弹出层\n\n\"navigationBar\" 导航栏",
303
+ "type": "string"
304
+ }
305
+ },
306
+ "type": "object"
307
+ },
308
+ "type": "array"
52
309
  },
53
310
  "titleNView": {
54
311
  "anyOf": [
55
- {
56
- "type": "object"
57
- },
58
312
  {
59
313
  "const": false,
60
314
  "type": "boolean"
315
+ },
316
+ {
317
+ "properties": {
318
+ "autoBackButton": {
319
+ "default": true,
320
+ "description": "标题栏控件是否显示左侧返回按钮",
321
+ "type": "boolean"
322
+ },
323
+ "backButton": {
324
+ "description": "返回按钮的样式,详见 [backButton](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-backbuttonstyles)",
325
+ "properties": {
326
+ "background": {
327
+ "anyOf": [
328
+ {
329
+ "$ref": "#/definitions/HEXColor"
330
+ },
331
+ {
332
+ "$ref": "#/definitions/RGBAColor"
333
+ }
334
+ ],
335
+ "default": "灰色半透明",
336
+ "description": "背景颜色,仅在标题栏 type 为 \"transparent\" 时生效,当标题栏透明时按钮显示的背景颜色,支持 HEX 和 RGBA 颜色",
337
+ "format": "color"
338
+ },
339
+ "badgeText": {
340
+ "description": "角标文本,最多显示3个字符,超过则显示为 ...",
341
+ "type": "string"
342
+ },
343
+ "color": {
344
+ "anyOf": [
345
+ {
346
+ "$ref": "#/definitions/HEXColor"
347
+ },
348
+ {
349
+ "$ref": "#/definitions/RGBAColor"
350
+ }
351
+ ],
352
+ "default": "窗口标题栏控件的标题文字颜色",
353
+ "description": "图标和标题颜色,支持 HEX 和 RGBA 颜色",
354
+ "format": "color"
355
+ },
356
+ "colorPressed": {
357
+ "anyOf": [
358
+ {
359
+ "$ref": "#/definitions/HEXColor"
360
+ },
361
+ {
362
+ "$ref": "#/definitions/RGBAColor"
363
+ }
364
+ ],
365
+ "default": "color 属性值自动调整透明度为 0.3",
366
+ "description": "按下状态按钮文字颜色,支持 HEX 和 RGBA 颜色",
367
+ "format": "color"
368
+ },
369
+ "fontSize": {
370
+ "$ref": "#/definitions/PxSize",
371
+ "description": "返回图标文字大小,单位为 px\n\n窗口标题栏为透明样式 type 为 \"transparent\" 时,默认值为 \"22px\"\n\n窗口标题栏为默认样式 type 为 \"default\" 时,默认值为 \"27px\""
372
+ },
373
+ "fontWeight": {
374
+ "default": "normal",
375
+ "description": "返回图标的粗细\n\n\"normal\" 正常\n\n\"bold\" 粗体",
376
+ "enum": [
377
+ "normal",
378
+ "bold"
379
+ ],
380
+ "type": "string"
381
+ },
382
+ "redDot": {
383
+ "default": false,
384
+ "description": "是否显示红点,当设置了角标文本时红点不显示",
385
+ "type": "boolean"
386
+ },
387
+ "title": {
388
+ "default": "",
389
+ "description": "返回按钮上的标题,显示在返回图标(字体图标)后",
390
+ "type": "string"
391
+ },
392
+ "titleWeight": {
393
+ "description": "返回按钮上标题的粗细\n\n\"normal\" 正常\n\n\"bold\" 粗体",
394
+ "enum": [
395
+ "normal",
396
+ "bold"
397
+ ],
398
+ "type": "string"
399
+ }
400
+ },
401
+ "type": "object"
402
+ },
403
+ "backgroundColor": {
404
+ "anyOf": [
405
+ {
406
+ "$ref": "#/definitions/HEXColor"
407
+ },
408
+ {
409
+ "$ref": "#/definitions/RGBAColor"
410
+ }
411
+ ],
412
+ "default": "#F7F7F7",
413
+ "description": "背景颜色,支持 HEX 和 RGBA 颜色,App 端仅悬浮导航栏支持 RGBA 颜色",
414
+ "format": "color"
415
+ },
416
+ "backgroundImage": {
417
+ "description": "背景图片\n\n背景图片路径,如 \"/static/img.png\",仅支持本地文件绝对路径,根据实际标题栏宽高拉伸绘制\n\n渐变色,仅支持线性渐变,两种颜色的渐变,如 \"linear-gradient(to top, #a80077, #66ff00)\",其中第一个参数为渐变方向,可选 \"to right\"(从左向右渐变)/ \"to left\"(从右向左渐变)/ \"to bottom\"(从上到下渐变)/ \"to top\"(从下到上渐变)/ \"to bottom right\"(从左上到右下渐变)/\"to top left\"(从左上到右下渐变)",
418
+ "type": "string"
419
+ },
420
+ "backgroundRepeat": {
421
+ "default": "no-repeat",
422
+ "description": "仅在 backgroundImage 设置为图片路径时有效\n\n\"repeat\" 背景图片在垂直方向和水平方向平铺\n\n\"repeat-x\" 背景图片在水平方向平铺,垂直方向拉伸\n\n\"repeat-y\" 背景图片在垂直方向平铺,水平方向拉伸\n\n\"no-repeat\" 背景图片在垂直方向和水平方向都拉伸",
423
+ "enum": [
424
+ "repeat",
425
+ "repeat-x",
426
+ "repeat-y",
427
+ "no-repeat"
428
+ ],
429
+ "type": "string"
430
+ },
431
+ "blurEffect": {
432
+ "default": "none",
433
+ "description": "高斯模糊效果,仅在 type 为 \"transparent\" 或 \"float\" 时有效\n\n使用模糊效果时应避免设置背景颜色,设置背景颜色可能覆盖模糊效果\n\n\"dark\" 暗风格模糊,对应 iOS 原生 UIBlurEffectStyleDark 效果\n\n\"extralight\" 高亮风格模糊,对应 iOS 原生 UIBlurEffectStyleExtraLight 效果\n\n\"light\" 亮风格模糊,对应 iOS 原生 UIBlurEffectStyleLight 效果\n\n\"none\" 无模糊效果",
434
+ "enum": [
435
+ "dark",
436
+ "extralight",
437
+ "light",
438
+ "none"
439
+ ],
440
+ "type": "string"
441
+ },
442
+ "buttons": {
443
+ "description": "自定义按钮,详见 [自定义按钮](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-buttons)",
444
+ "items": {
445
+ "$ref": "#/definitions/TitleNViewButton"
446
+ },
447
+ "type": "array"
448
+ },
449
+ "coverage": {
450
+ "anyOf": [
451
+ {
452
+ "$ref": "#/definitions/PxSize"
453
+ },
454
+ {
455
+ "$ref": "#/definitions/PercentageSize"
456
+ }
457
+ ],
458
+ "default": "132px",
459
+ "description": "标题栏控件变化作用范围,仅在 type 为 \"transparent\" 时有效,页面滚动时标题栏背景透明度将发生变化\n\n当页面滚动到指定偏移量时标题栏背景变为完全不透明\n\n支持单位为 px 的逻辑像素值、百分比"
460
+ },
461
+ "homeButton": {
462
+ "default": false,
463
+ "description": "标题栏控件是否显示 Home 按钮",
464
+ "type": "boolean"
465
+ },
466
+ "searchInput": {
467
+ "description": "原生导航栏上的搜索框配置,详见 [searchInput](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-searchinput)",
468
+ "properties": {
469
+ "align": {
470
+ "default": "center",
471
+ "description": "非输入状态下文本的对齐方式\n\n\"left\" 居左对齐\n\n\"right\" 居右对齐\n\n\"center\" 居中对齐",
472
+ "enum": [
473
+ "center",
474
+ "left",
475
+ "right"
476
+ ],
477
+ "type": "string"
478
+ },
479
+ "autoFocus": {
480
+ "default": false,
481
+ "description": "是否自动获取焦点",
482
+ "type": "boolean"
483
+ },
484
+ "backgroundColor": {
485
+ "anyOf": [
486
+ {
487
+ "$ref": "#/definitions/HEXColor"
488
+ },
489
+ {
490
+ "$ref": "#/definitions/RGBAColor"
491
+ }
492
+ ],
493
+ "default": "rgba(255,255,255,0.5)",
494
+ "description": "背景颜色,支持 HEX 和 RGBA 颜色",
495
+ "format": "color"
496
+ },
497
+ "borderRadius": {
498
+ "$ref": "#/definitions/PxSize",
499
+ "default": "0px",
500
+ "description": "输入框的圆角半径,单位为 px"
501
+ },
502
+ "disabled": {
503
+ "default": false,
504
+ "description": "是否禁止输入",
505
+ "type": "boolean"
506
+ },
507
+ "placeholder": {
508
+ "description": "提示文本",
509
+ "type": "string"
510
+ },
511
+ "placeholderColor": {
512
+ "$ref": "#/definitions/HEXColor",
513
+ "default": "#CCCCCC",
514
+ "description": "提示文本颜色,支持 HEX 颜色",
515
+ "format": "color"
516
+ }
517
+ },
518
+ "type": "object"
519
+ },
520
+ "splitLine": {
521
+ "anyOf": [
522
+ {
523
+ "type": "boolean"
524
+ },
525
+ {
526
+ "properties": {
527
+ "color": {
528
+ "anyOf": [
529
+ {
530
+ "$ref": "#/definitions/HEXColor"
531
+ },
532
+ {
533
+ "$ref": "#/definitions/RGBAColor"
534
+ }
535
+ ],
536
+ "default": "#CCCCCC",
537
+ "description": "底部分割线颜色,支持 HEX 和 RGBA 颜色",
538
+ "format": "color"
539
+ },
540
+ "height": {
541
+ "anyOf": [
542
+ {
543
+ "$ref": "#/definitions/PxSize"
544
+ },
545
+ {
546
+ "$ref": "#/definitions/PercentageSize"
547
+ }
548
+ ],
549
+ "default": "1px",
550
+ "description": "底部分割线高度,支持单位为 px 的逻辑像素值、百分比"
551
+ }
552
+ },
553
+ "type": "object"
554
+ }
555
+ ],
556
+ "default": false,
557
+ "description": "是否显示标题栏的底部分割线"
558
+ },
559
+ "subtitleColor": {
560
+ "anyOf": [
561
+ {
562
+ "$ref": "#/definitions/HEXColor"
563
+ },
564
+ {
565
+ "$ref": "#/definitions/RGBAColor"
566
+ }
567
+ ],
568
+ "default": "与主标题文字颜色一致",
569
+ "description": "副标题文字颜色,支持 HEX 和 RGBA 颜色",
570
+ "format": "color"
571
+ },
572
+ "subtitleOverflow": {
573
+ "default": "ellipsis",
574
+ "description": "标题文字超出显示区域时处理方式\n\n\"clip\" 超出显示区域时内容裁剪\n\n\"ellipsis\" 超出显示区域时尾部显示省略标记(...)",
575
+ "enum": [
576
+ "clip",
577
+ "ellipsis"
578
+ ],
579
+ "type": "string"
580
+ },
581
+ "subtitleSize": {
582
+ "anyOf": [
583
+ {
584
+ "$ref": "#/definitions/PxSize"
585
+ },
586
+ {
587
+ "const": "auto",
588
+ "type": "string"
589
+ }
590
+ ],
591
+ "default": "auto",
592
+ "description": "副标题文字字体大小,单位为 px\n\n\"auto\" 自动计算,约为 12px"
593
+ },
594
+ "subtitleText": {
595
+ "description": "副标题文字内容,设置副标题后将显示两行标题,副标题显示在主标题(titleText)下方\n\n设置副标题后将居左显示",
596
+ "type": "string"
597
+ },
598
+ "tags": {
599
+ "description": "原生 View 增强,详见 [5+ View 控件](http://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.ViewDrawTagStyles)",
600
+ "items": {
601
+ "properties": {
602
+ "color": {
603
+ "anyOf": [
604
+ {
605
+ "$ref": "#/definitions/HEXColor"
606
+ },
607
+ {
608
+ "$ref": "#/definitions/RGBAColor"
609
+ }
610
+ ],
611
+ "default": "#FFFFFF",
612
+ "description": "矩形区域颜色,支持 HEX 和 RGBA 颜色\n\n不推荐使用,推荐使用 rectStyles\n\n当 tag 属性值为 \"rect\" 时有效,用于指定矩形区域颜色",
613
+ "format": "color"
614
+ },
615
+ "id": {
616
+ "description": "绘制操作标识\n\n可通过 view 对象的 drawBitmap / drawRect / drawText / clearRect 方法进行更新",
617
+ "type": "string"
618
+ },
619
+ "inputStyles": {
620
+ "description": "绘制输入框的样式\n\n当 tag 属性值为 \"input\" 时有效,用于指定绘制输入框的样式、大小位置等信息",
621
+ "properties": {
622
+ "borderColor": {
623
+ "$ref": "#/definitions/HEXColor",
624
+ "default": "#000000",
625
+ "description": "输入框的边框颜色,支持 HEX 颜色",
626
+ "format": "color"
627
+ },
628
+ "borderRadius": {
629
+ "$ref": "#/definitions/PxSize",
630
+ "default": "0px",
631
+ "description": "输入框的边框圆角半径,单位为 px"
632
+ },
633
+ "borderWidth": {
634
+ "$ref": "#/definitions/PxSize",
635
+ "default": "1px",
636
+ "description": "输入框的边框宽度,单位为 px"
637
+ },
638
+ "fontSize": {
639
+ "$ref": "#/definitions/PxSize",
640
+ "default": "16px",
641
+ "description": "输入框的字体大小,单位为 px"
642
+ },
643
+ "placeholder": {
644
+ "description": "输入框的提示文本\n\n当用户未输入内容时显示在编辑框中(灰色文字)。",
645
+ "type": "string"
646
+ },
647
+ "type": {
648
+ "default": "text",
649
+ "description": "输入框类型\n\n\"email\" 邮箱地址输入框\n\n\"number\" 数字输入框\n\n\"search\" 搜索文本输入框\n\n\"tel\" 电话号码输入框\n\n\"text\" 普通文本输入框\n\n\"url\" URL地址输入框",
650
+ "enum": [
651
+ "email",
652
+ "number",
653
+ "search",
654
+ "tel",
655
+ "text",
656
+ "url"
657
+ ],
658
+ "type": "string"
659
+ }
660
+ },
661
+ "type": "object"
662
+ },
663
+ "position": {
664
+ "default": {
665
+ "height": "100%",
666
+ "left": "0px",
667
+ "top": "0px",
668
+ "width": "100%"
669
+ },
670
+ "description": "绘制内容区域,相对于 View 控件的区域信息\n\n当 tag 属性值为 \"img\" 时,用于指定绘制图片的目标区域\n\n当 tag 属性值为 \"rect\" 时,用于指定绘制的矩形区域\n\n当 tag 属性值为 \"font\" 时,用于指定绘制文本的目标区域,此时 height 属性值支持设置为 \"wrap_content\",表示文本高度根据内容自动计算,此时通过 top 来定位文本绘制的起始位置",
671
+ "properties": {
672
+ "bottom": {
673
+ "anyOf": [
674
+ {
675
+ "$ref": "#/definitions/PxSize"
676
+ },
677
+ {
678
+ "$ref": "#/definitions/PercentageSize"
679
+ },
680
+ {
681
+ "const": "auto",
682
+ "type": "string"
683
+ }
684
+ ],
685
+ "description": "区域顶部相对于作用对象或容器向上的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\"\n\n当设置了 top 和 height 值时,忽略此属性值\n\n当未设置 top 值时,可通过 bottom 属性值来确定区域的垂直位置\n\n当未设置 height 值时,可通过 top 和 bottom 属性值来确定区域的高度"
686
+ },
687
+ "height": {
688
+ "anyOf": [
689
+ {
690
+ "$ref": "#/definitions/PxSize"
691
+ },
692
+ {
693
+ "$ref": "#/definitions/PercentageSize"
694
+ }
695
+ ],
696
+ "default": "100%",
697
+ "description": "区域高度,相对于作用对象或容器的高度,支持单位为 px 的逻辑像素值或百分比"
698
+ },
699
+ "left": {
700
+ "anyOf": [
701
+ {
702
+ "$ref": "#/definitions/PxSize"
703
+ },
704
+ {
705
+ "$ref": "#/definitions/PercentageSize"
706
+ },
707
+ {
708
+ "const": "auto",
709
+ "type": "string"
710
+ }
711
+ ],
712
+ "default": "0px",
713
+ "description": "区域顶部相对于作用对象或容器向右的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\""
714
+ },
715
+ "right": {
716
+ "anyOf": [
717
+ {
718
+ "$ref": "#/definitions/PxSize"
719
+ },
720
+ {
721
+ "$ref": "#/definitions/PercentageSize"
722
+ },
723
+ {
724
+ "const": "auto",
725
+ "type": "string"
726
+ }
727
+ ],
728
+ "description": "区域顶部相对于作用对象或容器向左的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\"\n\n当设置了 left 和 width 值时,忽略此属性值\n\n当未设置 left 值时,可通过 right 属性值来确定区域的水平位置\n\n当未设置 width 值时,可通过 left 和 right 属性值来确定区域的宽度"
729
+ },
730
+ "top": {
731
+ "anyOf": [
732
+ {
733
+ "$ref": "#/definitions/PxSize"
734
+ },
735
+ {
736
+ "$ref": "#/definitions/PercentageSize"
737
+ },
738
+ {
739
+ "const": "auto",
740
+ "type": "string"
741
+ }
742
+ ],
743
+ "default": "0px",
744
+ "description": "区域顶部相对于作用对象或容器向下的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\""
745
+ },
746
+ "width": {
747
+ "anyOf": [
748
+ {
749
+ "$ref": "#/definitions/PxSize"
750
+ },
751
+ {
752
+ "$ref": "#/definitions/PercentageSize"
753
+ }
754
+ ],
755
+ "default": "100%",
756
+ "description": "区域宽度,相对于作用对象或容器的宽度,支持单位为 px 的逻辑像素值或百分比"
757
+ }
758
+ },
759
+ "type": "object"
760
+ },
761
+ "rectStyles": {
762
+ "description": "绘制区域的样式\n\n当 tag 属性值为 \"rect\" 时有效,用于指定绘制区域的样式、填充颜色、圆角大小等信息",
763
+ "properties": {
764
+ "borderColor": {
765
+ "anyOf": [
766
+ {
767
+ "$ref": "#/definitions/HEXColor"
768
+ },
769
+ {
770
+ "$ref": "#/definitions/RGBAColor"
771
+ }
772
+ ],
773
+ "default": "color 属性值",
774
+ "description": "矩形边框颜色,绘制矩形边框的颜色,支持 HEX 和 RGBA 颜色",
775
+ "format": "color"
776
+ },
777
+ "borderWidth": {
778
+ "$ref": "#/definitions/PxSize",
779
+ "default": "0px",
780
+ "description": "矩形边框宽度,单位为 px"
781
+ },
782
+ "color": {
783
+ "anyOf": [
784
+ {
785
+ "$ref": "#/definitions/HEXColor"
786
+ },
787
+ {
788
+ "$ref": "#/definitions/RGBAColor"
789
+ }
790
+ ],
791
+ "default": "#FFFFFF",
792
+ "description": "绘制颜色,矩形填充区域的颜色,支持 HEX 和 RGBA 颜色",
793
+ "format": "color"
794
+ },
795
+ "radius": {
796
+ "$ref": "#/definitions/PxSize",
797
+ "default": "0px",
798
+ "description": "矩形区域的圆角半径,单位为 px"
799
+ }
800
+ },
801
+ "type": "object"
802
+ },
803
+ "richTextStyles": {
804
+ "description": "绘制富文本的样式\n\n当 tag 属性值为 \"richtext\" 时有效,用于指定绘制富文本内容的默认字体颜色、字体类型等信息",
805
+ "properties": {
806
+ "align": {
807
+ "default": "left",
808
+ "description": "富文本内容的水平对齐方式,对整体内容有效,无法单独控制每行的内容\n\n\"left\" 字体在指定的区域中水平居左对齐\n\n\"center\" 字体在指定的区域中水平居中对齐\n\n\"right\" 字体在指定的区域中水平居右对齐",
809
+ "enum": [
810
+ "left",
811
+ "right",
812
+ "center"
813
+ ],
814
+ "type": "string"
815
+ },
816
+ "family": {
817
+ "description": "富文本默认使用的字体名称,如果指定名称的字体不存在,则使用默认字体",
818
+ "type": "string"
819
+ },
820
+ "fontSrc": {
821
+ "description": "富文本默认使用的字体文件路径,必须为本地路径,如果指定的文件路径无效,则使用系统默认字体",
822
+ "type": "string"
823
+ }
824
+ },
825
+ "type": "object"
826
+ },
827
+ "sprite": {
828
+ "default": {
829
+ "height": "100%",
830
+ "left": "0px",
831
+ "top": "0px",
832
+ "width": "100%"
833
+ },
834
+ "description": "图片源的绘制区域\n\n当 tag 属性值为 \"img\" 时有效,用于指定图片源的绘制区域,相对于图片的区域信息",
835
+ "properties": {
836
+ "bottom": {
837
+ "anyOf": [
838
+ {
839
+ "$ref": "#/definitions/PxSize"
840
+ },
841
+ {
842
+ "$ref": "#/definitions/PercentageSize"
843
+ },
844
+ {
845
+ "const": "auto",
846
+ "type": "string"
847
+ }
848
+ ],
849
+ "description": "区域顶部相对于作用对象或容器向上的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\"\n\n当设置了 top 和 height 值时,忽略此属性值\n\n当未设置 top 值时,可通过 bottom 属性值来确定区域的垂直位置\n\n当未设置 height 值时,可通过 top 和 bottom 属性值来确定区域的高度"
850
+ },
851
+ "height": {
852
+ "anyOf": [
853
+ {
854
+ "$ref": "#/definitions/PxSize"
855
+ },
856
+ {
857
+ "$ref": "#/definitions/PercentageSize"
858
+ }
859
+ ],
860
+ "default": "100%",
861
+ "description": "区域高度,相对于作用对象或容器的高度,支持单位为 px 的逻辑像素值或百分比"
862
+ },
863
+ "left": {
864
+ "anyOf": [
865
+ {
866
+ "$ref": "#/definitions/PxSize"
867
+ },
868
+ {
869
+ "$ref": "#/definitions/PercentageSize"
870
+ },
871
+ {
872
+ "const": "auto",
873
+ "type": "string"
874
+ }
875
+ ],
876
+ "default": "0px",
877
+ "description": "区域顶部相对于作用对象或容器向右的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\""
878
+ },
879
+ "right": {
880
+ "anyOf": [
881
+ {
882
+ "$ref": "#/definitions/PxSize"
883
+ },
884
+ {
885
+ "$ref": "#/definitions/PercentageSize"
886
+ },
887
+ {
888
+ "const": "auto",
889
+ "type": "string"
890
+ }
891
+ ],
892
+ "description": "区域顶部相对于作用对象或容器向左的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\"\n\n当设置了 left 和 width 值时,忽略此属性值\n\n当未设置 left 值时,可通过 right 属性值来确定区域的水平位置\n\n当未设置 width 值时,可通过 left 和 right 属性值来确定区域的宽度"
893
+ },
894
+ "top": {
895
+ "anyOf": [
896
+ {
897
+ "$ref": "#/definitions/PxSize"
898
+ },
899
+ {
900
+ "$ref": "#/definitions/PercentageSize"
901
+ },
902
+ {
903
+ "const": "auto",
904
+ "type": "string"
905
+ }
906
+ ],
907
+ "default": "0px",
908
+ "description": "区域顶部相对于作用对象或容器向下的偏移量,支持单位为 px 的逻辑像素值、百分比(相对于作用对象或容器的高度)或 \"auto\""
909
+ },
910
+ "width": {
911
+ "anyOf": [
912
+ {
913
+ "$ref": "#/definitions/PxSize"
914
+ },
915
+ {
916
+ "$ref": "#/definitions/PercentageSize"
917
+ }
918
+ ],
919
+ "default": "100%",
920
+ "description": "区域宽度,相对于作用对象或容器的宽度,支持单位为 px 的逻辑像素值或百分比"
921
+ }
922
+ },
923
+ "type": "object"
924
+ },
925
+ "src": {
926
+ "description": "绘制的图片资源\n\n当 tag 属性值为 \"img\" 时有效,可以是图片资源路径(字符串类型)或者图片对象(plus.nativeObj.Bitmap对象)\n\nsrc 路径支持 gif 图片,设置的图片路径文件使用 \".gif\" 后缀时则认为是 gif 图片,如\"_www/loading.gif\"",
927
+ "type": "string"
928
+ },
929
+ "tag": {
930
+ "description": "绘制操作类型\n\n\"img\" 绘制图片,与 drawBitmap 操作一致,此时 id、src、position、sprite 属性值有效\n\n\"rect\" 绘制矩形区域,与 drawRect 操作一致,此时 id、color、position、rectStyles 属性值有效\n\n\"font\" 绘制文本内容,与 drawText 操作一致,此时 id、position、text、textStyles 属性值有效\n\n\"richtext\" 绘制富文本内容,与 drawRichText 操作一致,此时 id、position、text、richTextStyles 属性值有效\n\n\"input\" 绘制输入框内容,此时 id、position、inputStyles 属性值有效",
931
+ "enum": [
932
+ "img",
933
+ "rect",
934
+ "font",
935
+ "richtext",
936
+ "input"
937
+ ],
938
+ "type": "string"
939
+ },
940
+ "text": {
941
+ "description": "绘制的文本内容\n\n当 tag 属性值为 \"font\" 时有效,用于保存绘制的文本内容",
942
+ "type": "string"
943
+ },
944
+ "textStyles": {
945
+ "description": "绘制文本的样式\n\n当 tag 属性值为 \"font\" 时有效,用于指定绘制文本内容的字体大小、字体颜色、字体类型等信息",
946
+ "properties": {
947
+ "align": {
948
+ "default": "center",
949
+ "description": "水平对齐方式\n\n\"left\" 字体在指定的区域中水平居左对齐\n\n\"center\" 字体在指定的区域中水平居中对齐\n\n\"right\" 字体在指定的区域中水平居右对齐",
950
+ "enum": [
951
+ "left",
952
+ "right",
953
+ "center"
954
+ ],
955
+ "type": "string"
956
+ },
957
+ "color": {
958
+ "anyOf": [
959
+ {
960
+ "$ref": "#/definitions/HEXColor"
961
+ },
962
+ {
963
+ "$ref": "#/definitions/RGBAColor"
964
+ }
965
+ ],
966
+ "default": "#000000",
967
+ "description": "字体颜色,支持 HEX 和 RGBA 颜色",
968
+ "format": "color"
969
+ },
970
+ "decoration": {
971
+ "default": "none",
972
+ "description": "文本装饰\n\n\"none\" 无装饰效果\n\n\"underline\" 文本带下划线效果\n\n\"line-through\" 文本带贯穿线(删除线)效果",
973
+ "enum": [
974
+ "none",
975
+ "underline",
976
+ "line-through"
977
+ ],
978
+ "type": "string"
979
+ },
980
+ "family": {
981
+ "description": "字体名称,如果指定名称的字体不存在,则使用默认字体",
982
+ "type": "string"
983
+ },
984
+ "fontSrc": {
985
+ "description": "字体文件路径",
986
+ "type": "string"
987
+ },
988
+ "lineSpacing": {
989
+ "anyOf": [
990
+ {
991
+ "$ref": "#/definitions/PxSize"
992
+ },
993
+ {
994
+ "$ref": "#/definitions/PercentageSize"
995
+ }
996
+ ],
997
+ "default": "20%",
998
+ "description": "文本行间距,支持单位为 px 的逻辑像素值或百分比"
999
+ },
1000
+ "margin": {
1001
+ "default": "0px",
1002
+ "description": "文本间距,用于设置字体在绘制目标区域四个方向(top / right / bottom / left)的边距,支持单位为 px 的逻辑像素值或百分比(相对于绘制目标区域)",
1003
+ "type": "string"
1004
+ },
1005
+ "overflow": {
1006
+ "default": "clip",
1007
+ "description": "文本内容超出显示区域时处理方式\n\n\"clip\" 超出显示区域时内容裁剪\n\n\"ellipsis\" 超出显示区域时尾部显示省略标记(...)",
1008
+ "enum": [
1009
+ "clip",
1010
+ "ellipsis"
1011
+ ],
1012
+ "type": "string"
1013
+ },
1014
+ "size": {
1015
+ "$ref": "#/definitions/PxSize",
1016
+ "default": "16px",
1017
+ "description": "字体大小,单位为 px"
1018
+ },
1019
+ "style": {
1020
+ "default": "normal",
1021
+ "description": "字体样式\n\n\"normal\" 正常样式\n\n\"italic\" 斜体样式",
1022
+ "enum": [
1023
+ "normal",
1024
+ "italic"
1025
+ ],
1026
+ "type": "string"
1027
+ },
1028
+ "verticalAlign": {
1029
+ "default": "middle",
1030
+ "description": "垂直对齐方式,文本内容在指定绘制区域中的垂直对齐方式\n\n\"top\" 垂直居顶对齐\n\n\"middle\" 垂直居中对齐\n\n\"bottom\" - 垂直居底对齐",
1031
+ "enum": [
1032
+ "top",
1033
+ "middle",
1034
+ "bottom"
1035
+ ],
1036
+ "type": "string"
1037
+ },
1038
+ "weight": {
1039
+ "default": "normal",
1040
+ "description": "字体粗细\n\n\"normal\" 正常\n\n\"bold\" 粗体",
1041
+ "enum": [
1042
+ "normal",
1043
+ "bold"
1044
+ ],
1045
+ "type": "string"
1046
+ },
1047
+ "whiteSpace": {
1048
+ "default": "nowrap",
1049
+ "description": "文本换行模式\n\n\"nowrap\" 不换行,将所有文本在一行中绘制,忽略换行符(\"\\n\")\n\n\"normal\" 自动换行,当指定的宽度无法绘制所有文本时自动换行绘制,碰到 \"\\n\" 字符时强制换行",
1050
+ "enum": [
1051
+ "normal",
1052
+ "nowrap"
1053
+ ],
1054
+ "type": "string"
1055
+ }
1056
+ },
1057
+ "type": "object"
1058
+ }
1059
+ },
1060
+ "type": "object"
1061
+ },
1062
+ "type": "array"
1063
+ },
1064
+ "titleAlign": {
1065
+ "default": "auto",
1066
+ "description": "文本对齐方式\n\n\"center\" 居中对齐\n\n\"left\" 居左对齐\n\n\"auto\" 根据平台自动选择(Android 平台居左对齐,iOS 平台居中对齐)",
1067
+ "enum": [
1068
+ "auto",
1069
+ "center",
1070
+ "left"
1071
+ ],
1072
+ "type": "string"
1073
+ },
1074
+ "titleColor": {
1075
+ "$ref": "#/definitions/HEXColor",
1076
+ "default": "#000000",
1077
+ "description": "标题文字颜色,支持 HEX 颜色",
1078
+ "format": "color"
1079
+ },
1080
+ "titleIcon": {
1081
+ "description": "标题图标,图标路径如 \"./img/t.png\",仅支持本地文件路径,相对路径,相对于当前页面的 host 位置,固定宽高为逻辑像素值 \"34px\"\n\n图片的宽高需要相同\n\n设置标题图标后标题将居左显示",
1082
+ "type": "string"
1083
+ },
1084
+ "titleIconRadius": {
1085
+ "$ref": "#/definitions/PxSize",
1086
+ "default": "0px",
1087
+ "description": "标题图标圆角,单位为 px"
1088
+ },
1089
+ "titleOverflow": {
1090
+ "default": "ellipsis",
1091
+ "description": "标题文字超出显示区域时处理方式\n\n\"ellipsis\" 超出显示区域时尾部显示省略标记(...)\n\n\"clip\" 超出显示区域时内容裁剪",
1092
+ "enum": [
1093
+ "ellipsis",
1094
+ "clip"
1095
+ ],
1096
+ "type": "string"
1097
+ },
1098
+ "titleSize": {
1099
+ "description": "标题文字大小",
1100
+ "type": "string"
1101
+ },
1102
+ "titleText": {
1103
+ "description": "标题文字内容",
1104
+ "type": "string"
1105
+ },
1106
+ "type": {
1107
+ "default": "default",
1108
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"transparent\" 滚动透明渐变\n\n\"float\" 悬浮导航栏",
1109
+ "enum": [
1110
+ "default",
1111
+ "transparent",
1112
+ "float"
1113
+ ],
1114
+ "type": "string"
1115
+ }
1116
+ },
1117
+ "type": "object"
61
1118
  }
62
1119
  ],
63
- "description": "导航栏 ,详见?:导航栏; 设置为 false 不显示默认导航栏"
1120
+ "description": "导航栏,详见 [导航栏](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview)\n\n当 navigationStyle 设为 \"custom\" 或 titleNView 设为 false时,原生导航栏不显示,详见 [自定义导航栏使用注意](https://uniapp.dcloud.net.cn/collocation/pages#customnav)"
64
1121
  }
65
1122
  },
66
1123
  "type": "object"
67
1124
  },
68
- "Color": {
69
- "anyOf": [
70
- {
71
- "$ref": "#/definitions/RGBColor"
72
- },
73
- {
74
- "$ref": "#/definitions/RGBAColor"
75
- },
76
- {
77
- "$ref": "#/definitions/HEXColor"
78
- }
79
- ]
80
- },
81
1125
  "Condition": {
82
1126
  "additionalProperties": false,
83
1127
  "properties": {
84
1128
  "current": {
85
- "description": "当前激活的模式,list节点的索引值",
1129
+ "description": "当前激活的模式,list 节点的索引值",
86
1130
  "type": "number"
87
1131
  },
88
1132
  "list": {
@@ -108,18 +1152,25 @@
108
1152
  "type": "array"
109
1153
  }
110
1154
  },
1155
+ "required": [
1156
+ "current",
1157
+ "list"
1158
+ ],
111
1159
  "type": "object"
112
1160
  },
113
1161
  "EasyCom": {
114
1162
  "additionalProperties": false,
115
1163
  "properties": {
116
1164
  "autoscan": {
1165
+ "default": true,
1166
+ "description": "是否开启自动扫描,开启后将会自动扫描符合 `components/组件名称/组件名称.vue` 目录结构的组件",
117
1167
  "type": "boolean"
118
1168
  },
119
1169
  "custom": {
120
1170
  "additionalProperties": {
121
1171
  "type": "string"
122
1172
  },
1173
+ "description": "以正则方式自定义组件匹配规则\n\n如果 `autoscan` 不能满足需求,可以使用 `custom` 自定义匹配规则",
123
1174
  "type": "object"
124
1175
  }
125
1176
  },
@@ -128,130 +1179,132 @@
128
1179
  "GlobalStyle": {
129
1180
  "properties": {
130
1181
  "animationDuration": {
131
- "default": "300",
1182
+ "default": 300,
132
1183
  "description": "窗口显示动画的持续时间,单位为 ms",
133
1184
  "type": "number"
134
1185
  },
135
1186
  "animationType": {
1187
+ "$ref": "#/definitions/AnimationType",
136
1188
  "default": "pop-in",
137
- "description": "窗口显示的动画效果,详见:窗口动画",
138
- "type": "string"
1189
+ "description": "窗口显示的动画效果,详见 [窗口动画](https://uniapp.dcloud.net.cn/api/router#animation)"
139
1190
  },
140
1191
  "app-plus": {
141
1192
  "$ref": "#/definitions/AppPlus",
142
- "description": "设置编译到 App 平台的特定样式,配置项参考下方 app-plus"
1193
+ "description": "设置编译到 App 平台的特定样式,配置项参考 [app-plus](https://uniapp.dcloud.net.cn/collocation/pages#app-plus)\n\n相应的类型是 AppPlus"
143
1194
  },
144
1195
  "backgroundColor": {
145
- "anyOf": [
146
- {
147
- "$ref": "#/definitions/HEXColor"
148
- },
149
- {
150
- "$ref": "#/definitions/ThemeColor"
151
- }
152
- ],
1196
+ "$ref": "#/definitions/HEXColor",
153
1197
  "default": "#ffffff",
154
- "description": "下拉显示出来的窗口的背景色"
1198
+ "description": "下拉显示出来的窗口的背景色,支持 HEX 颜色",
1199
+ "format": "color"
155
1200
  },
156
1201
  "backgroundColorBottom": {
157
- "anyOf": [
158
- {
159
- "$ref": "#/definitions/HEXColor"
160
- },
161
- {
162
- "$ref": "#/definitions/ThemeColor"
163
- }
164
- ],
1202
+ "$ref": "#/definitions/HEXColor",
165
1203
  "default": "#ffffff",
166
- "description": "底部窗口的背景色(bounce回弹区域)"
1204
+ "description": "底部窗口的背景色(bounce回弹区域)",
1205
+ "format": "color"
167
1206
  },
168
1207
  "backgroundColorTop": {
169
- "anyOf": [
170
- {
171
- "$ref": "#/definitions/HEXColor"
172
- },
173
- {
174
- "$ref": "#/definitions/ThemeColor"
175
- }
176
- ],
1208
+ "$ref": "#/definitions/HEXColor",
177
1209
  "default": "#ffffff",
178
- "description": "顶部窗口的背景色(bounce回弹区域)"
1210
+ "description": "顶部窗口的背景色(bounce回弹区域)",
1211
+ "format": "color"
179
1212
  },
180
1213
  "backgroundTextStyle": {
181
1214
  "default": "dark",
182
- "description": "下拉 loading 的样式,仅支持 dark / light",
1215
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
1216
+ "enum": [
1217
+ "dark",
1218
+ "light"
1219
+ ],
183
1220
  "type": "string"
184
1221
  },
185
1222
  "dynamicRpx": {
186
- "default": "false",
187
- "description": "动态 rpx,屏幕大小变化会重新渲染 rpx",
1223
+ "default": false,
1224
+ "description": "是否使用动态 rpx,屏幕大小变化会重新渲染 rpx",
188
1225
  "type": "boolean"
189
1226
  },
190
1227
  "enablePullDownRefresh": {
191
- "default": "false",
192
- "description": "是否开启下拉刷新,详见页面生命周期。",
1228
+ "default": false,
1229
+ "description": "是否开启下拉刷新,详见 [页面生命周期](https://uniapp.dcloud.net.cn/tutorial/page.html#lifecycle)",
193
1230
  "type": "boolean"
194
1231
  },
195
1232
  "h5": {
196
1233
  "$ref": "#/definitions/H5",
197
- "description": "设置编译到 H5 平台的特定样式,配置项参考下方 H5"
1234
+ "description": "设置编译到 H5 平台的特定样式,配置项参考 [H5](https://uniapp.dcloud.net.cn/collocation/pages#h5)\n\n相应的类型是 H5"
198
1235
  },
199
1236
  "leftWindow": {
200
- "default": "true",
201
- "description": "当存在 leftWindow 时,默认是否显示 leftWindow",
1237
+ "default": true,
1238
+ "description": "当存在 leftWindow 时,默认是否显示 leftWindow,详见 [topWindow](https://uniapp.dcloud.net.cn/collocation/pages.html#topwindow)",
202
1239
  "type": "boolean"
203
1240
  },
204
1241
  "maxWidth": {
205
- "description": "单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选)",
1242
+ "description": "当浏览器可见区域宽度大于 maxWidth 时两侧留白,当小于等于 maxWidth 时页面铺满,单位为 px\n\n不同页面支持配置不同的 maxWidth\n\nmaxWidth = leftWindow(可选)+ page(页面主体)+ rightWindow(可选)\n\n使用时,页面内 fixed 元素需要使用 --window-left 和 --window-right 来保证布局位置正确",
206
1243
  "type": "number"
207
1244
  },
208
1245
  "mp-alipay": {
209
- "description": "设置编译到 mp-alipay 平台的特定样式,配置项参考下方 MP-ALIPAY",
210
- "type": "object"
1246
+ "$ref": "#/definitions/MpAlipay",
1247
+ "description": "设置编译到 mp-alipay 平台的特定样式,配置项参考 [MP-ALIPAY](https://uniapp.dcloud.net.cn/collocation/pages#mp-alipay) 和 <https://opendocs.alipay.com/mini/framework/app-json#window>\n\n相应的类型是 MpAlipay"
211
1248
  },
212
1249
  "mp-baidu": {
213
- "description": "设置编译到 mp-baidu 平台的特定样式",
214
- "type": "object"
1250
+ "$ref": "#/definitions/MpBaidu",
1251
+ "description": "设置编译到 mp-baidu 平台的特定样式,配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu) 和 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>\n\n相应的类型是 MpBaidu"
215
1252
  },
216
1253
  "mp-jd": {
217
- "description": "设置编译到 mp-jd 平台的特定样式",
218
- "type": "object"
1254
+ "$ref": "#/definitions/MpJd",
1255
+ "description": "设置编译到 mp-jd 平台的特定样式\n\n相应的类型是 MpJd"
219
1256
  },
220
1257
  "mp-kuaishou": {
221
- "description": "设置编译到 mp-kuaishou 平台的特定样式",
222
- "type": "object"
1258
+ "$ref": "#/definitions/MpKuaishou",
1259
+ "description": "设置编译到 mp-kuaishou 平台的特定样式\n\n相应的类型是 MpKuaishou"
223
1260
  },
224
1261
  "mp-lark": {
225
- "description": "设置编译到 mp-lark 平台的特定样式",
226
- "type": "object"
1262
+ "$ref": "#/definitions/MpLark",
1263
+ "description": "设置编译到 mp-lark 平台的特定样式\n\n相应的类型是 MpLark"
227
1264
  },
228
1265
  "mp-qq": {
229
- "description": "设置编译到 mp-qq 平台的特定样式",
230
- "type": "object"
1266
+ "$ref": "#/definitions/MpQq",
1267
+ "description": "设置编译到 mp-qq 平台的特定样式\n\n相应的类型是 MpQq"
231
1268
  },
232
1269
  "mp-toutiao": {
233
- "description": "设置编译到 mp-toutiao 平台的特定样式",
234
- "type": "object"
1270
+ "$ref": "#/definitions/MpToutiao",
1271
+ "description": "设置编译到 mp-toutiao 平台的特定样式,配置项参考 <https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration#window>\n\n相应的类型是 MpToutiao"
235
1272
  },
236
1273
  "mp-weixin": {
237
- "description": "设置编译到 mp-weixin 平台的特定样式",
238
- "type": "object"
1274
+ "$ref": "#/definitions/MpWeixin",
1275
+ "description": "设置编译到 mp-weixin 平台的特定样式,配置项参考 [MP-WEIXIN](https://uniapp.dcloud.net.cn/collocation/pages#mp-weixin) 和 <https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#window>\n\n相应的类型是 MpWeixin"
239
1276
  },
240
1277
  "navigationBarBackgroundColor": {
241
- "anyOf": [
242
- {
243
- "$ref": "#/definitions/HEXColor"
244
- },
245
- {
246
- "$ref": "#/definitions/ThemeColor"
1278
+ "$ref": "#/definitions/HEXColor",
1279
+ "description": "导航栏背景颜色(同状态栏背景色),支持 HEX 颜色",
1280
+ "format": "color"
1281
+ },
1282
+ "navigationBarShadow": {
1283
+ "additionalProperties": false,
1284
+ "description": "导航栏阴影",
1285
+ "properties": {
1286
+ "colorType": {
1287
+ "description": "阴影颜色",
1288
+ "enum": [
1289
+ "grey",
1290
+ "blue",
1291
+ "green",
1292
+ "orange",
1293
+ "red",
1294
+ "yellow"
1295
+ ],
1296
+ "type": "string"
247
1297
  }
248
- ],
249
- "default": "#F7F7F7",
250
- "description": "导航栏背景颜色(同状态栏背景色)"
1298
+ },
1299
+ "type": "object"
251
1300
  },
252
1301
  "navigationBarTextStyle": {
253
- "default": "white",
254
- "description": "导航栏标题颜色及状态栏前景颜色,仅支持 black/white",
1302
+ "default": "black",
1303
+ "description": "导航栏标题颜色及状态栏前景颜色,仅支持 \"black\" / \"white\"",
1304
+ "enum": [
1305
+ "black",
1306
+ "white"
1307
+ ],
255
1308
  "type": "string"
256
1309
  },
257
1310
  "navigationBarTitleText": {
@@ -260,67 +1313,80 @@
260
1313
  },
261
1314
  "navigationStyle": {
262
1315
  "default": "default",
263
- "description": "导航栏样式,仅支持 default/custom。custom即取消默认的原生导航栏,需看使用注意",
1316
+ "description": "导航栏样式,仅支持 \"default\" / \"custom\"\n\n\"custom\" 即取消默认的原生导航栏,详看 [使用注意](https://uniapp.dcloud.net.cn/collocation/pages#customnav)",
1317
+ "enum": [
1318
+ "default",
1319
+ "custom"
1320
+ ],
264
1321
  "type": "string"
265
1322
  },
266
1323
  "onReachBottomDistance": {
267
- "default": "50",
268
- "description": "页面上拉触底事件触发时距页面底部距离,单位只支持px,详见页面生命周期",
1324
+ "default": 50,
1325
+ "description": "页面上拉触底事件触发时距页面底部距离,单位为 px,详见 [页面生命周期](https://uniapp.dcloud.net.cn/tutorial/page.html#lifecycle)",
269
1326
  "type": "number"
270
1327
  },
271
1328
  "pageOrientation": {
272
1329
  "default": "portrait",
273
- "description": "横屏配置,屏幕旋转设置,仅支持 auto / portrait / landscape 详见 响应显示区域变化",
1330
+ "description": "横屏配置,屏幕旋转设置,仅支持 \"auto\" / \"portrait\" / \"landscape\",详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)\n\n\"auto\" 自动\n\n\"portrait\" 竖屏\n\n\"landscape\" 横屏",
274
1331
  "type": "string"
275
1332
  },
276
1333
  "renderingMode": {
277
- "description": "同层渲染,webrtc(实时音视频) 无法正常时尝试配置 seperated 强制关掉同层",
1334
+ "description": "同层渲染,webrtc(实时音视频)无法正常时尝试配置为 \"seperated\" 强制关掉同层渲染",
278
1335
  "type": "string"
279
1336
  },
280
1337
  "rightWindow": {
281
- "default": "true",
282
- "description": "当存在 rightWindow 时,默认是否显示 rightWindow",
1338
+ "default": true,
1339
+ "description": "当存在 rightWindow 时,默认是否显示 rightWindow,详见 [topWindow](https://uniapp.dcloud.net.cn/collocation/pages.html#topwindow)",
283
1340
  "type": "boolean"
284
1341
  },
285
1342
  "rpxCalcBaseDeviceWidth": {
286
- "default": "375",
287
- "description": "rpx 计算使用的基准设备宽度,设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算,单位 px",
1343
+ "default": 375,
1344
+ "description": "rpx 计算使用的基准设备宽度,设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算,单位为 px",
288
1345
  "type": "number"
289
1346
  },
290
1347
  "rpxCalcIncludeWidth": {
291
- "default": "750",
292
- "description": "rpx 计算特殊处理的值,始终按实际的设备宽度计算,单位 rpx",
1348
+ "default": 750,
1349
+ "description": "rpx 计算特殊处理的值,始终按实际的设备宽度计算,单位为 rpx",
293
1350
  "type": "number"
294
1351
  },
295
1352
  "rpxCalcMaxDeviceWidth": {
296
- "default": "960",
297
- "description": "rpx 计算所支持的最大设备宽度,单位 px",
1353
+ "default": 960,
1354
+ "description": "rpx 计算所支持的最大设备宽度,单位为 px",
298
1355
  "type": "number"
299
1356
  },
300
1357
  "titleImage": {
301
- "description": "导航栏图片地址(替换当前文字标题),支付宝小程序内必须使用https的图片链接地址",
1358
+ "description": "导航栏图片地址(替换当前文字标题)\n\n支付宝小程序内必须使用 https 图片链接地址",
302
1359
  "type": "string"
303
1360
  },
304
1361
  "titlePenetrate": {
305
1362
  "default": "NO",
306
1363
  "description": "导航栏点击穿透",
1364
+ "enum": [
1365
+ "YES",
1366
+ "NO"
1367
+ ],
307
1368
  "type": "string"
308
1369
  },
309
1370
  "topWindow": {
310
- "default": "true",
311
- "description": "当存在 topWindow 时,默认是否显示 topWindow",
1371
+ "default": true,
1372
+ "description": "当存在 topWindow 时,默认是否显示 topWindow,详见 [topWindow](https://uniapp.dcloud.net.cn/collocation/pages.html#topwindow)",
312
1373
  "type": "boolean"
313
1374
  },
314
1375
  "transparentTitle": {
315
1376
  "default": "none",
316
- "description": "导航栏整体(前景、背景)透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明",
1377
+ "description": "导航栏整体(前景、背景)透明设置,仅支持 \"always\" / \"auto\" / \"none\n\n\"always\" 一直透明\n\n\"auto\" 滑动自适应\n\n\"none\" 不透明",
1378
+ "enum": [
1379
+ "always",
1380
+ "auto",
1381
+ "none"
1382
+ ],
317
1383
  "type": "string"
318
1384
  },
319
1385
  "usingComponents": {
320
1386
  "additionalProperties": {
321
1387
  "type": "string"
322
1388
  },
323
- "description": "引用小程序组件,参考 小程序组件",
1389
+ "description": "引用小程序组件,详见 [小程序组件](https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html#%E5%B0%8F%E7%A8%8B%E5%BA%8F%E8%87%AA%E5%AE%9A%E4%B9%89%E7%BB%84%E4%BB%B6%E6%94%AF%E6%8C%81)",
324
1390
  "type": "object"
325
1391
  }
326
1392
  },
@@ -328,37 +1394,132 @@
328
1394
  },
329
1395
  "H5": {
330
1396
  "properties": {
331
- "backgroundColor": {
332
- "$ref": "#/definitions/HEXColor",
333
- "default": "#F7F7F7",
334
- "description": "背景颜色,颜色值格式为\"#RRGGBB\"。"
335
- },
336
- "buttons": {
337
- "description": "自定义按钮,参考 buttons",
338
- "items": {},
339
- "type": "array"
340
- },
341
- "searchInput": {
342
- "description": "导航栏上的搜索框样式,详见:searchInput",
1397
+ "pullToRefresh": {
1398
+ "description": "下拉刷新,详见 [下拉刷新](https://uniapp.dcloud.net.cn/collocation/pages#h5-pulltorefresh)",
1399
+ "properties": {
1400
+ "color": {
1401
+ "$ref": "#/definitions/HEXColor",
1402
+ "default": "#2BD009",
1403
+ "description": "下拉刷新控件颜色,支持 HEX 颜色"
1404
+ },
1405
+ "offset": {
1406
+ "anyOf": [
1407
+ {
1408
+ "$ref": "#/definitions/PxSize"
1409
+ },
1410
+ {
1411
+ "$ref": "#/definitions/PercentageSize"
1412
+ }
1413
+ ],
1414
+ "default": "0px",
1415
+ "description": "下拉刷新控件起始位置,支持支持单位为 px 的逻辑像素值或百分比"
1416
+ }
1417
+ },
343
1418
  "type": "object"
344
1419
  },
345
- "titleColor": {
346
- "$ref": "#/definitions/HEXColor",
347
- "default": "#000000",
348
- "description": "标题文字颜色"
349
- },
350
- "titleSize": {
351
- "description": "标题文字字体大小",
352
- "type": "string"
353
- },
354
- "titleText": {
355
- "description": "标题文字内容",
356
- "type": "string"
357
- },
358
- "type": {
359
- "default": "default",
360
- "description": "导航栏样式。\"default\"-默认样式;\"transparent\"-透明渐变。",
361
- "type": "string"
1420
+ "titleNView": {
1421
+ "anyOf": [
1422
+ {
1423
+ "const": false,
1424
+ "type": "boolean"
1425
+ },
1426
+ {
1427
+ "properties": {
1428
+ "backgroundColor": {
1429
+ "$ref": "#/definitions/HEXColor",
1430
+ "default": "#F7F7F7",
1431
+ "description": "背景颜色,支持 HEX 颜色",
1432
+ "format": "color"
1433
+ },
1434
+ "buttons": {
1435
+ "description": "自定义按钮,详见 [自定义按钮](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-buttons)",
1436
+ "items": {
1437
+ "$ref": "#/definitions/TitleNViewButton"
1438
+ },
1439
+ "type": "array"
1440
+ },
1441
+ "searchInput": {
1442
+ "description": "导航栏上的搜索框配置,详见 [searchInput](https://uniapp.dcloud.net.cn/collocation/pages#h5-searchinput)",
1443
+ "properties": {
1444
+ "align": {
1445
+ "default": "center",
1446
+ "description": "非输入状态下文本的对齐方式\n\n\"left\" 居左对齐\n\n\"right\" 居右对齐\n\n\"center\" 居中对齐",
1447
+ "enum": [
1448
+ "center",
1449
+ "left",
1450
+ "right"
1451
+ ],
1452
+ "type": "string"
1453
+ },
1454
+ "autoFocus": {
1455
+ "default": false,
1456
+ "description": "是否自动获取焦点",
1457
+ "type": "boolean"
1458
+ },
1459
+ "backgroundColor": {
1460
+ "anyOf": [
1461
+ {
1462
+ "$ref": "#/definitions/HEXColor"
1463
+ },
1464
+ {
1465
+ "$ref": "#/definitions/RGBAColor"
1466
+ }
1467
+ ],
1468
+ "default": "rgba(255,255,255,0.5)",
1469
+ "description": "背景颜色,支持 HEX 和 RGBA 颜色",
1470
+ "format": "color"
1471
+ },
1472
+ "borderRadius": {
1473
+ "$ref": "#/definitions/PxSize",
1474
+ "default": "0px",
1475
+ "description": "输入框的圆角半径,单位为 px"
1476
+ },
1477
+ "disabled": {
1478
+ "default": false,
1479
+ "description": "是否禁止输入",
1480
+ "type": "boolean"
1481
+ },
1482
+ "placeholder": {
1483
+ "description": "提示文本",
1484
+ "type": "string"
1485
+ },
1486
+ "placeholderColor": {
1487
+ "$ref": "#/definitions/HEXColor",
1488
+ "default": "#CCCCCC",
1489
+ "description": "提示文本颜色,支持 HEX 颜色",
1490
+ "format": "color"
1491
+ }
1492
+ },
1493
+ "type": "object"
1494
+ },
1495
+ "titleColor": {
1496
+ "$ref": "#/definitions/HEXColor",
1497
+ "default": "#000000",
1498
+ "description": "标题文字颜色,支持 HEX 颜色",
1499
+ "format": "color"
1500
+ },
1501
+ "titleSize": {
1502
+ "description": "标题文字大小",
1503
+ "type": "string"
1504
+ },
1505
+ "titleText": {
1506
+ "description": "标题文字内容",
1507
+ "type": "string"
1508
+ },
1509
+ "type": {
1510
+ "default": "default",
1511
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"transparent\" 滚动透明渐变",
1512
+ "enum": [
1513
+ "default",
1514
+ "transparent"
1515
+ ],
1516
+ "type": "string"
1517
+ }
1518
+ },
1519
+ "type": "object"
1520
+ }
1521
+ ],
1522
+ "description": "导航栏,详见 [导航栏](https://uniapp.dcloud.net.cn/collocation/pages#h5-titlenview)"
362
1523
  }
363
1524
  },
364
1525
  "type": "object"
@@ -366,115 +1527,847 @@
366
1527
  "HEXColor": {
367
1528
  "type": "string"
368
1529
  },
369
- "IconFont": {
370
- "additionalProperties": false,
1530
+ "MpAlipay": {
1531
+ "description": "设置编译到 mp-alipay 平台的特定样式,配置项参考 [MP-ALIPAY](https://uniapp.dcloud.net.cn/collocation/pages#mp-alipay) 和 <https://opendocs.alipay.com/mini/framework/app-json#window>\n\n相应的类型是 MpAlipay",
371
1532
  "properties": {
372
- "color": {
373
- "description": "字体图标颜色",
1533
+ "allowsBounceVertical": {
1534
+ "default": "YES",
1535
+ "description": "是否允许向下拉拽",
1536
+ "enum": [
1537
+ "YES",
1538
+ "NO"
1539
+ ],
374
1540
  "type": "string"
375
1541
  },
376
- "fontSize": {
377
- "description": "字体图标字号(px)",
378
- "type": "string"
1542
+ "backgroundColor": {
1543
+ "$ref": "#/definitions/HEXColor",
1544
+ "description": "窗口的背景色,支持 HEX 颜色",
1545
+ "format": "color"
379
1546
  },
380
- "selectedColor": {
381
- "description": "字体图标选中颜色",
382
- "type": "string"
1547
+ "backgroundImageColor": {
1548
+ "$ref": "#/definitions/HEXColor",
1549
+ "description": "下拉露出显示背景图的底色,仅 Android 有效,iOS 下页面背景图底色会使用 backgroundColor 的值",
1550
+ "format": "color"
383
1551
  },
384
- "selectedText": {
385
- "description": "选中后字库 Unicode 码",
1552
+ "backgroundImageUrl": {
1553
+ "description": "下拉露出显示背景图的链接,支持网络地址和本地地址,尽量使用绝对地址",
386
1554
  "type": "string"
387
1555
  },
388
- "text": {
389
- "description": "字库 Unicode 码",
390
- "type": "string"
391
- }
392
- },
393
- "type": "object"
394
- },
395
- "MidButton": {
396
- "additionalProperties": false,
397
- "properties": {
398
- "backgroundImage": {
399
- "description": "中间按钮的背景图片路径",
1556
+ "defaultTitle": {
1557
+ "description": "页面默认标题",
400
1558
  "type": "string"
401
1559
  },
402
- "height": {
403
- "default": "50px",
404
- "description": "中间按钮的高度,可以大于 tabBar 高度,达到中间凸起的效果",
1560
+ "enableScrollBar": {
1561
+ "default": "YES",
1562
+ "description": "仅支持 Android,是否显示 WebView 滚动条",
1563
+ "enum": [
1564
+ "YES",
1565
+ "NO"
1566
+ ],
405
1567
  "type": "string"
406
1568
  },
407
- "iconPath": {
408
- "description": "中间按钮的图片路径",
1569
+ "gestureBack": {
1570
+ "default": "YES",
1571
+ "description": "仅支持 iOS,是否支持手势返回",
1572
+ "enum": [
1573
+ "YES",
1574
+ "NO"
1575
+ ],
409
1576
  "type": "string"
410
1577
  },
411
- "iconWidth": {
412
- "default": "24px",
413
- "description": "图片宽度(高度等比例缩放)",
1578
+ "navigationBarFrontColor": {
1579
+ "description": "导航栏前景色",
1580
+ "enum": [
1581
+ "black",
1582
+ "white"
1583
+ ],
414
1584
  "type": "string"
415
1585
  },
416
- "iconfont": {
417
- "$ref": "#/definitions/IconFont",
418
- "description": "字体图标,优先级高于 iconPath"
1586
+ "onReachBottomDistance": {
1587
+ "description": "页面上拉触底时触发时距离页面底部的距离,单位为 px,详情可查看 [页面事件处理函数](https://opendocs.alipay.com/mini/framework/page-detail#%E9%A1%B5%E9%9D%A2%E4%BA%8B%E4%BB%B6%E5%A4%84%E7%90%86%E5%87%BD%E6%95%B0)",
1588
+ "type": "number"
419
1589
  },
420
- "text": {
421
- "description": "中间按钮的文字",
422
- "type": "string"
1590
+ "pullRefresh": {
1591
+ "default": false,
1592
+ "description": "是否允许下拉刷新,allowsBounceVertical 值需要为 \"YES\",全局配置后全局生效,但是如果单个页面配置了该参数,以页面的配置为准",
1593
+ "type": "boolean"
423
1594
  },
424
- "width": {
425
- "default": "80px",
426
- "description": "中间按钮的宽度,tabBar 其它项为减去此宽度后平分,默认值为与其它项平分宽度",
427
- "type": "string"
428
- }
429
- },
430
- "type": "object"
431
- },
432
- "PageMetaDatum": {
433
- "properties": {
434
- "needLogin": {
435
- "description": "当前页面是否需要登录才可以访问,此配置优先级高于 uniIdRouter 下的 needLogin",
1595
+ "responsive": {
1596
+ "default": true,
1597
+ "description": "rpx 单位是否宽度自适应\n\n当设置为 false 时,2 rpx 将恒等于 1 px,不再根据屏幕宽度进行自适应,此时 750 rpx 将不再等于 100% 宽度",
436
1598
  "type": "boolean"
437
1599
  },
438
- "path": {
439
- "description": "配置页面路径",
1600
+ "showTitleLoading": {
1601
+ "default": "NO",
1602
+ "description": "是否进入时显示导航栏的 loading",
1603
+ "enum": [
1604
+ "YES",
1605
+ "NO"
1606
+ ],
440
1607
  "type": "string"
441
1608
  },
442
- "style": {
443
- "$ref": "#/definitions/GlobalStyle",
444
- "description": "配置页面窗口表现,配置项参考下方 pageStyle"
1609
+ "titleBarColor": {
1610
+ "$ref": "#/definitions/HEXColor",
1611
+ "description": "导航栏背景色,支持 HEX 颜色"
445
1612
  },
446
- "type": {
1613
+ "titleImage": {
1614
+ "description": "导航栏图片地址,会替换当前文字标题,只支持 https 图片链接",
1615
+ "type": "string"
1616
+ },
1617
+ "titlePenetrate": {
1618
+ "default": "NO",
1619
+ "description": "导航栏点击穿透",
1620
+ "enum": [
1621
+ "YES",
1622
+ "NO"
1623
+ ],
1624
+ "type": "string"
1625
+ },
1626
+ "transparentTitle": {
1627
+ "default": "none",
1628
+ "description": "导航栏透明设置\n\nalways 一直透明\n\nauto 滑动自适应\n\nnone 不透明",
1629
+ "enum": [
1630
+ "always",
1631
+ "auto",
1632
+ "none"
1633
+ ],
447
1634
  "type": "string"
448
1635
  }
449
1636
  },
450
- "required": [
451
- "path"
452
- ],
453
1637
  "type": "object"
454
1638
  },
455
- "PagesConfig": {
1639
+ "MpBaidu": {
1640
+ "description": "设置编译到 mp-baidu 平台的特定样式,配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu) 和 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>\n\n相应的类型是 MpBaidu",
456
1641
  "properties": {
457
- "condition": {
458
- "$ref": "#/definitions/Condition",
459
- "description": "启动模式配置"
1642
+ "backgroundColor": {
1643
+ "$ref": "#/definitions/HEXColor",
1644
+ "default": "#FFFFFF",
1645
+ "description": "窗口的背景色,支持 HEX 颜色"
460
1646
  },
461
- "easycom": {
462
- "$ref": "#/definitions/EasyCom",
463
- "description": "组件自动引入规则"
1647
+ "backgroundColorBottom": {
1648
+ "$ref": "#/definitions/HEXColor",
1649
+ "default": "#FFFFFF",
1650
+ "description": "底部窗口的背景色,仅 iOS 支持"
464
1651
  },
465
- "entryPagePath": {
466
- "description": "默认启动首页,新增于 HBuilderX 3.7.0",
1652
+ "backgroundColorTop": {
1653
+ "$ref": "#/definitions/HEXColor",
1654
+ "default": "#FFFFFF",
1655
+ "description": "顶部窗口的背景色,仅 iOS 支持"
1656
+ },
1657
+ "backgroundTextStyle": {
1658
+ "default": "dark",
1659
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
1660
+ "enum": [
1661
+ "dark",
1662
+ "light"
1663
+ ],
467
1664
  "type": "string"
468
1665
  },
469
- "globalStyle": {
470
- "$ref": "#/definitions/GlobalStyle",
471
- "description": "设置默认页面的窗口表现"
1666
+ "enablePullDownRefresh": {
1667
+ "default": false,
1668
+ "description": "是否开启全局的下拉刷新",
1669
+ "type": "boolean"
472
1670
  },
473
- "leftWindow": {
474
- "$ref": "#/definitions/TheWindow",
475
- "description": "大屏左侧窗口"
1671
+ "navigationBarBackgroundColor": {
1672
+ "$ref": "#/definitions/HEXColor",
1673
+ "default": "#000000",
1674
+ "description": "导航栏背景颜色,支持 HEX 颜色",
1675
+ "format": "color"
476
1676
  },
477
- "pages": {
1677
+ "navigationBarTextStyle": {
1678
+ "default": "white",
1679
+ "description": "导航栏标题、状态栏颜色",
1680
+ "enum": [
1681
+ "black",
1682
+ "white"
1683
+ ],
1684
+ "type": "string"
1685
+ },
1686
+ "navigationBarTitleText": {
1687
+ "description": "导航栏标题文字内容",
1688
+ "type": "string"
1689
+ },
1690
+ "navigationStyle": {
1691
+ "default": "default",
1692
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
1693
+ "enum": [
1694
+ "default",
1695
+ "custom"
1696
+ ],
1697
+ "type": "string"
1698
+ },
1699
+ "onReachBottomDistance": {
1700
+ "default": 50,
1701
+ "description": "页面上拉触底事件触发时距页面底部距离,单位为 px",
1702
+ "type": "number"
1703
+ },
1704
+ "pageOrientation": {
1705
+ "default": "portrait",
1706
+ "description": "屏幕旋转设置,支持 auto / portrait / landscape\n\n\"auto\" 自动\n\n\"portrait\" 竖屏\n\n\"landscape\" 横屏",
1707
+ "enum": [
1708
+ "auto",
1709
+ "portrait",
1710
+ "landscape"
1711
+ ],
1712
+ "type": "string"
1713
+ },
1714
+ "textSizeAdjust": {
1715
+ "default": "auto",
1716
+ "description": "小程序页面是否禁止响应字体大小的设置\n\n\"auto\" 默认响应\n\n\"none\" 不响应",
1717
+ "enum": [
1718
+ "auto",
1719
+ "none"
1720
+ ],
1721
+ "type": "string"
1722
+ }
1723
+ },
1724
+ "type": "object"
1725
+ },
1726
+ "MpJd": {
1727
+ "description": "设置编译到 mp-jd 平台的特定样式,配置项参考 <https://mp-docs.jd.com/doc/dev/framework/504#heading-3>\n\n相应的类型是 MpJd",
1728
+ "properties": {
1729
+ "backgroundColor": {
1730
+ "$ref": "#/definitions/HEXColor",
1731
+ "default": "#FFFFFF",
1732
+ "description": "下拉窗口的背景色,不是页面的背景颜色"
1733
+ },
1734
+ "backgroundColorBottom": {
1735
+ "$ref": "#/definitions/HEXColor",
1736
+ "default": "#FFFFFF",
1737
+ "description": "底部窗口的背景色,仅 iOS 支持"
1738
+ },
1739
+ "backgroundColorTop": {
1740
+ "$ref": "#/definitions/HEXColor",
1741
+ "default": "#FFFFFF",
1742
+ "description": "顶部窗口的背景色,仅 iOS 支持"
1743
+ },
1744
+ "backgroundTextStyle": {
1745
+ "default": "dark",
1746
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
1747
+ "enum": [
1748
+ "dark",
1749
+ "light"
1750
+ ],
1751
+ "type": "string"
1752
+ },
1753
+ "enablePullDownRefresh": {
1754
+ "default": false,
1755
+ "description": "是否开启全局的下拉刷新,详见 [Page.onPullDownRefresh](https://mp-docs.jd.com/doc/dev/framework/520#heading-10)",
1756
+ "type": "boolean"
1757
+ },
1758
+ "navigationBarBackgroundColor": {
1759
+ "$ref": "#/definitions/HEXColor",
1760
+ "default": "#000000",
1761
+ "description": "导航栏背景颜色,支持 HEX 颜色",
1762
+ "format": "color"
1763
+ },
1764
+ "navigationBarTextStyle": {
1765
+ "default": "white",
1766
+ "description": "导航栏标题、状态栏颜色",
1767
+ "enum": [
1768
+ "black",
1769
+ "white"
1770
+ ],
1771
+ "type": "string"
1772
+ },
1773
+ "navigationBarTitleText": {
1774
+ "description": "导航栏标题文字内容",
1775
+ "type": "string"
1776
+ },
1777
+ "navigationStyle": {
1778
+ "default": "default",
1779
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
1780
+ "enum": [
1781
+ "default",
1782
+ "custom"
1783
+ ],
1784
+ "type": "string"
1785
+ }
1786
+ },
1787
+ "type": "object"
1788
+ },
1789
+ "MpKuaishou": {
1790
+ "description": "设置编译到 mp-kuaishou 平台的特定样式,配置项参考 <https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html#window>\n\n相应的类型是 MpKuaishou",
1791
+ "properties": {
1792
+ "backgroundColor": {
1793
+ "$ref": "#/definitions/HEXColor",
1794
+ "default": "#FFFFFF",
1795
+ "description": "窗口的背景色,支持 HEX 颜色"
1796
+ },
1797
+ "backgroundColorBottom": {
1798
+ "$ref": "#/definitions/HEXColor",
1799
+ "default": "#FFFFFF",
1800
+ "description": "底部窗口的背景色,仅 iOS 支持"
1801
+ },
1802
+ "backgroundColorTop": {
1803
+ "$ref": "#/definitions/HEXColor",
1804
+ "default": "#FFFFFF",
1805
+ "description": "顶部窗口的背景色,仅 iOS 支持"
1806
+ },
1807
+ "backgroundTextStyle": {
1808
+ "default": "dark",
1809
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
1810
+ "enum": [
1811
+ "dark",
1812
+ "light"
1813
+ ],
1814
+ "type": "string"
1815
+ },
1816
+ "enablePullDownRefresh": {
1817
+ "default": false,
1818
+ "description": "是否开启全局的下拉刷新,详见 [Page.onPullDownRefresh](https://mp.kuaishou.com/docs/develop/frame/page/page_page.html#onpulldownrefresh)",
1819
+ "type": "boolean"
1820
+ },
1821
+ "navigationBarBackgroundColor": {
1822
+ "$ref": "#/definitions/HEXColor",
1823
+ "default": "#000000",
1824
+ "description": "导航栏背景颜色,支持 HEX 颜色",
1825
+ "format": "color"
1826
+ },
1827
+ "navigationBarTextStyle": {
1828
+ "default": "white",
1829
+ "description": "导航栏标题、状态栏颜色",
1830
+ "enum": [
1831
+ "black",
1832
+ "white"
1833
+ ],
1834
+ "type": "string"
1835
+ },
1836
+ "navigationBarTitleText": {
1837
+ "description": "导航栏标题文字内容",
1838
+ "type": "string"
1839
+ },
1840
+ "navigationStyle": {
1841
+ "default": "default",
1842
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
1843
+ "enum": [
1844
+ "default",
1845
+ "custom"
1846
+ ],
1847
+ "type": "string"
1848
+ },
1849
+ "onReachBottomDistance": {
1850
+ "default": 50,
1851
+ "description": "页面上拉触底事件触发时距页面底部距离,单位为 px,详见 [Page.onReachBottom](https://mp.kuaishou.com/docs/develop/frame/page/page_page.html#onreachbottom)",
1852
+ "type": "number"
1853
+ },
1854
+ "pageOrientation": {
1855
+ "default": "portrait",
1856
+ "description": "屏幕旋转设置,支持 auto / portrait / landscape,详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)\n\n\"auto\" 自动\n\n\"portrait\" 竖屏\n\n\"landscape\" 横屏",
1857
+ "enum": [
1858
+ "auto",
1859
+ "portrait",
1860
+ "landscape"
1861
+ ],
1862
+ "type": "string"
1863
+ }
1864
+ },
1865
+ "type": "object"
1866
+ },
1867
+ "MpLark": {
1868
+ "description": "设置编译到 mp-lark 平台的特定样式,配置项参考 <https://open.feishu.cn/document/client-docs/gadget/introduction/global-settings#a172b7dd>\n\n相应的类型是 MpLark",
1869
+ "properties": {
1870
+ "PCMode": {
1871
+ "additionalProperties": false,
1872
+ "description": "PCMode 模式下特定的窗口配置,支持的属性与通用 window 配置属性一致,仅当在 ext 内配置了 defaultPages.PCMode 时生效",
1873
+ "type": "object"
1874
+ },
1875
+ "backgroundColor": {
1876
+ "$ref": "#/definitions/HEXColor",
1877
+ "default": "#FFFFFF",
1878
+ "description": "窗口的背景色,支持 HEX 颜色"
1879
+ },
1880
+ "backgroundColorBottom": {
1881
+ "$ref": "#/definitions/HEXColor",
1882
+ "default": "#FFFFFF",
1883
+ "description": "底部窗口的背景色"
1884
+ },
1885
+ "backgroundColorTop": {
1886
+ "$ref": "#/definitions/HEXColor",
1887
+ "default": "#FFFFFF",
1888
+ "description": "顶部窗口的背景色"
1889
+ },
1890
+ "backgroundTextStyle": {
1891
+ "default": "dark",
1892
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
1893
+ "enum": [
1894
+ "dark",
1895
+ "light"
1896
+ ],
1897
+ "type": "string"
1898
+ },
1899
+ "enablePullDownRefresh": {
1900
+ "default": false,
1901
+ "description": "是否开启全局的下拉刷新",
1902
+ "type": "boolean"
1903
+ },
1904
+ "navigationBarBackgroundColor": {
1905
+ "$ref": "#/definitions/HEXColor",
1906
+ "default": "#000000",
1907
+ "description": "导航栏背景颜色,支持 HEX 颜色",
1908
+ "format": "color"
1909
+ },
1910
+ "navigationBarTextStyle": {
1911
+ "default": "white",
1912
+ "description": "导航栏标题、状态栏颜色",
1913
+ "enum": [
1914
+ "black",
1915
+ "white"
1916
+ ],
1917
+ "type": "string"
1918
+ },
1919
+ "navigationBarTitleText": {
1920
+ "description": "导航栏标题文字内容",
1921
+ "type": "string"
1922
+ },
1923
+ "navigationStyle": {
1924
+ "default": "default",
1925
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
1926
+ "enum": [
1927
+ "default",
1928
+ "custom"
1929
+ ],
1930
+ "type": "string"
1931
+ },
1932
+ "onReachBottomDistance": {
1933
+ "default": 50,
1934
+ "description": "页面上拉触底事件触发时距页面底部距离,单位为 px",
1935
+ "type": "number"
1936
+ },
1937
+ "transparentTitle": {
1938
+ "default": "none",
1939
+ "description": "导航栏透明设置\n\n\"always\" 一直透明\n\n\"auto\" 滑动自适应\n\n\"none\" 不透明",
1940
+ "enum": [
1941
+ "always",
1942
+ "auto",
1943
+ "none"
1944
+ ],
1945
+ "type": "string"
1946
+ }
1947
+ },
1948
+ "type": "object"
1949
+ },
1950
+ "MpQq": {
1951
+ "description": "设置编译到 mp-qq 平台的特定样式,配置项参考 <https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#window>\n\n相应的类型是 MpQq",
1952
+ "properties": {
1953
+ "backgroundColor": {
1954
+ "$ref": "#/definitions/HEXColor",
1955
+ "default": "#FFFFFF",
1956
+ "description": "窗口的背景色,支持 HEX 颜色"
1957
+ },
1958
+ "backgroundColorBottom": {
1959
+ "$ref": "#/definitions/HEXColor",
1960
+ "default": "#FFFFFF",
1961
+ "description": "底部窗口的背景色,仅 iOS 支持"
1962
+ },
1963
+ "backgroundColorTop": {
1964
+ "$ref": "#/definitions/HEXColor",
1965
+ "default": "#FFFFFF",
1966
+ "description": "顶部窗口的背景色,仅 iOS 支持"
1967
+ },
1968
+ "backgroundTextStyle": {
1969
+ "default": "dark",
1970
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
1971
+ "enum": [
1972
+ "dark",
1973
+ "light"
1974
+ ],
1975
+ "type": "string"
1976
+ },
1977
+ "enablePullDownRefresh": {
1978
+ "default": false,
1979
+ "description": "是否开启全局的下拉刷新,详见 [Page.onPullDownRefresh](https://q.qq.com/wiki/develop/miniprogram/frame/logic/logic_register_page.html#onPullDownRefresh)",
1980
+ "type": "boolean"
1981
+ },
1982
+ "navigationBarBackgroundColor": {
1983
+ "$ref": "#/definitions/HEXColor",
1984
+ "default": "#000000",
1985
+ "description": "导航栏背景颜色,支持 HEX 颜色",
1986
+ "format": "color"
1987
+ },
1988
+ "navigationBarTextStyle": {
1989
+ "default": "white",
1990
+ "description": "导航栏标题、状态栏颜色",
1991
+ "enum": [
1992
+ "black",
1993
+ "white"
1994
+ ],
1995
+ "type": "string"
1996
+ },
1997
+ "navigationBarTitleText": {
1998
+ "description": "导航栏标题文字内容",
1999
+ "type": "string"
2000
+ },
2001
+ "navigationStyle": {
2002
+ "default": "default",
2003
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
2004
+ "enum": [
2005
+ "default",
2006
+ "custom"
2007
+ ],
2008
+ "type": "string"
2009
+ },
2010
+ "pageOrientation": {
2011
+ "default": "portrait",
2012
+ "description": "屏幕旋转设置,支持 auto / portrait / landscape,详见 [响应显示区域变化](https://q.qq.com/wiki/develop/miniprogram/frame/view/view_section_change.html)\n\n\"auto\" 自动\n\n\"portrait\" 竖屏\n\n\"landscape\" 横屏",
2013
+ "enum": [
2014
+ "auto",
2015
+ "portrait",
2016
+ "landscape"
2017
+ ],
2018
+ "type": "string"
2019
+ }
2020
+ },
2021
+ "type": "object"
2022
+ },
2023
+ "MpToutiao": {
2024
+ "description": "设置编译到 mp-toutiao 平台的特定样式,配置项参考 <https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration#window>\n\n相应的类型是 MpToutiao",
2025
+ "properties": {
2026
+ "backgroundColor": {
2027
+ "$ref": "#/definitions/HEXColor",
2028
+ "default": "#FFFFFF",
2029
+ "description": "窗口的背景色,支持 HEX 颜色"
2030
+ },
2031
+ "backgroundColorBottom": {
2032
+ "$ref": "#/definitions/HEXColor",
2033
+ "default": "同 backgroundColor",
2034
+ "description": "底部窗口的背景色,仅 iOS 支持"
2035
+ },
2036
+ "backgroundColorTop": {
2037
+ "$ref": "#/definitions/HEXColor",
2038
+ "default": "同 backgroundColor",
2039
+ "description": "顶部窗口的背景色,仅 iOS 支持"
2040
+ },
2041
+ "backgroundTextStyle": {
2042
+ "default": "dark",
2043
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
2044
+ "enum": [
2045
+ "dark",
2046
+ "light"
2047
+ ],
2048
+ "type": "string"
2049
+ },
2050
+ "enablePullDownRefresh": {
2051
+ "default": false,
2052
+ "description": "是否开启全局的下拉刷新",
2053
+ "type": "boolean"
2054
+ },
2055
+ "navigationBarBackgroundColor": {
2056
+ "$ref": "#/definitions/HEXColor",
2057
+ "default": "#000000",
2058
+ "description": "导航栏背景颜色,支持 HEX 颜色",
2059
+ "format": "color"
2060
+ },
2061
+ "navigationBarTextStyle": {
2062
+ "default": "white",
2063
+ "description": "导航栏标题颜色,同时影响标题颜色、右胶囊颜色、左返回箭头颜色",
2064
+ "enum": [
2065
+ "black",
2066
+ "white"
2067
+ ],
2068
+ "type": "string"
2069
+ },
2070
+ "navigationBarTitleText": {
2071
+ "description": "导航栏标题文字内容",
2072
+ "type": "string"
2073
+ },
2074
+ "navigationStyle": {
2075
+ "default": "default",
2076
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
2077
+ "enum": [
2078
+ "default",
2079
+ "custom"
2080
+ ],
2081
+ "type": "string"
2082
+ },
2083
+ "onReachBottomDistance": {
2084
+ "default": 50,
2085
+ "description": "页面上拉触底事件触发时距页面底部距离,单位为 px",
2086
+ "type": "number"
2087
+ },
2088
+ "skeleton": {
2089
+ "description": "框架骨架屏配置,仅支持配置 config 属性,优先级高于 app.json,详见 [小程序框架骨架屏](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/guide/experience-optimization/list/skeleton)",
2090
+ "properties": {
2091
+ "config": {
2092
+ "description": "包含超时移除及自动生成配置等",
2093
+ "properties": {
2094
+ "backgroundColor": {
2095
+ "$ref": "#/definitions/HEXColor",
2096
+ "default": "#fff",
2097
+ "description": "骨架屏背景色,支持 HEX 颜色",
2098
+ "format": "color"
2099
+ },
2100
+ "button": {
2101
+ "default": "{ color: '#efefef }",
2102
+ "description": "骨架页面中被视为按钮块的配置",
2103
+ "properties": {
2104
+ "color": {
2105
+ "$ref": "#/definitions/HEXColor",
2106
+ "default": "#efefef",
2107
+ "description": "骨架页面中被视为按钮块的颜色,支持 HEX 颜色",
2108
+ "format": "color"
2109
+ }
2110
+ },
2111
+ "type": "object"
2112
+ },
2113
+ "cssUnit": {
2114
+ "default": "vw",
2115
+ "description": "CSS单位,元素绝对定位都使用 \"vw\" 与 \"vh\"",
2116
+ "enum": [
2117
+ "px",
2118
+ "rem",
2119
+ "vw",
2120
+ "vh",
2121
+ "vmin",
2122
+ "vmax"
2123
+ ],
2124
+ "type": "string"
2125
+ },
2126
+ "decimal": {
2127
+ "default": 4,
2128
+ "description": "生成骨架屏页面中 css 值保留的小数点位数,默认为 4",
2129
+ "type": "number"
2130
+ },
2131
+ "image": {
2132
+ "default": {
2133
+ "color": "#efefef",
2134
+ "shape": "rect"
2135
+ },
2136
+ "description": "骨架页面中图片块配置",
2137
+ "properties": {
2138
+ "color": {
2139
+ "$ref": "#/definitions/HEXColor",
2140
+ "default": "#efefef",
2141
+ "description": "骨架页面中图片块颜色,支持 HEX 颜色",
2142
+ "format": "color"
2143
+ },
2144
+ "shape": {
2145
+ "default": "rect",
2146
+ "description": "骨架页面中图片块形状\n\ncircle 圆形\n\nrect 矩形",
2147
+ "enum": [
2148
+ "circle",
2149
+ "rect"
2150
+ ],
2151
+ "type": "string"
2152
+ }
2153
+ },
2154
+ "type": "object"
2155
+ },
2156
+ "loading": {
2157
+ "default": "spin",
2158
+ "description": "骨架屏显示时的动画",
2159
+ "enum": [
2160
+ "spin",
2161
+ "chiaroscuro",
2162
+ "shine"
2163
+ ],
2164
+ "type": "string"
2165
+ },
2166
+ "mode": {
2167
+ "default": "fullscreen",
2168
+ "description": "默认为使用绝对定位占满全屏\n\n当对自定义组件使用,作为局部加载的样式时,可设置为 \"auto\",高度随内容高度撑开",
2169
+ "enum": [
2170
+ "fullscreen",
2171
+ "auto"
2172
+ ],
2173
+ "type": "string"
2174
+ },
2175
+ "timeout": {
2176
+ "default": 2000,
2177
+ "description": "设置骨架屏超时移除时间,单位为 ms,为 0 时关闭超时移除",
2178
+ "type": "number"
2179
+ }
2180
+ },
2181
+ "type": "object"
2182
+ },
2183
+ "page": {
2184
+ "additionalProperties": {
2185
+ "type": "string"
2186
+ },
2187
+ "description": "页面路径同骨架屏文件的对应关系",
2188
+ "type": "object"
2189
+ }
2190
+ },
2191
+ "type": "object"
2192
+ },
2193
+ "transparentTitle": {
2194
+ "default": "none",
2195
+ "description": "仅在 navigationStyle 为 \"default\" 时生效,用来控制导航栏透明设置\n\n\"always\" 一直透明\n\n\"auto\" 滑动自适应\n\n\"none\" 不透明",
2196
+ "enum": [
2197
+ "always",
2198
+ "auto",
2199
+ "none"
2200
+ ],
2201
+ "type": "string"
2202
+ }
2203
+ },
2204
+ "type": "object"
2205
+ },
2206
+ "MpWeixin": {
2207
+ "description": "设置编译到 mp-weixin 平台的特定样式,配置项参考 [MP-WEIXIN](https://uniapp.dcloud.net.cn/collocation/pages#mp-weixin) 和 <https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#window>\n\n相应的类型是 MpWeixin",
2208
+ "properties": {
2209
+ "backgroundColor": {
2210
+ "$ref": "#/definitions/HEXColor",
2211
+ "default": "#FFFFFF",
2212
+ "description": "窗口的背景色,支持 HEX 颜色"
2213
+ },
2214
+ "backgroundColorBottom": {
2215
+ "$ref": "#/definitions/HEXColor",
2216
+ "default": "#FFFFFF",
2217
+ "description": "底部窗口的背景色,仅 iOS 支持"
2218
+ },
2219
+ "backgroundColorTop": {
2220
+ "$ref": "#/definitions/HEXColor",
2221
+ "default": "#FFFFFF",
2222
+ "description": "顶部窗口的背景色,仅 iOS 支持"
2223
+ },
2224
+ "backgroundTextStyle": {
2225
+ "default": "dark",
2226
+ "description": "下拉 loading 的样式,仅支持 \"dark\" / \"light\"",
2227
+ "enum": [
2228
+ "dark",
2229
+ "light"
2230
+ ],
2231
+ "type": "string"
2232
+ },
2233
+ "enablePullDownRefresh": {
2234
+ "default": false,
2235
+ "description": "是否开启全局的下拉刷新,详见 [Page.onPullDownRefresh](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onpulldownrefresh)",
2236
+ "type": "boolean"
2237
+ },
2238
+ "handleWebviewPreload": {
2239
+ "default": "static",
2240
+ "description": "控制预加载下个页面的时机,详见 [控制预加载下个页面的时机](https://developers.weixin.qq.com/miniprogram/dev/framework/performance/tips/runtime_nav.html#_2-4-%E6%8E%A7%E5%88%B6%E9%A2%84%E5%8A%A0%E8%BD%BD%E4%B8%8B%E4%B8%AA%E9%A1%B5%E9%9D%A2%E7%9A%84%E6%97%B6%E6%9C%BA)\n\n\"static\" 在当前页面 onReady 触发 200ms 后触发预加载\n\n\"auto\" 渲染线程空闲时进行预加载,由基础库根据一段时间内 requestAnimationFrame 的触发频率算法判断\n\n\"manual\" 由开发者通过调用 [wx.preloadWebview](https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadWebview.html) 触发,开发者可以在页面主要内容的 setData 结束后手动触发",
2241
+ "enum": [
2242
+ "static",
2243
+ "manual",
2244
+ "auto"
2245
+ ],
2246
+ "type": "string"
2247
+ },
2248
+ "homeButton": {
2249
+ "default": false,
2250
+ "description": "在非首页、非页面栈最底层页面或非 tabbar 内页面中的导航栏展示 home 键",
2251
+ "type": "boolean"
2252
+ },
2253
+ "initialRenderingCache": {
2254
+ "description": "页面初始渲染缓存配置,详见 [初始渲染缓存](https://developers.weixin.qq.com/miniprogram/dev/framework/view/initial-rendering-cache.html)",
2255
+ "enum": [
2256
+ "static",
2257
+ "dynamic"
2258
+ ],
2259
+ "type": "string"
2260
+ },
2261
+ "navigationBarBackgroundColor": {
2262
+ "$ref": "#/definitions/HEXColor",
2263
+ "default": "#000000",
2264
+ "description": "导航栏背景颜色,支持 HEX 颜色",
2265
+ "format": "color"
2266
+ },
2267
+ "navigationBarTextStyle": {
2268
+ "default": "white",
2269
+ "description": "导航栏标题、状态栏颜色",
2270
+ "enum": [
2271
+ "black",
2272
+ "white"
2273
+ ],
2274
+ "type": "string"
2275
+ },
2276
+ "navigationBarTitleText": {
2277
+ "description": "导航栏标题文字内容",
2278
+ "type": "string"
2279
+ },
2280
+ "navigationStyle": {
2281
+ "default": "default",
2282
+ "description": "导航栏样式\n\n\"default\" 默认样式\n\n\"custom\" 自定义导航栏,只保留右上角胶囊按钮",
2283
+ "enum": [
2284
+ "default",
2285
+ "custom"
2286
+ ],
2287
+ "type": "string"
2288
+ },
2289
+ "onReachBottomDistance": {
2290
+ "default": 50,
2291
+ "description": "页面上拉触底事件触发时距页面底部距离,单位为 px,详见 [Page.onReachBottom](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onreachbottom)",
2292
+ "type": "number"
2293
+ },
2294
+ "pageOrientation": {
2295
+ "default": "portrait",
2296
+ "description": "屏幕旋转设置,支持 auto / portrait / landscape,详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)\n\n\"auto\" 自动\n\n\"portrait\" 竖屏\n\n\"landscape\" 横屏",
2297
+ "enum": [
2298
+ "auto",
2299
+ "portrait",
2300
+ "landscape"
2301
+ ],
2302
+ "type": "string"
2303
+ },
2304
+ "restartStrategy": {
2305
+ "description": "重新启动策略配置\n\n\"homePage\" 如果从这个页面退出小程序,下次将从首页冷启动\n\n\"homePageAndLatestPage\" 如果从这个页面退出小程序,下次冷启动后立刻加载这个页面,页面的参数保持不变(不可用于 tab 页)",
2306
+ "enum": [
2307
+ "homePage",
2308
+ "homePageAndLatestPage"
2309
+ ],
2310
+ "type": "string"
2311
+ },
2312
+ "visualEffectInBackground": {
2313
+ "default": "none",
2314
+ "description": "切入系统后台时,隐藏页面内容,保护用户隐私",
2315
+ "enum": [
2316
+ "hidden",
2317
+ "none"
2318
+ ],
2319
+ "type": "string"
2320
+ }
2321
+ },
2322
+ "type": "object"
2323
+ },
2324
+ "PageMetaDatum": {
2325
+ "properties": {
2326
+ "needLogin": {
2327
+ "description": "当前页面是否需要登录才可以访问,此配置优先级高于 uniIdRouter 下的 needLogin",
2328
+ "type": "boolean"
2329
+ },
2330
+ "path": {
2331
+ "description": "配置页面路径",
2332
+ "type": "string"
2333
+ },
2334
+ "style": {
2335
+ "$ref": "#/definitions/GlobalStyle",
2336
+ "description": "配置页面窗口表现,配置项参考下方 pageStyle"
2337
+ },
2338
+ "type": {
2339
+ "type": "string"
2340
+ }
2341
+ },
2342
+ "required": [
2343
+ "path"
2344
+ ],
2345
+ "type": "object"
2346
+ },
2347
+ "PagesConfig": {
2348
+ "description": "对 uni-app 进行全局配置,决定页面文件的路径、窗口样式、原生的导航栏、底部的原生 tabBar 等,类似微信小程序中 app.json 的页面管理部分\n\n注意定位权限申请等原属于 app.json 的内容,需要在 manifest 中配置",
2349
+ "properties": {
2350
+ "condition": {
2351
+ "$ref": "#/definitions/Condition",
2352
+ "description": "启动模式配置,仅开发期间生效"
2353
+ },
2354
+ "easycom": {
2355
+ "$ref": "#/definitions/EasyCom",
2356
+ "description": "组件自动引入规则"
2357
+ },
2358
+ "entryPagePath": {
2359
+ "description": "默认启动首页,新增于 HBuilderX 3.7.0",
2360
+ "type": "string"
2361
+ },
2362
+ "globalStyle": {
2363
+ "$ref": "#/definitions/GlobalStyle",
2364
+ "description": "设置默认页面的窗口表现"
2365
+ },
2366
+ "leftWindow": {
2367
+ "$ref": "#/definitions/TheWindow",
2368
+ "description": "大屏左侧窗口"
2369
+ },
2370
+ "pages": {
478
2371
  "description": "设置页面路径及窗口表现",
479
2372
  "items": {
480
2373
  "$ref": "#/definitions/PageMetaDatum"
@@ -483,7 +2376,30 @@
483
2376
  },
484
2377
  "preloadRule": {
485
2378
  "additionalProperties": {
486
- "$ref": "#/definitions/PreloadRule"
2379
+ "additionalProperties": false,
2380
+ "description": "页面路径",
2381
+ "properties": {
2382
+ "network": {
2383
+ "default": "wifi",
2384
+ "description": "在指定网络下预下载\n\n\"all\" 不限网络\n\n\"wifi\" 仅 wifi 下预下载",
2385
+ "enum": [
2386
+ "all",
2387
+ "wifi"
2388
+ ],
2389
+ "type": "string"
2390
+ },
2391
+ "packages": {
2392
+ "description": "进入页面后预下载分包的 root 或 name\n\n__APP__ 表示主包",
2393
+ "items": {
2394
+ "type": "string"
2395
+ },
2396
+ "type": "array"
2397
+ }
2398
+ },
2399
+ "required": [
2400
+ "packages"
2401
+ ],
2402
+ "type": "object"
487
2403
  },
488
2404
  "description": "分包预下载规则",
489
2405
  "type": "object"
@@ -493,11 +2409,8 @@
493
2409
  "description": "大屏右侧窗口"
494
2410
  },
495
2411
  "subPackages": {
496
- "description": "分包加载配置",
497
- "items": {
498
- "$ref": "#/definitions/SubPackage"
499
- },
500
- "type": "array"
2412
+ "$ref": "#/definitions/SubPackages",
2413
+ "description": "分包加载配置"
501
2414
  },
502
2415
  "tabBar": {
503
2416
  "$ref": "#/definitions/TabBar",
@@ -512,33 +2425,41 @@
512
2425
  "description": "自动跳转相关配置,新增于 HBuilderX 3.5.0"
513
2426
  },
514
2427
  "workers": {
2428
+ "anyOf": [
2429
+ {
2430
+ "type": "string"
2431
+ },
2432
+ {
2433
+ "additionalProperties": false,
2434
+ "properties": {
2435
+ "isSubpackage": {
2436
+ "default": false,
2437
+ "description": "是否打包为分包",
2438
+ "type": "boolean"
2439
+ },
2440
+ "path": {
2441
+ "description": "`Worker` 代码放置的目录",
2442
+ "type": "string"
2443
+ }
2444
+ },
2445
+ "required": [
2446
+ "path"
2447
+ ],
2448
+ "type": "object"
2449
+ }
2450
+ ],
515
2451
  "description": "`Worker` 代码放置的目录"
516
2452
  }
517
2453
  },
518
2454
  "type": "object"
519
2455
  },
520
- "PreloadRule": {
521
- "additionalProperties": false,
522
- "properties": {
523
- "network": {
524
- "default": "wifi",
525
- "description": "在指定网络下预下载,可选值为:all(不限网络)、wifi(仅wifi下预下载)",
526
- "type": "string"
527
- },
528
- "packages": {
529
- "description": "进入页面后预下载分包的 root 或 name。__APP__ 表示主包。",
530
- "items": {
531
- "type": "string"
532
- },
533
- "type": "array"
534
- }
535
- },
536
- "type": "object"
2456
+ "PercentageSize": {
2457
+ "type": "string"
537
2458
  },
538
- "RGBAColor": {
2459
+ "PxSize": {
539
2460
  "type": "string"
540
2461
  },
541
- "RGBColor": {
2462
+ "RGBAColor": {
542
2463
  "type": "string"
543
2464
  },
544
2465
  "SubPackage": {
@@ -546,7 +2467,9 @@
546
2467
  "properties": {
547
2468
  "pages": {
548
2469
  "description": "子包由哪些页面组成,参数同 pages",
549
- "items": {},
2470
+ "items": {
2471
+ "$ref": "#/definitions/PageMetaDatum"
2472
+ },
550
2473
  "type": "array"
551
2474
  },
552
2475
  "root": {
@@ -554,48 +2477,73 @@
554
2477
  "type": "string"
555
2478
  }
556
2479
  },
2480
+ "required": [
2481
+ "root",
2482
+ "pages"
2483
+ ],
557
2484
  "type": "object"
558
2485
  },
2486
+ "SubPackages": {
2487
+ "items": {
2488
+ "$ref": "#/definitions/SubPackage"
2489
+ },
2490
+ "type": "array"
2491
+ },
559
2492
  "TabBar": {
560
2493
  "properties": {
561
2494
  "backgroundColor": {
562
- "anyOf": [
563
- {
564
- "$ref": "#/definitions/Color"
565
- },
566
- {
567
- "$ref": "#/definitions/ThemeColor"
568
- }
2495
+ "$ref": "#/definitions/HEXColor",
2496
+ "description": "tab 的背景色",
2497
+ "format": "color"
2498
+ },
2499
+ "backgroundImage": {
2500
+ "description": "设置背景图片,优先级高于 backgroundColor",
2501
+ "type": "string"
2502
+ },
2503
+ "backgroundRepeat": {
2504
+ "default": "no-repeat",
2505
+ "description": "设置标题栏的背景图平铺方式\n\n\"repeat\" 背景图片在垂直方向和水平方向平铺\n\n\"repeat-x\" 背景图片在水平方向平铺,垂直方向拉伸\n\n\"repeat-y\" 背景图片在垂直方向平铺,水平方向拉伸\n\n\"no-repeat\" 背景图片在垂直方向和水平方向都拉伸",
2506
+ "enum": [
2507
+ "no-repeat",
2508
+ "repeat",
2509
+ "repeat-x",
2510
+ "repeat-y"
569
2511
  ],
570
- "description": "tab 的背景色"
2512
+ "type": "string"
571
2513
  },
572
2514
  "blurEffect": {
573
2515
  "default": "none",
574
- "description": "iOS 高斯模糊效果,可选值 dark/extralight/light/none(参考?:使用说明)",
2516
+ "description": "iOS 高斯模糊效果,参考 [使用说明](https://ask.dcloud.net.cn/article/36617)",
2517
+ "enum": [
2518
+ "dark",
2519
+ "extralight",
2520
+ "light",
2521
+ "none"
2522
+ ],
575
2523
  "type": "string"
576
2524
  },
577
2525
  "borderStyle": {
578
2526
  "anyOf": [
579
2527
  {
2528
+ "const": "black",
2529
+ "type": "string"
2530
+ },
2531
+ {
2532
+ "const": "white",
580
2533
  "type": "string"
581
2534
  },
582
2535
  {
583
- "$ref": "#/definitions/ThemeColor"
2536
+ "$ref": "#/definitions/HEXColor"
584
2537
  }
585
2538
  ],
586
2539
  "default": "black",
587
- "description": "tabbar 上边框的颜色,可选值 black/white,也支持其他颜色值"
2540
+ "description": "tabBar 上边框的颜色",
2541
+ "format": "color"
588
2542
  },
589
2543
  "color": {
590
- "anyOf": [
591
- {
592
- "$ref": "#/definitions/Color"
593
- },
594
- {
595
- "$ref": "#/definitions/ThemeColor"
596
- }
597
- ],
598
- "description": "tab 上的文字默认颜色"
2544
+ "$ref": "#/definitions/HEXColor",
2545
+ "description": "tab 上的文字默认颜色",
2546
+ "format": "color"
599
2547
  },
600
2548
  "fontSize": {
601
2549
  "default": "10px",
@@ -613,11 +2561,11 @@
613
2561
  "type": "string"
614
2562
  },
615
2563
  "iconfontSrc": {
616
- "description": "list设置 iconfont 属性时,需要指定字体文件路径",
2564
+ "description": "list 设置 iconfont 属性时,需要指定字体文件路径",
617
2565
  "type": "string"
618
2566
  },
619
2567
  "list": {
620
- "description": "tab 的列表,详见 list 属性说明,最少2个、最多5个 tab",
2568
+ "description": "tab 列表,最少 2个,最多 5 个",
621
2569
  "items": {
622
2570
  "$ref": "#/definitions/TabBarItem"
623
2571
  },
@@ -626,24 +2574,27 @@
626
2574
  "type": "array"
627
2575
  },
628
2576
  "midButton": {
629
- "$ref": "#/definitions/MidButton",
2577
+ "$ref": "#/definitions/TabBarMidButton",
630
2578
  "description": "中间按钮 仅在 list 项为偶数时有效"
631
2579
  },
632
2580
  "position": {
633
2581
  "default": "bottom",
634
- "description": "可选值 bottom、top",
2582
+ "description": "tab 位置",
2583
+ "enum": [
2584
+ "bottom",
2585
+ "top"
2586
+ ],
2587
+ "type": "string"
2588
+ },
2589
+ "redDotColor": {
2590
+ "description": "tabBar上红点颜色",
2591
+ "format": "color",
635
2592
  "type": "string"
636
2593
  },
637
2594
  "selectedColor": {
638
- "anyOf": [
639
- {
640
- "$ref": "#/definitions/Color"
641
- },
642
- {
643
- "$ref": "#/definitions/ThemeColor"
644
- }
645
- ],
646
- "description": "tab 上的文字选中时的颜色"
2595
+ "$ref": "#/definitions/HEXColor",
2596
+ "description": "tab 上的文字选中时的颜色",
2597
+ "format": "color"
647
2598
  },
648
2599
  "spacing": {
649
2600
  "default": "3px",
@@ -652,18 +2603,45 @@
652
2603
  }
653
2604
  },
654
2605
  "required": [
2606
+ "color",
2607
+ "selectedColor",
655
2608
  "list"
656
2609
  ],
657
2610
  "type": "object"
658
2611
  },
2612
+ "TabBarIconFont": {
2613
+ "properties": {
2614
+ "color": {
2615
+ "$ref": "#/definitions/HEXColor",
2616
+ "description": "字体图标颜色"
2617
+ },
2618
+ "fontSize": {
2619
+ "description": "字体图标字号,单位为 px",
2620
+ "type": "string"
2621
+ },
2622
+ "selectedColor": {
2623
+ "$ref": "#/definitions/HEXColor",
2624
+ "description": "字体图标选中颜色"
2625
+ },
2626
+ "selectedText": {
2627
+ "description": "选中后字库 Unicode 码",
2628
+ "type": "string"
2629
+ },
2630
+ "text": {
2631
+ "description": "字库 Unicode 码",
2632
+ "type": "string"
2633
+ }
2634
+ },
2635
+ "type": "object"
2636
+ },
659
2637
  "TabBarItem": {
660
2638
  "properties": {
661
2639
  "iconPath": {
662
- "description": "图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px, 当 position 为 top 时,此参数无效,不支持网络图片,不支持字体图标",
2640
+ "description": "图片路径,icon 大小限制为 40 kb,建议尺寸为 81px * 81px\n\n当 position 为 \"top\" 时,此参数无效\n\n不支持网络图片,不支持字体图标",
663
2641
  "type": "string"
664
2642
  },
665
2643
  "iconfont": {
666
- "$ref": "#/definitions/IconFont",
2644
+ "$ref": "#/definitions/TabBarIconFont",
667
2645
  "description": "字体图标,优先级高于 iconPath"
668
2646
  },
669
2647
  "pagePath": {
@@ -671,11 +2649,11 @@
671
2649
  "type": "string"
672
2650
  },
673
2651
  "selectedIconPath": {
674
- "description": "选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 position 为 top 时,此参数无效",
2652
+ "description": "选中时的图片路径,icon 大小限制为 40 kb,建议尺寸为 81px * 81px\n\n当 position 为 \"top\" 时,此参数无效\n\n不支持网络图片,不支持字体图标",
675
2653
  "type": "string"
676
2654
  },
677
2655
  "text": {
678
- "description": "tab 上按钮文字,在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标",
2656
+ "description": "tab 上按钮文字,在 App 和 H5 平台为非必填,例如中间可放一个没有文字的 + 号图标",
679
2657
  "type": "string"
680
2658
  },
681
2659
  "visible": {
@@ -683,6 +2661,45 @@
683
2661
  "type": "boolean"
684
2662
  }
685
2663
  },
2664
+ "required": [
2665
+ "pagePath"
2666
+ ],
2667
+ "type": "object"
2668
+ },
2669
+ "TabBarMidButton": {
2670
+ "properties": {
2671
+ "backgroundImage": {
2672
+ "description": "中间按钮的背景图片路径",
2673
+ "type": "string"
2674
+ },
2675
+ "height": {
2676
+ "default": "50px",
2677
+ "description": "中间按钮的高度,可以大于 tabBar 高度,达到中间凸起的效果",
2678
+ "type": "string"
2679
+ },
2680
+ "iconPath": {
2681
+ "description": "中间按钮的图片路径",
2682
+ "type": "string"
2683
+ },
2684
+ "iconWidth": {
2685
+ "default": "24px",
2686
+ "description": "图片宽度(高度等比例缩放)",
2687
+ "type": "string"
2688
+ },
2689
+ "iconfont": {
2690
+ "$ref": "#/definitions/TabBarIconFont",
2691
+ "description": "字体图标,优先级高于 iconPath"
2692
+ },
2693
+ "text": {
2694
+ "description": "中间按钮的文字",
2695
+ "type": "string"
2696
+ },
2697
+ "width": {
2698
+ "default": "80px",
2699
+ "description": "中间按钮的宽度,tabBar 其它项为减去此宽度后平分,默认值为与其它项平分宽度",
2700
+ "type": "string"
2701
+ }
2702
+ },
686
2703
  "type": "object"
687
2704
  },
688
2705
  "TheWindow": {
@@ -690,10 +2707,10 @@
690
2707
  "properties": {
691
2708
  "matchMedia": {
692
2709
  "additionalProperties": false,
693
- "description": "配置显示该窗口的规则,配置项参考下方 matchMedia",
2710
+ "description": "配置显示该窗口的规则,配置项参考 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages#matchmedia)",
694
2711
  "properties": {
695
2712
  "minWidth": {
696
- "default": "768",
2713
+ "default": 768,
697
2714
  "description": "当设备可见区域宽度 >= minWidth 时,显示该 window",
698
2715
  "type": "number"
699
2716
  }
@@ -706,7 +2723,7 @@
706
2723
  },
707
2724
  "style": {
708
2725
  "$ref": "#/definitions/GlobalStyle",
709
- "description": "配置页面窗口表现,配置项参考下方 pageStyle"
2726
+ "description": "配置页面窗口表现,配置项参考 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages#style)"
710
2727
  }
711
2728
  },
712
2729
  "required": [
@@ -714,18 +2731,124 @@
714
2731
  ],
715
2732
  "type": "object"
716
2733
  },
717
- "ThemeColor": {
718
- "type": "string"
2734
+ "TitleNViewButton": {
2735
+ "additionalProperties": false,
2736
+ "properties": {
2737
+ "background": {
2738
+ "anyOf": [
2739
+ {
2740
+ "$ref": "#/definitions/HEXColor"
2741
+ },
2742
+ {
2743
+ "$ref": "#/definitions/RGBAColor"
2744
+ }
2745
+ ],
2746
+ "default": "灰色半透明",
2747
+ "description": "自定义按钮背景色,仅在标题栏 type 为 \"transparent\" 时生效,支持 HEX 和 RGBA 颜色",
2748
+ "format": "color"
2749
+ },
2750
+ "color": {
2751
+ "$ref": "#/definitions/HEXColor",
2752
+ "default": "与标题文字样式一样",
2753
+ "description": "自定义按钮文字颜色,支持 HEX 颜色",
2754
+ "format": "color"
2755
+ },
2756
+ "colorPressed": {
2757
+ "anyOf": [
2758
+ {
2759
+ "$ref": "#/definitions/HEXColor"
2760
+ },
2761
+ {
2762
+ "$ref": "#/definitions/RGBAColor"
2763
+ }
2764
+ ],
2765
+ "default": "color 属性值自动调整透明度为 0.3",
2766
+ "description": "自定义按钮按下状态文字颜色,支持 HEX 和 RGBA 颜色",
2767
+ "format": "color"
2768
+ },
2769
+ "float": {
2770
+ "default": "right",
2771
+ "description": "自定义按钮在标题栏的显示位置,仅支持 \"right\" / \"left\"\n\n\"right\" 右侧\n\n\"left\" 左侧",
2772
+ "enum": [
2773
+ "right",
2774
+ "left"
2775
+ ],
2776
+ "type": "string"
2777
+ },
2778
+ "fontSize": {
2779
+ "description": "自定义按钮文字大小",
2780
+ "type": "string"
2781
+ },
2782
+ "fontSrc": {
2783
+ "description": "自定义按钮字体文件路径,只支持本地地址",
2784
+ "type": "string"
2785
+ },
2786
+ "fontWeight": {
2787
+ "default": "normal",
2788
+ "description": "自定义按钮文字粗细,仅支持 \"normal\" | \"bold\"\n\n\"normal\" 标准\n\n\"bold\" 加粗",
2789
+ "enum": [
2790
+ "normal",
2791
+ "bold"
2792
+ ],
2793
+ "type": "string"
2794
+ },
2795
+ "select": {
2796
+ "default": false,
2797
+ "description": "自定义按钮是否显示选择指示图标(向下箭头),常用于城市选择",
2798
+ "type": "boolean"
2799
+ },
2800
+ "text": {
2801
+ "description": "自定义按钮文字内容。使用字体图标时 unicode 字符表示必须以\"\\\\u\" 开头,如 \"\\\\ue123\"",
2802
+ "type": "string"
2803
+ },
2804
+ "type": {
2805
+ "default": "none",
2806
+ "description": "自定义按钮样式,详见 [自定义按钮样式](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-buttons-type)\n\n\"forward\" 前进按钮\n\n\"back\" 后退按钮\n\n\"share\" 分享按钮\n\n\"favorite\" 收藏按钮\n\n\"home\" 主页按钮\n\n\"menu\" 菜单按钮\n\n\"close\" 关闭按钮\n\n\"none\" 无样式,需通过 text 属性设置按钮上显示的内容、通过 fontSrc 属性设置使用的字体库",
2807
+ "enum": [
2808
+ "forward",
2809
+ "back",
2810
+ "share",
2811
+ "favorite",
2812
+ "home",
2813
+ "menu",
2814
+ "close",
2815
+ "none"
2816
+ ],
2817
+ "type": "string"
2818
+ },
2819
+ "width": {
2820
+ "anyOf": [
2821
+ {
2822
+ "$ref": "#/definitions/PxSize"
2823
+ },
2824
+ {
2825
+ "const": "auto",
2826
+ "type": "string"
2827
+ }
2828
+ ],
2829
+ "default": "44px",
2830
+ "description": "自定义按钮文字宽度,支持单位为 px 的逻辑像素值或 \"auto\",按钮内容居中显示"
2831
+ }
2832
+ },
2833
+ "type": "object"
719
2834
  },
720
2835
  "UniIdRouter": {
721
2836
  "additionalProperties": false,
722
2837
  "properties": {
723
2838
  "loginPage": {
724
2839
  "description": "登录页面路径",
2840
+ "examples": [
2841
+ "pages/index/index"
2842
+ ],
725
2843
  "type": "string"
726
2844
  },
727
2845
  "needLogin": {
728
2846
  "description": "需要登录才可以访问的页面列表,可以使用正则语法",
2847
+ "examples": [
2848
+ [
2849
+ "pages/detail/.*"
2850
+ ]
2851
+ ],
729
2852
  "items": {
730
2853
  "type": "string"
731
2854
  },
@@ -733,7 +2856,7 @@
733
2856
  },
734
2857
  "resToLogin": {
735
2858
  "default": true,
736
- "description": "是否自动解析云对象及 clientDB 的错误码,如果是客户端 token 不正确或 token 过期则自动跳转配置的登录页面",
2859
+ "description": "是否是否自动解析云对象及 clientDB 的错误码,如果是客户端 token 不正确或 token 过期则自动跳转配置的登录页面",
737
2860
  "type": "boolean"
738
2861
  }
739
2862
  },