tmui-cli 2.0.5 → 5.3.1

package/data/uniappx/input.md

@@ -0,0 +1,108 @@
+title: tmui 3.2.0 组件库
+
+#### 表单组件
+
+# 输入框 TmInput
+
+可以全局配置圆角风格.
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/input.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| modelValue | string\|number | "" | 输入框的值 | 
+| inputStyle | string | "" | 输入框自定义的style样式 | 
+| inputClass | string | "" | 输入框自定义的class样式 | 
+| type | string | - | 输入类型,可选值:text,number,idcard,digit,tel,safe-password,nickname,textarea:文本域 | 
+| password | boolean | false | 是否是密码框 | 
+| showEye | boolean | false | 显示密码小眼睛 | 
+| placeholder | string | "请输入或选择" | 输入框的占位文字 | 
+| placeholderStyle | string | "color:#b1b1b1;" | 输入框的占位文字样式 | 
+| placeholderClass | string | "" | 输入框的占位样式 | 
+| align | string | "left" | 输入框的对齐方式,可选值:left,right,center | 
+| color | string | "" | 输入框背景 | 
+| darkBgColor | string | "transparent" | 输入框暗黑背景，空值取全局的配置提供会覆盖全局的配色。默认是透明 | 
+| fontSize | string\|number | "32" | 输入框字体大小 | 
+| width | string\|number | "auto" | - | 
+| height | string\|number | "88" | - | 
+| minHeight | string\|number | "auto" | - | 
+| inputPadding | string | "24" | 输入框内的左右间隙 | 
+| round | string\|number\|Array\<string \| number\> | "" | 输入框圆角,默认空值取全局的配置 | 
+| showClear | boolean | false | 是否显示清除按钮 | 
+| clearColor | string | "#b1b1b1" | 清除按钮颜色 | 
+| showCharCount | boolean | false | 是否显示字符字统计 | 
+| fontColor | string | "#333333" | 字体颜色 | 
+| darkFontColor | string | "" | 暗黑模式字体颜色,如果不填写自动反转 | 
+| focusFontColor | string | "" | 激活时的字体颜色空值取全局主题色,并且darkFontColor会失效.如果填写none则不生效 | 
+| leftIcon | string | "" | 左图标的名称 | 
+| iconColor | string | "" | 左图标的颜色默认空值取全局的主题色。 | 
+| rightIcon | string | "" | 右图标的名称 | 
+| rightText | string | "" | 右文字 | 
+| leftText | string | "" | 右文字 | 
+| disabled | boolean | false | 是否禁用 | 
+| focus | boolean | false | 是否聚焦 | 
+| confirmType | string | "done" | 键盘右下解按钮文字,可以取值:send,search,next,done只对input有效,对textarea无效 | 
+| cursorSpacing | number | 0 | 光标与键盘的距离，单位px | 
+| maxlength | number | -1 | 输入框的最大长度 | 
+| confirmHold | boolean | false | - | 
+| cursor | number | NaN | 不可用，容易引起bug | 
+| cursorColor | string | "" | 光标颜色,默认空值取全局配置 | 
+| selectionStart | number | -1 | 光标起始位置 | 
+| selectionEnd | number | -1 | 光标结束位置 | 
+| adjustPosition | boolean | true | 是否自动聚焦 | 
+| autoBlur | boolean | false | 是否自动失焦 | 
+| ignoreCompositionEvent | boolean | true | - | 
+| alwaysEmbed | boolean | true | 强制input处于同层状态,不可用，容易引起bug | 
+| holdKeyboard | boolean | false | focus时，点击页面的时候不收起键盘 | 
+| safePasswordCertPath | string | "" | - | 
+| safePasswordLength | number | NaN | - | 
+| safePasswordTimeStamp | number | NaN | - | 
+| safePasswordNonce | string | '' | - | 
+| safePasswordSalt | string | '' | - | 
+| safePasswordCustomHash | string | '' | - | 
+| randomNumber | boolean | false | - | 
+| controlled | boolean | false | - | 
+| alwaysSystem | boolean | false | - | 
+| inputmode | string | "text" | input输入模式 | 
+| autoHeight | boolean | false | 尽量不要使用,客户大量手机机型反馈部分手机在手写时会异常.最好固定高. | 
+| fixed | boolean | false | - | 
+| showConfirmBar | boolean | false | - | 
+| focusHighlight | boolean\|string | true | 是否高亮聚焦当前输入框会使用全局的主题色为边框色。 | 
+| focusHighlightStyle | string | '' | 高亮聚焦当前输入框的样式默认为自动全局2pxsolid主题色,如果填写了以你的为准。 | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| linechange | 名称：evt,{height:0,heightRpx:0,lineCount:0}, | - | 输入框行数变化时触发(文本哉才有) | 
+| keyboardheightchange | 名称：height,键盘高度, | - | 键盘高度变化时触发 | 
+| confirm | 名称：value,输入的值, | - | 点击完成按钮时触发 | 
+| blur | - | - | 失去焦点时触发 | 
+| focus | - | - | 获取焦点时触发 | 
+| clear | - | - | 清除事件 | 
+| input | 名称：value,输入的值, | - | 输入时候触发 | 
+| update:modelValue | 名称：value,输入的值, | - | 等同v-model | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| left | - | 左侧插槽 | 
+| leftIcon | - | 输入框左侧图标插槽 | 
+| maxlength | - | 输入框右侧显示字数 | 
+| rightIcon | - | 输入框内右侧图标 | 
+| right | - | 输入框右侧 | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/modal.md

