tmui-cli 2.0.3 → 2.0.4

package/data/uni-app-x-docs/component/common.md

@@ -0,0 +1,304 @@
+# 组件的全局属性和事件
+
+每个组件都有属性和事件。有些属性和事件，是所有组件都支持的。
+
+## 组件全局属性 <Help>
+
+<!-- CUSTOMTYPEJSON.general-attribute.attribute -->
+
+#### data-*@dataset
+
+从 5.21 起全平台 dataset 调整为 UniDOMStringMap 类型。
+
+支持能力：
+
+- 支持 Map 相关 API 操作，如 get、set、has 等。
+- 支持索引访问，如 dataset['foo']。
+- 支持点操作符访问，如 dataset.foo。
+
+注意：
+
+- dataset 赋值、修改操作仅影响 dataset 自身，不会写入 attribute 或底层原生节点属性。
+- 如果定义了 get、set、has 等与 Map 标准 API 冲突的 key，需要通过 Map API 获取数据值。例如 data-get 使用 dataset.get('get')，data-set 使用 dataset.get('set')；不支持通过索引或点操作符读取这些冲突 key 的数据值。
+- App 蒸汽模式不支持通过 UniElement.getAttribute 获取 data-*，仅支持通过 dataset 获取。
+- App 蒸汽模式目前仅支持在 uvue 中使用 dataset；uts插件的utssdk中暂不支持获取 uvue/JS 层设置的 dataset。
+- 小程序平台仅支持通过事件 target/currentTarget 以及 createSelectorQuery、createIntersectionObserver 获取实际 dataset；通过 getElementById 无法获取到实际 dataset。
+
+
+<!-- CUSTOMTYPEJSON.general-attribute.compatibility -->
+
+### App-Android平台专有属性@attribute-android
+
+> android-开头的属性名称为App-Android平台专有属性
+
+#### android-layer-type <Badge text="HBuilderX 4.01"/>
+
+> 不支持动态修改此属性
+>
+> 更多信息可参考Android官方文档[硬件加速](https://developer.android.google.cn/topic/performance/hardware-accel?hl=zh-cn)。
+
+App-Android平台设置组件视图渲染模型，字符串类型，可取值：
+- "hardware": 视图在硬件中渲染为硬件纹理
+- "software": 视图在软件中渲染为位图
+- "none": 视图正常渲染，不使用缓冲区
+默认值为"none"。
+
+::: tip Tips
+- 不建议对所有的组件设置`hardware`，大量的视图在硬件中渲染会占用巨大的显存开销、增加Android原生渲染的复杂度。
+- 不建议对频繁修改的组件设置`hardware`，频繁修改的会增加硬件的缓存更新。
+- 通过[DrawableContext](../dom/drawablecontext.md)或其他方式绘制复杂图形时，建议设置为`hardware`。
+- 执行复杂动画或大量动画时，建议设置为`hardware`。
+- 由于安卓原生限制，当设置`android-layer-type`为`hardware`或`software`时，`overflow: visible`不生效。
+:::
+
+<!-- CUSTOMTYPEJSON.global-properties.example -->
+
+### 参见
+
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.global-properties-events.global-properties)
+
+## 组件全局事件 <Help>
+
+<!-- CUSTOMTYPEJSON.general-event.attribute -->
+
+<!-- CUSTOMTYPEJSON.general-event.compatibility -->
+
+<!-- CUSTOMTYPEJSON.general-event.example -->
+
+### touch 事件@touch
+触摸事件包括：touchstart、touchmove、touchcancel、touchend 等。
+
+在多点触摸的屏幕上，touch事件返回数组，包含了每个touch点对应的x、y坐标。
+
+双指缩放，可以参考uni.preview的源码，这是一个uvue页面，监听双指来缩放图片。[详见](https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-previewImage)
+
+<!-- CUSTOMTYPEJSON.touch-events.example -->
+
+### tap/click 事件@tap
+
+- App端
+App端手指按下后在组件区域内移动不会取消tap/click事件的触发，移动到组件区域外才会取消tap/click事件的触发。
+
+- Web端
+手指按下后移动会取消tap/click事件的触发，即手指移动后抬起不会响应tap/click事件
+
+
+### transition 事件 <Badge text="Android 3.93"/>
+
+- @transitionend
+
+	transition 效果结束时触发
+
+<!-- CUSTOMTYPEJSON.transition-events.example -->
+
+### 冒泡事件系统
+
+> DOM事件主要有三个阶段：`捕获阶段`、`目标阶段`和`冒泡阶段`。
+>
+> App平台目前暂不支持事件的捕获阶段编程。
+
+以点击事件为例，当触发点击时，
+1. 首先从根节点逐级向下分发，直到监听点击事件的节点为止（捕获阶段）；
+2. 然后事件到达当前节点并触发点击事件（目标阶段）；
+3. 接着继续向上逐级触发父节点的点击事件，直到根节点为止（冒泡阶段）。
+
+::: warning 注意
+虽然有3个阶段，但第2个阶段（“目标阶段”：事件到达了元素）并没有单独处理：捕获和冒泡阶段的处理程序都会在该阶段触发。
+
+我们一般使用默认的事件注册机制，将事件注册到冒泡阶段，相对来说，大多数处理情况都在冒泡阶段。
+:::
+
+#### 阻止冒泡
+
+在事件回调中，可以通过调用`event.stopPropagation`方法阻止事件冒泡。
+
+<!-- CUSTOMTYPEJSON.touch-events-case.example -->
+
+#### 阻止默认行为
+
+在事件回调中，可以通过调用`event.preventDefault`方法阻止默认行为。`event.preventDefault`仅处理默认行为，事件冒泡不会被阻止。
+
+<!-- CUSTOMTYPEJSON.touch-events-preventDefault-click.example -->
+
+### Bug & Tips
+
+- uni-app x 4.0以前，连续触发`click`或`tap`事件，可能会出现事件丢失的情况。请升级新版
+
+::: info 调整
+
+1. uni-app x 4.0+ ，组件事件类型的名称增加 Uni 前缀，避免与浏览器全局事件冲突
+2. 非 Uni 开头的事件类型名称被标记为废弃，功能不受影响。
+3. 如您使用uni-app x 4.0以下版本，仍需去掉 Uni 前缀
+
+变更示例
+```html
+<template>
+  <slider @change="sliderChange" />
+</template>
+<script setup lang="uts">
+  // 变更之前类型为 SliderChangeEvent
+  //function  sliderChange(e : SliderChangeEvent) {
+  // }
+
+  // 变更之后类型为 UniSliderChangeEvent
+  function sliderChange(e : UniSliderChangeEvent) {
+  }
+</script>
+```
+:::
+
+### 参见
+
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.global-properties-events.global-events)
+
+## UniEvent
+
+> 在小程序端各种Event事件名称只能作为类型是用，不能作为值使用。比如：`let xx: UniTouchEvent = e`是支持的，`xx instanceof UniTouchEvent`是不支持的
+
+<!-- CUSTOMTYPEJSON.UniEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.param -->
+
+
+
+### UniEvent 方法 @event-methods
+<!-- CUSTOMTYPEJSON.UniEvent.methods.stopPropagation.name -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.stopPropagation.description -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.stopPropagation.param -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.stopPropagation.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.stopPropagation.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.stopPropagation.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.preventDefault.name -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.preventDefault.description -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.preventDefault.param -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.preventDefault.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.preventDefault.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniEvent.methods.preventDefault.tutorial -->
+
+## UniCustomEvent\<T> @unicustomevent
+
+<!-- CUSTOMTYPEJSON.UniCustomEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniCustomEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniCustomEvent.param -->
+
+
+## UniPointerEvent
+
+<!-- CUSTOMTYPEJSON.UniPointerEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniPointerEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniPointerEvent.param -->
+
+<!-- CUSTOMTYPEJSON.UniPointerEvent.example -->
+
+## UniTouchEvent
+
+<!-- CUSTOMTYPEJSON.UniTouchEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniTouchEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniTouchEvent.param -->
+
+UniTouchEvent 的 type 类型包括：touchstart、touchmove、touchend、touchcancel、longpress。
+
+## UniTouch
+
+<!-- CUSTOMTYPEJSON.UniTouch.description -->
+
+<!-- CUSTOMTYPEJSON.UniTouch.extends -->
+
+<!-- CUSTOMTYPEJSON.UniTouch.param -->
+
+<!-- CUSTOMTYPEJSON.Unigeneral-event.example -->
+
+## UniMouseEvent
+
+<!-- CUSTOMTYPEJSON.UniMouseEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniMouseEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniMouseEvent.param -->
+
+<!-- CUSTOMTYPEJSON.UniMouseEvent.example -->
+
+## UniKeyEvent
+
+<!-- CUSTOMTYPEJSON.UniKeyEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniKeyEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniKeyEvent.param -->
+
+<!-- CUSTOMTYPEJSON.UniKeyEvent.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniKeyEvent.example -->
+
+## UniNativeViewEvent
+
+<!-- CUSTOMTYPEJSON.UniNativeViewEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniNativeViewEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniNativeViewEvent.param -->
+
+<!-- CUSTOMTYPEJSON.UniNativeViewEvent.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniNativeViewEvent.example -->
+
+## UniVideoEvent
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.description -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.extends -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.param -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.example -->
+
+### UniVideoEvent 的方法 @univideoevent-methods
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.stopPropagation.name -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.stopPropagation.description -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.stopPropagation.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.stopPropagation.param -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.stopPropagation.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.stopPropagation.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.preventDefault.name -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.preventDefault.description -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.preventDefault.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.preventDefault.param -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.preventDefault.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniVideoEvent.methods.preventDefault.tutorial -->
+
+
+## 参见
+
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.global-properties-events)

