sp-dev-fx-webparts/samples/js-workbench-customizer
dependabot[bot] 932c4ca5f8
Bump jszip, @microsoft/sp-build-web and @microsoft/sp-webpart-workbench
Bumps [jszip](https://github.com/Stuk/jszip), [@microsoft/sp-build-web](http://aka.ms/spfx) and [@microsoft/sp-webpart-workbench](http://aka.ms/spfx). These dependencies needed to be updated together.

Updates `jszip` from 2.5.0 to 3.7.1
- [Release notes](https://github.com/Stuk/jszip/releases)
- [Changelog](https://github.com/Stuk/jszip/blob/main/CHANGES.md)
- [Commits](https://github.com/Stuk/jszip/compare/v2.5.0...v3.7.1)

Updates `@microsoft/sp-build-web` from 1.10.0 to 1.15.2

Updates `@microsoft/sp-webpart-workbench` from 1.10.0 to 1.12.1

---
updated-dependencies:
- dependency-name: jszip
  dependency-type: indirect
- dependency-name: "@microsoft/sp-build-web"
  dependency-type: direct:development
- dependency-name: "@microsoft/sp-webpart-workbench"
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-09-13 14:38:14 +00:00
..
.devcontainer Added SPFx 1.10 containers 2022-02-15 00:50:11 -05:00
assets Removing unnecessary office product from the sample metadata 2021-12-10 19:55:32 +02:00
config Adding PnP identifier for the MPN ID entries in samples - distinct sample usage in production 2021-01-07 14:51:39 +02:00
src Update styles to fix bug on full-width 2020-07-30 11:36:20 +01:00
.editorconfig Renaming a folder and fixing typo in readme 2019-02-12 11:17:16 +02:00
.gitignore Renaming a folder and fixing typo in readme 2019-02-12 11:17:16 +02:00
.yo-rc.json Revert "Update to SPFx 1.11.0" 2020-10-05 11:00:18 +01:00
README.md Added SPFx 1.10 containers 2022-02-15 00:50:11 -05:00
gulpfile.js Renaming a folder and fixing typo in readme 2019-02-12 11:17:16 +02:00
package-lock.json Bump jszip, @microsoft/sp-build-web and @microsoft/sp-webpart-workbench 2022-09-13 14:38:14 +00:00
package.json Bump jszip, @microsoft/sp-build-web and @microsoft/sp-webpart-workbench 2022-09-13 14:38:14 +00:00
pnpm-lock.yaml update to SPFx 1.10 2020-01-21 16:16:10 +00:00
shrinkwrap.yaml Renaming a folder and fixing typo in readme 2019-02-12 11:17:16 +02:00
tsconfig.json Revert "Update to SPFx 1.11.0" 2020-10-05 11:00:18 +01:00
tslint.json Renaming a folder and fixing typo in readme 2019-02-12 11:17:16 +02:00

README.md

Workbench customizer

Summary

This sample shows how the Workbench page can be customized to display in a way that better mimics a modern SharePoint page. This is done using CSS overrides on some of the page styles, which does not cause any negative impact on your site as the web part is not intended to be consumed by final users, only developers. The web part also has some properties that control which customizations are applied to the workbench page (all enabled by default). There is also an option to switch the page to Preview after the page is loaded, which gives a UI more close to what end users will see on a published page - this is very useful when doing UI work.

Demo

Usage

Deploy to tenant

The easiest way to use the solution is to package it up and deploy to the App Catalog. You can then add the web part to the bottom of the O365 Workbench page when developing your custom solutions.

Run locally

Alternatively, you can add the output files for the web part to a custom SPFx project and the web part will also be served and available both from the local or hosted Workbench page:

  • Generate the output files for the solution by executing gulp bundle --ship
  • Copy all files from js-workbench-customizer\dist to the dist folder of your custom solution
  • Copy the workbenchCustomizer folder from js-workbench-customizer\lib\webparts to the corresponding webparts folder of your custom solution

Note: This approach will not "pollute" your solution with additional resources or dependencies as the SPFx toolchain will ignore those additional files by default when you package your solution. You can also clean everything by running gulp clean as both the lib and dist folders are deleted and recreated again. Git will also ignore dist and lib folders by default, so the files will never be added to source control.

Compatibility

SPFx 1.11 Node.js v10 Compatible with SharePoint Online Does not work with SharePoint 2019 Does not work with SharePoint 2016 (Feature Pack 2) Local Workbench Compatible Hosted Workbench Compatible Compatible with Remote Containers

Applies to

Prerequisites

  • Office 365 subscription with SharePoint Online license
  • SharePoint Framework development environment already set up.

Solution

Solution Author(s)
workbench-customizer Joel Rodrigues

Version history

Version Date Comments
1.0 January 24, 2019 Initial release
1.1 February 05, 2020 Update to SPFx 1.10.0
1.2 June 04, 2020 Added full-width support
1.3 July 07, 2020 Simplified web part
1.4 July 28, 2020 Update styles to minimise toolbar overlap
1.5 July 30, 2020 Update styles to improve full-width mode

Minimal Path to Awesome

  • Clone this repository
  • in the command line run:
    • npm install
    • gulp serve

This sample can also be opened with VS Code Remote Development. Visit https://aka.ms/spfx-devcontainer for further instructions.

Video

Workbench customizer for improved debugging experience

Help

We do not support samples, but this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.

If you're having issues building the solution, please run spfx doctor from within the solution folder to diagnose incompatibility issues with your environment.

You can try looking at issues related to this sample to see if anybody else is having the same issues.

You can also try looking at discussions related to this sample and see what the community is saying.

If you encounter any issues while using this sample, create a new issue.

For questions regarding this sample, create a new question.

Finally, if you have an idea for improvement, make a suggestion.

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.