black bull slot

black bull slot

This page assumes you've already read the Components Basics. Read that first if you are

new to components.

Slot Content and6️⃣ Outlet ​

We have learned that components can accept

props, which can be JavaScript values of any type. But how about6️⃣ template content? In

some cases, we may want to pass a template fragment to a child component, and let the

6️⃣ child component render the fragment within its own template.

For example, we may have a

component that supports usage like6️⃣ this:

template < FancyButton > Click

me!

The template of looks like

this:

template <6️⃣ button class = "fancy-btn" > < slot >

button >

The element is6️⃣ a slot outlet that indicates where the parent-provided

slot content should be rendered.

And the final rendered DOM:

html < button class6️⃣ =

"fancy-btn" >Click me!

With slots, the is responsible for

rendering the outer (and its fancy styling),6️⃣ while the inner content is

provided by the parent component.

Another way to understand slots is by comparing them

to JavaScript6️⃣ functions:

js // parent component passing slot content FancyButton (

'Click me!' ) // FancyButton renders slot content in its own6️⃣ template function

FancyButton ( slotContent ) { return `

R${ slotContent }

` }

Slot content is not just limited to6️⃣ text. It can be any valid template

content. For example, we can pass in multiple elements, or even other

components:

template6️⃣ < FancyButton > < span style = "color:red" >Click me! <

AwesomeIcon name = "plus" />

By using slots, our is more

flexible and reusable. We can now use it in different places with different6️⃣ inner

content, but all with the same fancy styling.

Vue components' slot mechanism is

inspired by the native Web Component 6️⃣ element, but with additional capabilities

that we will see later.

Render Scope ​

Slot content has access to the data scope of6️⃣ the

parent component, because it is defined in the parent. For example:

template < span >{{

message }} <6️⃣ FancyButton >{{ message }}

Here both {{ message

}} interpolations will render the same content.

Slot content does not have6️⃣ access to

the child component's data. Expressions in Vue templates can only access the scope it

is defined in, consistent6️⃣ with JavaScript's lexical scoping. In other

words:

Expressions in the parent template only have access to the parent scope;

expressions in6️⃣ the child template only have access to the child scope.

Fallback Content

​

There are cases when it's useful to specify fallback6️⃣ (i.e. default) content for a

slot, to be rendered only when no content is provided. For example, in a

6️⃣ component:

template < button type = "submit" > < slot >

We might

want the text "Submit"6️⃣ to be rendered inside the if the parent didn't provide

any slot content. To make "Submit" the fallback content,6️⃣ we can place it in between the

tags:

template < button type = "submit" > < slot > Submit

Now when we use in a parent component,

providing no content6️⃣ for the slot:

template < SubmitButton />

This will render the

fallback content, "Submit":

html < button type = "submit" >Submit

But6️⃣ if we

provide content:

template < SubmitButton >Save

Then the provided

content will be rendered instead:

html < button type =6️⃣ "submit" >Save

Named

Slots ​

There are times when it's useful to have multiple slot outlets in a single

component.6️⃣ For example, in a component with the following

template:

template < div class = "container" > < header > < main > < footer >

For these cases,6️⃣ the

element has a special attribute, name , which can be used to assign a unique ID to

different6️⃣ slots so you can determine where content should be rendered:

template < div

class = "container" > < header > <6️⃣ slot name = "header" > < main >

< slot > < footer > < slot name = "footer" >

div >

A outlet6️⃣ without name implicitly has the name "default".

In a parent

component using , we need a way to pass multiple6️⃣ slot content fragments,

each targeting a different slot outlet. This is where named slots come in.

To pass a

named slot,6️⃣ we need to use a