如何将Sitecore Search facet过滤器从多选改为单选？

数据老陈

2026-6-29

要把默认的多选facet改成单选，核心是点击新选项时替换该facet下的所有选中值，而非累加。以下两种方法均可实现需求：

方法1：直接替换选中值数组（推荐）

利用onFacetClick的type: 'valueIds'参数，直接将该facet的选中值数组设置为仅包含当前点击的ID，一步完成单选逻辑：

<button onClick={() => {
  onFacetClick({
    facetId: 'article_type',
    type: 'valueIds',
    valueIds: [selectedArticleTypeValue?.id], // 仅保留当前选中的单个ID
    facetIndex: 0,
  });
}}>
  {jobFacet?.text}
</button>

方法2：先取消已有选中项，再选中当前项

如果需要更精细的控制，可以先取消该facet下所有已选中的选项，再选中当前点击的选项：

// 先通过useSearch获取当前搜索状态（需确保已引入该hook）
const { searchState } = useSearch();

<button onClick={() => {
  // 找到当前facet下已选中的所有值ID
  const existingSelectedIds = searchState.facets?.find(f => f.id === 'article_type')?.selectedValueIds || [];
  
  // 逐个取消已选中的选项
  existingSelectedIds.forEach(id => {
    onFacetClick({
      facetValueId: id,
      facetIndex: 0,
      facetId: 'article_type',
      type: 'valueId',
      checked: false,
    });
  });
  
  // 选中当前点击的选项
  onFacetClick({
    facetValueId: selectedArticleTypeValue?.id,
    facetIndex: 0,
    facetId: 'article_type',
    type: 'valueId',
    checked: true,
  });
}}>
  {jobFacet?.text}
</button>