tmui-cli 2.0.6 → 5.3.2

package/data/uniappx/css/transition-delay.md

@@ -11,7 +11,7 @@ CSS 的transition-delay属性规定了在过渡效果开始作用之前需要等
 
 | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
 | :- | :- | :- |
-| x | x | x |
+| 5.21 | 5.11 | x |
 
 ### 语法
 ```
@@ -40,9 +40,6 @@ transition-delay: <time>#;
 >示例
 ```vue
 <template>
-  
-  <scroll-view style="flex: 1">
-  
     <view>
       <text class="uni-title-text">view 组件 transition-delay：1s</text>
       <view :class="classValue"></view>
@@ -123,9 +120,6 @@ transition-delay: <time>#;
       
 
     </view>
-  
-  </scroll-view>
-  
 </template>
 
 <style>

package/data/uniappx/css/transition-duration.md

@@ -11,7 +11,7 @@ transition-duration 属性以秒或毫秒为单位指定过渡动画所需的时
 
 | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
 | :- | :- | :- |
-| x | x | x |
+| 5.21 | 5.11 | x |
 
 ### 语法
 ```
@@ -33,9 +33,6 @@ transition-duration: <time>#;
 >示例
 ```vue
 <template>
-  
-  <scroll-view style="flex: 1">
-  
     <view>
       <text class="uni-title-text">view 组件 transition-duration：2s </text>
       <view :class="classValue"></view>
@@ -44,6 +41,13 @@ transition-duration: <time>#;
         <button class="button-item" @click="reset">reset</button>
       </view>
 
+      <text class="uni-title-text uni-common-mt">transition 简写 duration：500ms</text>
+      <view ref="durationOnlyRef" :class="durationOnlyClass" style="transition: 500ms;"></view>
+      <view class="button-container">
+        <button class="button-item" @click="durationOnlyStart">duration start</button>
+        <button class="button-item" @click="durationOnlyReset">duration reset</button>
+      </view>
+
       <text class="uni-title-text uni-common-mt">text 组件 transition-duration: 2s</text>
       <text :class="textClassValue">transition-duration: 2s</text>
       <view class="button-container">
@@ -147,9 +151,6 @@ transition-duration: <time>#;
       
 
     </view>
-  
-  </scroll-view>
-  
 </template>
 
 <style>
@@ -164,6 +165,10 @@ transition-duration: <time>#;
     width: 300px;
   }
 
