如何在内容为空时隐藏SharePoint Content Query Web部件？是否有对应属性？

嘿，针对你问的这个问题，我整理了实用的解决方法，还有关于专属属性的说明：

一、空内容时隐藏的实现方法 #

1. 修改CQWP的XSL模板（推荐原生方案） #

这是最贴合SharePoint原生机制的方法，因为CQWP的内容渲染完全依赖XSLT：

• 编辑目标CQWP，在“XSL链接”字段找到默认使用的XSL文件路径（通常是Style Library/XSL Style Sheets/ContentQueryMain.xsl），把这个文件下载到本地。
• 打开下载的XSL文件，找到核心的ContentQueryMain模板（这是负责渲染整个Web部件内容的模板）。
• 在模板的最开头添加判断逻辑，只有当返回的项目数量大于0时，才渲染Web部件内容：

<xsl:template name="ContentQueryMain">
  <!-- 新增：判断是否有返回内容 -->
  <xsl:if test="$Rows/@Count &gt; 0">
    <!-- 这里保留原来模板里的所有渲染代码 -->
    <div id="WebPartWPQ" class="ms-webpartzone-cell ms-webpart-cell-vertical ms-fullWidth">
      <!-- 原有的标题、内容区域等代码 -->
    </div>
  </xsl:if>
</xsl:template>

• 将修改后的XSL文件上传回SharePoint的样式库中，然后回到Web部件编辑界面，把“XSL链接”指向这个修改后的文件，保存设置即可。

2. 使用JavaScript/jQuery快速实现 #

如果不想修改XSL，可以在页面中嵌入脚本，通过DOM检查来隐藏空内容的CQWP：

// 等待页面加载完成
document.addEventListener('DOMContentLoaded', function() {
  // 替换成你的CQWP的实际ID（可以通过浏览器开发者工具查看）
  const cqwpElement = document.getElementById('WebPartWPQ2');
  if (!cqwpElement) return;
  
  // 检查Web部件的内容区域是否为空（根据实际DOM结构调整选择器）
  const contentArea = cqwpElement.querySelector('.ms-contentareaseparator').nextElementSibling;
  if (contentArea && contentArea.children.length === 0) {
    cqwpElement.style.display = 'none';
  }
});

如果你的页面已经加载了jQuery，也可以用更简洁的写法：

$(function() {
  const $cqwp = $('#WebPartWPQ2');
  if ($cqwp.find('.ms-contentareaseparator').siblings().length === 0) {
    $cqwp.hide();
  }
});

二、是否存在专属Web部件属性？ #

很遗憾，SharePoint原生的Content Query Web部件没有内置的专属属性可以直接设置“空内容时自动隐藏”。这个需求需要通过上面的XSL修改或者脚本注入的方式来实现。

如果是使用SharePoint Online的现代页面，建议考虑替换为Highlighted Content Web部件，它自带“无内容时隐藏”的配置选项，比经典的CQWP更灵活。

内容的提问来源于stack exchange，提问作者Vish