Share
Embed
Transcript
56 slides
-
Angular Elements .NET Day Bern, 23.05.2019 Thomas Gassmann @gassmannT 22.05.2019
.NET Day Bern - Angular Elements 1 -
Thomas Gassmann Principal Consultant, Trainer, Speaker thomasgassmann.ch @gassmannT 22.05.2019 .NET
Day Bern - Angular Elements 2 -
Agenda 22.05.2019 .NET Day Bern - Angular Elements 3 ▪
Intro Angular Elements ▪ Web Components ▪ Getting started with Angular Elements ▪ Outlook -
22.05.2019 .NET Day Bern - Angular Elements 5 «Angular is
ideal for building complete applications, and our tooling, documentation and infrastructure are primarily aimed at this case.» Rob Wormald, Angular Team -
Platform 22.05.2019 .NET Day Bern - Angular Elements 6 Dependency
Injection Decorators Zones Compile Binding Render Material Mobile Universal CLI Language Service Augury ngUpdate Router Animation i18n -
22.05.2019 .NET Day Bern - Angular Elements 7 «[…] but
it’s quite challenging to use in scenarios that don’t fit that specific Singe Page Application model.» Rob Wormald, Angular Team -
Use case 22.05.2019 .NET Day Bern - Angular Elements 8
▪ Enhancing existing HTML Pages ▪ Content Management Systems integration ▪ Use components in other environments or frameworks ▪ Microfrontends ▪ Migrating Legacy Apps -
Web Components 22.05.2019 .NET Day Bern - Angular Elements 11
Web Components are a set of features added by the W3C HTML Template Shadow DOM HTML Imports Custom Elements -
Custom Elements 22.05.2019 .NET Day Bern - Angular Elements 13
Custom elements share the same API surface as native DOM objects: ▪ Attributes ▪ Properties ▪ Methods ▪ Events -
Create and Define a Custom Element 22.05.2019 .NET Day Bern
- Angular Elements 14 class myElement extends HTMLElement { … } customElements.define('my-element', myElement); -
Reactions 22.05.2019 .NET Day Bern - Angular Elements 15 class
myElement extends HTMLElement { connectedCallback() { ... } disconnectedCallback() { ... } } -
Attributes 22.05.2019 .NET Day Bern - Angular Elements 16 class
myElement extends HTMLElement { static get observedAttributes() { return ['country']; } attributeChangedCallback(name, oldValue, newValue) { if (name === 'country') { // do something with newValue } } } -
Properties 22.05.2019 .NET Day Bern - Angular Elements 18 class
myElement extends HTMLElement { get country() { return this.getAttribute('country'); } set country(val) { this.setAttribute('country', val); } } -
22.05.2019 .NET Day Bern - Angular Elements 19 let games
= document.querySelector('world-cup-statistics'); games.country = 'ger'; -
Custom Events 22.05.2019 .NET Day Bern - Angular Elements 20
class myElement extends HTMLElement { emitCountryChange() { this.dispatchEvent( new CustomEvent('country-change', { detail: this.country })); } } -
22.05.2019 .NET Day Bern - Angular Elements 21 let games
= document.querySelector('world-cup-statistics'); games.addEventListener('country-change', event => { ... }); -
Custom Elements in Angular 22.05.2019 .NET Day Bern - Angular
Elements 22 <world-cup-statistics [country]="'sui'" (countryChanged)="foobar($event)" > </world-cup-statistics > => Angular has been designed for this -
Enter Angular Elements 22.05.2019 .NET Day Bern - Angular Elements
23 Transforming Angular Component to Custom Element -
Enter Angular Elements 22.05.2019 .NET Day Bern - Angular Elements
24 Provides a bridge from angular concepts to web components. ▪ @HostBinding() => Attributes ▪ @Input() => Properties ▪ @Output() => CustomEvents ▪ Lifecycle Hooks => Reactions -
A lot of framework exists 22.05.2019 .NET Day Bern -
Angular Elements 25 -
Platform 22.05.2019 .NET Day Bern - Angular Elements 27 Dependency
Injection Decorators Zones Compile Binding Render Material Mobile Universal CLI Language Service Augury ngUpdate Router Animation i18n -
First Steps 22.05.2019 .NET Day Bern - Angular Elements 28
Update Angular CLI Update Angular CLI to > 6 ng new angularElements Create a new Angular CLI project ng add @angular/elements Add support for angular elements ng g c <NAME> -v ShadowDom Generate new component -
Component 22.05.2019 .NET Day Bern - Angular Elements 29 @Component({
selector: 'app-world-cup-statistics', templateUrl: '…', encapsulation: ViewEncapsulation.ShadowDom }) export class WorldCupStatisticsComponent implements OnInit { public games$: Observable<Game[]>; constructor(private service: GameService) {} ngOnInit() {… } } -
Module 22.05.2019 .NET Day Bern - Angular Elements 30 export
class AppModule { constructor(private injector: Injector) {} ngDoBootstrap() { const el1 = createCustomElement( WorldCupStatisticsComponent, { injector: this.injector }); customElements.define('world-cup-statistics', el1); } } -
Module 22.05.2019 .NET Day Bern - Angular Elements 31 @NgModule({
imports: [BrowserModule, HttpClientModule], declarations: [WorldCupStatisticsComponent], entryComponents: [WorldCupStatisticsComponent], bootstrap: […] }) export class AppModule { … } -
Module 22.05.2019 .NET Day Bern - Angular Elements 32 @NgModule({
imports: [BrowserModule, HttpClientModule], declarations: [WorldCupStatisticsComponent], entryComponents: [WorldCupStatisticsComponent], bootstrap: […] }) export class AppModule { … } -
First Steps 22.05.2019 .NET Day Bern - Angular Elements 35
▪ Install NPM Package npm install @webcomponents/custom-elements –-save ▪ Add import to polyfills.ts import '@webcomponents/custom-elements/custom-elements.min'; import '@webcomponents/custom-elements/src/native-shim'; -
Add Custom Element dynamically 22.05.2019 .NET Day Bern - Angular
Elements 36 const el = document.createElement('myElement'); el.country = 'SUI'; el.setAttribute('country', 'GER’); el.addEventListener([]); document.body.appendChild(el); -
Angular Elements are the Host Element 22.05.2019 .NET Day Bern
- Angular Elements 38 export class TestComponent implements OnInit { constructor(el: ElementRef) { el.nativeElement // <- Angular Element } @HostListener('click’) onHostClick($event) { ... } @HostBinding('attr.selected') isActive: boolean; } -
Dependency Injection 22.05.2019 .NET Day Bern - Angular Elements 39
Plattform Injector (Renderer) Module Injector (Services) Component Injector (ElementRef) -
Dependency Injection in Angular Elements 22.05.2019 .NET Day Bern -
Angular Elements 40 Plattform Injector (Renderer) Module Injector (Services) Element Injector (ElementRef) Element Injector (ElementRef) -
Module 22.05.2019 .NET Day Bern - Angular Elements 41 export
class AppModule { constructor(private injector: Injector) {} ngDoBootstrap() { const el1 = createCustomElement( WorldCupStatisticsComponent, { injector: this.injector }); customElements.define('world-cup-statistics', el1); } } -
Content Projection 22.05.2019 .NET Day Bern - Angular Elements 43
<app-test> <span>Hallo Welt</span> </app-test> @Component({ selector: 'app-test', template: ` <ng-content></ng-content> ` }) export class TestComponent { } -
Shadow DOM 22.05.2019 .NET Day Bern - Angular Elements 44
@Component({ … encapsulation: ViewEncapsulation.ShadowDom }) export class WorldCupStatisticsComponent implements OnInit { … } -
Angular Elements in V7 22.05.2019 .NET Day Bern - Angular
Elements 46 ▪ It is just the beginning ▪ Size is too big for shipping in non Angular projects ▪ Will be much better with Ivy (V8) ▪ Will be much easier with V8+ ▪ Browser Support. -
Outlook 22.05.2019 .NET Day Bern - Angular Elements 47 @Component({
selector: 'app-test', template: '...', customElement: true }) export class TestComponent { ... } -
22.05.2019 .NET Day Bern - Angular Elements 48 How to
use it today in non Angular Projects? -
Optimize and combine bundle in a single file 22.05.2019 .NET
Day Bern - Angular Elements 49 npm install ngx-build-plus Install package ngx-build-plus "build:element": "ng build --prod --output- hashing=none --single-bundle --keep-polyfills" Add script command npm run build:element Run Command ng add ngx-build-plus Install package ngx-build-plus -
22.05.2019 .NET Day Bern - Angular Elements 52 It is
just the beginning. Stay tuned with Angular 8+ -
A Special Thanks To 22.05.2019 .NET Day Bern - Angular
Elements 53 Manfred Steyer https://www.softwarearchitekt.at/ -
Ressources 22.05.2019 .NET Day Bern - Angular Elements 54 ▪
github.com/gassmannT/ngElement ▪ thomasgassmann.net ▪ swissangular.com ▪ m.trivadis.com/angular ▪ angular-academy.ch -
Thank you Thomas Gassmann @gassmannT thomasgassmann.net [email protected] 22.05.2019 .NET Day
Bern - Angular Elements 55