sp-dev-fx-webparts/tutorials/tutorial-getting-started/README.md

89 lines
3.7 KiB
Markdown
Raw Normal View History

2017-06-28 08:41:39 -04:00
# Getting started with client-side web parts
## Summary
2021-09-01 05:51:46 -04:00
This sub folder contains client-side projects includes the web parts detailed in the Getting Started walkthroughs. Technically these web parts could have remained in one single solution, but to ensure that they match exactly what's in the tutorials, we have separated them to dedicated solutions. Sub folders contains the following web parts:
2017-06-28 08:41:39 -04:00
| Solution | Getting Started Walkthrough | Video
| ------------- | ------------- | ------------- |
| hello-world | [Build your first web part](https://docs.microsoft.com/sharepoint/dev/spfx/web-parts/get-started/build-a-hello-world-web-part) | [video](https://www.youtube.com/watch?v=QbDtsMg88Js) |
| hello-world-sp | [Connect your client-side web part to SharePoint](https://docs.microsoft.com/sharepoint/dev/spfx/web-parts/get-started/connect-to-sharepoint) | [video](https://www.youtube.com/watch?v=9VMwjb2pbQ8) |
| jquery-webpart | [Add jQueryUI Accordion to your SharePoint client-side web part](https://docs.microsoft.com/sharepoint/dev/spfx/web-parts/get-started/add-jqueryui-accordion-to-web-part) | [video](https://www.youtube.com/watch?v=-3m__hRQxEI) |
| documentcardexample-webpart | [Use Office UI Fabric React components in your SharePoint client-side web part](https://docs.microsoft.com/sharepoint/dev/spfx/web-parts/get-started/use-fabric-react-components) | [video](https://www.youtube.com/watch?v=1N6kNvLxyg4) |
| asset-deployment-webpart | [Provision SharePoint assets from SharePoint Framework solutions](https://docs.microsoft.com/sharepoint/dev/spfx/web-parts/get-started/provision-sp-assets-from-package) | TBD |
2017-06-28 08:41:39 -04:00
2021-09-01 05:51:46 -04:00
You can also find other SharePoint Framework related videos from the [SharePoint PnP YouTube Channel](https://aka.ms/SPPnP-Videos).
2017-06-28 08:41:39 -04:00
## Used SharePoint Framework Version
2021-11-02 00:46:21 -04:00
![GA](https://img.shields.io/badge/SPFx-GA-green.svg)
2017-06-28 08:41:39 -04:00
## Applies to
2022-10-24 09:42:45 -04:00
* [SharePoint Framework Developer Preview](https://learn.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
* [Microsoft 365 developer tenant](https://learn.microsoft.com/sharepoint/dev/spfx/set-up-your-developer-tenant)
2017-06-28 08:41:39 -04:00
## Solution
| Solution | Author(s) |
| ------------- | ------------- |
| web-part-tutorials | Microsoft SharePoint Framework Team |
## Version history
| Version | Date | Comments |
| ------------- | ------------- | ------------- |
| 0.3.0 | February 28th 2017 | Updated to GA level. |
| 0.2.0 | February 15th 2017 | Updated to RC0 level. |
| 0.1.0 | December 16th 2016 | Updated to drop 6 level. |
| 0.0.1 | August 31st 2016 | Initial release supporting SharePoint Framework developer preview. |
## 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.**
----------
## Build and run the tutorials
To build and run this client-side project, you will need to clone and build the tutorials project.
Clone this repo by executing the following command in your console:
```
2021-05-02 15:04:59 -04:00
git clone https://github.com/pnp/sp-dev-fx-webparts.git
2017-06-28 08:41:39 -04:00
```
Navigate to the cloned repo folder which should be the same as the repo name:
```
cd sp-dev-fx-webparts
```
Navigate to the `tutorials` folder:
```
cd tutorials
```
Navigate to the `specific web part` folder:
```
cd 'subfolder'
```
Now run the following command to install the npm packages:
```
npm install
```
2021-09-01 05:51:46 -04:00
This will install the required npm packages and dependencies to build and run the client-side project.
2017-06-28 08:41:39 -04:00
Once the npm packages are installed, run the command to preview your web parts in SharePoint Workbench:
```
gulp serve
```
2021-12-20 10:25:30 -05:00
<img src="https://pnptelemetry.azurewebsites.net/sp-dev-fx-webparts/tutorials" />