content.md

@typedef {can-stache.sectionRenderer} can-component/content @parent can-component.elements

Positions the LIGHT_DOM within a component’s [can-component.prototype.view].

@signature <content>DEFAULT_CONTENT</content>

When a user creates a new component in a view, the content between the tags is the LIGHT_DOM. For example, Hello <b>World</b> is the LIGHT_DOM in the following:

<my-tag>Hello <b>World</b></my-tag>

The <content> tag can be used within my-tag to position the LIGHT_DOM. For example, to position the LIGHT_DOM within an <h1>, <my-tag> could be defined like:

import Component from "can-component";

Component.extend( {
	tag: "my-tag",
	view: "<h1><content/></h1>"
} );

 @param {can-stache.sectionRenderer} [DEFAULT_CONTENT] The content that should be
 used if there is no `LIGHT_DOM` passed to the component.

 The following, makes `my-tag` show `Hi There!` if no `LIGHT_DOM` is passed:

 ```js

Component.extend( { tag: "my-tag", view: "

Hi There!

" } );

The children of `<content>` can be used as a default value for rendering in the case that no content is passed.

for example: 
```js
Component.extend( {
    tag: "my-tag",
    view: stache( "<h1><content>Hello world</content></h1>" )
} );

used like <my-tag></my-tag>

will render:

<my-tag><h1>Hello world</h1></my-tag>

When the content is specified, those children will be ignored:

<my-tag>Hello friend</my-tag> will render:

<my-tag><h1>Hello friend</h1></my-tag>