将注释文档添加到 XSD 子元素

Question

我想向 XSD 子元素添加注释文档：

例如：

<xsd:complexType name="XY">
    <xsd:sequence>
        <xsd:element type="xType" name="x"/>
            <xsd:annotation>
                <xsd:documentation> I want to add a description here. 
                </xsd:documentation>
            </xsd:annotation>
        <xsd:element type="yType" name="y"/>
    </xsd:sequence>
    <xsd:attribute type="xsd:string" name="NAME" use="required"/>
</xsd:complexType>

显然不行。

有没有办法明确定义子元素的文档

Answer 1

不要告诉我们它不起作用，告诉我们它是如何失败的！

我看不出您的代码应该失败的任何原因（更不用说任何“明显”的原因）。当然，它包含对未声明类型的引用。以下示例工作正常：

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    
    <xs:element name="X">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="a" type="xs:string">
                    <xs:annotation>
                        <xs:documentation>Great!</xs:documentation>
                    </xs:annotation>
                </xs:element>
            </xs:sequence>
            <xs:assert test="matches(a, '^(hello|world)$', 'm')"/>                                           
        </xs:complexType>
    </xs:element>
    
</xs:schema>

将注释文档添加到 XSD 子元素

Add annotation-documentation to XSD child element

xml

xsd

xsd-1.1