You need to enable JavaScript to run this app. Microsoft Graph Toolkit:React版如何为Person卡片添加自定义详情?
优惠活动
大模型
产品
解决方案
定价
更多

Microsoft Graph Toolkit:React版如何为Person卡片添加自定义详情?

React 场景下 MGT Person 卡片自定义附加详情的实现方法

核心原理

你参考的原生 Web Components 实现中,两层<template>标签本质是具名插槽机制:

  • 外层带data-type="person-card"的模板,作用是替换Person组件默认的弹出卡片内容
  • 内层带data-type="additional-details"的模板,作用是在Person卡片的附加详情区域插入自定义内容
    MGT的React封装组件完全兼容这套插槽逻辑,你当前代码的问题是没有正确把自定义内容映射到对应的插槽位置,导致内容无法渲染在弹出卡片内部。

分版本实现方案

方案1:适配 MGT React v3+ 版本(支持原生 slot 属性映射)

这个版本的MGT React组件和原生Web Components的插槽规则完全对齐,只需要在对应元素上加上slot属性,值和原生模板的data-type保持一致即可。
你可以直接在现有代码基础上调整:

  1. 给内层的PersonCard组件加上slot="person-card",告知外层Person组件,这个卡片组件要替换默认的弹出卡片插槽
  2. 把你要自定义的附加详情块加上slot="additional-details",作为PersonCard的子元素传入,这部分内容就会自动渲染到卡片的附加详情区域

调整后的代码:

<Person 
  userId={val.person} 
  view={cf.GetPersonViewMode(this.props.roleSize)} 
  fetchImage={true} 
  showPresence={true}
  personCardInteraction={PersonCardInteraction.hover} 
  line2Property="mail"
>
  <PersonCard 
    inheritDetails={true}
    slot="person-card"
  >
    {/* 自定义附加详情,带上对应的slot属性 */}
    <div slot="additional-details">
      <h3>Stuffed Animal Friends:</h3>
      <ul>
        <li>Giraffe</li>
        <li>lion</li>
        <li>Rabbit</li>
      </ul>
    </div>
  </PersonCard>
</Person>

方案2:适配 MGT React v2 及以下旧版本

旧版本的MGT React没有开放原生插槽的属性支持,是通过专用的模板prop传递自定义内容,不需要嵌套子元素加slot属性:

<Person 
  userId={val.person} 
  view={cf.GetPersonViewMode(this.props.roleSize)} 
  fetchImage={true} 
  showPresence={true}
  personCardInteraction={PersonCardInteraction.hover} 
  line2Property="mail"
  {/* 对应person-card插槽,传入自定义的PersonCard组件 */}
  personCardTemplate={
    <PersonCard 
      inheritDetails={true}
      {/* 对应additional-details插槽,传入自定义的详情内容 */}
      additionalDetailsTemplate={
        <>
          <h3>Stuffed Animal Friends:</h3>
          <ul>
            <li>Giraffe</li>
            <li>lion</li>
            <li>Rabbit</li>
          </ul>
        </>
      }
    />
  }
/>

常见踩坑提醒

  • 必须保留inheritDetails={true}属性,该属性会让PersonCard自动复用外层Person组件已经拉取的用户数据,避免重复发起用户信息请求
  • 自定义内容一定要绑定对应的插槽规则,否则内容会直接渲染在Person组件的实体位置,而不是出现在弹出的卡片内部
  • 自定义的附加详情内容可以直接写常规的JSX逻辑,包括接入状态、绑定事件、引入其他React组件,不需要适配特殊的模板语法

内容的提问来源于stack exchange,提问作者Frank-Ove Kristiansen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 03:06:00