Skip to content

Commit

Permalink
docs: some small updates
Browse files Browse the repository at this point in the history
  • Loading branch information
danielroe committed Sep 5, 2023
1 parent 007eceb commit 9590647
Showing 1 changed file with 7 additions and 5 deletions.
12 changes: 7 additions & 5 deletions docs/2.guide/2.directory-structure/1.components.md
Expand Up @@ -314,16 +314,18 @@ Now you can register server-only components with the `.server` suffix and use th

Server-only components use `<NuxtIsland>` under the hood, meaning that `lazy` prop and `#fallback` slot are both passed down to `<NuxtIsland>`.

#### server components and context
#### Server Component Context

When rendering a server-only or island component, `<NuxtIsland>` makes a HTTP request to GET a `NuxtIslandResponse`.
When rendering a server-only or island component, `<NuxtIsland>` makes a fetch request which comes back with a `NuxtIslandResponse`. (This is an internal request if rendered on the server, or a request that you can see in the network tab if it's rendering on client-side navigation.)

This means:

- A new Vue app will be created server-side to create the `NuxtIslandResponse`.
- You can't access to the island app context from your SSR app and you can't access to your SSR app context from the island component. Both are different context.
- Plugins will be ran for the island Vue app except those marked with `env.islands: false` on an object plugin.
- A new 'island context' will be created while rendering the component.
- You can't access the 'island context' from the rest of your app and you can't access the context of the rest of your app from the island component. In other words, the server component or island is _isolated_ from the rest of your app.
- Your plugins will run again when rendering the island, unless they have `env: { islands: false }` set (which you can do in an object-syntax plugin).

You can access to an island context within an island component through `nuxtApp.ssrContext.islandContext`.
Within an island component, you can access its island context through `nuxtApp.ssrContext.islandContext`. Note that while island components are still marked as experimental, the format of this context may change.

::alert{type=info}
Slots can be interactive and are wrapped within a `<div>` with `display: contents;`
Expand Down

0 comments on commit 9590647

Please sign in to comment.