如何：为内容查询 Web 部件自定义 XSL

上次修改时间： 2015年3月9日

适用范围： SharePoint Server 2010

可以使用内容查询 Web 部件聚合来自网站中多个数据源的内容，然后将其全部呈现在一个位置。配置和自定义内容查询 Web 部件之前，应考虑想实现的品牌和网站设计。Microsoft SharePoint Server 2010 包含三个您可以修改的可扩展样式语言 (XSL) 文件，通过修改这些文件，您可以使用内容查询 Web 部件用于显示它聚合的内容的样式来呈现字段。

本主题指出内容查询 Web 部件使用的三个 XSL 文件，并说明它们的工作原理；另外还指出您可以修改的模板和变量，并说明如何修改这些文件，以便内容查询 Web 部件呈现具有您指定的外观和行为的数据。

下表列出并说明了三个用于描述内容查询 Web 部件的 XSL 文件。

默认情况下，ItemStyle.xsl 和 Header.xsl 文件中包含下列模板。Header.xsl 文件包含组样式定义，而 ItemStyle.xsl 文件包含应用于内容查询 Web 部件中的行项目的定义。这些样式对应于"组样式"和"项目样式"下拉列表（当您在"样式库"中选择样式时出现）中的可用选项。

每个模板均包含两部分处理指令：

• 处理数据和确保正确格式化的 <xsl:variable> 部分。

• 呈现 HTML 并包含数据的 <div> 部分。

以下是 ImageRight 模板的模板代码（带有注释）：

///Declares an XSL template named ImageRight that

///processes row style elements defined as ImageRight.

- <xsl:template name="ImageRight" match="Row[@Style='ImageRight']"
mode="itemstyle">

///The <xsl:variable> sections process and ensure correct formatting of the data.

///This section declares the variable named SafeLinkUrl, includes instructions to call the OuterTemplate.GetSafeLink function, and includes the LinkUrl expression to scope the call to the UrlColumnName parameter.
  - <xsl:variable name="SafeLinkUrl">
       /// The OuterTemplate.GetSafeLink variable passes in the UrlColumnName that represents the column name containing the ItemUrl.
    - <xsl:call-template name="OuterTemplate.GetSafeLink">
        <xsl:with-param name="UrlColumnName" select="'LinkUrl'" />
      </xsl:call-template>
    </xsl:variable>

///This section declares the variable named SafeImageUrl and calls the OuterTemplate.GetSafeStaticUrl function.
  - <xsl:variable name="SafeImageUrl">
    - <xsl:call-template name="OuterTemplate.GetSafeStaticUrl">
        <xsl:with-param name="UrlColumnName" select="'ImageUrl'" /> 
      </xsl:call-template>
    </xsl:variable>

///This section declares the variable named SafeImageHtml and calls the OuterTemplate.GetColumnDataForUnescapedOutput function, and passes the 'PublishingRollupImage' and 'Image' parameter values to the template rule.
  - <xsl:variable name="SafeImageHtml">
    - <xsl:call-template name="OuterTemplate.GetColumnDataForUnescapedOutput">
        <xsl:with-param name="Name" select="'PublishingRollupImage'" /> 
        <xsl:with-param name="MustBeOfType" select="'Image'" /> 
      </xsl:call-template>
    </xsl:variable>

///This section declares the variable named DisplayTitle, includes calls to the OuterTemplate.GetTitle function, and passes the @Title and 'LinkUrl' parameter values to the template rule.
  - <xsl:variable name="DisplayTitle">
    - <xsl:call-template name="OuterTemplate.GetTitle">
        <xsl:with-param name="Title" select="@Title" /> 
        <xsl:with-param name="UrlColumnName" select="'LinkUrl'" /> 
      </xsl:call-template>
   </xsl:variable>

///This section declares the variable named LinkTarget and tests whether it should open the target URL in a new window. If the test returns True, then the template rule processes the instruction to open the target URL in a new window.
  - <xsl:variable name="LinkTarget">
      <xsl:if test="@OpenInNewWindow = 'True'">_blank</xsl:if> 
    </xsl:variable>

///The <div> sections define the data to render and provide instructions on how to render it. This code block defines item data, and uses the OuterTemplate.CallPresenceStatusIconTemplate function to verify whether it should create an icon.
- <div class="item">
    <xsl:call-template name="OuterTemplate.CallPresenceStatusIconTemplate" />
///The <xsl:if test> instruction supplies a condition for the XSLT engine to evaluate. If the test evaluates to True after converting it to a Boolean value, the ItemStyle renders the content.
    - <xsl:if test="string-length($SafeImageUrl) = 0 and string-length($SafeImageHtml) != 0">
      - <div class="image-area-right">
          <xsl:value-of disable-output-escaping="yes" select="$SafeImageHtml" /> 
        </div>
      </xsl:if>
    - <xsl:if test="string-length($SafeImageUrl) != 0">
      - <div class="image-area-right">
        - <a href="{$SafeLinkUrl}" target="{$LinkTarget}">
            <img class="image" align="left" border="0"   src="{$SafeImageUrl}" alt="{@ImageUrlAltText}" /> 
          </a>
        </div>
      </xsl:if>
  - <div class="link-item">
    - <a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@LinkToolTip}">
       <xsl:value-of select="$DisplayTitle" /> 
      </a>
      - <div class="description">
          <xsl:value-of select="@Description" /> 
        </div>
     </div>
  </div>
  </xsl:template>

SharePoint Server 2010 XSL 文件的 <xsl:variables> 部分中可使用多个函数，如下表中所示。

添加内容查询 Web 部件并自定义内容查询 Web 部件 XSL

1. 导航到网站的主页，单击"网站操作"，再单击"编辑网页"，以在编辑模式下签出网页。

2. 在某个"Web 部件区域"中，单击"添加 Web 部件"，然后选择并添加一个内容查询 Web 部件。

3. 单击"编辑"，再单击"修改共享 Web 部件"。

4. 根据需要修改属性以及将字段添加到内容查询 Web 部件中。有关详细信息，请参阅如何：使用自定义属性自定义内容查询 Web 部件。

   备注

   当您修改内容查询 Web 部件时，"样式"部分中有两个下拉列表：一个用于"组"样式，另一个用于"项目"样式。这些列表项都是由 ItemStyle.xsl 和 Header.xsl 文件中的模板定义的。

5. 使用本主题中的参考信息作为指南，通过编辑 XSL 来修改 select 语句、变量和表达式的值。例如，可以修改 <div> 部分中的 select 语句的值，以指示表达式解析到另一个变量。

创建项目样式

1. 找到与您要创建的样式类似的样式。

2. 复制该样式，并更改 name 和 match 属性值：

   <xsl:template name="ImageRight" match="Row[@Style='ImageRight']" mode="itemstyle">
   <xsl:template name="ImageRight2" match="Row[@Style='ImageRight2']" mode="itemstyle">
   

请参阅

任务

如何：使用自定义属性自定义内容查询 Web 部件

如何：自定义内容查询 Web 部件的 RSS

如何：在内容查询 Web 部件中显示自定义字段