[12.x] Add @includeIsolated directive for isolated Blade includes
#58311
+43
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR introduces a new
@includeIsolatedBlade directive that includes a view without inheriting the parent scope's variables.I work in a codebase where we use
<x-component>for reusable components and@component()for partials (because we like variable isolation). However,@component()brings overhead we don't need: slot management, the opening/closing tag ceremony, and component lifecycle logic.@includeIsolatedwould give us the best of both worlds: the simplicity of@includewith the isolation of@component.This PR is another shot of: #45616
Motivation
Currently,
@includepasses all parent scope variables viaget_defined_vars():This implicit inheritance can lead to:
The recommended workaround is Blade components (
<x-partials.hero />), but components come with overhead(slots, validation, class resolution) that isn't always needed for simple partials.
Proposed Solution
@includeIsolated()provides explicit-only data passing where "explicit > implicit":Benefits:
@component(no slot/component machinery)@includeIf,@includeWhen,@includeFirstpatterns