tmui-cli 2.0.2 → 2.0.4

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

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

package/data/uni-app-x-docs/component/sticky-header.md

@@ -0,0 +1,50 @@
+<!-- ## sticky-header -->
+
+<!-- UTSCOMJSON.sticky-header.name -->
+
+<!-- UTSCOMJSON.sticky-header.description -->
+
+<!-- UTSCOMJSON.sticky-header.compatibility -->
+
+<!-- UTSCOMJSON.sticky-header.attribute -->
+
+<!-- UTSCOMJSON.sticky-header.event -->
+
+<!-- UTSCOMJSON.sticky-header.component_type-->
+
+### 使用场景
+
+父元素滚动过程中，实现某个子元素固定到父元素顶部的需求
+
+需求其实就是元素吸顶。可将需要吸顶元素放入sticky-header组件中，sticky-header组件作为父元素的子元素，放到吸顶元素原来的位置即可。
+
+**示例：**
+
+```html
+<list-view id="list-view" style="flex: 1; background-color: #f5f5f5;">
+  <sticky-header>
+    <!-- 固定到父元素顶部的元素 -->
+    <text style="padding: 20px; background-color: #f5f5f5;">向上滑动页面，体验sticky-header吸顶效果。</text>
+  </sticky-header>
+  <list-item v-for="index in 20" :key="index" style="padding: 15px; margin: 5px 0;background-color: #fff;border-radius: 5px;">
+    <text class="text">itme-content-{{index}}</text>
+  </list-item>
+</list-view>
+```
+
+#### 注意事项
+
++ 同一元素下不能存在多 `sticky-header` 组件，使用多个 `sticky-header` 组件需分别放到 `sticky-section` 中
++ `sticky-header` 组件，不支持设置css样式，不要通过 class 和 style 设置样式
++ 鸿蒙平台暂不支持 `padding` 属性，可通过设置子元素样式来实现类似效果
++ 鸿蒙平台 `sticky-header` 组件只能作为 `sticky-section` 的子元素使用
++ 鸿蒙平台API版本低于17的设备不支持 `sticky-header` 组件，可在滚动容器里自行监听滚动，设置某个区域的top为固定值来实现吸顶效果，参考hello uni-app x的模板->[scroll-view自定义滚动吸顶示例](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/template/scroll-view-sticky-section/scroll-view-sticky-section.uvue)
++ 蒸汽模式 sticky-header必须是sticky-section内首个元素
++ 蒸汽模式 每个sticky-section下仅支持一个sticky-header
+
+
+<!-- UTSCOMJSON.sticky-header.children -->
+
+<!-- UTSCOMJSON.sticky-header.example -->
+
+<!-- UTSCOMJSON.sticky-header.reference -->

package/data/uni-app-x-docs/component/sticky-section.md

