XML / XSD - 添加说明

时间:2015-01-21 10:44:58

标签: xml xsd documentation editor

使用XSD,我可以确保XML文件有效,但是还有一种方法,使用XSD将信息附加到元素和属性,以便打开XML和XSD文件的软件能够显示用户点击正在描述的元素时的描述?

1 个答案:

答案 0 :(得分:5)

您正在描述 xsd:documentation 元素。

xsd:documentationxsd:appinfo都可以包含在xsd:annotation元素中:

  • 使用xsd:documentation 用户 提供元信息。
  • 使用xsd:appinfo 应用 提供元信息。

W3C XML Schema Part 0: Primer Second Edition介绍了注释here,其中提供了以下如何使用xsd:documentation的示例:

<xsd:element name="internationalPrice">
  <xsd:annotation>
    <xsd:documentation xml:lang="en">
         element declared with anonymous type
    </xsd:documentation>
  </xsd:annotation>
  <xsd:complexType>
    <xsd:annotation>
      <xsd:documentation xml:lang="en">
           empty anonymous type with 2 attributes
      </xsd:documentation>
    </xsd:annotation>
    <xsd:complexContent>
      <xsd:restriction base="xsd:anyType">
        <xsd:attribute name="currency" type="xsd:string"/>
        <xsd:attribute name="value"    type="xsd:decimal"/>
      </xsd:restriction>
    </xsd:complexContent>
  </xsd:complexType>
</xsd:element>