SPFx Material-UI Component Library


This is a SharePoint Framework (SPFx) component library built using Material-UI (MUI). It provides reusable React components for building modern and visually appealing user interfaces in SharePoint.

Deployment

A .sppkg solution package is available in Releases. You can upload this package to your SharePoint App Catalog for direct deployment.

This package includes built-in configurable web parts, making it easy to use without additional development.

Installation

To install this component library in your SPFx project, you can use npm:

``bash
npm install mui-spfx-controls --save
`

Usage

Once installed, you can import and use the components in your SPFx web part or extension. Alternatively, prebuilt webparts can be used after deploying solution to site's AppCatalog. For example:

$3

!Explorer

A document library explorer component for traversing SharePoint libraries.

$3

- context (required): SP context
- library (required): Required library to traverse
- defaultDisplayType (optional): View type Grid or List
- height (optional): Height of the container
- onFileOpen (optional): Triggers when file is clicked

`jsx
import * as React from 'react';
import { Explorer } from 'mui-spfx-controls';

const ExplorerWebPart = ({ context, library }) => {
return (
context={context}
library={library}
defaultDisplayType="grid"
height={750}
/>
);
};

export default ExplorerWebPart;
`

$3

!Code Editor

A code editor component powered by Monaco Editor with MUI integration.

#### Props

- renderControls (optional): Render controls for the editor

`jsx
import * as React from 'react';
import { CodeEditor } from 'mui-spfx-controls';

const CodeEditorWebPart = () => {
return ;
};

export default CodeEditorWebPart;
`

---

$3

!Site Breadcrumb

$3

A breadcrumb component for nested multi level deep SharePoint sites.

#### Props

- context (required): SP context

`jsx
import * as React from 'react';
import { SiteBreadcrumb } from 'mui-spfx-controls';

const SiteBreadcrumbWebPart = ({ context }) => {
return ;
};

export default SiteBreadcrumbWebPart;
`

---

$3

!People Picker

A SharePoint people picker component with MUI library integration

#### Props

- context (required): SP context
- label (required): Textfield label
- onSelectionChange (optional): Get selection value updates
- searchSuggestionLimit (optional): number of suggestions to provide
- multiple (optional): single/multi select
- disabled (optional): Is component disabled
- variant (optional): Textfield variant ('standard', 'outlined', 'filled')
- tagVariant (optional): Chip variant ('filled', 'outlined')
- color (optional): Button color, e.g., "primary" or "secondary"
- tagColor (optional): Chip color, e.g., "default" or "secondary"
- size (optional): Size of component
- LoadingComponent (optional): A loading component
- renderInput (optional): Render a custom input component
- sx (optional): MUI's sx prop

`jsx
import * as React from 'react';
import { PeoplePicker } from 'mui-spfx-controls';

const PeoplePickerWebPart = ({ context }) => {
return (
context={context}
label="People"
size="small"
disabled={false}
variant="outlined"
tagVariant="filled"
color="primary"
tagColor="secondary"
/>
);
};

export default PeoplePickerWebPart;
`

---

$3

!Dashboard

A dashboard component with MUI Data Grid

#### Props

- context (required): SP context
- list (required): SharePoint list to pull data from
- fields (required): Internal Name of fields to display in dashboard
- columnAction (optional): Enable/Disable column on/off feature
- densityAction (optional): Enable/Disable column density
- filterAction (optional): Enable/Disable filtering
- exportAction (optional): Enable/Disable export functionality
- searchAction (optional): Enable/Disable search functionality
- tabAction (optional): Enable/Disable tab feature
- tabValue (required if tabAction is true): Array object for Tabs
- editable (optional): Enable/Disable editing feature
- resizable (optional): Enable/Disable column resizing
- height (optional): Absolute or relative container height
- sx (optional): MUI's sx prop

`jsx
import * as React from 'react';
import { Dashboard } from 'mui-spfx-controls';

const DashboardWebPart = ({ context }) => {
return (
context={context}
list="ListName"
fields={['Field1', 'Field2', 'Field3', 'Field4']}
columnAction={false}
exportAction={true}
tabAction={true}
densityAction={false}
searchAction={true}
editable={true}
resizable={true}
tabValue={[
{ fieldToMatch: 'Field1', stringToMatch: 'Test', label: 'Tab1' },
]}
height={750}
/>
);
};

