Global attributes for HTML-rendering elements
Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
The View schema of Collaborative Application Markup Language (CAML) provides several universal attributes that can be used to describe any CAML rendering element. These attributes can be implemented in standard and specialized elements in the View schema.
Note
The presence of any one of these attributes implies that it is TRUE (for example, HTMLEncode cannot be set to FALSE).
Universal attributes include the following.
AutoHyperLink
When TRUE, scans the rendering for strings that appear to be hyperlinks (for example, www.microsoft.com
). When it finds these strings, it automatically adds an appropriate <A>
tag around the text so that the user can follow the hyperlink. HTMLEncode is assumed TRUE when AutoHyperLink is set to TRUE.
AutoNewLine
When TRUE, inserts <BR>
tags into the text stream and replaces multiple spaces with a nonbreaking space (
). AutoHyperLink must be TRUE for this attribute to take effect. HTMLEncode is assumed TRUE when AutoNewLine is set to TRUE.
Default
If the spanned text is nothing, render this text instead. For example, <ows:XML><ListProperty Select="Description" Default="This list has no description"/></ows:XML>
. The previous example renders the default text if there is no description for the list in question.
ExpandXML
When TRUE, reviews the rendered content and sends it on another pass through the CAML interpreter. This allows CAML to render CAML.
HTMLEncode
When TRUE, converts any embedded characters so that they are all displayed as text in the browser. This means that any characters that could be confused with HTML tags are converted to entities such as &gt;
instead of >
.
StripWS
When TRUE, strips whitespace from the beginning and end of an element. For example, <ows:XML StripWS="TRUE"> Microsoft </ows:XML>
renders "Microsoft" without surrounding spaces.
URLEncode
When TRUE, converts special characters, such as spaces, to quoted UTF-8 format (for example, %c3%ab
for character ë
).
URLEncodeAsURL
Similar to URLEncode, but assumes that what is being encoded is a path component of a URL. For example, <ows:XML URLEncodeAsURL="TRUE">SharePoint website</ows:XML>
renders SharePoint%20website
. This attribute, unlike URLEncode, does not encode the forward slash (/
).