@@ -0,0 +1,54 @@
+<!-- ## sticky-section -->
+
+<!-- UTSCOMJSON.sticky-section.name -->
+
+<!-- UTSCOMJSON.sticky-section.description -->
+
+<!-- UTSCOMJSON.sticky-section.compatibility -->
+
+<!-- UTSCOMJSON.sticky-section.attribute -->
+
+<!-- UTSCOMJSON.sticky-section.event -->
+
+<!-- UTSCOMJSON.sticky-section.component_type-->
+
+### sticky-section使用场景
+
+父元素滚动过程中，多个元素有固定到父元素顶部的需求。
+
+父元素中多个元素吸顶需要使用sticky-section组件。sticky-section组件作为sticky-header组件的父容器。sticky-section组件会控制子元素的滚动吸顶业务。sticky-section组件之间可通过push-pinned-header属性控制吸顶重叠时是否上推。
+
+**示例：**
+
+```html
+<list-view id="list-view" style="flex: 1; background-color: #f5f5f5;">
+  <sticky-section v-for="sectionId in 3" :id="sectionId" push-pinned-header=false :preload="true">
+    <sticky-header>
+      <text style="padding: 20px; background-color: #f5f5f5;">sticky-header吸顶--{{sectionId}}</text>
+    </sticky-header>
+    <list-item v-for="index in 20" :key="index" style="padding: 15px; margin: 5px 0;background-color: #fff;border-radius: 5px;">
+      <text class="text">itme-content-{{index}}</text>
+    </list-item>
+  </sticky-section>
+</list-view>
+```
+
+#### preload属性说明
+
+> 仅app平台蒸汽模式支持
+
+preload属性用于控制sticky-section组件的预加载行为，默认值为false。设置为true时，sticky-section组件会在滚动到该section之前就进行渲染，从而避免或减少滚动到该section时出现空白或闪烁的情况。例如在index-bar这种直接跳转到某个section的场景下，设置preload为true可以提升用户体验。参考：[uni-ui-x index-bar示例](https://gitcode.com/dcloud/uni-ui-x/blob/dev/pages/uni-ui/index-bar/index-bar.uvue)
+
+#### 注意事项  
+
++ Android平台、iOS平台sticky-section组件支持存放多个sticky-header子组件，多个sticky-header滚动吸顶时，后一个sticky-header会停靠在前一个sticky-header的末尾处, 仅限于同一个sticky-section父容器。多个sticky-section吸顶停靠通过push-pinned-header控制。  
++ `sticky-section` 组件，不支持设置css样式，不要通过 class 和 style 设置样式  
++ Android平台 `sticky-section` 组件作为 list-view 的子元素时需要注意，sticky-section子元素仅支持sticky-header、list-item，其他元素无法正常显示
++ 鸿蒙平台暂不支持 `padding` 属性，可通过设置子元素样式来实现类似效果  
++ 蒸汽模式 sticky-section内的list-item必须使用v-for、不能使用v-if，且此v-for必须有key
+
+<!-- UTSCOMJSON.sticky-section.children -->
+
+<!-- UTSCOMJSON.sticky-section.example -->
+
+<!-- UTSCOMJSON.sticky-section.reference -->

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

@@ -0,0 +1,8 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移至：
+
+- [sticky-header](sticky-header.md)
+- [sticky-section](sticky-section.md)

package/data/uni-app-x-docs/component/store-home.md

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

package/data/uni-app-x-docs/component/store-product.md

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

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

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

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

@@ -0,0 +1,94 @@
+<!-- ## swiper -->
+
+<!-- UTSCOMJSON.swiper.name -->
+
+<!-- UTSCOMJSON.swiper.description -->
+
+<!-- UTSCOMJSON.swiper.compatibility -->
+
+<!-- UTSCOMJSON.swiper.attribute -->
+
+<!-- UTSCOMJSON.swiper.event -->
+
+<!-- UTSCOMJSON.swiper.component_type-->
+
+<!-- UTSCOMJSON.swiper.children -->
+
+<!-- UTSCOMJSON.swiper.example -->
+
+<!-- EXAMPLEJSON.swiper.swiper-list-view -->
+
+<!-- EXAMPLEJSON.swiper.swiper-more -->
+
+**平台差异**
+
+- web、小程序、app-harmony 端的swiper-item为绝对定位，无法撑开swiper。所以swiper组件的默认高度为150px。
+- app-android和iOS的swiper目前默认会以内容高度撑开作为其高度。如果要多端拉齐应自行设置swiper的style里的高度。后续Android和iOS的swiper也会统一为其他平台的方式。
+
+:::warning 注意
+- 使用 `auto-height` 属性时，`swiper-item` 组件外层容器和 slot 内容之间会增加一层 `view`，这会导致设置在 `swiper-item` 上的布局样式无法直接影响插槽内的元素（比如 `align-items: center`），请注意避免影响布局。
+- 蒸汽模式不再支持 `rebound` 属性，如需控制是否回弹效果，请使用 `disable-bounce` 属性。
+- 蒸汽模式不再支持 `indicator-color` 和 `indicator-active-color` 属性，如需自定义指示点颜色及其他样式，请使用 `indicator-style`、`indicator-class` 和 `indicator-active-style`、`indicator-active-class` 属性。
+- 蒸汽模式新增通过 `<template v-slot:indicator>` 具名插槽自定义指示点，示例代码如下：
+:::
+```vue
+<template>
+	<swiper :current="current" @change="handleSwiperChange">
+		<swiper-item>
+			<view style="height: 100%; align-items: center; justify-content: center; background-color: #16a085;">
+				<text style="color: white;">Item 1</text>
+			</view>
+		</swiper-item>
+		<swiper-item>
+			<view style="height: 100%; align-items: center; justify-content: center; background-color: #cccccc;">
+				<text style="color: black;">Item 2</text>
+			</view>
+		</swiper-item>
+		<swiper-item>
+			<view style="height: 100%; align-items: center; justify-content: center; background-color: #00cc00;">
+				<text style="color: white;">Item 3</text>
+			</view>
+		</swiper-item>
+		<template v-slot:indicator>
+			<text v-for="(_, index) in 3" class="custom-indicator-text" :class="{ 'active': current === index }">{{index + 1}}</text>
+		</template>
+	</swiper>
+</template>
+
+<script setup lang="uts">
+	const current = ref(0)
+
+	const handleSwiperChange = (e : UniSwiperChangeEvent) => {
+		current.value = e.detail.current
+	}
+</script>
+
+<style>
+	.custom-indicator-text {
+		margin: 0 5px;
+	}
+
+	.custom-indicator-text.active {
+		font-size: 18px;
+		color: yellow;
+		font-weight: bold;
+	}
+</style>
+```
+
+
+## swiper-item
+
+<!-- UTSCOMJSON.swiper-item.description -->
+
+<!-- UTSCOMJSON.swiper-item.compatibility -->
+
+<!-- UTSCOMJSON.swiper-item.attribute -->
+
+<!-- UTSCOMJSON.swiper-item.event -->
+
+<!-- UTSCOMJSON.swiper-item.component_type-->
+
+<!-- UTSCOMJSON.swiper-item.example -->
+
+<!-- UTSCOMJSON.swiper-item.reference -->

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

@@ -0,0 +1,28 @@
+<!-- ## switch -->
+
+<!-- UTSCOMJSON.switch.name -->
+
+<!-- UTSCOMJSON.switch.description -->
+
+<!-- UTSCOMJSON.switch.compatibility -->
+
+<!-- UTSCOMJSON.switch.attribute -->
+
+type为checkbox只有微信小程序和Web平台支持。一般建议使用标准的[checkbox组件](checkbox-group.md)
+
+<!-- UTSCOMJSON.switch.event -->
+
+<!-- UTSCOMJSON.switch.component_type-->
+
+<!-- UTSCOMJSON.switch.children -->
+
+### 注意事项：
+- app-ios平台不支持padding style（padding-top、padding-left、padding-right、padding-bottom）
+
+### 暗黑模式
+
+App平台蒸汽模式从 5.25+ 起内置适配 switch 默认样式的暗黑模式。暗黑模式下，switch 未选中时轨道背景色为 `#3b3b3f`；选中时轨道背景色为 `#007aff`。
+
+<!-- UTSCOMJSON.switch.example -->
+
+<!-- UTSCOMJSON.switch.reference -->

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

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

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

@@ -0,0 +1,242 @@
+<!-- ## text -->
+
+<!-- UTSCOMJSON.text.name -->
+
+<!-- UTSCOMJSON.text.description -->
+
+<!-- UTSCOMJSON.text.compatibility -->
+
+在app-uvue和app-nvue中，文本只能写在text中，而不能写在view的text区域。文本样式的控制也应该在text组件上写style，而不是在view的样式里写。
+
+虽然app-uvue中写在view的text区域的文字，也会被编译器自动包裹一层text组件，看起来也可以使用。但这样会造成无法修改该text文字的样式，详见uvue的[样式不继承](../css/README.md#stylenoextends)章节。
+
+<!-- UTSCOMJSON.text.attribute -->
+
+<!-- UTSCOMJSON.text.event -->
+
+<!-- UTSCOMJSON.text.component_type-->
+
+### hover-class
+App平台蒸汽模式（Vapor） `text` 组件新增支持 `hover-class` 实现点击态效果。
+
+**注意**
+- 蒸汽模式（Vapor）子 `text` 组件不支持 hover 相关功能
+- VDOM模式 `text` 组件不支持 hover 相关功能
+
+
+### 空白字符
+`空白字符`并不只是指空格键敲出来的那个`空格`字符，它是一个字符集合。
+包括以下字符：
+- 普通空格 (Space): (ASCII 32)
+- 制表符 (Tab): \t (ASCII 9)
+- 换行符 (Line Feed): \n (ASCII 10)
+- 回车符 (Carriage Return): \r (ASCII 13)
+
+空白字符的处理分为 编译期处理 和  运行期处理 两个阶段。
+
+#### 编译期处理
+编译期间仅处理template中直接写在text节点中的静态文本，如下示例1：
+```uvue
+<template>
+  <text id="t1"> a   bc def	g
+hi </text>
+</template>
+```
+编译期间会将template中静态文本的所有空白字符转换为空格，并将多个连续空格合并为一个空格，首尾空格保留。
+如上示例1编译后text组件中的文本内容为“ a bc def g hi ”。
+
+注意：编译期间不会处理变量中的空白字符。
+
+#### 运行期处理
+由 `space` 属性 和 [white-space](../css/white-space.md) 样式共同决定。
+- `space` 属性：仅处理空格字符
+- [white-space](../css/white-space.md)样式： 处理所有空白字符
+
+如下示例2，演示text组件使用变量中的文本：
+```uvue
+<template>
+  <text>{{text}}</text>
+</template>
+<script lang="uts" setup>
+  let text = ' a   bc def\tg\nhi '
+</script>
+```
+>上面代码中的 \t 和 \n 是 `转义字符`，\t 表示 制表符 (Tab)，\n 表示 换行符 (Line Feed)
+
+编译期间不会对变量中的空白字符做处理，而是由各平台运行环境根据 [white-space](../css/white-space.md) 样式处理并渲染。
+
+**space属性**
+如果text组件配置了space属性值，会先根据space属性值处理文本中的空格，再根据 [white-space](../css/white-space.md) 样式处理。
+蒸汽模式（Vapor）废弃了space属性。推荐统一改用css white-space来处理空白字符。
+
+**App-Android、App-iOS平台**
+HBuilderX5.0版本开始 app-andorid/app-ios平台调整 [white-space](../css/white-space.md) 样式控制空白字符处理逻辑与 W3C 规范一致，
+默认值为 `keep`。
+如上示例2中将保留所有空格（连续空格不会合并）、制表符、换行符进行渲染，a和b之间有3个空格。
+
+app-andorid/app-ios平台避免使用 `space` 属性处理空格，存在以下平台差异：
+- app-android平台配置了 `space` 属性将只处理空格转换，忽略 white-space 样式值，即按 white-space: keep 处理。
+- app-ios平台配置了 `space` 属性将先处理空格转换，再根据 white-space 属性值处理空白字符。
+后续统一会废弃 	`space` 属性，推荐统一改用css white-space 来处理空白字符。
+
+**App-Harmony平台**
+蒸汽模式（Vapor） [white-space](../css/white-space.md) 样式控制空白字符处理逻辑与 W3C 规范一致，默认值为 `keep`。
+
+**Web平台**
+HBuilderX5.0版本开始 web平台调整 [white-space](../css/white-space.md) 样式控制空白字符处理逻辑与 W3C 规范一致，
+默认值为 `pre-line`。
+如上示例2中将合并空格（连续空格合并为1个空格），制表符转换为空格，保留换行符进行渲染，a和b之间只有1个空格。
+
+uni-app x中有text组件，这是一个web没有的组件。且uni-app x在非web平台，包括小程序平台，都不支持<br>换行，所以uni-app x设计为text组件中的`\n`默认不会忽略，而是换行。
+
+不管app平台默认值keep，还是web平台默认值pre-line，都是这个表现。
+
+web的默认值preline，虽然支持\n换行，同时会合并\n以外的其他多个连续空白字符为1个。这是web与app的不同。app为了提升性能，默认值为keep，即默认不会合并连续的空白字符。
+
+
+### 实体字符
+`实体字符`（Entity Character）是在标记语言（如 vue/uvue 的 template 中）或编程中，用来表示那些具有特殊含义、无法直接输入或显示的字符的一种编码方式。
+实体字符通常由三部分组成，以 &开头，以 ;结尾，中间是实体名称或编号。
+常见的实体字符包括：
+- 空格	(space)：&amp;nbsp;，实体编号表示为 &amp;#160;
+- 小于号(<)：&amp;lt;，实体编号表示为 &amp;#60;
+- 大于号	(>)：&amp;gt;，实体编号表示为 &amp;#62;
+- 和号	(&)：&amp;amp;，实体编号表示为 &amp;#38;
+- 引号	(")：&amp;quot;，实体编号表示为 &amp;#34;
+- 版权符号(©)：&amp;copy;，实体编号表示为 &amp;#169;
+- 注册商标(®	)：&amp;reg;，实体编号表示为 &amp;#174;
+
+实体字符的处理分为 编译期处理 和  运行期处理 两个阶段。
+
+#### 编译期处理
+某些字符在标记语言中是预留的。例如，template会将 < 视作标签的开始。如果想在文本上显示“5 < 10”，直接输入 < 可能会导致编译器误以为后面跟着一个标签，从而引起编译报错，这时需要使用`实体字符` &amp;lt; 表示 <，如下示例：
+```uvue
+<template>
+  <text id="t1">5 &lt; 10</text>
+</template>
+```
+编译期间会将template中静态文本的所有实体字符解析为真实字符。
+如上示例编译后text组件中的文本内容为“5 < 10”。
+
+注意：编译期间不会处理变量中的实体字符。
+
+#### 运行期处理
+由 `decode` 属性值决定是否在运行期解析实体字符，默认运行期不解析实体字符。
+
+如下示例，演示text组件使用变量中的文本：
+
+```uvue
+<template>
+  <text decode="false">{{text}}</text>
+</template>
+<script lang="uts" setup>
+  let text = '5 &lt; 10'
+</script>
+```
+
+编译期间不会对变量中的实体字符做转换，而是由各平台运行环境根据 `decode` 属性值决定是否转换。
+- `decode` 属性值设置为 true 时：运行期转换实体字符，上面示例字符串显示为 “5 < 10”
+- `decode` 属性值设置为 false 时：运行期不转换实体字符，上面示例字符串显示为 “5 &amp;lt; 10”
+
+**注意**
+蒸汽模式（Vapor）将废弃 `decode` 属性，运行期不再解析实体字符。
+
+
+<!-- UTSCOMJSON.text.children -->
+
+text组件在web浏览器渲染（含浏览器、小程序webview渲染模式、app-vue）和uvue中，可以并只能嵌套text组件。
+
+app平台 text 组件虽然支持嵌套，但注意限制：
+1. 子组件不继承父组件样式。这样使用会在编译到web渲染的平台时产生差异。
+2. 子组件设置的排版相关样式（如position、display、width、height、margin、padding等）以及部分text独有样式（如text-align、lines、white-space、text-overflow）不生效
+3. 嵌套时建议将文本写在`<text></text>`标签之间，例如：`<text><text>嵌套文本1</text><text>嵌套文本2</text></text>`，避免出现预期外的效果。
+
+HBuilderX4.51版本起 text组件嵌套时，子组件支持点击事件响应。之前版本如有这方面需求，请改用 [rich-text](./rich-text.md)
+
+<!-- UTSCOMJSON.text.example -->
+
+<!-- EXAMPLEJSON.text.text-writer -->
+
+<!-- EXAMPLEJSON.text.text-props -->
+
+::: warning 注意
+App 端不支持 `text` 组件中渲染多段文本，如果 `text` 组件中的文本是动态的，可以将计算后的结果通过数据给到 `text` 组件, 而不是在模板中通过 `template` 拼接多段文本, 以免出现渲染异常。
+
+错误写法：
+```vue
+<template>
+  <view>
+    <text>
+      <template v-for="item in list">
+        <template v-if="item['show']">{{item['text']}}</template>
+      </template>
+    </text>
+  </view>
+</template>
+
+<script setup lang="uts">
+  const list = ref([
+    {
+      show: true,
+      text: 'a'
+    },{
+      show: false,
+      text: 'b'
+    },{
+      show: true,
+      text: 'c'
+    }
+  ])
+
+</script>
+```
+
+正确写法：
+```vue
+<template>
+  <view>
+    <text>{{textValue}}</text>
+  </view>
+</template>
+
+<script setup lang="uts">
+  const list = ref([
+    {
+      show: true,
+      text: 'a'
+    }, {
+      show: false,
+      text: 'b'
+    }, {
+      show: true,
+      text: 'c'
+    }
+  ])
+  const textValue = computed((): string => {
+    let res = ''
+    list.value.forEach(item => {
+      if (item['show'] === true) {
+        res += item['text']
+      }
+    })
+    return res
+  })
+</script>
+```
+:::
+
+<!-- UTSCOMJSON.text.reference -->
+
+## max-lines
+
+多行文本设置最大行，目前在web规范中，需使用临时规范-webkit-line-clamp，并搭配display: -webkit-box。
+
+App平台在VDOM模式时使用了自定义的css属性lines，在蒸汽模式下改成了text的max-lines组件属性。
+
+使用max-lines属性时，不需要写 `display: -webkit-box;-webkit-box-orient: vertical;overflow: hidden;`。如果你需要兼容web，可以写在web的条件编译中。
+
+web和小程序的text组件暂未支持max-lines组件属性，后续计划蒸汽模式的全平台text组件都将支持max-lines属性，并在web和小程序上编译为-webkit写法。
+
+## Bug & Tips@tips
+- app-Android平台和app-iOS VDOM平台 selectable开启后，仅支持全部文字复制，暂不支持自由调整光标选择文字。如需自由选择文字，请使用[rich-text组件](rich-text.md)。web平台默认就是可复制文字的，selectable无效。
+- web平台4.86版本起text组件调整为display:block，嵌套text组件时，子text默认display为inline。此前版本无论父子均为inline。如无必要请勿覆盖text的display样式，以免出现预期外的效果。

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

@@ -0,0 +1,90 @@
+<!-- ## textarea -->
+
+<!-- UTSCOMJSON.textarea.name -->
+
+<!-- UTSCOMJSON.textarea.description -->
+
+<!-- UTSCOMJSON.textarea.compatibility -->
+
+<!-- UTSCOMJSON.textarea.attribute -->
+
+<!-- UTSCOMJSON.textarea.event -->
+
+<!-- UTSCOMJSON.textarea.component_type-->
+
+
+#### 获取原生view对象
+
+为增强uni-app x组件的开放性，从 `HBuilderX 4.25` 起，UniElement对象提供了 [getAndroidView](../dom/unielement.md#getandroidview) 和 [getIOSView](../dom/unielement.md#getiosview) 方法。
+
+该方法可以获取到 textarea 组件对应的原生对象，即Android的`AppCompatEditText`对象、iOS的`UITextView`对象。
+
+进而可以调用原生对象提供的方法，这极大的扩展了组件的能力。
+
+**Android 平台：**
+
+获取textarea组件对应的UniElement对象，通过UniElement对象的[getAndroidView](../dom/unielement.md#getandroidview-2)方法获取组件原生AppCompatEditText对象
+
+```uts
+//导入安卓原生AppCompatEditText对象
+import AppCompatEditText from "androidx.appcompat.widget.AppCompatEditText"
+
+//通过textarea组件定义的id属性值，获取textarea标签的UniElement对象
+const textareaElement = uni.getElementById(id)
+//UniElement.getAndroidView设置泛型为安卓底层AppCompatEditText对象，直接获取AppCompatEditText， 如果泛型不匹配会返回null
+if(textareaElement != null) {
+	//editText就是textarea组件对应的原生view对象
+	const editText = textareaElement.getAndroidView<AppCompatEditText>()
+}
+```
+
+**iOS 平台：**
+
+获取textarea组件对应的UniElement对象，通过UniElement对象的[getIOSView](../dom/unielement.md#getiosview)方法获取组件原生UITextView对象。
+
+```uts
+//通过 textarea 组件定义的 id 属性值，获取 textarea 标签的 UniElement 对象
+const textareaElement = uni.getElementById(id)
+//获取原生 view
+const view = inputElement?.getIOSView();
+//判断 view 是否存在，类型是否为 UITextView
+if (view != null && view instanceof UITextView) {
+    //将 view 转换为 UITextView 类型
+    const textField = view! as UITextView;
+}
+```
+
++ iOS平台 uvue 环境使用 js 驱动无法处理原生类型，getIOSView 方法需要在 uts 插件中使用。
+
+更多示例请参考 uts 插件 [uts-get-native-view](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/uni_modules/uts-get-native-view/utssdk/app-ios/index.uts)
+
+<!-- UTSCOMJSON.textarea.children -->
+
+<!-- UTSCOMJSON.textarea.example -->
+
+<!-- UTSCOMJSON.textarea.reference -->
+
+## 键盘上推专题
+input和textarea组件都一个属性`adjust-position`，默认为true，即软键盘弹出时，默认上推页面以显示出输入框，避免输入框被软键盘遮挡。
+
+因为此处内容与input重复，详见[input文档](input.md#adjust-position)
+
+## inputmode说明
+
+inputmode 兼容性：Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android >= 66、Firefox for Android >= 79、Safari on iOS >= 12.2、WebView Android >= 66
+
+## placeholder-style和placeholder-class说明
+- uni-app x 4.41前，App平台仅支持`color`、`font-size`、`font-weight`。
+- uni-app x 4.41后，App平台新增支持`font-family`、`font-style`、`text-align`，其中`text-align`仅App-Android平台支持，App-iOS平台的placeholder位置取决于textarea的`text-align`。
+- App-HarmonyOS `placeholder-class` 暂不支持 css 变量。
+
+## Tips
+
+* uni-app x 4.0 起，App-Android平台 textarea 点击输入框外的屏幕会自动收起软键盘。
+* uni-app x 4.0 起，App-Android平台 textarea 的 font-size 默认值统一为 16px，line-height 默认值为 1.2em，width 默认值为300px。
+* uni-app x 4.15 起，App-iOS平台 textarea 软键盘默认右下角改为 return(换行) ，换行时，键盘不会收起。
+* 由于Android系统限制，textarea的键盘右下角按钮只能是`换行`，所以暂时不提供`confirm-type`属性。
+* 当软键盘右下角为 换行 时，confirm-hold 恒为 true，设置为false也不生效，即按下 换行 时，软键盘不会消失。
+* 在Android 9以下的系统版本，样式`line-height`点击键盘换行时行间距设置无效，此问题是Android系统的bug，后续解决。
+* App平台蒸汽模式样式设置暂不支持 css 变量。
+* 所有 boolean 类型的属性，只有设置为布尔类型的 false 才会关闭该属性，其他任何值（包括字符串 "false"）都会被当做 true 处理（微信小程序中空字符串会被视为 false）。

package/data/uni-app-x-docs/component/uni-ui-x/README.md

@@ -0,0 +1 @@
+<!-- UTSCOMJSON.uni-ui-x.readme -->