export default DashboardWebPart;
`

---

$3

!List Form

A List Form component with MUI TextFields and Pickers to create form from lists

#### Props

- context (required): SP context
- list (required): SharePoint list to pull data from
- fields (required): Internal Name of fields to display in dashboard
- paperVariant (optional): Variant of the paper component ('outlined', 'elevation'),
- paperElevation: Elevation of the paper component,
- inputVariant: Textfield variant ('standard', 'outlined', 'filled'),
- inputSize (optional): Textfield size ('small', 'medium'),
- fieldSpacing (optional): Spacing between fields,

`jsx
import * as React from 'react';
import { ListForm } from 'mui-spfx-controls';

const ListFormWebPart = ({ context }) => {
return (
context={context}
list="ListName"
fields={['Field1', 'Field2', 'Field3', 'Field4']}
paperVariant="elevation"
paperElevation={2}
inputVariant="outlined"
inputSize="medium"
fieldSpacing={2}
/>
);
};

export default ListFormWebPart;
`

---

$3

!List Item Picker

A List Item Picker component with MUI integration

#### Props

- context (required): SP context
- list (required): SharePoint list to pull data from
- fields (required): Internal Name of fields to include in the results
- displayField (required): Internal Name of the field to display in dropdown
- label (required): Textfield label
- onSelectionChange (optional): Get selection value updates
- multiple (optional): single/multi select
- searchSuggestionLimit (optional): number of suggestions to provide
- disabled (optional): Is component disabled
- variant (optional): Textfield variant ('standard', 'outlined', 'filled')
- size (optional): Size of component
- LoadingComponent (optional): A loading component
- color (optional): Button color, e.g., "primary" or "secondary"
- sx (optional): MUI's sx prop

`jsx
import * as React from 'react';
import { ListItemPicker } from 'mui-spfx-controls';

const ListItemPickerWebPart = ({ context }) => {
return (
context={context}
list="ListName"
fields={['Field1', 'Field2', 'Field3', 'Field4']}
displayField="Title"
label="List Items"
searchSuggestionLimit={10}
multiple={true}
variant="outlined"
size="medium"
/>
);
};

export default ListItemPickerWebPart;
`

---

$3

!Navigation

A Navigation component with MUI integration using MUI TreeView

#### Props

- context (required): SP context
- items (required): Array object to dynamically create the navigation tree
- itemProps (optional): Props for Tree Item
- viewProps (optional): Props for Tree View
- sx (optional): MUI's sx prop

`jsx
import * as React from 'react';
import { Navigation } from 'mui-spfx-controls';

const NavigationWebPart = () => {
return (
items={[
{
id: 'iron_man',
label: 'Iron Man',
children: [
{
id: 'iron_man_1',
label: 'Iron Man (2008)',
link: 'https://www.imdb.com/title/tt0371746/',
},
],
},
]}
/>
);
};

export default NavigationWebPart;
`

---

$3

!Searchbar

A search bar component with MUI library integration

#### Props

- context (required): SP context
- label (optional): Textfield label
- onSearchResultSelect (optional): Get selection value updates
- variant (optional): Textfield variant ('standard', 'outlined', 'filled')
- size (optional): Size of component
- color (optional): Button color, e.g., "primary" or "secondary"
- scope (optional): Search scope (URL)
- excludedScope (optional): Search scope to exclude (URL)
- sx (optional): MUI's sx prop

`jsx
import * as React from 'react';
import { SearchBar } from 'mui-spfx-controls';

const SearchBarWebPart = ({ context }) => {
return (
context={context}
label="Search"
size="small"
scope="https://acme.sharepoint.com/sites/include"
excludedScope="https://acme.sharepoint.com/sites/exclude"
/>
);
};

export default SearchBarWebPart;
`

---

Development

Run the solution in development mode:

Clone the repository:

`bash
git clone https://github.com/anapeksha/mui-spfx-controls.git
`

Install dependencies:

`bash
cd mui-spfx-controls
npm install
`

Serve the solution

`bash
npm run serve:fast
``

Test the components/webparts in the workbench

License

This project is licensed under the MIT License - see LICENSE file for details.