v 0.1.0
This commit is contained in:
commit
dbb43915e4
|
@ -0,0 +1,33 @@
|
||||||
|
# Logs
|
||||||
|
logs
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
|
||||||
|
# Dependency directories
|
||||||
|
node_modules
|
||||||
|
|
||||||
|
# Build generated files
|
||||||
|
dist
|
||||||
|
lib
|
||||||
|
release
|
||||||
|
solution
|
||||||
|
temp
|
||||||
|
*.sppkg
|
||||||
|
|
||||||
|
# Coverage directory used by tools like istanbul
|
||||||
|
coverage
|
||||||
|
|
||||||
|
# OSX
|
||||||
|
.DS_Store
|
||||||
|
|
||||||
|
# Visual Studio files
|
||||||
|
.ntvs_analysis.dat
|
||||||
|
.vs
|
||||||
|
bin
|
||||||
|
obj
|
||||||
|
|
||||||
|
# Resx Generated Code
|
||||||
|
*.resx.ts
|
||||||
|
|
||||||
|
# Styles Generated Code
|
||||||
|
*.scss.ts
|
|
@ -0,0 +1,16 @@
|
||||||
|
!dist
|
||||||
|
config
|
||||||
|
|
||||||
|
gulpfile.js
|
||||||
|
|
||||||
|
release
|
||||||
|
src
|
||||||
|
temp
|
||||||
|
|
||||||
|
tsconfig.json
|
||||||
|
tslint.json
|
||||||
|
|
||||||
|
*.log
|
||||||
|
|
||||||
|
.yo-rc.json
|
||||||
|
.vscode
|
|
@ -0,0 +1,23 @@
|
||||||
|
{
|
||||||
|
"version": "0.2.0",
|
||||||
|
"configurations": [
|
||||||
|
{
|
||||||
|
"name": "Hosted workbench",
|
||||||
|
"type": "pwa-chrome",
|
||||||
|
"request": "launch",
|
||||||
|
"url": "https://enter-your-SharePoint-site/_layouts/workbench.aspx",
|
||||||
|
"webRoot": "${workspaceRoot}",
|
||||||
|
"sourceMaps": true,
|
||||||
|
"sourceMapPathOverrides": {
|
||||||
|
"webpack:///.././src/*": "${webRoot}/src/*",
|
||||||
|
"webpack:///../../../src/*": "${webRoot}/src/*",
|
||||||
|
"webpack:///../../../../src/*": "${webRoot}/src/*",
|
||||||
|
"webpack:///../../../../../src/*": "${webRoot}/src/*"
|
||||||
|
},
|
||||||
|
"runtimeArgs": [
|
||||||
|
"--remote-debugging-port=9222",
|
||||||
|
"-incognito"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
|
@ -0,0 +1,13 @@
|
||||||
|
// Place your settings in this file to overwrite default and user settings.
|
||||||
|
{
|
||||||
|
// Configure glob patterns for excluding files and folders in the file explorer.
|
||||||
|
"files.exclude": {
|
||||||
|
"**/.git": true,
|
||||||
|
"**/.DS_Store": true,
|
||||||
|
"**/bower_components": true,
|
||||||
|
"**/coverage": true,
|
||||||
|
"**/lib-amd": true,
|
||||||
|
"src/**/*.scss.ts": true
|
||||||
|
},
|
||||||
|
"typescript.tsdk": ".\\node_modules\\typescript\\lib"
|
||||||
|
}
|
|
@ -0,0 +1,16 @@
|
||||||
|
{
|
||||||
|
"@microsoft/generator-sharepoint": {
|
||||||
|
"plusBeta": false,
|
||||||
|
"isCreatingSolution": true,
|
||||||
|
"version": "1.14.0",
|
||||||
|
"libraryName": "react-cherry-picked-content",
|
||||||
|
"libraryId": "6a0a135e-c421-4508-955a-dbb0b392104a",
|
||||||
|
"environment": "spo",
|
||||||
|
"packageManager": "npm",
|
||||||
|
"solutionName": "react-cherry-picked-content",
|
||||||
|
"solutionShortDescription": "react-cherry-picked-content description",
|
||||||
|
"skipFeatureDeployment": true,
|
||||||
|
"isDomainIsolated": false,
|
||||||
|
"componentType": "webpart"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,65 @@
|
||||||
|
# react-cherry-picked-content
|
||||||
|
|
||||||
|
## Summary
|
||||||
|
|
||||||
|
The Cherry=Picked Content Web Part is a modern replacement for the classic Content Editor Web Part, with a twist: code snippets can only be picked from approved document libraries.
|
||||||
|
|
||||||
|
![React Cherry=Picked Content Sample](./assets/React-Cherry-Picked-Content-Sample.png)
|
||||||
|
|
||||||
|
## Used SharePoint Framework Version
|
||||||
|
|
||||||
|
![version](https://img.shields.io/badge/version-1.14.0-green.svg)
|
||||||
|
|
||||||
|
## Applies to
|
||||||
|
|
||||||
|
- [SharePoint Framework](https://aka.ms/spfx)
|
||||||
|
- [Microsoft 365 tenant](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/set-up-your-developer-tenant)
|
||||||
|
|
||||||
|
> Get your own free development tenant by subscribing to [Microsoft 365 developer program](http://aka.ms/o365devprogram)
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
> N/A
|
||||||
|
|
||||||
|
## Solution
|
||||||
|
|
||||||
|
Solution|Author(s)
|
||||||
|
--------|---------
|
||||||
|
React-Cherry-Picked-Content | [Christophe Humbert](https://github.com/PathToSharePoint)
|
||||||
|
|
||||||
|
## Version history
|
||||||
|
|
||||||
|
Version|Date|Comments
|
||||||
|
-------|----|--------
|
||||||
|
0.1.0|February 21, 2022|Initial draft
|
||||||
|
|
||||||
|
## 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.**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Minimal Path to Awesome
|
||||||
|
|
||||||
|
- Clone this repository
|
||||||
|
- Under components, edit ApprovedLibraries.ts to list your approved libraries that contain HTML snippets
|
||||||
|
- Ensure that you are at the solution folder
|
||||||
|
- in the command-line run:
|
||||||
|
- **npm install**
|
||||||
|
- **gulp serve**
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
This Web Part illustrates the following concepts:
|
||||||
|
|
||||||
|
- Cascading dropdown in the Property Pane
|
||||||
|
- Use of SPHttpClient and the SharePoint REST API to query SharePoint content
|
||||||
|
- React function component with useState and useEffect hooks
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [Getting started with SharePoint Framework](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/set-up-your-developer-tenant)
|
||||||
|
- [Building for Microsoft teams](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/build-for-teams-overview)
|
||||||
|
- [Use Microsoft Graph in your solution](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/web-parts/get-started/using-microsoft-graph-apis)
|
||||||
|
- [Publish SharePoint Framework applications to the Marketplace](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/publish-to-marketplace-overview)
|
||||||
|
- [Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp) - Guidance, tooling, samples and open-source controls for your Microsoft 365 development
|
Binary file not shown.
After Width: | Height: | Size: 1.1 MiB |
|
@ -0,0 +1,18 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://developer.microsoft.com/json-schemas/spfx-build/config.2.0.schema.json",
|
||||||
|
"version": "2.0",
|
||||||
|
"bundles": {
|
||||||
|
"cherry-picked-content-web-part": {
|
||||||
|
"components": [
|
||||||
|
{
|
||||||
|
"entrypoint": "./lib/webparts/cherryPickedContent/CherryPickedContentWebPart.js",
|
||||||
|
"manifest": "./src/webparts/cherryPickedContent/CherryPickedContentWebPart.manifest.json"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"externals": {},
|
||||||
|
"localizedResources": {
|
||||||
|
"CherryPickedContentWebPartStrings": "lib/webparts/cherryPickedContent/loc/{locale}.js"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,7 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://developer.microsoft.com/json-schemas/spfx-build/deploy-azure-storage.schema.json",
|
||||||
|
"workingDir": "./release/assets/",
|
||||||
|
"account": "<!-- STORAGE ACCOUNT NAME -->",
|
||||||
|
"container": "react-cherry-picked-content",
|
||||||
|
"accessKey": "<!-- ACCESS KEY -->"
|
||||||
|
}
|
|
@ -0,0 +1,40 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://developer.microsoft.com/json-schemas/spfx-build/package-solution.schema.json",
|
||||||
|
"solution": {
|
||||||
|
"name": "react-cherry-picked-content-client-side-solution",
|
||||||
|
"id": "6a0a135e-c421-4508-955a-dbb0b392104a",
|
||||||
|
"version": "1.0.0.0",
|
||||||
|
"includeClientSideAssets": true,
|
||||||
|
"skipFeatureDeployment": true,
|
||||||
|
"isDomainIsolated": false,
|
||||||
|
"developer": {
|
||||||
|
"name": "Christophe Humbert",
|
||||||
|
"websiteUrl": "",
|
||||||
|
"privacyUrl": "",
|
||||||
|
"termsOfUseUrl": "",
|
||||||
|
"mpnId": "Undefined-1.14.0"
|
||||||
|
},
|
||||||
|
"metadata": {
|
||||||
|
"shortDescription": {
|
||||||
|
"default": "react-cherry-picked-content description"
|
||||||
|
},
|
||||||
|
"longDescription": {
|
||||||
|
"default": "react-cherry-picked-content description"
|
||||||
|
},
|
||||||
|
"screenshotPaths": [],
|
||||||
|
"videoUrl": "",
|
||||||
|
"categories": []
|
||||||
|
},
|
||||||
|
"features": [
|
||||||
|
{
|
||||||
|
"title": "react-cherry-picked-content Feature",
|
||||||
|
"description": "The feature that activates elements of the react-cherry-picked-content solution.",
|
||||||
|
"id": "bb64f400-c482-4467-83ae-3a05b9eacf4d",
|
||||||
|
"version": "1.0.0.0"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"paths": {
|
||||||
|
"zippedPackage": "solution/react-cherry-picked-content.sppkg"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,6 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://developer.microsoft.com/json-schemas/core-build/serve.schema.json",
|
||||||
|
"port": 4321,
|
||||||
|
"https": true,
|
||||||
|
"initialPage": "https://enter-your-SharePoint-site/_layouts/workbench.aspx"
|
||||||
|
}
|
|
@ -0,0 +1,4 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://developer.microsoft.com/json-schemas/spfx-build/write-manifests.schema.json",
|
||||||
|
"cdnBasePath": "<!-- PATH TO CDN -->"
|
||||||
|
}
|
|
@ -0,0 +1,16 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const build = require('@microsoft/sp-build-web');
|
||||||
|
|
||||||
|
build.addSuppression(`Warning - [sass] The local CSS class 'ms-Grid' is not camelCase and will not be type-safe.`);
|
||||||
|
|
||||||
|
var getTasks = build.rig.getTasks;
|
||||||
|
build.rig.getTasks = function () {
|
||||||
|
var result = getTasks.call(build.rig);
|
||||||
|
|
||||||
|
result.set('serve', result.get('serve-deprecated'));
|
||||||
|
|
||||||
|
return result;
|
||||||
|
};
|
||||||
|
|
||||||
|
build.initialize(require('gulp'));
|
File diff suppressed because it is too large
Load Diff
|
@ -0,0 +1,32 @@
|
||||||
|
{
|
||||||
|
"name": "react-cherry-picked-content",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"private": true,
|
||||||
|
"main": "lib/index.js",
|
||||||
|
"scripts": {
|
||||||
|
"build": "gulp bundle",
|
||||||
|
"clean": "gulp clean",
|
||||||
|
"test": "gulp test"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"react": "16.13.1",
|
||||||
|
"react-dom": "16.13.1",
|
||||||
|
"office-ui-fabric-react": "7.174.1",
|
||||||
|
"@microsoft/sp-core-library": "1.14.0",
|
||||||
|
"@microsoft/sp-property-pane": "1.14.0",
|
||||||
|
"@microsoft/sp-webpart-base": "1.14.0",
|
||||||
|
"@microsoft/sp-lodash-subset": "1.14.0",
|
||||||
|
"@microsoft/sp-office-ui-fabric-core": "1.14.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/react": "16.9.51",
|
||||||
|
"@types/react-dom": "16.9.8",
|
||||||
|
"@microsoft/sp-build-web": "1.14.0",
|
||||||
|
"@microsoft/sp-tslint-rules": "1.14.0",
|
||||||
|
"@microsoft/sp-module-interfaces": "1.14.0",
|
||||||
|
"@microsoft/rush-stack-compiler-3.9": "0.4.47",
|
||||||
|
"gulp": "~4.0.2",
|
||||||
|
"ajv": "~5.2.2",
|
||||||
|
"@types/webpack-env": "1.13.1"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1 @@
|
||||||
|
// A file is required to be in the root of the /src directory by the TypeScript compiler
|
|
@ -0,0 +1,28 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://developer.microsoft.com/json-schemas/spfx/client-side-web-part-manifest.schema.json",
|
||||||
|
"id": "3e86ecba-18ac-44e2-862e-fc268a929584",
|
||||||
|
"alias": "CherryPickedContentWebPart",
|
||||||
|
"componentType": "WebPart",
|
||||||
|
|
||||||
|
// The "*" signifies that the version should be taken from the package.json
|
||||||
|
"version": "*",
|
||||||
|
"manifestVersion": 2,
|
||||||
|
|
||||||
|
// If true, the component can only be installed on sites where Custom Script is approved.
|
||||||
|
// Components that allow authors to embed arbitrary script code should set this to true.
|
||||||
|
// https://support.office.com/en-us/article/Turn-scripting-capabilities-on-or-off-1f2c515f-5d7e-448a-9fd7-835da935584f
|
||||||
|
"requiresCustomScript": false,
|
||||||
|
"supportedHosts": ["SharePointWebPart", "TeamsPersonalApp", "TeamsTab", "SharePointFullPage"],
|
||||||
|
"supportsThemeVariants": true,
|
||||||
|
|
||||||
|
"preconfiguredEntries": [{
|
||||||
|
"groupId": "5c03119e-3074-46fd-976b-c60198311f70", // Other
|
||||||
|
"group": { "default": "Other" },
|
||||||
|
"title": { "default": "Cherry-Picked-Content" },
|
||||||
|
"description": { "default": "Cherry-Picked-Content description" },
|
||||||
|
"officeFabricIconFontName": "BullseyeTargetEdit",
|
||||||
|
"properties": {
|
||||||
|
"description": "Cherry-Picked-Content"
|
||||||
|
}
|
||||||
|
}]
|
||||||
|
}
|
|
@ -0,0 +1,199 @@
|
||||||
|
import * as React from 'react';
|
||||||
|
import * as ReactDom from 'react-dom';
|
||||||
|
import { Version } from '@microsoft/sp-core-library';
|
||||||
|
import {
|
||||||
|
IPropertyPaneConfiguration,
|
||||||
|
IPropertyPaneDropdownOption,
|
||||||
|
PropertyPaneDropdown,
|
||||||
|
PropertyPaneTextField
|
||||||
|
} from '@microsoft/sp-property-pane';
|
||||||
|
import { BaseClientSideWebPart } from '@microsoft/sp-webpart-base';
|
||||||
|
import { IReadonlyTheme } from '@microsoft/sp-component-base';
|
||||||
|
|
||||||
|
import * as strings from 'CherryPickedContentWebPartStrings';
|
||||||
|
import CherryPickedContent from './components/CherryPickedContent';
|
||||||
|
import { ICherryPickedContentProps } from './components/ICherryPickedContentProps';
|
||||||
|
import { update } from '@microsoft/sp-lodash-subset';
|
||||||
|
|
||||||
|
import { SPHttpClient, SPHttpClientResponse } from '@microsoft/sp-http';
|
||||||
|
import { approvedLibraries } from './components/ApprovedLibraries';
|
||||||
|
|
||||||
|
export interface ICherryPickedContentWebPartProps {
|
||||||
|
description: string;
|
||||||
|
libraryPicker: string;
|
||||||
|
libraryItemPicker: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export default class CherryPickedContentWebPart extends BaseClientSideWebPart<ICherryPickedContentWebPartProps> {
|
||||||
|
|
||||||
|
private _isDarkTheme: boolean = false;
|
||||||
|
private _environmentMessage: string = '';
|
||||||
|
|
||||||
|
protected onInit(): Promise<void> {
|
||||||
|
this._environmentMessage = this._getEnvironmentMessage();
|
||||||
|
|
||||||
|
return super.onInit();
|
||||||
|
}
|
||||||
|
|
||||||
|
public render(): void {
|
||||||
|
const element: React.ReactElement<ICherryPickedContentProps> = React.createElement(
|
||||||
|
CherryPickedContent,
|
||||||
|
{
|
||||||
|
description: this.properties.description,
|
||||||
|
libraryPicker: this.properties.libraryPicker,
|
||||||
|
libraryItemPicker: this.properties.libraryItemPicker,
|
||||||
|
approvedLibraries: this.approvedLibraries,
|
||||||
|
context: this.context,
|
||||||
|
isDarkTheme: this._isDarkTheme,
|
||||||
|
environmentMessage: this._environmentMessage,
|
||||||
|
hasTeamsContext: !!this.context.sdks.microsoftTeams,
|
||||||
|
userDisplayName: this.context.pageContext.user.displayName
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
ReactDom.render(element, this.domElement);
|
||||||
|
}
|
||||||
|
|
||||||
|
private _getEnvironmentMessage(): string {
|
||||||
|
if (!!this.context.sdks.microsoftTeams) { // running in Teams
|
||||||
|
return this.context.isServedFromLocalhost ? strings.AppLocalEnvironmentTeams : strings.AppTeamsTabEnvironment;
|
||||||
|
}
|
||||||
|
|
||||||
|
return this.context.isServedFromLocalhost ? strings.AppLocalEnvironmentSharePoint : strings.AppSharePointEnvironment;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected onThemeChanged(currentTheme: IReadonlyTheme | undefined): void {
|
||||||
|
if (!currentTheme) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
this._isDarkTheme = !!currentTheme.isInverted;
|
||||||
|
const {
|
||||||
|
semanticColors
|
||||||
|
} = currentTheme;
|
||||||
|
this.domElement.style.setProperty('--bodyText', semanticColors.bodyText);
|
||||||
|
this.domElement.style.setProperty('--link', semanticColors.link);
|
||||||
|
this.domElement.style.setProperty('--linkHovered', semanticColors.linkHovered);
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
protected onDispose(): void {
|
||||||
|
ReactDom.unmountComponentAtNode(this.domElement);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected get dataVersion(): Version {
|
||||||
|
return Version.parse('1.0');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Only content from the approved libraries can be selected
|
||||||
|
private approvedLibraries = approvedLibraries;
|
||||||
|
|
||||||
|
private updateWebPartProperty(property, value, refreshWebPart = true, refreshPropertyPane = true) {
|
||||||
|
|
||||||
|
update(this.properties, property, () => value);
|
||||||
|
if (refreshWebPart) this.render();
|
||||||
|
if (refreshPropertyPane) this.context.propertyPane.refresh();
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
// Dropdown gets disabled while retrieving items asynchronously
|
||||||
|
private itemsDropdownDisabled: boolean = true;
|
||||||
|
|
||||||
|
// Files in the selected library
|
||||||
|
private libraryItemsList: IPropertyPaneDropdownOption[];
|
||||||
|
|
||||||
|
// Asynchronous library query
|
||||||
|
private getLibraryItemsList = (library) => {
|
||||||
|
// Validate approved location
|
||||||
|
const filesLocation = this.approvedLibraries.filter(loc => loc.key == library)[0];
|
||||||
|
const filesQuery = window.location.origin + filesLocation.siteRelativeURL + "/_api/web/lists/getbytitle('" + filesLocation.library + "')/files?$select=Name";
|
||||||
|
|
||||||
|
return this.context.spHttpClient.get(filesQuery, SPHttpClient.configurations.v1)
|
||||||
|
.then((response: SPHttpClientResponse) => response.json())
|
||||||
|
.then(data => data.value);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Runs before getting the Property Pane configuration
|
||||||
|
protected onPropertyPaneConfigurationStart(): void {
|
||||||
|
|
||||||
|
this.itemsDropdownDisabled = true;
|
||||||
|
|
||||||
|
if (this.properties.libraryPicker)
|
||||||
|
this.getLibraryItemsList(this.properties.libraryPicker)
|
||||||
|
.then((files): void => {
|
||||||
|
// store items
|
||||||
|
this.libraryItemsList = files.map(file => { return { key: file.Name, text: file.Name }; });
|
||||||
|
this.itemsDropdownDisabled = false;
|
||||||
|
})
|
||||||
|
.then(() => this.context.propertyPane.refresh());
|
||||||
|
}
|
||||||
|
|
||||||
|
// This API is invoked after updating the new value of the property in the property bag (Reactive mode).
|
||||||
|
protected onPropertyPaneFieldChanged(propertyPath: string, oldValue: any, newValue: any): void {
|
||||||
|
super.onPropertyPaneFieldChanged(propertyPath, oldValue, newValue);
|
||||||
|
if ((propertyPath === 'libraryPicker') && (newValue)) {
|
||||||
|
// get previously selected item
|
||||||
|
const previousItem: string = this.properties.libraryItemPicker;
|
||||||
|
// reset selected item
|
||||||
|
this.properties.libraryItemPicker = "";
|
||||||
|
// disable item selector until new items are loaded
|
||||||
|
this.itemsDropdownDisabled = true;
|
||||||
|
// push new item value
|
||||||
|
this.onPropertyPaneFieldChanged('libraryItemPicker', previousItem, this.properties.libraryItemPicker);
|
||||||
|
// this.render();
|
||||||
|
// refresh the item selector control by repainting the property pane
|
||||||
|
this.context.propertyPane.refresh();
|
||||||
|
|
||||||
|
this.getLibraryItemsList(newValue)
|
||||||
|
.then((files): void => {
|
||||||
|
|
||||||
|
if (files.length) {
|
||||||
|
// store items
|
||||||
|
this.libraryItemsList = files.map(file => { return { key: file.Name, text: file.Name }; });
|
||||||
|
// enable item selector
|
||||||
|
this.itemsDropdownDisabled = false;
|
||||||
|
// this.render();
|
||||||
|
// refresh the item selector control by repainting the property pane
|
||||||
|
this.context.propertyPane.refresh();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected getPropertyPaneConfiguration(): IPropertyPaneConfiguration {
|
||||||
|
return {
|
||||||
|
pages: [
|
||||||
|
{
|
||||||
|
header: {
|
||||||
|
description: strings.PropertyPaneDescription
|
||||||
|
},
|
||||||
|
groups: [
|
||||||
|
{
|
||||||
|
groupName: strings.BasicGroupName,
|
||||||
|
groupFields: [
|
||||||
|
// Web Part title
|
||||||
|
PropertyPaneTextField('description', {
|
||||||
|
label: strings.DescriptionFieldLabel
|
||||||
|
}),
|
||||||
|
// Library Picker (approved libraries only)
|
||||||
|
PropertyPaneDropdown('libraryPicker', {
|
||||||
|
label: strings.LibraryPickerLabel,
|
||||||
|
options: this.approvedLibraries,
|
||||||
|
selectedKey: this.properties.libraryPicker,
|
||||||
|
|
||||||
|
}),
|
||||||
|
// Cascading Library Item Picker
|
||||||
|
PropertyPaneDropdown('libraryItemPicker', {
|
||||||
|
label: strings.LibraryItemPickerLabel,
|
||||||
|
options: this.libraryItemsList,
|
||||||
|
selectedKey: this.properties.libraryItemPicker,
|
||||||
|
disabled: this.itemsDropdownDisabled
|
||||||
|
})
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
Binary file not shown.
After Width: | Height: | Size: 12 KiB |
Binary file not shown.
After Width: | Height: | Size: 12 KiB |
|
@ -0,0 +1,20 @@
|
||||||
|
export const approvedLibraries = [
|
||||||
|
{
|
||||||
|
key: "/sites/PublicCDN/SiteAssets",
|
||||||
|
siteRelativeURL: "/sites/PublicCDN",
|
||||||
|
library: "Site Assets",
|
||||||
|
text: "Public CDN Site Assets"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
key: "/sites/PublicCDN/Shared%20Documents",
|
||||||
|
siteRelativeURL: "/sites/PublicCDN",
|
||||||
|
library: "Documents",
|
||||||
|
text: "Public CDN Documents"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
key: "/sites/PrivateCDN/SiteAssets",
|
||||||
|
siteRelativeURL: "/sites/PrivateCDN",
|
||||||
|
library: "Site Assets",
|
||||||
|
text: "Private CDN Site Assets"
|
||||||
|
}
|
||||||
|
];
|
|
@ -0,0 +1,34 @@
|
||||||
|
@import '~office-ui-fabric-react/dist/sass/References.scss';
|
||||||
|
|
||||||
|
.cherryPickedContent {
|
||||||
|
overflow: hidden;
|
||||||
|
padding: 1em;
|
||||||
|
color: "[theme:bodyText, default: #323130]";
|
||||||
|
color: var(--bodyText);
|
||||||
|
&.teams {
|
||||||
|
font-family: $ms-font-family-fallbacks;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.welcome {
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.welcomeImage {
|
||||||
|
width: 100%;
|
||||||
|
max-width: 420px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.links {
|
||||||
|
a {
|
||||||
|
text-decoration: none;
|
||||||
|
color: "[theme:link, default:#03787c]";
|
||||||
|
color: var(--link); // note: CSS Custom Properties support is limited to modern browsers only
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
text-decoration: underline;
|
||||||
|
color: "[theme:linkHovered, default: #014446]";
|
||||||
|
color: var(--linkHovered); // note: CSS Custom Properties support is limited to modern browsers only
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,84 @@
|
||||||
|
import * as React from 'react';
|
||||||
|
import styles from './CherryPickedContent.module.scss';
|
||||||
|
import { ICherryPickedContentProps } from './ICherryPickedContentProps';
|
||||||
|
import { escape } from '@microsoft/sp-lodash-subset';
|
||||||
|
|
||||||
|
import { SPHttpClient, SPHttpClientResponse } from '@microsoft/sp-http';
|
||||||
|
|
||||||
|
const CherryPickedContent: React.FunctionComponent<ICherryPickedContentProps> = (props) => {
|
||||||
|
|
||||||
|
const message = props.libraryItemPicker? "Loading...":"Edit Web Part properties to select a file.";
|
||||||
|
const defaultNode = document.createRange().createContextualFragment("<div><h3>" + message + "</h3></div>");
|
||||||
|
|
||||||
|
const [appendedNode, setAppendedNode] = React.useState(defaultNode);
|
||||||
|
|
||||||
|
React.useEffect(() => {
|
||||||
|
async function fetchSnippet() {
|
||||||
|
|
||||||
|
// Validate that the library is approved
|
||||||
|
let filteredApprovedLibraries = props.approvedLibraries.filter(lib => lib.key == props.libraryPicker);
|
||||||
|
if ((filteredApprovedLibraries.length > 0) && (props.libraryItemPicker)) {
|
||||||
|
|
||||||
|
let fileURL = props.libraryPicker + "/" + props.libraryItemPicker;
|
||||||
|
|
||||||
|
const webURLQuery = props.context.pageContext.web.absoluteUrl + `/_api/sp.web.getweburlfrompageurl(@v)?@v=%27${window.location.origin}${fileURL}%27`;
|
||||||
|
|
||||||
|
// if (props.url)
|
||||||
|
// const htmlFragment: string = (props.url) ?
|
||||||
|
let webURL = await props.context.spHttpClient.get(webURLQuery, SPHttpClient.configurations.v1)
|
||||||
|
.then((response: SPHttpClientResponse) => response.json())
|
||||||
|
.then(data => data.value);
|
||||||
|
const snippetURLQuery = webURL + `/_api/web/getFileByServerRelativeUrl('${fileURL}')/$value`;
|
||||||
|
|
||||||
|
const htmlFragment = await props.context.spHttpClient.get(snippetURLQuery, SPHttpClient.configurations.v1)
|
||||||
|
.then((response: SPHttpClientResponse) => response.text());
|
||||||
|
// : "<div>No content loaded.</div>";
|
||||||
|
const node = document.createRange().createContextualFragment(htmlFragment);
|
||||||
|
setAppendedNode(node);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
setAppendedNode(defaultNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
fetchSnippet();
|
||||||
|
}, [props.libraryPicker, props.libraryItemPicker]);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section className={`${styles.cherryPickedContent} ${props.hasTeamsContext ? styles.teams : ''}`}>
|
||||||
|
<div ref={ref => { if (ref) { ref.innerHTML = ""; ref.appendChild(appendedNode); } }}>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<h3>Approved libraries:</h3>
|
||||||
|
<p>
|
||||||
|
<ul>
|
||||||
|
{props.approvedLibraries.map(lib => <li>{lib.text}</li>)}
|
||||||
|
</ul>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
<div className={styles.welcome}>
|
||||||
|
<img alt="" src={props.isDarkTheme ? require('../assets/welcome-dark.png') : require('../assets/welcome-light.png')} className={styles.welcomeImage} />
|
||||||
|
<h2>Welcome, {escape(props.userDisplayName)}!</h2>
|
||||||
|
<div>{props.environmentMessage}</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div>
|
||||||
|
<h3>Welcome to SharePoint Framework!</h3>
|
||||||
|
<p>
|
||||||
|
The SharePoint Framework (SPFx) is a extensibility model for Microsoft Viva, Microsoft Teams and SharePoint. It's the easiest way to extend Microsoft 365 with automatic Single Sign On, automatic hosting and industry standard tooling.
|
||||||
|
</p>
|
||||||
|
<h4>Learn more about SPFx development:</h4>
|
||||||
|
<ul className={styles.links}>
|
||||||
|
<li><a href="https://aka.ms/spfx" target="_blank">SharePoint Framework Overview</a></li>
|
||||||
|
<li><a href="https://aka.ms/spfx-yeoman-graph" target="_blank">Use Microsoft Graph in your solution</a></li>
|
||||||
|
<li><a href="https://aka.ms/spfx-yeoman-teams" target="_blank">Build for Microsoft Teams using SharePoint Framework</a></li>
|
||||||
|
<li><a href="https://aka.ms/spfx-yeoman-viva" target="_blank">Build for Microsoft Viva Connections using SharePoint Framework</a></li>
|
||||||
|
<li><a href="https://aka.ms/spfx-yeoman-store" target="_blank">Publish SharePoint Framework applications to the marketplace</a></li>
|
||||||
|
<li><a href="https://aka.ms/spfx-yeoman-api" target="_blank">SharePoint Framework API reference</a></li>
|
||||||
|
<li><a href="https://aka.ms/m365pnp" target="_blank">Microsoft 365 Developer Community</a></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default CherryPickedContent;
|
|
@ -0,0 +1,13 @@
|
||||||
|
import { WebPartContext } from "@microsoft/sp-webpart-base";
|
||||||
|
|
||||||
|
export interface ICherryPickedContentProps {
|
||||||
|
description: string;
|
||||||
|
libraryPicker: string;
|
||||||
|
libraryItemPicker: string;
|
||||||
|
approvedLibraries: any[];
|
||||||
|
context: WebPartContext;
|
||||||
|
isDarkTheme: boolean;
|
||||||
|
environmentMessage: string;
|
||||||
|
hasTeamsContext: boolean;
|
||||||
|
userDisplayName: string;
|
||||||
|
}
|
|
@ -0,0 +1,13 @@
|
||||||
|
define([], function() {
|
||||||
|
return {
|
||||||
|
"PropertyPaneDescription": "Modern Content Editor Web Part with a twist: content can only be picked from approved locations.",
|
||||||
|
"BasicGroupName": "Web Part Properties",
|
||||||
|
"DescriptionFieldLabel": "Title",
|
||||||
|
"LibraryPickerLabel": "Pick an approved library",
|
||||||
|
"LibraryItemPickerLabel":"Pick a file",
|
||||||
|
"AppLocalEnvironmentSharePoint": "The app is running on your local environment as SharePoint web part",
|
||||||
|
"AppLocalEnvironmentTeams": "The app is running on your local environment as Microsoft Teams app",
|
||||||
|
"AppSharePointEnvironment": "The app is running on SharePoint page",
|
||||||
|
"AppTeamsTabEnvironment": "The app is running in Microsoft Teams"
|
||||||
|
}
|
||||||
|
});
|
|
@ -0,0 +1,16 @@
|
||||||
|
declare interface ICherryPickedContentWebPartStrings {
|
||||||
|
PropertyPaneDescription: string;
|
||||||
|
BasicGroupName: string;
|
||||||
|
DescriptionFieldLabel: string;
|
||||||
|
LibraryPickerLabel: string;
|
||||||
|
LibraryItemPickerLabel: string;
|
||||||
|
AppLocalEnvironmentSharePoint: string;
|
||||||
|
AppLocalEnvironmentTeams: string;
|
||||||
|
AppSharePointEnvironment: string;
|
||||||
|
AppTeamsTabEnvironment: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
declare module 'CherryPickedContentWebPartStrings' {
|
||||||
|
const strings: ICherryPickedContentWebPartStrings;
|
||||||
|
export = strings;
|
||||||
|
}
|
Binary file not shown.
After Width: | Height: | Size: 10 KiB |
Binary file not shown.
After Width: | Height: | Size: 542 B |
|
@ -0,0 +1,35 @@
|
||||||
|
{
|
||||||
|
"extends": "./node_modules/@microsoft/rush-stack-compiler-3.9/includes/tsconfig-web.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"target": "es5",
|
||||||
|
"forceConsistentCasingInFileNames": true,
|
||||||
|
"module": "esnext",
|
||||||
|
"moduleResolution": "node",
|
||||||
|
"jsx": "react",
|
||||||
|
"declaration": true,
|
||||||
|
"sourceMap": true,
|
||||||
|
"experimentalDecorators": true,
|
||||||
|
"skipLibCheck": true,
|
||||||
|
"outDir": "lib",
|
||||||
|
"inlineSources": false,
|
||||||
|
"strictNullChecks": false,
|
||||||
|
"noUnusedLocals": false,
|
||||||
|
"typeRoots": [
|
||||||
|
"./node_modules/@types",
|
||||||
|
"./node_modules/@microsoft"
|
||||||
|
],
|
||||||
|
"types": [
|
||||||
|
"webpack-env"
|
||||||
|
],
|
||||||
|
"lib": [
|
||||||
|
"es5",
|
||||||
|
"dom",
|
||||||
|
"es2015.collection",
|
||||||
|
"es2015.promise"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"include": [
|
||||||
|
"src/**/*.ts",
|
||||||
|
"src/**/*.tsx"
|
||||||
|
]
|
||||||
|
}
|
|
@ -0,0 +1,29 @@
|
||||||
|
{
|
||||||
|
"extends": "./node_modules/@microsoft/sp-tslint-rules/base-tslint.json",
|
||||||
|
"rules": {
|
||||||
|
"class-name": false,
|
||||||
|
"export-name": false,
|
||||||
|
"forin": false,
|
||||||
|
"label-position": false,
|
||||||
|
"member-access": true,
|
||||||
|
"no-arg": false,
|
||||||
|
"no-console": false,
|
||||||
|
"no-construct": false,
|
||||||
|
"no-duplicate-variable": true,
|
||||||
|
"no-eval": false,
|
||||||
|
"no-function-expression": true,
|
||||||
|
"no-internal-module": true,
|
||||||
|
"no-shadowed-variable": true,
|
||||||
|
"no-switch-case-fall-through": true,
|
||||||
|
"no-unnecessary-semicolons": true,
|
||||||
|
"no-unused-expression": true,
|
||||||
|
"no-with-statement": true,
|
||||||
|
"semicolon": true,
|
||||||
|
"trailing-comma": false,
|
||||||
|
"typedef": false,
|
||||||
|
"typedef-whitespace": false,
|
||||||
|
"use-named-parameter": true,
|
||||||
|
"variable-name": false,
|
||||||
|
"whitespace": false
|
||||||
|
}
|
||||||
|
}
|
Loading…
Reference in New Issue