## 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
{{data.multiLineText}}
拍平
{{data.multiLineText}}
setProperty 设置与 getPropertyValue 获取
white-space
设置值: {{data.whiteSpace}}
获取值: {{data.whiteSpaceActual}}
{{data.multiLineText}}
拍平
设置值: {{data.whiteSpace}}
获取值: {{data.whiteSpaceActualFlat}}
{{data.multiLineText}}
第一个枚举值,'' (空字符串) - 空值情况
```
:::
### 参见
- [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/white-space)
- [相关 Bug](https://issues.dcloud.net.cn/?mid=css.properties.text.white-space)