package/data/uni-app-x-docs/component/cover-image.md

@@ -0,0 +1,25 @@
+## cover-image
+
+<!-- UTSCOMJSON.cover-image.description -->
+
+cover-image 在uni-app x的app、web、微信小程序上，已废弃，使用 image 即可。
+
+在其他小程序平台，某些原生组件（如map、canvas、video）不支持同层渲染，仍需要 cover-image 来覆盖。
+
+<!-- UTSCOMJSON.cover-image.compatibility -->
+
+::: warning 注意
+app 端并不是在运行时实现了 cover-image 组件，仅仅是编译器把 cover-image 编译为了 image。运行时获取到的Dom仍然是UniImageElement。
+:::
+
+<!-- UTSCOMJSON.cover-image.attribute -->
+
+<!-- UTSCOMJSON.cover-image.event -->
+
+<!-- UTSCOMJSON.cover-image.component_type -->
+
+<!-- UTSCOMJSON.cover-image.children -->
+
+<!-- UTSCOMJSON.cover-image.example -->
+
+<!-- UTSCOMJSON.cover-image.reference -->

package/data/uni-app-x-docs/component/cover-view.md

@@ -0,0 +1,25 @@
+## cover-view
+
+<!-- UTSCOMJSON.cover-view.description -->
+
+cover-view 在uni-app x的app、web、微信小程序上，已废弃，使用view即可。
+
+在其他小程序平台，某些原生组件（如map、canvas、video）不支持同层渲染，仍需要cover-view来覆盖。
+
+<!-- UTSCOMJSON.cover-view.compatibility -->
+
+::: warning 注意
+app 端并不是在运行时实现了cover-view组件，仅仅是编译器把cover-view编译为了view。
+:::
+
+<!-- UTSCOMJSON.cover-view.attribute -->
+
+<!-- UTSCOMJSON.cover-view.event -->
+
+<!-- UTSCOMJSON.cover-view.component_type -->
+
+<!-- UTSCOMJSON.cover-view.children -->
+
+<!-- UTSCOMJSON.cover-view.example -->
+
+<!-- UTSCOMJSON.cover-view.reference -->

