honeymoose
/
sp-dev-fx-webparts
mirror of https://github.com/pnp/sp-dev-fx-webparts.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated Readme

This commit is contained in:
Daniel Gaeta 2016-09-09 16:06:55 -07:00
parent 7e48be7b09
commit 7d6c6bf45d
1 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
samples/angular2-prototype/README.md
View File

@ -18,10 +18,23 @@ This package produces the following:
* lib/* commonjs components - this allows this package to be reused from other packages.
* dist/* - a single bundle containing the components used for uploading to a cdn pointing a registered Sharepoint webpart library to.
* src/* - all files for the expiriemental angular2 todo webpart.
* src/webparts/todo/core - an abstract base class that we created for angular2 applications.
* src/webparts/todo/TodoWebPart.ts - a class to create unique instances of the root class component and return other metadata for the NgModule decorator function.
Our experiment findings:
1. Bootstrapping multiple angular2 applications on the same page:
* Each time bootstrap is invoked on a component, it will create ComponentMetadata associated with the class's 'annoations' array for the root component.
* Angular2 uses this annotation array to match element's on the DOM to angular root component references/properties.
* When bootstrap is invoked an additional time with the same root component class, it will again create a ComponentMetadata object and append it to the 'annotions' array associated with the root class.
* However, it appears that only the first defined ComponentMetadata object in the 'annotations' array is parsed by the compiler. (i.e. any other duplicate bootstrapped classes have nativeElements that point to the first boostrapped component)
* We were able to construct a work around by defining our root component class and AppModule as an expression with unique selector tags.
* This forced a new class prototype object to be created with a new annotations array.
* Moreover, it took a bit of reverse engineering and digging into hidden properties to find references to the rootComponent so that we could make updates to class properties and to the view.
Our experiment questions:
* We have 3 questions you can find in 'src/webparts/todo/core/BaseAngular2WebpPart.ts' that are marked by '@question'.
### Build options
gulp nuke - TODO