@@ -0,0 +1,74 @@
+title: tmui 3.2.0 组件库
+
+#### 反馈组件
+
+# 对话框 TmModal
+
+可全局统一更改风格。使用时注意下：如果height:auto，将失去内容滚动效果。如果要内容滚动height必定是一个值。
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/modal.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| customStyle | string | "" | 自定义遮罩样式 | 
+| title | string | $i18n.t("tmui32x.tmModal.title") | 标题 | 
+| showFooter | boolean | true | 显示底部操作栏 | 
+| showTitle | boolean | true | 是否显示底部关闭按钮 | 
+| showClose | boolean | false | 是否显示底部关闭按钮 | 
+| showCancel | boolean | true | 显示取消按钮 | 
+| overlayClick | boolean | true | 遮罩是否允许点击被关闭 | 
+| show | boolean | false | 显示可v-model:show双向绑定 | 
+| duration | number | 250 | 动画时间 | 
+| cancelText | string | $i18n.t("tmui32x.cancelText") | 取消按钮的文本 | 
+| confirmText | string | $i18n.t("tmui32x.confirmText") | 确认按钮的文本 | 
+| round | string\|number | "" | 打开方向为上和下时的圆角空值时，取全局配置的圆角。 | 
+| width | string\|number | "84%" | 宽，百分比，Px,rpx，auto都支持 | 
+| height | string\|number | "350" | 宽，百分比，Px,rpx，auto都支持 | 
+| maxHeight | string\|number | "80%" | 可以是百分比,px,rpx单位数字。如果你不带单位，默认转换为rpx单位。 | 
+| disabledScroll | boolean | false | 是否禁用内部的scroll标签禁用后内容不会滚动，如果设定了指定高，内容超出指定高，会被裁切但如果没有指定高，内容自动的话，高是自动的。有这个属性是因为截止4.03scroll-view里面放input不会上推键盘，及内部的viewtouchMove会失效。 | 
+| disabled | boolean | false | 禁用弹层 | 
+| bgColor | string | "white" | 容器背景色 | 
+| darkBgColor | string | "" | 暗黑时的容器背景色，不填写的话取sheetDarkColor | 
+| zIndex | string\|number | "1105" | - | 
+| contentPadding | string\|number | "32" | 内容区域的间隙 | 
+| btnColor | string | "" | - | 
+| beforeClose | () =\> Promise\<boolean\> | true | 关闭前执行，可以是异步函数，只有当用户点击confirm时才会触发。如果返回false将阻止关闭。true允许关闭。 | 
+| disableTeleport | boolean | false | 是否禁用teleport（H5平台）在嵌套组件或特殊环境下，可以禁用teleport避免DOM错误 | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| click | - | - | 点击遮罩事件 | 
+| close | - | - | 关闭是触发 | 
+| open | - | - | 打开时触发 | 
+| beforeOpen | - | - | 打开前执行 | 
+| beforeClose | - | - | 关闭前执行 | 
+| update:show | - | - | 等同v-model:show | 
+| cancel | - | - | 取消时触发 | 
+| confirm | - | - | 确认时触发 | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| trigger | 名称：binding,show 类型：Boolean 
+ | 标签触发显示遮罩，免于使用变量控制 | 
+| title | 名称：binding,show 类型：Boolean 
+ | 标题插槽 | 
+| default | - | 默认插槽 | 
+| footer | - | 底部操作栏 | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/money.md

@@ -0,0 +1,52 @@
+title: tmui 3.2.0 组件库
+
+#### 展示组件
+
+# 金额栅格 TmMoney
+
+对金额进行栅格化
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/money.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| digit | number | 2 | 小数点后几位 | 
+| thousand | boolean | false | 开启千分位 | 
+| thousandUnit | string | "," | 千分位的分隔符 | 
+| thousandLen | number | 3 | 千分位的长度，默认是3位一位，如果为4就是万分位依此类推 | 
+| symbolText | string | '￥' | 货币符号 | 
+| symbolPosition | string | 'left' | 货币符号位置left:左侧right:右侧 | 
+| color | string | 'primary' | 文字颜色 | 
+| darkColor | string | '' | 暗黑时的文字颜色 | 
+| fontSize | string | '32' | 文字大小 | 
+| preFontSize | string | '32' | 货币符号及小数字号大小 | 
+| showCn | boolean | false | 是否显示中文金额 | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| default | 名称：binding,inter 类型：string 
+名称：binding,digit 类型：string 
+名称：binding,cn 类型：string 
+名称：binding,lineHeight 类型：string 
+ | 默认插槽 | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/more.md

