## white-space white-space 属性用于设置如何处理元素中的空白字符(空格、换行符、制表符)以及文本是否自动换行。 ### uni-app x 兼容性 Web: 4.0; Android: 4.0; iOS: 4.11; HarmonyOS: 4.61 ### App平台拍平(flatten)兼容性 @flatten_compatibility | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) | | :- | :- | :- | | 5.21 | 5.11 | 5.0 | ### 语法 ``` white-space: normal | pre | nowrap | pre-wrap | pre-line | break-spaces | [ <'white-space-collapse'> || <'text-wrap'> || <'white-space-trim'> ]; ``` ### 值限制 - enum ### white-space 的属性值 | 名称 | 兼容性 | 描述 | | :- | :- | :- | | normal | Web: 4.0; Android: 4.0; iOS: 4.11; HarmonyOS: 4.61 | 换行符(\n)当做空白符处理,连续的多个空白字符会合并为一个空格,文本遇到边界会自动换行,行末空白字符移除。 | | nowrap | Web: 4.0; Android: 4.0; iOS: 4.11; HarmonyOS: 4.61 | 换行符(\n)当做空白符处理,连续的多个空白字符会合并为一个空格,文本遇到边界不会自动换行,行末空白字符移除。 | | pre | Web: 4.0; Android: 4.81; iOS: 4.81; HarmonyOS(VDOM): x; HarmonyOS(Vapor): 5.0 | 换行符(\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界不会自动换行,行末空白字符保留。 | | pre-wrap | Web: 4.0; Android: 4.81; iOS: 4.81; HarmonyOS(VDOM): x; HarmonyOS(Vapor): 5.0 | 换行符(\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界会自动换行,行末空白字符保留但“不占位置”。 | | pre-line | Web: 4.0; Android: 4.81; iOS: 4.81; HarmonyOS(VDOM): x; HarmonyOS(Vapor): 5.0 | 换行符(\n)保留并换行显示,连续的多个空白字符会合并为一个空格,文本遇到边界会自动换行,行末空白字符移除。 | | break-spaces | Web: 4.0; Android: 4.81; iOS: 4.81; HarmonyOS(VDOM): x; HarmonyOS(Vapor): 5.0 | 换行符(\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界会自动换行,行末空白字符换行处理。 | | keep | Web: x; Android: 5.0; iOS: 5.0; HarmonyOS(VDOM): x; HarmonyOS(Vapor): 5.0 | 不对空白字符处理,保持原始值。换行符(\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界会自动换行,行末空白字符保留。 | ### 默认值 @default-value | 平台 | 默认值 | | :- | :- | | uvue-app | keep | | uvue-web | pre-line | **注意**:W3C 默认值为:normal ### 适用组件 @unix-tags - [text](/component/text.md) - [button](/component/button.md) ### 注意@tips #### 空白字符处理不止由white-space属性决定 对于写在模板中的text组件中的空白字符,在编译阶段,会由编译器先行处理。另外text组件的space属性也会干扰空白字符处理。规则[详见](../component/text.md#空白字符)。 uni-app x中有text组件,这是一个web没有的组件。且uni-app x在非web平台,包括小程序平台,都不支持
换行,所以uni-app x设计为text组件中的`\n`默认不会忽略,而是换行。 不管app平台默认值keep,还是web平台默认值pre-line,都是这个表现。 #### HBuilderX5.0版本调整 app平台、web平台调整了 white-space 属性的实现。之前接近小程序的表现,之后按 W3C 标准规范执行。同时为了text组件性能考虑, app 平台新增支持 `keep` 属性值,且默认为 `keep`。 **默认值调整** - app-android、app-ios平台新增支持取值 `keep`,默认值由 `normal` 调整为 `keep` - app-harmony平台蒸汽模式(Vapor)支持取值 `keep`,默认值为 `keep` - web平台,默认值由 `normal` 调整为 `pre-line` **调整前实现规范** - normal(与调整后的pre-line效果一致) 换行符(\\n)保留并换行显示,连续的多个空白字符会合并为一个空格,文本遇到边界会自动换行,行末空白字符移除。 - nowrap 换行符(\\n)保留并换行显示,连续的多个空白字符会合并为一个空格,文本遇到边界不会自动换行,行末空白字符移除。 - pre 换行符(\\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界不会自动换行,行末空白字符保留。 - pre-wrap 换行符(\\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界会自动换行,行末空白字符保留。 - pre-line 换行符(\\n)保留并换行显示,连续的多个空白字符会合并为一个空格,文本遇到边界会自动换行,行末空白字符移除。 - break-spaces 换行符(\\n)保留并换行显示,连续的多个空白字符保留,文本遇到边界会自动换行,行末空白字符保留。 ### 示例 示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/text/white-space.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/text/white-space.uvue) ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/text/white-space > appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/text/white-space >示例 ```vue ``` ::: ### 参见 - [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/white-space) - [相关 Bug](https://issues.dcloud.net.cn/?mid=css.properties.text.white-space)