sp-dev-fx-webparts/samples/js-employee-spotlight/README.md

6.1 KiB

page_type products languages extensions
sample
office-sp
javascript
typescript
contentType technologies platforms createdDate
samples
SharePoint Framework
react
8/1/2017 12:00:00 AM

Employee Spotlight

Summary

Simple Web Part that demonstrates the use of SharePoint Framework for show casing Employee Spotlight. The web part pulls data from a configured list and User Profile service. The properties pane for this web part has 5 cascading dropdowns.

  • A drop down list of sites(webs) in the current site collection.
  • A drop down list of list titles in the selected site(web).
  • 3 drop downs with list of field names from selected list, which includes
    • Name(Person or Group Column).
    • Spotlight Description (Multiline - Enriched text Column).
    • Expiry date for Spotlight event (DateTime Column with Date only option).
  • The properties pane also has options for following slider effects.
    • Background color - A color picker to choose Slider background color
    • Font color - A color picker to choose Slider font color
    • Set Auto slide - A switch to enable/disable auto slide for slider
    • Slider Speed - A Slider control to select slider speed from 0sec - 7sec with 0.5sec as a step.

Screeshot of the Employee Spotlight web part options.

Once the user selects all the configuration details, the web part displays the spotlight details from the configured list.

Screeshot of the Employee Spotlight web part.

Data is displayed only when hosted in SharePoint. No mock data included at this point for local testing.

Compatibility

SPFx 1.8.0 Node.js v6 | v5 Compatible with SharePoint Online Does not work with SharePoint 2019 Does not work with SharePoint 2016 (Feature Pack 2) Local Workbench Incompatible Hosted Workbench Compatible

Applies to

Solution

Solution Author(s)
js-employee-spotlight SPS (Strategic Products and Services)

Version history

Version Date Comments
1.0 June 12, 2017 Initial release

Minimal Path to Awesome

  • Clone this repository
  • in the command line run:
    • npm install
    • tsd install
    • gulp serve
    • Open the workbench on your Office 365 Developer tenant
      • Basic functionality can be tested locally, data is only shown when used in context of SharePoint

Features

The js-employee-spotlight web part displays the content of the list specified in the web part properties pane, The list should have the 3 mandatory fields.

This Web Part illustrates the following concepts on top of the SharePoint Framework:

  • Using a dynamic drop down box in the web part properties pane to display cascading dropdowns, which contains
    • the titles webs in current sitecollection
    • titles of the lists in the selected web
    • fields of a selected list
  • Use of a third party control(sp-client-custom-fields) for selecting web part foreground and background colors.
  • Use of switch, slider controls to configure slider speed and auto scrolling.
  • Using a javascript slider.
  • Fetching the user details from User Profile service like user designation, user profile image.
  • Logging.
  • Rendering error messages.

Help

We do not support samples, but we this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.

If you're having issues building the solution, please run spfx doctor from within the solution folder to diagnose incompatibility issues with your environment.

You can try looking at issues related to this sample to see if anybody else is having the same issues.

You can also try looking at discussions related to this sample and see what the community is saying.

If you encounter any issues while using this sample, create a new issue.

For questions regarding this sample, create a new question.

Finally, if you have an idea for improvement, make a suggestion.

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.