Microsoft Graph Toolkit React组件 (mgt-react) 允许React开发人员在应用程序Graph Toolkit Microsoft React。 该库包装所有 Microsoft Graph Toolkit组件,并导出为React组件。
可以使用哪些组件?
该库从 Microsoft Graph Toolkit Web 组件自动生成,并且所有组件都作为React组件。
这些React的名称在 PascalCase 中,不包含Mgt前缀。 例如,组件 mgt-person 可用为 , Person组件 mgt-people-picker 为 PeoplePicker。
安装
若要安装,请使用以下命令之一。
npm install @microsoft/mgt-react
或者
yarn add @microsoft/mgt-react
用法
所有组件都可通过 npm 包使用 PascalCase 进行命名。 若要使用组件,请首先将其导入到顶部。
import { Person } from '@microsoft/mgt-react';
现在,你可以将 Person JSX 中的任何位置用作常规React组件。
<Person personQuery="me" />
所有属性和事件与组件文档中的定义完全一样。
例如,可以将属性 personDetails 设置为对象:
const App = (props) => {
const personDetails = {
displayName: 'Bill Gates',
};
return <Person personDetails={personDetails}></Person>;
};
或者,注册事件处理程序:
import { PeoplePicker, People } from '@microsoft/mgt-react';
const App = (props) => {
const [people, setPeople] = useState([]);
const handleSelectionChanged = (e) => {
setPeople(e.target.selectedPeople);
};
return
<div>
<PeoplePicker selectionChanged={handleSelectionChanged} />
Selected People: <People people={people} />
</div>;
};
模板
大多数 Microsoft Graph Toolkit 组件都mgt-react支持模板,并允许你React模板。
例如,若要创建模板以用于在 mgt-agenda 组件中呈现事件,请首先定义用于呈现事件的组件:
import { MgtTemplateProps } from '@microsoft/mgt-react';
const MyEvent = (props: MgtTemplateProps) => {
const { event } = props.dataContext;
return <div>
{event.subject}<br />
{event.attendees
.map((attendee: any) => attendee.emailAddress.name)
.join(', ')}
</div>;
};
然后,使用它作为封装组件的子项,然后将模板属性设置为 event。
import { Agenda } from '@microsoft/mgt-react';
const App = (props) => {
return <Agenda>
<MyEvent template="event">
</Agenda>
}
属性 template 允许您指定要覆盖的模板。 在这种情况下,将 MyEvent 针对每个事件重复 event 组件,并且对象将作为属性的一部分 dataContext 传递。
另请参阅
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 sebastienlevert)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
