<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<control xmlns="http://www.sap.com/sap.ui.library.xsd">
    <name>CustomData</name>
    <derived/>
    <documentation>Contains a single key/value pair of custom data attached to an &lt;code&gt;Element&lt;/code&gt;.</documentation>
    <baseType>sap.ui.core/Element</baseType>
    <properties>
        <property name="id" type="sap.ui.core/ID">
            <documentation>The unique identifier within a page, either configured or automatically generated.</documentation>
        </property>
        <property name="key" type="sap.ui.core/string" group="Data">
            <documentation>The key of the data in this CustomData object.
When the data is just stored, it can be any string, but when it is to be written to HTML
(&lt;code&gt;writeToDom == true&lt;/code&gt;) then it must also be a valid HTML attribute name.
It must conform to the {@link sap.ui.core.ID} type and may contain no colon. To avoid collisions,
it also may not start with "sap-ui". When written to HTML, the key is prefixed with "data-".
If any restriction is violated, a warning will be logged and nothing will be written to the DOM.</documentation>
        </property>
        <property name="value" type="sap.ui.core/any" group="Data">
            <documentation>The data stored in this CustomData object.
When the data is just stored, it can be any JS type, but when it is to be written to HTML
(&lt;code&gt;writeToDom == true&lt;/code&gt;) then it must be a string. If this restriction is violated,
a warning will be logged and nothing will be written to the DOM.</documentation>
        </property>
        <property name="writeToDom" type="sap.ui.core/boolean" defaultValue="false" group="Data" since="1.9.0">
            <documentation>If set to "true" and the value is of type "string" and the key conforms to the documented restrictions,
this custom data is written to the HTML root element of the control as a "data-*" attribute.
If the key is "abc" and the value is "cde", the HTML will look as follows:

&amp;lt;SomeTag ... data-abc="cde" ... &amp;gt;

Thus the application can provide stable attributes by data binding which can be used for styling or
identification purposes.

&lt;b&gt;ATTENTION:&lt;/b&gt; use carefully to not create huge attributes or a large number of them.</documentation>
        </property>
    </properties>
</control>
