2.0.2 • Published 1 year ago

@mgcm/react v2.0.2

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
1 year ago

@mgcm/react

@mgcm/react

This is package that provides a Widget API intergration for React apps.

Usage

Install it with:

yarn add @mgcm/react

Providing the Widget API to React components

While this package contains a <WidgetApiProvider> you probably don't want to use this package most of the time. Prefer using @mgcm/mui which internally use this package to share functionality.

Acessing the Widget API

Once the Widget API is provided to React components, use the useWidgetApi hook to access it:

import { useWidgetApi } from '@mgcm/react';

const widgetApi = useWidgetApi();

Mocking the Widget API

Most of the time you will use <MuiWidgetApiProvider> to initialize and provide the WidgetApi to your react components. However, if you want to mock it in tests, you can use <WidgetApiMockProvider> to provide a mocked version:

import { WidgetApiMockProvider } from '@mgcm/react';

<WidgetApiMockProvider value={widgetApi}>
  /* Your child components */
</WidgetApiMockProvider>;