+  .duration-only-ani {
+    width: 300px;
+  }
+
   .text-box {
     width: 200px;
     height: 60px;

package/data/uniappx/css/transition-property.md

@@ -11,7 +11,7 @@ transition-property 指定应用过渡属性的名称。
 
 | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
 | :- | :- | :- |
-| x | x | x |
+| 5.21 | 5.11 | x |
 
 ### 语法
 ```

package/data/uniappx/css/transition-timing-function.md

@@ -11,7 +11,7 @@ CSS 属性受到 transition effect的影响，会产生不断变化的中间值
 
 | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
 | :- | :- | :- |
-| x | x | x |
+| 5.21 | 5.11 | x |
 
 ### 语法
 ```
@@ -46,9 +46,6 @@ App平台不支持指定多个过渡效果。
 >示例
 ```vue
 <template>
-  
-  <scroll-view style="flex: 1">
-  
     <view>
       <text class="uni-title-text uni-common-mt">view 组件 transition-timing-function：linear</text>
       <view :class="classValue"></view>
@@ -129,9 +126,6 @@ App平台不支持指定多个过渡效果。
       
 
     </view>
-  
-  </scroll-view>
-  
 </template>
 
 <style>

package/data/uniappx/css/transition.md

@@ -11,7 +11,7 @@ transition CSS 属性是 transition-property、transition-duration、transition-
 
 | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
 | :- | :- | :- |
-| x | x | x |
+| 5.21 | 5.11 | x |
 
 ### 语法
 ```
@@ -42,10 +42,7 @@ transition暂不支持结束属性值为百分比。
 >示例
 ```vue
 <template>
-  
-  <scroll-view class="uni-theme-root" style="flex: 1">
-  
-  <view class="transition-page uni-theme-root">
+  <view class="transition-page">
     <view class="container">
       <text class="text">点击修改宽度</text>
       <view class="base-style transition-width" id="widthOrHeight" @click="changeWidthOrHeight"></view>
@@ -218,6 +215,7 @@ transition暂不支持结束属性值为百分比。
       <view class="base-style transition-border-background" id="borderAndBackgroundColor" @click="changeBorderAndBackgroundColor"></view>
     </view>
 
+    
     <text class="uni-title-text uni-common-mt">scroll-view 组件</text>
     <text class="text">点击 scroll-view 查看 transition 效果</text>
 
@@ -229,6 +227,7 @@ transition暂不支持结束属性值为百分比。
         <text class="colored-box-text">transition: width 2s ease-in-out</text>
       </scroll-view>
     </view>
+    
 
     <view class="uni-common-mt">
       <text class="uni-title-text">setProperty 设置与 getPropertyValue 获取</text>
@@ -319,9 +318,6 @@ transition暂不支持结束属性值为百分比。
 			</navigator>
 		</view>
   </view>
-  
-  </scroll-view>
-  
 </template>
 
 <style>

package/data/uniappx/css/visibility.md

@@ -30,6 +30,14 @@ visibility: visible | hidden | collapse;
 **注意**
 设置 visibility 为 hidden，或设置 display 为 none 都可以隐藏元素。差异是通过 visibility 隐藏元素仍然占据页面位置，通过 display 隐藏元素不占据页面位置。
 
+#### App平台差异
+App平台设置如果元素的 visibility 设置为 hidden，其子元素将不可见，即使子元素的 visibility 设置为 visible 也不可见。
+
+**蒸汽模式拍平(flatten)**  
+- app-android平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的子元素默认仍然会显示，子元素的显示状态由其自身的visibility决定
+- app-ios平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的非拍平子元素默认仍然会显示，非拍平子元素的显示状态由其自身的visibility决定，而拍平子元素会跟随此view不可见
+- app-harmony平台visibility暂不支持拍平
+
 ### 默认值 @default-value 
  `visible`
 
@@ -42,10 +50,7 @@ visibility: visible | hidden | collapse;
 >示例
 ```vue
 <template>
-  
-  <scroll-view class="uni-theme-root" style="flex: 1">
-  
-    <view class="css-page uni-theme-root" style="flex-grow: 1;">
+    <view class="css-page" style="flex-grow: 1;">
       <text class="uni-tips">visibility: {{data.visibility}} ，说明：点击切换</text>
       <view class="demo-box">
         <view @click="changeVisibility">
@@ -134,9 +139,6 @@ visibility: visible | hidden | collapse;
       </view>
       
     </view>
-  
-  </scroll-view>
-  
 </template>
 
 
@@ -190,9 +192,6 @@ visibility: visible | hidden | collapse;
 
 ```
 
-#### App平台差异
-App平台设置如果元素的 visibility 设置为 hidden，其子元素将不可见，即使子元素的 visibility 设置为 visible 也不可见。
-
 ### 参见
 - [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/visibility)
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=css.properties.visibility)

package/data/uniappx/css/white-space.md

@@ -82,9 +82,6 @@ app平台、web平台调整了 white-space 属性的实现。之前接近小程
 >示例
 ```vue
 <template>
-  
-  <scroll-view style="flex: 1">
-  
     <view style="flex-grow: 1;">
       <scroll-view style="padding: 10px 0px; background-color: gray;justify-content: center;" direction="horizontal">
         <text class="text" :style="{ whiteSpace: data.whiteSpace }">{{data.multiLineText}}</text>
@@ -128,9 +125,6 @@ app平台、web平台调整了 white-space 属性的实现。之前接近小程
         </view>
       </scroll-view>
     </view>
-  
-  </scroll-view>
-  
 </template>
 
 <style>

package/data/uniappx/css/width.md

@@ -45,10 +45,7 @@ width: <viewport-length>{1,2};
 >示例
 ```vue
 <template>
-  
-  <scroll-view class="uni-theme-root" style="flex: 1">
-  
-  <view class="uni-theme-root" style="flex-grow: 1;">
+  <view style="flex-grow: 1;">
     <text class="uni-tips">说明：左边是正常版本，右边是拍平版本</text>
     <view>
       <text>width: 100px</text>
@@ -229,9 +226,6 @@ width: <viewport-length>{1,2};
     </view>
     
   </view>
-  
-  </scroll-view>
-  
 </template>
 
 <style>

package/data/uniappx/css/word-break.md

@@ -0,0 +1,151 @@
+## word-break
+
+word-break 属性指定文本在内容框内溢出时的断行规则。
+
+### uni-app x 兼容性 
+| Web | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- | :- | :- |
+| 4.0 | x | 5.31 | x | 5.31 | x | 5.31 |
+
+### App平台拍平（flatten）兼容性  @flatten_compatibility
+
+| Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
+| :- | :- | :- |
+| 5.31 | 5.31 | 5.31 |
+
+### 语法
+```
+word-break: normal | break-all | keep-all | break-word;
+```
+
+### word-break 的属性值
+| 名称 | 兼容性 | 描述 |
+| :- | :- | :- |
+| normal | Web 4.0 / Android(VDOM) x / Android(Vapor) 5.31 / iOS(VDOM) x / iOS(Vapor) 5.31 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.31（部分支持，见上） | 使用默认的断行规则。 |
+| break-all | Web 4.0 / Android(VDOM) x / Android(Vapor) 5.31 / iOS(VDOM) x / iOS(Vapor) 5.31 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.31（部分支持，见上） | 对于非中日韩文本，可在任意字符间断行。 |
+
+### 默认值 @default-value 
+ | 平台 | 默认值 |
+| :- | :- |
+| uvue-app | normal |
+| uvue-web | normal |
+
+ **注意**：W3C 默认值为：normal
+
+### 适用组件 @unix-tags 
+ - text
+
+### 示例 
+ 示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/text/word-break.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/text/word-break.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/text/word-break
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/text/word-break
+
+>示例
+```vue
+<template>
+  
+  <scroll-view style="flex: 1">
+  
+    <view style="flex-grow: 1;">
+      <text class="uni-tips">说明：左边是正常版本，右边是拍平版本</text>
+
+      <view class="demo-box">
+        <view class="demo-column">
+          <text class="uni-info">word-break: normal</text>
+          <text class="demo-text" style="word-break: normal;">hello uni-app x word-break example</text>
+          <text class="uni-info uni-common-mt">word-break: break-all</text>
+          <text class="demo-text" style="word-break: break-all;">hello uni-app x word-break example</text>
+        </view>
+
+        <view class="demo-column">
+          <text class="uni-info">word-break: normal</text>
+          <text class="demo-text" style="word-break: normal;" flatten>hello uni-app x word-break example</text>
+          <text class="uni-info uni-common-mt">word-break: break-all</text>
+          <text class="demo-text" style="word-break: break-all;" flatten>hello uni-app x word-break example</text>
+        </view>
+      </view>
+
+      <view class="uni-common-mt">
+        <text class="uni-title-text">setProperty 设置与 getPropertyValue 获取</text>
+      </view>
+
+      <view class="common-box">
+        <view class="uni-common-mt">
+          <text class="uni-title-text">word-break</text>
+          <text class="uni-info">设置值: {{data.wordBreak}}</text>
+          <text class="uni-info">获取值: {{data.wordBreakActual}}</text>
+          <view class="test-box">
+            <text ref="textRef" class="test-text" :style="{ wordBreak: data.wordBreak }">hello uni-app x word-break example</text>
+          </view>
+        </view>
+
+        <view class="uni-common-mt">
+          <text class="uni-title-text">拍平</text>
+          <text class="uni-info">设置值: {{data.wordBreak}}</text>
+          <text class="uni-info">获取值: {{data.wordBreakActualFlat}}</text>
+          <view class="test-box">
+            <text ref="textRefFlat" class="test-text" :style="{ wordBreak: data.wordBreak }" flatten>hello uni-app x word-break example</text>
+          </view>
+        </view>
+      </view>
+
+      <view class="uni-common-mt uni-common-mb">
+        <text class="uni-tips">第一个枚举值，'' (空字符串) - 空值情况</text>
+        <enum-data :items="wordBreakEnum" title="word-break 枚举值" @change="radioChangeWordBreak"
+          :compact="true"></enum-data>
+        <input-data :defaultValue="data.wordBreak" title="word-break 自定义值" type="text"
+          @confirm="inputChangeWordBreak"></input-data>
+      </view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+<style>
+  .demo-box {
+    flex-direction: row;
+    margin-top: 10px;
+  }
+
+  .demo-column {
+    flex: 1;
+    min-width: 0;
+    height: 240px;
+    padding: 10px;
+    background-color: gray;
+  }
+
+  .demo-text {
+    width: 140px;
+    height: 70px;
+    font-size: 18px;
+    background-color: lightgray;
+  }
+
+  .common-box {
+    flex-direction: row;
+    justify-content: space-around;
+  }
+
+  .test-box {
+    width: 180px;
+    height: 110px;
+    padding: 10px;
+    background-color: gray;
+    justify-content: center;
+  }
+
+  .test-text {
+    width: 140px;
+    font-size: 18px;
+    background-color: lightgray;
+  }
+</style>
+
+```
+
+### 参见
+- [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/word-break)
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=css.properties.text.word-break)

package/data/uniappx/css/z-index.md

@@ -46,9 +46,9 @@ z-index: auto | <integer>;
 - integer
 
 ### z-index 的属性值
-| 名称 | 兼容性 | 描述 |
-| :- | :- | :- |
-| auto | Web 4.0 / Android 系统版本 - / Android - / iOS 系统版本 - / iOS - / HarmonyOS 系统版本 - / HarmonyOS -（部分支持，见上） | 盒子不会创建一个新的局部层叠上下文。盒子在当前层叠上下文的层叠等级是 0。 |
+| 名称 | 描述 |
+| :- | :- |
+| auto | 盒子不会创建一个新的局部层叠上下文。盒子在当前层叠上下文的层叠等级是 0。 |
 
 ### 默认值 @default-value 
  | 平台 | 默认值 |
@@ -67,10 +67,7 @@ z-index: auto | <integer>;
 >示例
 ```vue
 <template>
-  
-  <scroll-view class="uni-theme-root" style="flex: 1">
-  
-  <view class="z-index-page uni-theme-root">
+  <view class="z-index-page">
     <view style="flex-grow: 1;">
       <view style="position:absolute;z-index:0;">
         <view class="common fixed default">
@@ -185,9 +182,6 @@ z-index: auto | <integer>;
       
     </view>
   </view>
-  
-  </scroll-view>
-  
 </template>
 
 

package/data/uniappx/i18n.md

@@ -25,8 +25,8 @@ APP 蒸汽模式、鸿蒙和 iOS VDOM 模式、Web平台、小程序平台可以
 │   ├── en.json
 │   ├── zh-Hans.json
 │   └── zh-Hant.json
-├── i18n.uts
-└── main.uts
+├── i18n.ts
+└── main.ts
 ```
 
 语言文件内容示例：
@@ -44,7 +44,7 @@ APP 蒸汽模式、鸿蒙和 iOS VDOM 模式、Web平台、小程序平台可以
 }
 ```
 
-在 `i18n.uts` 中初始化 `vue-i18n`：
+在 `i18n.ts` 中初始化 `vue-i18n`：
 
 ```ts
 import { createI18n } from 'vue-i18n'
@@ -64,12 +64,12 @@ export const i18n = createI18n({
 })
 ```
 
-在 `main.uts` 中挂载 `i18n`：
+在 `main.ts` 中挂载 `i18n`：
 
 ```ts
 import App from './App.uvue'
 import { createSSRApp } from 'vue'
-import { i18n } from './i18n.uts'
+import { i18n } from './i18n.ts'
 
 export function createApp() {
   const app = createSSRApp(App)
@@ -89,7 +89,7 @@ export function createApp() {
     <text>{{ t('i18n.description') }}</text>
     <text>{{ t('i18n.currentLocale') }}: {{ locale }}</text>
     <text>{{ t('i18n.greeting') }}</text>
-    <text>{{ t('i18n.named', { framework: 'uni-app x' } as UTSJSONObject) }}</text>
+    <text>{{ t('i18n.named', { framework: 'uni-app x' }) }}</text>
 
     <button @click="changeLocale('zh-Hans')">{{ t('i18n.switchToZhHans') }}</button>
     <button @click="changeLocale('zh-Hant')">{{ t('i18n.switchToZhHant') }}</button>
@@ -101,7 +101,7 @@ export function createApp() {
 
 ## pages.json 国际化@pages
 
-> App平台 pages.json 不支持通过配置语言json文件实现国际化，暂时可通过tabbar和navigationbar的API来设置文字  
+> App平台 pages.json 不支持通过配置语言json文件实现国际化，暂时可通过tabbar和navigationbar的API来设置文字
 
 Web平台还额外支持如下使用方式：
 
@@ -180,13 +180,13 @@ uni-app x 的部分组件和API涉及界面，框架内置支持的国际化语
 		* `拍摄` 打开的是系统相机界面，在app平台跟随系统语言，不受uni-app x内置国际化语言列表限制
 		* `从相册选择` 分系统相册和自定义相册。系统相册的国际化是根据手机OS的语言设置。自定义相册界面，在uni-app x内置国际化语言列表可配置。
 	+ 小程序这部分的国际化大多跟随小程序宿主的语言
-- [uni.chooseMedia](./api/choose-media.md)：  
-  + app平台弹出系统媒体选择界面，使用的是当前系统的语言。  
+- [uni.chooseMedia](./api/choose-media.md)：
+  + app平台弹出系统媒体选择界面，使用的是当前系统的语言。
 
-## manifest.json 国际化@manifest  
-> HBuilderX5.0及以上版本 app-android/app-ios 平台云端打包和 app-harmony 平台本地打包支持设置国际化  
+## manifest.json 国际化@manifest
+> HBuilderX5.0及以上版本 app-android/app-ios 平台云端打包和 app-harmony 平台本地打包支持设置国际化
 
-manifest.json 文件的国际化与 pages.json 一样，在项目根目录的locale目录下配置语言json文件，locale/[语言标签](#lantag).json，如下：  
+manifest.json 文件的国际化与 pages.json 一样，在项目根目录的locale目录下配置语言json文件，locale/[语言标签](#lantag).json，如下：
 
 ```
 ├── locale
@@ -195,7 +195,7 @@ manifest.json 文件的国际化与 pages.json 一样，在项目根目录的loc
 │   └── zh-Hant.json
 ```
 
-语言文件示例（zh-Hans.json）：  
+语言文件示例（zh-Hans.json）：
 
 ```json
 {
@@ -203,10 +203,10 @@ manifest.json 文件的国际化与 pages.json 一样，在项目根目录的loc
 }
 ```
 
-### 应用名称  
-在manifest.json可视化界面的“应用名称”中配置为 `%app.name%` 。  
+### 应用名称
+在manifest.json可视化界面的“应用名称”中配置为 `%app.name%` 。
 
-或在 源码视图 中配置如下：  
+或在 源码视图 中配置如下：
 ```json
 {
   "name": "%app.name%",
@@ -214,16 +214,16 @@ manifest.json 文件的国际化与 pages.json 一样，在项目根目录的loc
 }
 ```
 
-配置后需提交云端打包生效。  
+配置后需提交云端打包生效。
 
-**注意**  
-app-android、app-ios平台离线打包需在原生工程中配置应用的国际化名称。  
+**注意**
+app-android、app-ios平台离线打包需在原生工程中配置应用的国际化名称。
 
-### app-ios平台隐私信息许可描述  
-iOS平台应用的隐私信息访问的许可描述中的提示文字，也可在manifest.json中配置国际化。  
-在可视化界面 “iOS App配置” 的 “隐私信息访问的许可描述” 对应的项中配置，如 “摄像头（NSCameraUsageDescription）” 项配置为 `%app.ios.des.camera%` 。  
+### app-ios平台隐私信息许可描述
+iOS平台应用的隐私信息访问的许可描述中的提示文字，也可在manifest.json中配置国际化。
+在可视化界面 “iOS App配置” 的 “隐私信息访问的许可描述” 对应的项中配置，如 “摄像头（NSCameraUsageDescription）” 项配置为 `%app.ios.des.camera%` 。
 
-或在 源码视图 中配置 “摄像头（NSCameraUsageDescription）” 如下：  
+或在 源码视图 中配置 “摄像头（NSCameraUsageDescription）” 如下：
 ```json
 {
   "app-ios": {
@@ -236,10 +236,10 @@ iOS平台应用的隐私信息访问的许可描述中的提示文字，也可
 }
 ```
 
-配置后需提交云端打包生效。  
+配置后需提交云端打包生效。
 
-**注意**  
-app-ios平台暂不支持配置Info.plist文件中其他信息的国际化配置，有此特殊需求离线打包可在原生XCode工程中配置。  
+**注意**
+app-ios平台暂不支持配置Info.plist文件中除应用名称和隐私许可描述外的其他字段国际化配置，有此特殊需求请使用`uni-app x 原生SDK`在原生Xcode工程中配置。
 
 ## uniCloud国际化
 
@@ -337,15 +337,15 @@ Web平台注意要区分系统语言和应用语言的概念。
 
 当前应用语言发生变化时，触发回调。也就是`uni.setLocale`执行时。
 
-## 语言标签 @lantag  
+## 语言标签 @lantag
 
-语言标签由一个或多个子标签（subtags）组成，用连字号(-)分隔，子标签只能由基本拉丁字母或数字组成。处理逻辑遵循 BCP 47 规范。  
+语言标签由一个或多个子标签（subtags）组成，用连字号(-)分隔，子标签只能由基本拉丁字母或数字组成。处理逻辑遵循 BCP 47 规范。
 
 语言标签通常为两个或三个字母，参考[ISO 639](https://zh.wikipedia.org/wiki/ISO_639-1%E4%BB%A3%E7%A0%81%E8%A1%A8)规范
 
 语言代码-地区代码，地区代码为两个字母，参考[ISO 3166-2](https://zh.wikipedia.org/wiki/ISO_3166-2)规范
 
-常见语言标签示例：  
+常见语言标签示例：
 | 标签        | 含义            | 使用场景                |
 | -           | -               | -                      |
 | zh          | 中文（泛指）    | 通用中文内容            |