Local Components
The way we have included components so far makes them accessible from all *.vue
files in a project.
Components can be made to be local, meaning that they are only accessible inside a specific *.vue
file.
Global Components
The way we have included components inside main.js
so far make the components accessible inside the <template>
of all other *.vue
files in that project.
Example
We use the CompOne.vue
component inside both CompTwo.vue
and App.vue
to show that components are accessible to each other with our current main.js
setup.
main.js
:
import { createApp } from 'vue'
import App from './App.vue'
import CompOne from './components/CompOne.vue'
import CompTwo from './components/CompTwo.vue'
const app = createApp(App)
app.component('comp-one', CompOne)
app.component('comp-two', CompTwo)
app.mount('#app')
Run Example »
Local Components
We can include a component directly in the <script>
tag in a *.vue
file instead of including it in main.js
.
If we include a component directly in a *.vue
file, the component
becomes accessible only locally in that file.
Example
To make CompOne.vue
local to App.vue
, and only accessible there, we remove it from main.js
.
main.js
:
import { createApp } from 'vue'
import App from './App.vue'
import CompOne from './components/CompOne.vue'
import CompTwo from './components/CompTwo.vue'
const app = createApp(App)
app.component('comp-one', CompOne)
app.component('comp-two', CompTwo)
app.mount('#app')
And include CompOne.vue
directly in the <script>
tag of App.vue
instead.
App.vue
:
<template>
<h3>Local Component</h3>
<p>The CompOne.vue component is a local component and can only be used inside App.vue.</p>
<comp-one />
<comp-two />
</template>
<script>
import CompOne from './components/CompOne.vue';
export default {
components: {
'comp-one': CompOne
}
}
</script>
Run Example »
The CompOne.vue
component is now only available in App.vue
.
If you run the application in development mode and try to use CompOne.vue
from inside CompTwo.vue
you get a warning: