xs:whitespace facet 用于控制xml元素文本中空白字符的处理,仅适用于simpletype且须配合xs:restriction;取值为preserve(原样保留)、replace(换行制表符转空格)、collapse(默认,先replace再压缩首尾及连续空白)。

xs:whiteSpace facet 用于控制 XML 元素文本内容中空白字符(空格、制表符、换行符等)的处理方式,它只适用于简单类型(simpleType),且必须配合 xs:restriction 使用。
三种取值及其效果
xs:whiteSpace 只接受以下三个字符串值,每种都会改变解析器对空白的“保留”或“归一化”行为:
- preserve:原样保留所有空白字符,包括开头、中间、结尾的空格和换行。适合需要精确格式的场景,比如代码块、诗歌、日志行。
-
replace:把所有制表符(
\t)、换行(\n、\r)统一替换成空格,但不合并或删减空格数量。 - collapse:先执行 replace,再将连续多个空白字符(含空格)压缩成单个空格,并自动去掉首尾空白。这是默认行为(即使不显式声明,也等效于 collapse)。
实际写法示例
下面定义一个姓名字段,要求严格保留用户输入的换行和缩进:
<xs:element name="bio">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="preserve"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
而如果用于普通地址字段,希望忽略多余空格,可显式写为:
<xs:restriction base="xs:string"> <xs:whiteSpace value="collapse"/> </xs:restriction>
注意事项
这个 facet 不能用在属性上,仅限元素的内容;也不能和 xs:pattern 或其他 facet 冲突使用——例如,若已用 xs:pattern 要求“非空字符串”,又设 whiteSpace="collapse",那输入纯空白会被压缩为空串,导致校验失败。
另外,它影响的是验证阶段的值归一化行为,不是序列化输出格式。也就是说,XML 实际怎么存,还是看文档本身;XSD 只规定“解析时该怎么理解这些空白”。
基本上就这些。