@@ -0,0 +1,51 @@
+title: tmui 3.2.0 组件库
+
+#### 展示组件
+
+# 查看更多 tmMore
+
+让内容超过指定高时自动隐藏内容.
+
+## :hot_pepper: 示例
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/more.vue{vue}
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| width | string | "auto" | 组件宽度 | 
+| height | string | "60" | 被关闭时的高度。 | 
+| modelValue | boolean | false | 当前打开的状态 | 
+| activeColor | string | "" | 激活后的文本色,默认是读取全局色 | 
+| unActiveColor | string | "#a6a6a6" | 未激活后的文本色 | 
+| text | Array | ()=\>[]asstring[] | 打开和关闭状态的文本"展开更多","收起更多" | 
+| maskBgColor | Array | ()=\>['rgba(255,255,255,1)','rgba(255,255,255,0.3)'] | 遮罩的渐变的背景色 | 
+| darkMaskBgColor | Array | ()=\>['rgba(24,24,24,1.0)','rgba(24,24,24,0.3)'] | 暗黑时遮罩的渐变的背景色 | 
+| disabled | boolean | false | 是否禁用展开。 | 
+| showMoreBtn | boolean | true | 是否显示开启和关闭按钮,因为各个手机屏幕可能不一样,可能会根据行数自行决定是否要显示展开和关闭按钮,请通过此自行判断. | 
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| change | 名称：opened,当前打开的状态, | - | 状态切换时变换 | 
+| click | 名称：opened,当前打开的状态,可以通过此判断是点打开还是点关闭, | - | 点击展开的按钮时触发 | 
+| update:modelValue | - | - | - | 
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| default | 名称：binding,isOpened 类型：- 
+ | 默认插槽  | 
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |

package/data/uniappx/mp/README.md

@@ -1,93 +1,126 @@
 # 编译到小程序端
 
-> 新增于 HBuilderX 4.41+
+> HBuilder 4.41 + 支持编译到微信小程序
+> HBuilder 5.31 + 支持编译到支付宝小程序
 
-uni-app x 项目在编译到小程序平台时，将部分特性对齐了web与app端，因此和非uni-app x项目编译到小程序端略有差异。
+## 与 uni-app 相比，uni-app x 编译到小程序有如下不同
 
