sp-dev-fx-webparts/samples/react-rxjs-event-emitter/README.md

3.1 KiB
Raw Blame History

SPFx ReactiveX (RxJs) Event Emitter Sample

Summary

This sample shows how we can use the ReactiveX (RxJs) library with the SharePoint Framework to communicate between web parts through broadcasting events utilizing the Publishsubscribe pattern. It enables a webpart or component to emit event (broadcast message) and that event is received by other web parts or components that have been subscribed to receive it. Please note this is custom implementation of the Publishsubscribe pattern by using the ReactiveX (RxJs) library. The SPFx will nativelly support this in future without the need of custom implementation through new SPFx api called Event Aggregator, but it is still in Alpha.

SPFx ReactiveX (RxJs) Event Emitter Sample

Used SharePoint Framework Version

drop

Applies to

Prerequisites

Solution

Solution Author(s)
react-rxjs-event-emitter Velin Georgiev ( @VelinGeorgiev )

Version history

Version Date Comments
0.0.1 August 22, 2017 Initial commit
0.0.2 April 20, 2018 Updated to SPFx v1.4.1

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.
  • Open the command line, navigate to the web part folder and execute:
    • npm i
    • gulp test (optional)
    • gulp serve

Features

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

  • Using React for building SharePoint Framework client-side web parts.
  • Using Office UI Fabric React styles for building user experience consistent with SharePoint and Office.
  • The use the ReactiveX (RxJs) Event Emitter to broadcast messages (events).
  • The use the ReactiveX (RxJs) Event Emitter to subscribe and receive broadcasted messages (events).
  • Unit tests including spies, mocks and faking class methods and properties.

Making the RxJsEventEmitter external SPFx library.

The RxJsEventEmitter library can be turned into external library so it can be used by multiple SPFx solutions. There is a very good blog post by @waldekmastykarz how this can be done.