sp-dev-fx-webparts/samples/js-employee-spotlight

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.

.

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

.

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

Compatibility

⚠️ 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.

Applies to

• SharePoint Framework Developer
• Office 365 developer tenant

Contributors

• 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

This sample can also be opened with VS Code Remote Development. Visit https://aka.ms/spfx-devcontainer for further instructions.

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.