This web part provides you the ability to add a per instance listing of links with the ability to group sets of links. Links are stored as a collection of links within the web part's properties, removing the need for link storage within SharePoint lists, tenant properties, or other external link storage requirements.
Links and groups are both customizable.
Icons are from Fluent UI Icons, those icons that should be available within at least Fluent UI version 7.3.
View Fluent UI Icons for icon names.
The Links webpart can be configured with the following properties:
| Label | Property | Type | Required | Description |
|---|---|---|---|---|
| Useful links | title | string | no | The webpart title, editable inline with the webpart itself |
| Group names for the links | groupData | collection | no | Collection of group names for grouping links into sets |
| Link data | collectionData | collection | no | Collection of links |
Configurable properties for each collection row within the groupData collection:
| Label | Property | Type | Required | Description |
|---|---|---|---|---|
| Title | title | string | yes | The name of a group |
Configurable properties for each collection row within the collectionData collection:
| Label | Property | Type | Required | Description |
|---|---|---|---|---|
| Title | title | string | yes | The text / title of the link |
| URL | url | string | yes | The link url |
| UI Fabric icon name | icon | fabricIcon | no | Optional UI Fabric icon name |
| Group name | group | dropdown | no | Optional name of the group to add this link to |
| Target | target | dropdown | no | Optional target for this link, current or new window |
- Supported in SharePoint Online
none
| Solution | Author(s) |
|---|---|
| react-links V1 | Elio Struyf (@estruyf) |
| react-links V2 | Fabio Franzini (@fabiofranzini) |
| react-links V3 | Chandani Prajapati (@Chandani_SPD) |
| Version | Date | Comments |
|---|---|---|
| 1.0 | May 18th, 2018 | Initial release (extract web part from Starter Kit v1) |
| 2.0 | January 24, 2020 | Initial release (extract web part from Starter Kit v1) |
| 3.0 | February 2023 | Initial release for SharePoint Starter Kit v3 (Upgraded to SPFx 1.16.1) |
THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.
- Clone this repository
- Move to solution folder
- in the command line run:
npm installgulp serve
Description of the web part with possible additional details than in short summary. This Web Part illustrates the following concepts on top of the SharePoint Framework:
- PnP property control usage
- Fluent UI React controls