package/data/uni-app-x-docs/component/custom-tab-bar.md

@@ -0,0 +1,19 @@
+<!-- ## custom-tab-bar -->
+
+<!-- UTSCOMJSON.custom-tab-bar.name -->
+
+<!-- UTSCOMJSON.custom-tab-bar.description -->
+
+<!-- UTSCOMJSON.custom-tab-bar.compatibility -->
+
+<!-- UTSCOMJSON.custom-tab-bar.attribute -->
+
+<!-- UTSCOMJSON.custom-tab-bar.event -->
+
+<!-- UTSCOMJSON.custom-tab-bar.component_type -->
+
+<!-- UTSCOMJSON.custom-tab-bar.children -->
+
+<!-- UTSCOMJSON.custom-tab-bar.example -->
+
+<!-- UTSCOMJSON.custom-tab-bar.reference -->

package/data/uni-app-x-docs/component/double-tap-gesture-handler.md

@@ -0,0 +1,19 @@
+<!-- ## double-tap-gesture-handler -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.name -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.description -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.compatibility -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.attribute -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.event -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.component_type -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.children -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.example -->
+
+<!-- UTSCOMJSON.double-tap-gesture-handler.reference -->

package/data/uni-app-x-docs/component/draggable-sheet.md

@@ -0,0 +1,19 @@
+<!-- ## draggable-sheet -->
+
+<!-- UTSCOMJSON.draggable-sheet.name -->
+
+<!-- UTSCOMJSON.draggable-sheet.description -->
+
+<!-- UTSCOMJSON.draggable-sheet.compatibility -->
+
+<!-- UTSCOMJSON.draggable-sheet.attribute -->
+
+<!-- UTSCOMJSON.draggable-sheet.event -->
+
+<!-- UTSCOMJSON.draggable-sheet.component_type -->
+
+<!-- UTSCOMJSON.draggable-sheet.children -->
+
+<!-- UTSCOMJSON.draggable-sheet.example -->
+
+<!-- UTSCOMJSON.draggable-sheet.reference -->

