sp-dev-fx-webparts/samples/react-word-game/README.md

90 lines
3.7 KiB
Markdown
Raw Normal View History

2020-11-04 23:13:31 -05:00
# Word Game
## Summary
A fun game where you unscramble the words before the time runs out. It stores everyone's high scores in a SharePoint List on the Site.
![Word Game Preview](./assets/preview.gif)
2022-02-14 02:52:18 -05:00
## Compatibility
2020-11-04 23:13:31 -05:00
| :warning: 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. |
2021-11-07 01:43:55 -04:00
![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg)
![Node.js v10](https://img.shields.io/badge/Node.js-v10-green.svg)
![Compatible with SharePoint Online](https://img.shields.io/badge/SharePoint%20Online-Compatible-green.svg)
![Does not work with SharePoint 2019](https://img.shields.io/badge/SharePoint%20Server%202019-Incompatible-red.svg)
![Does not work with SharePoint 2016 (Feature Pack 2)](https://img.shields.io/badge/SharePoint%20Server%202016%20(Feature%20Pack%202)-Incompatible-red.svg "SharePoint Server 2016 Feature Pack 2 requires SPFx 1.1")
![Local Workbench Compatible](https://img.shields.io/badge/Local%20Workbench-Compatible-green.svg)
![Hosted Workbench Compatible](https://img.shields.io/badge/Hosted%20Workbench-Compatible-green.svg)
2022-02-15 00:37:36 -05:00
![Compatible with Remote Containers](https://img.shields.io/badge/Remote%20Containers-Compatible-green.svg)
2020-11-04 23:13:31 -05:00
## Applies to
2022-10-24 09:42:45 -04:00
* [SharePoint Framework](https://learn.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
* [Microsoft 365 tenant](https://learn.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)
2020-11-04 23:13:31 -05:00
## Prerequisites
- SharePoint Online Tenant or SharePoint 2019 On Prem
2023-02-18 22:58:44 -05:00
## Contributors
2020-11-04 23:13:31 -05:00
2023-02-18 22:58:44 -05:00
* Neil Barkhina ([www.neilb.net](https://www.neilb.net/))
* Don Kirkham ([@DonKirkham](https://twitter.com/DonKirkham/))
2020-11-04 23:13:31 -05:00
## Version history
Version|Date|Comments
-------|----|--------
1.0|May 27, 2020|Initial release
2.0|Nov 4, 2020|Upgrade to SPFx v1.11.0 (Don Kirkham)
## Minimal Path to Awesome
* Clone this repository
* In the command line run:
* `npm install`
* `gulp serve`
* If you haven't trusted your dev cert yet run
* `gulp trust-dev-cert`
* To Deploy it in your SharePoint Environment
* `gulp --ship`
* `gulp package-solution --ship`
* Upload the `.sppkg` file from the `sharepoint\solution` folder into your App Catalog
2022-02-15 00:37:36 -05:00
> This sample can also be opened with [VS Code Remote Development](https://code.visualstudio.com/docs/remote/remote-overview). Visit https://aka.ms/spfx-devcontainer for further instructions.
2020-11-04 23:13:31 -05:00
## Features
This demonstrates how you can create a fun game to play with your SharePoint peers. It was built using React and also uses jQuery to help load the Word List. It demonstrates these features:
- SharePoint REST API's
- Creating List and List Items API
- Creating columns in a SharePoint List
- Web Part Property Pane Settings
- CSS Styling and Animations
- Fun and engaging UX
- Responsive Design
If you want to disable the high scores feature you can edit the Web Part Settings. The Web Part stores the high scores in a SharePoint List that it creates called WordGameList. You can also change the Game Title in the settings:
![Settings](./assets/settings.PNG)
It also uses responsive design which works great on the SharePoint Mobile App:
![Mobile](./assets/wordgame_mobile.png)
2021-11-07 01:54:14 -05:00
## 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.**
2023-03-12 21:16:15 -04:00
<img src="https://m365-visitor-stats.azurewebsites.net/sp-dev-fx-webparts/samples/react-word-game" />