[2] [CODE(URI)@en[[[DAV:]]]] [[名前空間]]の [DFN[[CODE(XMLe)@en[[[prop]]]]]]
[[要素]]は、 [[資源]]に関する[[特性]]群を含めるもの [SRC[>>1]] です。

* 仕様書

[REFS[
- [1] '''[CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.18>'''
- [6] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.20>
- [9] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.22>
- [7] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.23>
- [11] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.26>
- [13] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-17>
]REFS]

* 構文

[3] [CODE(XMLe)@en[[[prop]]]] [[要素]]の[[子要素]]は、すべて[[資源]]に関する[[特性]]を定義するもの ([[特性名要素]]) でなければ[['''なりません''']] [SRC[>>1]]。

[4] [[テキスト]]を含めては[['''なりません''']] [SRC[>>1]]。

;; [5] [[要素間空白]]が認められるかは不明です。

[FIG(railroad)[
= *
== [[特性名要素]]
]FIG]

[14] 順序は意味を持ちません [SRC[>>13]]。

* 文脈

[8] [CODE(XMLe)@en[[[propfind]]]] [[要素]] [SRC[>>6]] や
[CODE(XMLe)@en[[[remove]]]] [[要素]] [SRC[>>7]] の[[子要素]]として使えます。
その場合[[特性]]の値を含んでは[['''なりません''']] [SRC[>>6, >>7]]。

[10] [CODE(XMLe)@en[[[propstat]]]] [[要素]]の[[子要素]]として使えます [SRC[>>9]]。
その場合 [CODE(XMLe)@en[[[status]]]] [[要素]]が適用される[[特性]]のみ含まなければ[['''なりません''']] [SRC[>>9]]。

[12] [CODE(XMLe)@en[[[set]]]] [[要素]]の[[子要素]]として使えます [SRC[>>11]]。
その場合設定する[[特性]]の名前と値を含めなければなりません。

[15] [CODE(HTTP)@en[[[LOCK]]]] [[要求]]に対する成功の[[応答]]の[[根要素]]としても用いられます。
その場合 [CODE(URI)@en[[[DAV:lockdiscovery]]]] [[特性]]が含まれることが求められています。

* 歴史

[FIG(quote)[
[FIGCAPTION[
[23] RFC 2518 (WebDAV) 12.11 prop XML element
]FIGCAPTION]

>
:   Name:       prop
:   Namespace:  DAV:
:   Purpose:    Contains properties related to a resource.
:   Description: The prop XML element is a generic container for
properties defined on resources.  All elements inside a prop XML
element MUST define properties related to the resource.  No other
elements may be used inside of a prop element.

:目的:資源に関係する[[特性]]を含める。
:説明:[CODE(DAVe)[prop]] XML 要素は、資源に定義された特性の汎用包含器です。
[CODE(DAVe)[prop]] XML 要素の内側の全ての要素はその資源に関する特性を定義しなければ'''なりません'''。
他の要素は [CODE(DAVe)[prop]] 要素の内側で使うことはできません。

>   <!ELEMENT prop ANY>
]FIG]