58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
# Supporting section backgrounds in your web parts
|
|
|
|
## Summary
|
|
|
|
These samples show how to implement support for section backgrounds in your web parts.
|
|
|
|
There are 3 web parts in this solution showing how to implement support for a background and 1 web part that shows what the fallback scenario looks like.
|
|
|
|
For more details on the implementation, check out the documentation at https://learn.microsoft.com/sharepoint/dev/spfx/web-parts/basics/supporting-section-backgrounds
|
|
|
|
### A basic web part
|
|
|
|
This basic (no framework) web part implements support for backgrounds.
|
|
|
|
![Basic Web Part](./assets/webpartexample1.png)
|
|
|
|
In the 2 column section above we defined a background color and inserted the first example web part in the left column. It picks up the background color and uses the right foreground color for text.
|
|
|
|
### A React based web part
|
|
|
|
This React based web part implements support for backgrounds, alike the basic the web part.
|
|
|
|
![React Web Part](./assets/webpartexample2.png)
|
|
|
|
### A web part using the Office UI Framework
|
|
|
|
This web part implements a Office UI button which is inheriting its colors correctly from the theme
|
|
|
|
![Office UI Component Web Part](./assets/webpartexample3.png)
|
|
|
|
## Building the code
|
|
|
|
- Clone the repository
|
|
- ```npm install```
|
|
- ```gulp build```
|
|
- ```gulp serve --nobrowser```
|
|
- Open a browser, navigate to the workbench (https://yourtenant.sharepoint.com/_layouts/workbench.aspx), add a section, change the background color and add the web parts.
|
|
|
|
## Applies to
|
|
|
|
* [SharePoint Framework](https://learn.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
|
|
* [Office 365 developer tenant](https://learn.microsoft.com/sharepoint/dev/spfx/set-up-your-developer-tenant)
|
|
|
|
## Contributors
|
|
|
|
* Microsoft
|
|
|
|
## Version history
|
|
|
|
Version|Date|Comments
|
|
-------|----|--------
|
|
1.0.0|March 13, 2019|Initial release
|
|
|
|
## 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.**
|
|
|
|
<img src="https://m365-visitor-stats.azurewebsites.net/sp-dev-fx-webparts/samples/section-backgrounds" /> |