如何声明具有两组不同属性的 xs:element？

Question

我的新 XML 私人语言包含元素 <figure>，表示插图（图像 + 标题）。

每当插图引用本地数据库中的某些图像时，我只想输入

<figure id="9809" width="full" />

识别图像编号 9809 及其相关说明。

另一方面，如果图像来自外部，我将需要稍微不同的语法：

<figure href="https://some-url-here" width="full">Some ad hoc catpion</figure>

到目前为止，我已经声明了一个结合了这两种行为的元素，如下所示：

  <!-- Figures -->
  <xs:simpleType name="FigureWidthEnum">
    <xs:restriction base="xs:token">
      <xs:enumeration value="center" />
      <xs:enumeration value="half" />
      <xs:enumeration value="full" />
    </xs:restriction>
  </xs:simpleType>

  <xs:element name="figure">
    <xs:complexType mixed="true">
      <xs:complexContent>
        <xs:extension base="Inline">
          <xs:attribute name="href" type="URI" />
          <xs:attribute name="id" type="xs:nonNegativeInteger" />
          <xs:attribute name="width" type="FigureWidthEnum" default="full" />
        </xs:extension>
      </xs:complexContent>
    </xs:complexType>
  </xs:element>

它工作正常，但一个新的编辑器可能会弄乱 3 个属性并键入不可能的东西我不想那么容易地通过架构验证器。例如：

<figure id="9809" width="full" href="https://some-unexpected-url">Some unexpected caption that should not be here</figure>

我想要 <figure> 有两个完全独立的语法，就好像我可以用相同的名称声明这两个元素：

  <xs:element name="figure">
    <xs:complexType mixed="true">
      <xs:complexContent>
        <xs:extension base="Inline">
          <xs:attribute name="href" type="URI" />
          <xs:attribute name="width" type="FigureWidthEnum" default="full" />
        </xs:extension>
      </xs:complexContent>
    </xs:complexType>
  </xs:element>

  <xs:element name="figure">
    <xs:complexType>
      <xs:attribute name="id" type="xs:nonNegativeInteger" />
      <xs:attribute name="width" type="FigureWidthEnum" default="full" />
    </xs:complexType>
  </xs:element>

事实上这是不可能的。

能以某种方式完成吗？

Answer 1

是的，XSD 1.1 是可能的，它提供了专门针对此类要求的 <xs:alternative> 元素。这是我设计的完整 XML 模式，可以完全按照您的需要进行验证：

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns:vc="http://www.w3.org/2007/XMLSchema-versioning"
           vc:minVersion="1.1">

  <!-- Figures -->
  <xs:simpleType name="FigureWidthEnum">
  <xs:restriction base="xs:token">
    <xs:enumeration value="center" />
      <xs:enumeration value="half" />
      <xs:enumeration value="full" />
    </xs:restriction>
  </xs:simpleType>

  <!-- stub definition -->
  <xs:complexType name="Inline"/>

  <!-- 'figure' element is declared once, but its type has two alternatives -->
  <xs:element name="figure">

    <!-- The first alternative is selected, when the condition specified
     in 'test' attribute is true. The condition must be a boolean XPath
     expression. The '@id' returns the value of 'id' attribute. However,
     when converted to boolean, it indicates whether 'id' attribute is
     specified at all. The anonymous complexType inside <xs:alternative>
     provides the element type valid for this case.
    -->
    <xs:alternative test="@id">
      <xs:complexType>
        <xs:attribute name="id" type="xs:nonNegativeInteger" />
        <xs:attribute name="width" type="FigureWidthEnum" default="full" />
      </xs:complexType>
    </xs:alternative>

    <!-- The second alternative has no 'test' attribute. That means, it must
     be selected by default, when all other alternatives (with a specified
     test condition) do not pass. Here, the anonymous complexType inside
     <xs:alternative> defines the element type in case of reference:
     when 'href' is present.
    -->
    <xs:alternative>
      <xs:complexType mixed="true">
        <xs:complexContent>
          <xs:extension base="Inline">
            <xs:attribute name="href" type="xs:anyURI" />
            <xs:attribute name="width" type="FigureWidthEnum" default="full" />
          </xs:extension>
        </xs:complexContent>
      </xs:complexType>
    </xs:alternative>
  </xs:element>

  <!-- this element is defined just to test the whole schema in XML below -->
  <xs:element name="figures">
    <xs:complexType>
      <xs:sequence>    
        <xs:element ref="figure" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>    
    </xs:complexType>
  </xs:element>

</xs:schema>

此架构验证的完整 XML 文件：

<?xml version="1.0" encoding="UTF-8"?>
<figures>

  <!-- passes validation -->
  <figure id="9809" width="full" />

  <!-- passes validation -->
  <figure width="full" href="https://some-unexpected-url">Some ad hoc caption</figure>

  <!-- does not pass the validation -->
  <figure id="9809" width="full" href="https://some-unexpected-url">
    Some unexpected caption that should not be here
  </figure>

</figures>

验证是使用 Apache Xerces 2.11.0（XSD 1.1 感知）完成的。

促销插件。对于使用 XML 模式和 WSDL 的人来说，这些链接可能会很有趣：FlexDoc/XML XSDDoc & WSDLDoc – 高性能通用 XML 带有图表的模式/WSDL 文档生成器

如何声明具有两组不同属性的 xs:element？

How to declare an xs:element with two different sets of attributes?

schema

xsd