package/data/uni-app-x-docs/component/editor.md

@@ -0,0 +1,33 @@
+<!-- ## editor -->
+
+<!-- UTSCOMJSON.editor.name -->
+
+<!-- UTSCOMJSON.editor.description -->
+
+<!-- UTSCOMJSON.editor.compatibility -->
+
+<!-- UTSCOMJSON.editor.attribute -->
+
+<!-- UTSCOMJSON.editor.event -->
+
+<!-- UTSCOMJSON.editor.component_type -->
+
+<!-- UTSCOMJSON.editor.children -->
+
+### 上下文对象API
+
+editor组件有上下文对象，api为[uni.createEditorContextAsync()](../api/create-editor-context-async.md)。
+
+给editor组件设一个id属性，将id的值传入uni.createEditorContextAsync()，即可得到editor组件的上下文对象，进一步可使用对象上的方法。
+
+
+<!-- UTSCOMJSON.editor.example -->
+
+<!-- UTSCOMJSON.editor.reference -->
+
+# tips
+- 虽然editor组件被分类到form组件，但并不能在form的submit中提交
+- 如果要做 im 输入类功能，需要使用 [onKeyboardHeightChange](../api/keyboard.md#onkeyboardheightchange) 监听键盘高度变化，来定位 editor 组件的位置，避免被键盘遮挡
+- editor 组件可以使用 `readOnly=false` 属性来让键盘失焦，然后通过 `readOnly=true;setTimeout(() => {editor.format(name, value)}, 0)` 来实现在 editor 组件失焦的情况下调用 format 方法来修改 editor 组件内容输入并自动聚焦。如果失焦后直接调用 format 方法，再手动聚焦设置的内容会被覆盖掉。
+- editor 存在 `min-height: 200px` 的默认样式，如果需要修改高度，请注意重写 `min-height` 样式
+  - **Bug：** 在 HBuilderX 5.21 之前 min-height 样式不生效，始终会有 200px 的最小高度

package/data/uni-app-x-docs/component/flow-item.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+已迁移至 [waterflow](./waterflow.md#flow-item)

package/data/uni-app-x-docs/component/force-press-gesture-handler.md

@@ -0,0 +1,19 @@
+<!-- ## force-press-gesture-handler -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.name -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.description -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.compatibility -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.attribute -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.event -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.component_type -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.children -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.example -->
+
+<!-- UTSCOMJSON.force-press-gesture-handler.reference -->

package/data/uni-app-x-docs/component/form.md

@@ -0,0 +1,108 @@
+<!-- ## form -->
+
+<!-- UTSCOMJSON.form.name -->
+
+<!-- UTSCOMJSON.form.description -->
+
+<!-- UTSCOMJSON.form.compatibility -->
+
+<!-- UTSCOMJSON.form.attribute -->
+
+<!-- UTSCOMJSON.form.event -->
+
+<!-- UTSCOMJSON.form.component_type-->
+
+## form内容项控制逻辑
+
+form组件的内容子组件包括：input、textarea、checkbox、radio、switch、slider，以及负责提交或重置的button组件。
+
+button可以设置form-type属性为submit或reset，点击时会分别触发form的提交或重置。
+
+在表单submit或reset时，这些表单内容子组件的值会被提交或重置。
+
+注意：目前不支持上述组件之外自行添加表单内容子组件。如有自定义组件，则不能使用form组件提交，需自行通过绑定data的方式获取组件值并自行编码提交数据。
+
+### submit策略差异
+
+form 组件的表单提交，微信小程序的实现策略，与浏览器W3C的策略略有差异。目前uni-app(x)在submit时，app和web上的实现与微信小程序相同。具体是：
+
+- uni-app表单提交的数据是一个对象`{"name": "value"}`。而浏览器标准form是数组，每项为 pair，pair[0] 对应name，pair[1] 对应value 。
+- 多个表单子项如果 name 相同，仅保留最后一个表单子项。而浏览器标准form整体是数组，不存在覆盖的情况。
+- 设置 disabled 属性的表单子项，仍然会提交。而浏览器标准form提交时会忽略disabled的表单子项。
+
+注意uni-app(x)编译到web平台，也是按uni-app(x)的策略，而不是浏览器的策略。uni-app(x) 的 web平台使用 uni-app 自己的 form 组件，而不是浏览器的 form 标签。
+
+### reset策略差异
+
+reset在浏览器W3C的策略是还原、重置。
+
+在uni-app(x)中，不同平台的策略不同，有的是`还原`，有的是`清空`。
+
+各平台策略如下：
+
+**uni-app-x**
+
+|App				|Web				|
+|:-:				|:-:				|
+|还原(3.97+)	|还原(4.0+)	|
+
+
+**uni-app**
+
+|App	|Web	|微信小程序	|支付宝小程序	|百度小程序	|抖音小程序	|
+|:-:	|:-:	|:-:			|:-:				|:-:			|:-:			|
+|清空	|清空	|清空			|还原				|清空			|清空			|
+
+
+1. 还原初始值
+
+```html
+<!-- reset 后为 name -->
+<input name="input1" value="name" />
+
+<!-- reset 后为 true -->
+<switch name="switch1" :checked="true" />
+
+<!-- reset 后为 50 -->
+<slider name="slider1" :value="50" :min="10" :max="110" />
+
+<!-- reset 后为 "写字" 被 checked -->
+<checkbox-group name="loves">
+  <view>
+    <checkbox value="0" /><text>读书</text>
+  </view>
+  <view>
+    <checkbox value="1" :checked="true" /><text>写字</text>
+  </view>
+</checkbox-group>
+```
+
+2. 清空已有值(含初始值和改变后的值)
+
+```html
+<!-- reset 后为 "" -->
+<input name="input1" value="name" />
+
+<!-- reset 后为 false -->
+<switch name="switch1" :checked="true" />
+
+<!-- reset 后为 最小值10 -->
+<slider name="slider1" :value="50" :min="10" :max="110" />
+
+<!-- reset 后为 无任何 checked -->
+<checkbox-group name="loves">
+  <view>
+    <checkbox value="0" /><text>读书</text>
+  </view>
+  <view>
+    <checkbox value="1" :checked="true" /><text>写字</text>
+  </view>
+</checkbox-group>
+```
+
+
+<!-- UTSCOMJSON.form.children -->
+
+<!-- UTSCOMJSON.form.example -->
+
+<!-- UTSCOMJSON.form.reference -->

package/data/uni-app-x-docs/component/functional-page-navigator.md

@@ -0,0 +1,19 @@
+<!-- ## functional-page-navigator -->
+
+<!-- UTSCOMJSON.functional-page-navigator.name -->
+
+<!-- UTSCOMJSON.functional-page-navigator.description -->
+
+<!-- UTSCOMJSON.functional-page-navigator.compatibility -->
+
+<!-- UTSCOMJSON.functional-page-navigator.attribute -->
+
+<!-- UTSCOMJSON.functional-page-navigator.event -->
+
+<!-- UTSCOMJSON.functional-page-navigator.component_type -->
+
+<!-- UTSCOMJSON.functional-page-navigator.children -->
+
+<!-- UTSCOMJSON.functional-page-navigator.example -->
+
+<!-- UTSCOMJSON.functional-page-navigator.reference -->

package/data/uni-app-x-docs/component/glass-effect-view.md

@@ -0,0 +1,32 @@
+<!-- UTSCOMJSON.glass-effect-view.name -->
+
+<!-- UTSCOMJSON.glass-effect-view.description -->
+
+本组件适合在iOS26以上制作顶部的左上返回箭头或右上悬浮按钮。
+液态玻璃的tabbar，一般不使用本组件，而是在[pages.json](../collocation/pagesjson.md#pages-tabbar)中配置tabbar的glassEffect属性。
+如果使用本组件实现tabbar，自定义性会强于pages.json的tabbar，但无法实现iOS UITabBar左右滑动item的动效。
+
+<!-- UTSCOMJSON.glass-effect-view.readme -->
+
+<!-- UTSCOMJSON.glass-effect-view.compatibility -->
+
+- iOS26以下：组件降级为系统毛玻璃效果，"regular" 映射为系统标准毛玻璃材质，"clear" 映射为更轻、更透明的毛玻璃材质，interactive、tint-color 属性将不生效。
+- 液态玻璃（Liquid Glass）是iOS26特有效果。它和毛玻璃在显示效果、触摸效果上并不一样。如需其他平台上使用毛玻璃效果，应使用css的[backdrop-filter](../css/backdrop-filter.md)
+
+<!-- UTSCOMJSON.glass-effect-view.attribute -->
+
+<!-- UTSCOMJSON.glass-effect-view.fileFormates -->
+
+<!-- UTSCOMJSON.glass-effect-view.event -->
+
+<!-- UTSCOMJSON.glass-effect-view.component_type -->
+
+<!-- UTSCOMJSON.glass-effect-view.children -->
+
+### Tips@tips
+
+- 玻璃材质需要实时采样和合成背景内容。大量创建、重叠或在长列表中频繁复用玻璃组件可能增加 GPU 合成开销造成卡顿。
+
+<!-- UTSCOMJSON.glass-effect-view.example -->
+
+<!-- UTSCOMJSON.glass-effect-view.reference -->

package/data/uni-app-x-docs/component/grid-builder.md

@@ -0,0 +1,19 @@
+<!-- ## grid-builder -->
+
+<!-- UTSCOMJSON.grid-builder.name -->
+
+<!-- UTSCOMJSON.grid-builder.description -->
+
+<!-- UTSCOMJSON.grid-builder.compatibility -->
+
+<!-- UTSCOMJSON.grid-builder.attribute -->
+
+<!-- UTSCOMJSON.grid-builder.event -->
+
+<!-- UTSCOMJSON.grid-builder.component_type -->
+
+<!-- UTSCOMJSON.grid-builder.children -->
+
+<!-- UTSCOMJSON.grid-builder.example -->
+
+<!-- UTSCOMJSON.grid-builder.reference -->

package/data/uni-app-x-docs/component/grid-view.md

@@ -0,0 +1,19 @@
+<!-- ## grid-view -->
+
+<!-- UTSCOMJSON.grid-view.name -->
+
+<!-- UTSCOMJSON.grid-view.description -->
+
+<!-- UTSCOMJSON.grid-view.compatibility -->
+
+<!-- UTSCOMJSON.grid-view.attribute -->
+
+<!-- UTSCOMJSON.grid-view.event -->
+
+<!-- UTSCOMJSON.grid-view.component_type -->
+
+<!-- UTSCOMJSON.grid-view.children -->
+
+<!-- UTSCOMJSON.grid-view.example -->
+
+<!-- UTSCOMJSON.grid-view.reference -->