sp-dev-fx-webparts/samples/react-pnp-js-sample/README.md

3.3 KiB

SharePoint Framework sample using @pnp/js and ReactJS

Summary

This solution builds off of the solution react-async-await-sp-pnp-js submitted by Jose Quinto (@jquintozamora , blog.josequinto.com)

This implementaiton refactors to take aspects out and utilize and showcase PnPjs Version 3.

React-pnp-js-sample

Compatibility

⚠️ Important
Every SPFx version is only compatible with specific version(s) of Node.js. In order to be able to build this sample, please ensure that the version of Node on your workstation matches one of the versions listed in this section. This sample will not work on a different version of Node.
Refer to https://aka.ms/spfx-matrix for more information on SPFx compatibility.

SPFx 1.14.0 Node.js v14 | v12 Compatible with SharePoint Online Incompatible with SharePoint 2019 Does not work with SharePoint 2016 (Feature Pack 2) Local Workbench Incompatible Hosted Workbench Compatible

For more information about SPFx compatibility, please refer to https://aka.ms/spfx-matrix

Applies to

Solution

Solution Author(s)
react-spfx-pnp-js-sample Julie Turner (@jfj1997)

Version history

Version Date Comments
1.1 Aug 29, 2022 Bug fix & dependency updates
1.0 Jan 13, 2022 Initial release

Minimal Path to Awesome

  1. clone this repo
  2. $ npm i
  3. Update online workbench url in the initialPage property of the config/serve.json file.
  4. $ gulp serve

Features

  • Establishing context for the SharePoint Factory Interface
  • Creating a project config file to centralize defining the PnPjs imports and SharePoint Querable object for reuse.
  • Demo extending the SharePoint Querables instance with the PnPLogging beavhior.
  • Demo extending the SharePoing Queryable instance with the Caching behavior
  • Demo loading list items from a SharePoint library
  • Demo creating a batched instance of the SharePoint Querable object.
  • Demo updating list items by modifying the Title property.
  • Demo executing a batch and working with the results.

Disclaimer

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.