sp-dev-fx-webparts/samples/react-kanban-board/README.md

106 lines
3.4 KiB
Markdown
Raw Normal View History

2020-07-02 22:53:00 -04:00
---
page_type: sample
products:
- office-sp
languages:
- javascript
- typescript
extensions:
contentType: samples
technologies:
- SharePoint Framework
platforms:
- React
createdDate: 7/17/2019 12:00:00 AM
---
2020-11-08 23:25:00 -05:00
# Kanban Board
## Summary
2020-06-27 17:04:23 -04:00
2020-07-02 02:29:03 -04:00
This solution contains an SPFx webpart that shows a kanban board using Office UI Fabric components ([Office UI Fabric](https://developer.microsoft.com/fluentui/)).
The webpart uses the default columns of the SharePoint Tasks list for showing the board's columns and the tasks.
2020-06-30 07:31:41 -04:00
![picture of the web part in action](assets/kanbanofficeUI.gif)
## Used SharePoint Framework Version
2020-07-02 22:53:00 -04:00
![1.10.0](https://img.shields.io/badge/version-1.10.0-green.svg)
## Applies to
* [SharePoint Framework](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
* [Office 365 tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)
## Prerequisites
This webpart reads the information from a Tasks list and uses the following OOB columns
* Task Name
* Assigned To
* % Complete
* Description
* Priority
* Task Status
2020-06-27 17:04:23 -04:00
The Task list can be chosen using the webpart properties (BaseTemplate 171 or 107)
## Solution
Solution|Author(s)
--------|---------
react-kanban-board | [Ram](https://twitter.com/ram_meenavalli)
react-kanban-board | Daniel Westerdale ([Westerdale Solutions Ltd.](https://westerdale.blog), [@westerdaled](https://twitter.com/westerdaled?s=20))
2020-06-28 16:08:00 -04:00
react-kanban-board | Peter Paul Kirschner ([@petkir_at](https://twitter.com/petkir_at))
## Version history
Version|Date|Comments
-------|----|--------
1.0.0.0|July 17, 2019|Initial release
1.0.1.0|April 21, 2020|Added support for Teams hosts
2020-07-02 22:53:00 -04:00
2.0.0.0|July 10, 2020| jqwidgets replaced with a custom Kanban Board based on Office UI Component and IE11 Support
2020-06-28 16:02:31 -04:00
2020-07-01 03:58:38 -04:00
[Read More about the implementation of this Board](./src/kanban/README.md)
2020-06-27 17:04:23 -04:00
## Usage
2020-07-02 02:29:03 -04:00
* PNP Placeholder control if not Configured
* PNP WebpartTitle control (toggle Show/Hide in property pane)
* PNP OrderPropertyPane control (change position of buckets)
* PNP ListSelectionPropertyPane control (including filtering on BaseTemplateId)
* Usage of BucketEdit in Pane (Use a component in property pane (custom field))
2020-06-28 16:06:28 -04:00
* Office UI Fabric
2020-06-27 17:04:23 -04:00
* PNP JS DataConnection to SharePoint
2020-07-02 22:53:00 -04:00
<!---Thanks from @petkir to: -->
2020-06-28 16:06:28 -04:00
<!--- -->
<!---* [Daniel Westerdale](https://github.com/westerdaled) for Testing and inspiration (everytime again)-->
<!---* [Hugo Bernier](https://github.com/hugoabernier) for Inspiration to use Office UI Fabric -->
2020-07-02 02:29:03 -04:00
<!---* [Jean-Philippe CIVADE](https://github.com/ewidance) for Bug Report IE11 (initiator of rewrite of this sample)-->
2020-06-28 16:06:28 -04:00
<!---* [RamPrasadMeenavalli](https://github.com/RamPrasadMeenavalli) for the initial Idea-->
2020-06-27 17:04:23 -04: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.**
---
## Minimal Path to Awesome
* Clone this repository
* in the command line run:
* `npm install`
* `gulp serve`
## Features
This sample highlights the following concepts
2020-07-02 02:29:03 -04:00
* Binding SharePoint list data to a custom Kanban-Control
2020-06-27 17:04:23 -04:00
* Updating SharePoint List Items based on events from the custom Kanban-Control
When a task is moved to different columns in the Kanban Board, the status of the respective SharePoint list item is updated using PnP JS
2020-07-02 22:53:00 -04:00
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-kanban-board" />