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保持一致即可。
你可以直接在现有代码基础上调整:
- 给内层的
PersonCard组件加上slot="person-card",告知外层Person组件,这个卡片组件要替换默认的弹出卡片插槽 - 把你要自定义的附加详情块加上
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
相关产品推荐
相关产品推荐

