Juri Strumpflohner
Juri Strumpflohner Juri is a full stack developer and tech lead with a special passion for the web and frontend development. He creates online videos for Egghead.io, writes articles on his blog and for tech magazines, speaks at conferences and holds training workshops.

Multi Content Projection aka Multiple Transclusion

How named/multi-slot transclusion works in Angular

2 min read

If you’re an AngularJS developer, I’m sure you heard about transclusion. Sounds really weird and mysterious, at least that’s what I thought when I first heard it.

If you google for it, you’ll probably land on one of Thoughtram’s articles (as you’ll do 90% of the time if you search for Angular articles 😉). This one is about multiple transclusion and named slots which is available in Angular 1.5.
What it does is to allow you to basically specify multiple regions within your component’s template, which can be provided by the component user. This is a huge improvement as previously you had to do a couple of hacks to arrive to the same result.

But what about Angular version 2+, I thought, and so I tweeted:

And here we go.

//our root app component
import {Component} from '@angular/core'

@Component({
  selector: 'multi-content',
  template: `
    <h3>Demoing content projection</h3>
    <div class="box">
      <ng-content select="[header]"></ng-content>
    </div>
    <div class="box">
      <ng-content select="[body]"></ng-content>
    </div>
  `,
  styles: [
    `
    .box {
      min-height: 30px;
      border: 1px solid black;
      display: block;
    }
    `
  ]
})
export class ContentProjectionComponent {}

We use <ng-content> alone if we don’t have the need for multiple content projection (as it’s apparently called in Angular). Otherwise, we can use the select property:

...
<ng-content select="[header]"></ng-content>
...

The component user can then define which content goes where:

<multi-content>
    <div header>This is projected to the header region</div>
    <div body>This goes to the body instead</div>
</multi-content>

Try it out yourself:

Another example of a collapsible panel component:

comments powered by Disqus