-与uni-app相比，uni-app x编译到微信小程序有2个显著差别：
-1. uni-app x 支持 Element API
-在微信小程序上开发高性能应用，离不开wxs。但wxs难用且不跨平台。\
-虽然微信小程序自身不支持Element操作，但uni-app x提供了跨平台的Element API，并且把这些API映射到了微信小程序的wxs上。\
-这样即实现了跨平台一致性，又解决了微信下wxs使用麻烦的问题。
-2. 布局全面使用flex
-小程序的webview渲染支持flex布局，但默认是block布局。\
-uni-app x中全平台统一使用flex布局。
+### uni-app x 的优势
+1. uni-app x 支持跨平台 Element API 来统一替代 wxs/sjs
+
+   在小程序上开发高性能应用，离不开 wxs/sjs。但 wxs/sjs 难用且不跨平台。\
+   虽然小程序自身不支持 Element 操作，但 uni-app x 提供了全平台的 Element API，并且把这些 API 映射到了小程序的 wxs/sjs 上。\
+   这样即实现了跨平台一致性，又解决了小程序下 wxs/sjs 使用麻烦的问题。
+
+2. 支持样式隔离策略2.0
+
+	老 uni-app 的全局样式、页面样式、组件样式，在不同平台的复用和隔离策略不一样。导致多端拉齐有很多坑。\
+	uni-app x 统一了[样式隔离策略2.0](../css/common/style-isolation.md)。\
+	除了多平台拉齐，[样式隔离策略2.0](../css/common/style-isolation.md)的externalClass机制对组件尤其友好，组件作者不再需要为了让开发者自定义组件样式而封装大量属性了。组件使用者也不再需要为了定制样式而改组件源码或者deep干扰了。\
+	
+3. 减少更多平台差异
+
+	各家小程序，表面规范接近，细节实现差异很大。经常要踩坑，写条件编译。\
+	老 uni-app 的测试例数量不足，很多细节差异官方并没有抹平。\
+	uni-app x 拥有大量细节测试例，为了过测，抹平了很多细节差异。\
+	对于开发者而言，坑变少了，也少写很多条件编译。
+
+整体而言，uni-app x 编写跨端小程序，可以更简单、更一致的做出高性能、代码清晰的小程序。
+
+### 差异
+1. 布局默认使用 flex
+
+小程序的 webview 渲染支持 flex 布局，但默认是 block 布局。\
+uni-app x 中全平台默认使用 flex 布局。\
+如需跨端到App，只能使用 flex 布局。\
+如果不需要App，也可以取消默认的样式重置。[见下](#resetcss)
+
+还有一些开发注意事项，详见下文。
+
+### 问题
+
+uni-app x 目前仅支持微信小程序和支付宝小程序。其他主流小程序还在陆续适配。一些自身已经停维的小程序平台可能 uni-app x 不再会支持。
 
 ## 基础库范围
-截止到HBuilderX 4.41发版时微信的主流基础库版本是3.7.1。
-uni-app x主要是在这个版本库上适配。
-已知过老的基础库版本上，scroll-view区域大小会不准确。请开发者检查并确保基础库版本大于3.7.1。
+
+截止到 HBuilder 4.41 发版时微信的主流基础库版本是 3.7.1。
+
+截止到 HBuilder 5.31 发版时支付宝小程序的主流基础库版本是 2.10.38。
+
+uni-app x 是在上述版本库上适配的。
 
 ## vue
 
-### 自定义组件启用virtualHost带来的影响@virtualHost
+### 自定义组件启用 virtualHost 带来的影响@virtualHost
 
-标准的小程序下的自定义组件会多套一层DOM，这影响性能且更会影响flex等样式传递。而uni-app x默认都是flex的。
+标准的小程序下的自定义组件会多套一层 DOM，这影响性能且更会影响 flex 等样式传递。而 uni-app x 默认都是 flex 的。
 
-所以为了拉齐样式表现，uni-app x 项目在编译到小程序时，默认启用了virtualHost，该配置是小程序平台提供的一种策略，可以取消多套的一层。\n
-同时默认启用了[mergeVirtualHostAttributes特性](https://uniapp.dcloud.net.cn/collocation/manifest.html#mp-weixin)，在取消多套的一层后，将原本父层的属性设置，合并到子层。
+所以为了拉齐样式表现，uni-app x 项目在编译到小程序时，默认启用了 virtualHost，该配置是小程序平台提供的一种策略，可以取消多套的一层。\n
+同时默认启用了[mergeVirtualHostAttributes 特性](https://uniapp.dcloud.net.cn/collocation/manifest.html#mp-weixin)，在取消多套的一层后，将原本父层的属性设置，合并到子层。
 
-`去掉一层`以及`合并父属性到子`，这2件事会对真实渲染的DOM产生影响。*尤其会影响在组件外获取组件的DOM*。
+`去掉一层`以及`合并父属性到子`，这 2 件事会对真实渲染的 DOM 产生影响。_尤其会影响在组件外获取组件的 DOM_。
 
 我们先看一个例子：
 
-有个组件c1，父级外层代码如下
+有个组件 c1，父级外层代码如下
+
 ```html
 <c1 id="c1parent" ref="c1ref" class="class1parent"></c1>
 ```
 
-c1组件的代码如下：
+c1 组件的代码如下：
+
 ```html
 <template>
-    <view class="classchild">
-    </view>
+  <view class="classchild"> </view>
 </template>
 ```
 
-然后看下mergeVirtualHostAttributes属性合并策略（HBuilderX 4.42+）：
-1. 仅将组件外层设置的 id、style、class 以及 v-show 指令生成的 hidden 属性，这4个属性合并到 vue 组件编译成的小程序组件根节点上，其他外层设置的属性都丢弃了。
+然后看下 mergeVirtualHostAttributes 属性合并策略（HBuilder 4.42+）：
+
+1. 仅将组件外层设置的 id、style、class 以及 v-show 指令生成的 hidden 属性，这 4 个属性合并到 vue 组件编译成的小程序组件根节点上，其他外层设置的属性都丢弃了。
 2. 仅对组件是单个根节点才会合并，组件内多个根节点的时候不会合并。父层全部丢弃。
 
-根据策略看，上述代码在运行时合并后，父层的id、class属性合并到组件根节点上，所以`class1parent` 和 `classchild` 同时生效。
+根据策略看，上述代码在运行时合并后，父层的 id、class 属性合并到组件根节点上，所以`class1parent` 和 `classchild` 同时生效。
 
-父层通过`uni.createSelectorQuery().in(this.$page).select('#c1parent')`拿不到NodesRef。
+父层通过`uni.createSelectorQuery().in(this.$page).select('#c1parent')`拿不到 NodesRef。
 
-但createSelectorQuery是支持设定查找范围的，上面的代码是在页面里查找，如果在父层代码里通过in方法指定查找组件，例如：`uni.createSelectorQuery().in(this.$refs['c1ref'] as ComponentPublicInstance).select('#c1parent') `，可以拿到c1组件的NodesRef
+但 createSelectorQuery 是支持设定查找范围的，上面的代码是在页面里查找，如果在父层代码里通过 in 方法指定查找组件，例如：`uni.createSelectorQuery().in(this.$refs['c1ref'] as ComponentPublicInstance).select('#c1parent') `，可以拿到 c1 组件的 NodesRef
 
-父层通过`uni.getElementById("c1parent")`也可以拿到UniElement。
+父层通过`uni.getElementById("c1parent")`也可以拿到 UniElement。
 
-实际上，不管是通过`.class1parent` 还是 `.classchild`，都可以拿到。因为样式合并后，这2个class在运行时同时存在。
+实际上，不管是通过`.class1parent` 还是 `.classchild`，都可以拿到。因为样式合并后，这 2 个 class 在运行时同时存在。
 
-vue组件的方法调用不受影响，ref取到组件后，可以直接调用组件的方法。
+vue 组件的方法调用不受影响，ref 取到组件后，可以直接调用组件的方法。
 
 ### refs@refs
 
-非 uni-app x 项目使用refs取内置组件引用时会获取到undefined，而 uni-app x 项目会获取到对应的UniElement。
+非 uni-app x 项目使用 refs 取内置组件引用时会获取到 undefined，而 uni-app x 项目会获取到对应的 UniElement。
 
 ## dom
 
 ### UniElement
 
-小程序端逻辑层与视图层分离，导致大多数同步的dom api都不可用。
+小程序端逻辑层与视图层分离，导致大多数同步的 dom api 都不可用。
 
-UniElement在小程序端仅支持如下属性/方法：
+UniElement 在小程序端仅支持如下属性/方法：
 
-- id 元素的id属性
+- id 元素的 id 属性
 - nodeName 元素的节点名
 - tagName 元素的标签名
-- style 元素的style对象，可以通过style对象调用style.setProperty方法
+- style 元素的 style 对象，可以通过 style 对象调用 style.setProperty 方法
 - getBoundingClientRectAsync 异步获取元素的布局位置信息
-- getAttribute 获取元素的属性值，目前仅支持id、style
+- getAttribute 获取元素的属性值，目前仅支持 id、style
 
 **注意**
 
-- 小程序端只有UniElement，不支持UniButtonElement、UniViewElement等类
-- 小程序端在各种事件在target、currentTarget指向未配置id的组件时，event.target、event.currentTarget会返回一个功能缺失的UniElement，仅能访问dataset、offsetTop、offsetLeft属性。
-- 小程序端在各种事件在target、currentTarget指向配置了id的组件时，event.target、event.currentTarget会返回一个功能和getElementById一致的UniElement，除了能访问getElementById返回的UniElement的各种属性方法之外，还能访问dataset、offsetTop、offsetLeft属性。
+- 小程序端只有 UniElement，不支持 UniButtonElement、UniViewElement 等类
+- 小程序端在各种事件在 target、currentTarget 指向未配置 id 的组件时，event.target、event.currentTarget 会返回一个功能缺失的 UniElement，仅能访问 dataset、offsetTop、offsetLeft 属性。
+- 小程序端在各种事件在 target、currentTarget 指向配置了 id 的组件时，event.target、event.currentTarget 会返回一个功能和 getElementById 一致的 UniElement，除了能访问 getElementById 返回的 UniElement 的各种属性方法之外，还能访问 dataset、offsetTop、offsetLeft 属性。
 
 ### 事件
 
-click、tap事件上补充了如下属性，使其表现更像PointerEvent：
+click、tap 事件上补充了如下属性，使其表现更像 PointerEvent：
 
 ```
 event.x
@@ -102,35 +135,38 @@ event.screenY
 
 ## css
 
-### 样式重置
+### 样式重置@resetcss
 
-App平台的ucss和webview的标准css略有差异。为保证多端统一，uni-app-x编译到小程序端时，会进行浏览器样式重置，内置组件根元素带有一些默认样式，详情参考：[uvue css使用](../css/README.md)。
+App 平台的 ucss 和 webview 的标准 css 略有差异。为保证多端统一，uni-app-x 编译到小程序端时，会进行浏览器样式重置，内置组件根元素带有一些默认样式，详情参考：[uvue css 使用](../css/README.md)。
 
-如果你不开发App，且不需要样式重置，想使用原始的小程序样式，那么可以在pages.json的globalStyle或对应的页面style内配置`enableUcssReset`为false来关闭ucss样式重置。参考：[page.json文档](../collocation/pagesjson.md)
+如果你不开发 App，且不需要样式重置，想使用原始的小程序样式，那么可以在 pages.json 的 globalStyle 或对应的页面 style 内配置 `enableUcssReset` 为 false 来关闭 ucss 样式重置。参考：[page.json 文档](../collocation/pagesjson.md)
 
-## skyline
+## 微信小程序 skyline
 
-对skyline的支持处于实验阶段。
+对 skyline 的支持处于实验阶段。
 
-目前编译器会根据页面是否为skyline来决定是否注入ucss样式覆盖，仅webview渲染的页面才会进行ucss样式覆盖。
+目前编译器会根据页面是否为 skyline 来决定是否注入 ucss 样式覆盖，仅 webview 渲染的页面才会进行 ucss 样式覆盖。
 
-worklet函数暂不支持写在uvue、uts文件内，推荐从js文件内引用。
+worklet 函数暂不支持写在 uvue、uts 文件内，推荐从 js 文件内引用。
 
 ## 其他差异
 
 ### 文件命名
+
 页面或组件目录下，不能使用与 `uvue` 同名的 `uts` 文件。\
-小程序端 `uvue` 文件会被编译为同名的 `js、json、wxml、wxss` 文件，如果存在同名 `uts` 文件，会导致冲突。
+小程序端 `uvue` 文件会被编译为同名的 `js、json、wxml/axml、wxss/acss` 文件，如果存在同名 `uts` 文件，会导致冲突。
 
 ### 实体字符
 
-uni-app x项目在编译到小程序端时，如果页面内静态的使用了实体字符`&gt;、&lt;、&thinsp;、&nbsp;、&ensp;、&emsp;`则会在最终输出的小程序页面文件中保留这些实体字符，例如`&nbsp;`在微信小程序的wxml文件中仍为`&nbsp;`不会被转为空格， 而非uni-app-x项目`&nbsp;`会转为空格。
+uni-app x 项目在编译到小程序端时，如果页面内静态的使用了实体字符`&gt;、&lt;、&thinsp;、&nbsp;、&ensp;、&emsp;`则会在最终输出的小程序页面文件中保留这些实体字符，例如`&nbsp;`在小程序的 wxml/axml 文件中仍为`&nbsp;`不会被转为空格， 而非 uni-app-x 项目`&nbsp;`会转为空格。
+
+### 微信小程序注意事项@mp-weixin
 
-### radio、checkbox组件使用justify-content等属性对齐插槽内容与选择框时与app、web表现不一致
+#### radio、checkbox 组件使用 justify-content 等属性对齐插槽内容与选择框时与 app、web 表现不一致
 
 > 此表现后续可能会调整，请勿依赖此特性进行布局
 
-由于小程序端radio、checkbox组件内部有一层额外节点，如下属性设置在根节点上不能按预期方式布局插槽内容与选择框
+由于小程序端 radio、checkbox 组件内部有一层额外节点，如下属性设置在根节点上不能按预期方式布局插槽内容与选择框
 
 ```
 flex-direction
@@ -143,13 +179,10 @@ align-items
 
 编译到支付宝小程序时需注意以下平台差异：
 
-- `scroll-view` 不支持通过 `slot="refresher"` 自定义下拉刷新内容，相关内容需通过条件编译排除支付宝小程序。
-- `radio`、`checkbox` 不支持将文本或 `text` 组件放在组件内部。选项文本应与 `radio`、`checkbox` 作为同级节点放置，通常可使用 `label` 包裹同级的选项组件和文本。
-- 同一页面存在多个 `page-container` 时，第二个及后续打开的 `page-container` 可能无法弹出，建议同一页面只保留一个 `page-container`。
-- `native-view` 暂不支持支付宝小程序，使用时需通过条件编译排除支付宝小程序。
-- `picker` 不支持 `mode` 属性，如需多平台兼容，需要为支付宝小程序单独处理选择能力。
-- `picker-view` 动态设置指示器样式时可能出现偏移，建议使用静态配置，避免运行时修改指示器样式。
+- 组件和 API 的支付宝平台限制请参阅对应组件和API文档
+- 支付宝小程序支持暗黑模式，需要通过 `themeLocation` 指定 `theme.json`，详见[暗黑主题适配教程](../api/theme-change.md)。
+- 支付宝小程序不支持完全自定义导航栏，`navigationStyle: "custom"` 不生效，详见[pages.json 页面配置](../collocation/pagesjson.md)。
 
 ## 开发和调试
 
-在HBuilderX底部状态栏选择语法平台，确保有微信小程序平台，否则代码提示不会有微信专有API。如果选择其他平台，但代码里在非MP-WEIXIN的条件编译里写了微信专有代码，ide会告警。
+在 HBuilder 底部状态栏选择语法平台，确保有指定的小程序平台，否则代码提示不会有该小程序专有 API。如果选择其他平台，但代码里在非当前小程序的条件编译里写了其他小程序平台专有代码，ide 会告警。

package/data/uniappx/native/download/android.md

@@ -103,30 +103,69 @@
 
 ## alpha版
 
-### 5.26.2026091402-alpha
+### 5.31.2026093010-alpha
 
-**[原生SDK(蒸汽模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android-Vapor/Android-uni-app-x-vapor-SDK@101163-5.26.zip)**
+**[原生SDK(蒸汽模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android-Vapor/Android-uni-app-x-vapor-SDK@101264-5.31.zip)**
 
-**[原生SDK(VDOM模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android/Android-uni-app-x-SDK@15075-5.26.zip)**
+**[原生SDK(VDOM模式)下载地址](https://web-ext-storage.dcloud.net.cn/uni-app-x/sdk/Android/Android-uni-app-x-SDK@15133-5.31.zip)**
 
-* 更新uni-app离线打包支持，需使用HBuilderX（5.26.2026091402-alpha）版本生成本地打包App资源。
-* 蒸汽模式 修复 组件 scroll-view 容器或内容变化引发的滚动不会触发scrollend事件 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32611)
-* 蒸汽模式 修复 组件 list-view list-item高度变成0时未重排后续item位置 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32592)
-* 蒸汽模式 修复 组件 list-view initial-scroll-bottom属性部分情况下未将初始位置滚动到底部 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32614)
-* 蒸汽模式 修复 组件 list-view 滚动期间及滚动结束瞬间概率出现闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32910)
-* 蒸汽模式 修复 组件 list-view 开启 scroll-anchoring 后追加消息可能出现白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32913)
-* 蒸汽模式 修复 组件 text 嵌套 text 上使用 v-if 或 v-for 时可能无法显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32539)
-* 蒸汽模式 修复 组件 rich-text 设置 translateY 后可能内容显示不完整 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32820)
-* 蒸汽模式 修复 5.25版本引发的 组件 rich-text 页面滚动到页面上边缘偶现闪白 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32911)
-* 蒸汽模式 修复 组件 image 没有设置 fade-show 加载网络图片首次显示会有渐变动画效果 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32762)
-* 蒸汽模式 修复 5.25版本引发的 组件 画布 2D 绘制指令全部执行成功但画布始终空白不上屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32730)
-* 蒸汽模式 修复 API uni.exit 执行 redirectTo 后可能无法正常退出显示白屏 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32768)
-* 蒸汽模式 修复 5.25版本引发的 API uni.getUniVerifyManager 调用报 `parameters length error` 错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32757)
+* 更新uni-app离线打包支持，需使用HBuilderX（5.31.2026093010-alpha）版本生成本地打包App资源。
+* 蒸汽模式 新增 uasm插件 [文档](http://doc.dcloud.net.cn/uni-app-x/plugin/uasm-plugin.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=17204>
+* 蒸汽模式 新增 vue <script setup>支持 lang="ts" 和 lang="js" [文档](https://doc.dcloud.net.cn/uni-app-x/vue/#lang) <https://issues.dcloud.net.cn/pages/issues/detail?id=31884>
+* 新增 API toast 允许设置是否与页面绑定 [文档](https://doc.dcloud.net.cn/uni-app-x/api/toast.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32914>
+* 新增 API uni.getFileSystemManager 支持 unzipSync 同步解压zip文件 [文档](https://doc.dcloud.net.cn/uni-app-x/api/get-file-system-manager.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32516>
+* 新增 API uni.getFileSystemManager getFileInfo 支持计算 sha256 摘要 [文档](https://doc.dcloud.net.cn/uni-app-x/api/get-file-system-manager.html#getfileinfo) <https://issues.dcloud.net.cn/pages/issues/detail?id=32932>
+* 新增 UniPage API TabBar 页面支持 onTabItemTap 生命周期 [文档](https://doc.dcloud.net.cn/uni-app-x/page.html#ontabitemtap) <https://issues.dcloud.net.cn/pages/issues/detail?id=32343>
+* 修复 pages.json TabBar 未配置 selectedColor 时显示有误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33166)
+* 修复 API uni.navigateBack 自定义基座且未使用 uni.hideLoading 时调用 uni.navigateBack 报错 uni-showLoading not found [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31939)
+* 修复 API uni.onPushMessage 回调首次执行后被释放 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32385)
+* 新增 组件 map 更新腾讯地图 sdk 为 6.18.0 版，适配支持 16KB 内存页面大小 [文档](https://doc.dcloud.net.cn/uni-app-x/component/map.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32831>
+* 新增 API push 更新个推 SDK 为 3.3.15 版，适配支持 16KB 内存页面大小 [文档](https://doc.dcloud.net.cn/uni-app-x/api/uni-push.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=33091>
+* 修复 组件 video 部分折叠屏设备上首帧闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32583)
+* 修复 API uni.getFileSystemManager unzip 解压部分zip文件可能失败 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33128)
+* 修复 API uni.startFacialRecognitionVerify 更新阿里云金融级实人认证SDK为 2.3.52 版，适配支持 16KB 内存页面大小 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33055)
+* 修复 DOM API UniElement 分屏模式下调用 requestFullscreen 显示异常 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32709)
+* 蒸汽模式 新增 pages.json 支持配置 backgroundTextStyle 属性 [文档](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32612>
+* 蒸汽模式 新增 组件 text 支持 CSS 样式 word-break [文档](https://doc.dcloud.net.cn/uni-app-x/css/word-break.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32705>
+* 蒸汽模式 新增 CSS animation 及 @keyframes 关键帧动画 [文档](https://doc.dcloud.net.cn/uni-app-x/css/animation.html#animation) <https://issues.dcloud.net.cn/pages/issues/detail?id=31169>
+* 蒸汽模式 新增 CSS calc 支持数学计算样式 [文档](https://doc.dcloud.net.cn/uni-app-x/css/common/function.html#calc) <https://issues.dcloud.net.cn/pages/issues/detail?id=32256>
+* 蒸汽模式 新增 DOM API UniElement 支持 attributes 返回当前元素上所有属性元素的集合 [文档](https://doc.dcloud.net.cn/uni-app-x/api/dom/unielement.html) <https://issues.dcloud.net.cn/pages/issues/detail?id=32488>
+* 蒸汽模式 修复 vue 组合使用v-for v-if时部分情况编译报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33263)
+* 蒸汽模式 修复 vue Teleport 包含 slot 时的字节码编译错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32570)
+* 蒸汽模式 修复 vue 组件插槽中空文本节点被丢弃的问题 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32633)
+* 蒸汽模式 修复 5.26版本引发的 组件 list-view 滚动锚定、初始滚动到底部功能触发滚动时概率出现闪烁 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33120)
+* 蒸汽模式 修复 组件 list-view 部分情况下list-item尺寸变化引发重排导致界面空白 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33123)
+* 蒸汽模式 修复 组件 rich-text nodes 使用节点列表数据类型时 text 中存在特殊字符会导致原生渲染下无法显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33106)
+* 蒸汽模式 修复 组件 rich-text list-view 内 native rich-text 折叠展开后内容不显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33286)
+* 蒸汽模式 修复 CSS page标签选择器背景色生效时机 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32858)
+* 蒸汽模式 修复 CSS var自定义变量 组件中使用 useComputedStyle 后动态更新 class 中的 var 样式不生效 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32577)
+* 蒸汽模式 新增 API uni.installWgt 支持应用资源热更新 [文档](https://doc.dcloud.net.cn/uni-app-x/api/install-wgt.html#tips) <https://issues.dcloud.net.cn/pages/issues/detail?id=32098>
+* 蒸汽模式 新增 UniApp API 支持 restart 重启应用 [文档](https://doc.dcloud.net.cn/uni-app-x/api/get-app.html#restart) <https://issues.dcloud.net.cn/pages/issues/detail?id=31806>
+* 蒸汽模式 修复 API uni.setTabBarStyle setTabBarStyle 未传文字颜色时重置 TabBar 文字颜色 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32448)
+* 蒸汽模式 修复 组件 input dialogPage 中输入框聚焦页面上推后，键盘收起页面位置未恢复 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33205)
+* 蒸汽模式 修复 API themeChange 切换主题与动态组件冲突导致闪退 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32559)
+* 蒸汽模式 修复 manifest.json 安卓端蒸汽模式设置横屏跳转页面问题 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32329)
+* 蒸汽模式 修复 组件 scroll-view 设置 refresher-enabled 为 true 开启下拉刷新后 v-if 切换节点出现旧视图残留叠加 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33208)
+* 蒸汽模式 修复 组件 list-view 打开页面获取数据后偶现整个列表变空白 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32994)
+* 蒸汽模式 修复 组件 rich-text mode 为 native, 大屏幕设备可能文字渲染毛刺 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32452)
+* 蒸汽模式 修复 组件 native-view 特定情况下 init 事件可能不触发 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32523)
+* 蒸汽模式 修复 组件 input onLoad 发起 request 请求后赋值偶现不显示 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32325)
+* 蒸汽模式 修复 组件 image svg 格式图片设置 fade-show 为 true 无效果 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32929)
+* 蒸汽模式 修复 组件 canvas v-if 切换后再访问原 CanvasContext 引发异常 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32767)
+* 蒸汽模式 修复 API uni.showLoading 页面销毁的过程中loading偶现异常 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33086)
+* 蒸汽模式 修复 API uni.hideLoading 配置动画类型后无法关闭加载框 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33188)
+* 蒸汽模式 修复 API uni.getWindowInfo 分屏模式下获取到的安全区域信息不正确 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32665)
+* 蒸汽模式 修复 API uni.onPushMessage requestPermission 参数默认值错误 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32668)
+* 蒸汽模式 修复 CSS z-index 偶发不生效导致元素被遮挡 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32983)
+* 蒸汽模式 修复 CSS box-shadow 渲染区域拦截点击事件导致低 z-index 元素无法响应点击 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32642)
+* 蒸汽模式 修复 CSS var自定义变量 退出应用后新进入 --status-bar-height 可能失效 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=31801)
+* 蒸汽模式 修复 DOM API UniElement 使用 rpx 样式时页面尺寸变化可能引发闪退 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33288)
+* 蒸汽模式 修复 运行调试 app后台状态下热更新崩溃 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32896)
+* VDOM模式 修复 CSS var自定义变量 padding 使用 var 情况下简写不生效 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32648)
 ### uts插件
-* 蒸汽模式 修复 字面量.toFloat方式声明的变量被编译为了Number类型 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32906)
-* 蒸汽模式 修复 5.25版本引发的 uts插件导出的常量不能被页面组件引用 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32903)
-* 蒸汽模式 修复 5.25版本引发的 暴露给页面组件调用的class上含可为空的function类型属性时编译报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32624)
+* 蒸汽模式 修复 5.25版本引发的 插件导出的方法接收非 double 类型数字时调用报错 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=32998)
+* 蒸汽模式 修复 convert2AbsFullPath不支持SD卡路径文件 [详情](https://issues.dcloud.net.cn/pages/issues/detail?id=33361)
 
 **[历史版本](https://pan.baidu.com/s/1OXvFjfGW6zDAyzTZGpY7hQ?pwd=aa2c)**
  
-**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.26.2026091402-alpha.html)**
+**[历史版本更新日志](https://download1.dcloud.net.cn/hbuilderx/changelog/5.31.2026093010-alpha.html)**