Including sub-views (@include) in Laravel - Step-by-Step Execution

Concept Flow - Including sub-views (@include)

Main View Starts Rendering

↓

@include Directive Found

↓

Load Sub-view Template

↓

Render Sub-view Content

↓

Insert Sub-view Content into Main View

↓

Continue Main View Rendering

↓

Main View Fully Rendered

The main view starts rendering, finds an @include directive, loads and renders the sub-view, inserts its content, then continues rendering the main view.

Execution Sample

Laravel

@include('header')
<p>Welcome to the site!</p>
@include('footer')

This code includes the 'header' sub-view, then shows a welcome message, then includes the 'footer' sub-view.

Execution Table

Step	Action	Template Processed	Output Produced	Notes
1	Start rendering main view	main view		Begin main template processing
2	Encounter @include('header')	main view		Pause main view to load sub-view
3	Load and render 'header' sub-view	header	<header>Site Header</header>	Sub-view content generated
4	Insert 'header' content into main view	main view	<header>Site Header</header>	Sub-view content placed
5	Render main view content after header	main view	<p>Welcome to the site!</p>	Main content rendered
6	Encounter @include('footer')	main view		Pause main view to load sub-view
7	Load and render 'footer' sub-view	footer	<footer>Site Footer</footer>	Sub-view content generated
8	Insert 'footer' content into main view	main view	<footer>Site Footer</footer>	Sub-view content placed
9	Finish rendering main view	main view	<header>Site Header</header><p>Welcome to the site!</p><footer>Site Footer</footer>	Full page output ready

💡 All parts rendered and combined, main view output complete

Variable Tracker

Variable	Start	After Step 3	After Step 7	Final
main_view_output	""	"<header>Site Header</header>"	"<header>Site Header</header><p>Welcome to the site!</p>"	"<header>Site Header</header><p>Welcome to the site!</p><footer>Site Footer</footer>"
sub_view_content	""	"<header>Site Header</header>"	"<footer>Site Footer</footer>"	""

Key Moments - 2 Insights

Why does the main view pause rendering when it hits @include?

Because @include tells Laravel to load and render the sub-view first, then insert its content before continuing the main view. See steps 2-4 and 6-8 in the execution table.

Is the sub-view output separate or combined with the main view?

The sub-view output is generated separately but immediately inserted into the main view output. This is shown by the 'sub_view_content' variable in the tracker and the combined output in the main_view_output.

Visual Quiz - 3 Questions

Look at the execution table, what is the output after step 4?

A "<footer>Site Footer</footer>"

B "<header>Site Header</header>"

C "<p>Welcome to the site!</p>"

D ""

💡 Hint

Check the 'Output Produced' column at step 4 in the execution table.

At which step does the footer sub-view content get inserted into the main view?

A Step 8

B Step 5

C Step 3

D Step 9

💡 Hint

Look for the step where 'Insert 'footer' content into main view' happens in the execution table.

If the 'header' sub-view was empty, how would main_view_output change after step 4?

A ""

B "<p>Welcome to the site!</p>"

C "" (empty string)

D "<header>Site Header</header>"

💡 Hint

Refer to variable_tracker for 'main_view_output' after step 3 and imagine 'sub_view_content' is empty.

Concept Snapshot

@include('view_name') inserts another view's content into the current view.
Laravel pauses the main view rendering, loads and renders the sub-view,
then inserts its output right where @include is called.
This helps reuse common parts like headers or footers.
Sub-views render fully before main view continues.

Full Transcript

When Laravel renders a view with @include, it starts the main view rendering. When it finds @include('subview'), it pauses the main view, loads and renders the sub-view fully, then inserts that sub-view's content into the main view output. After insertion, the main view continues rendering. This process repeats for each @include. The final output combines all parts into one HTML page. Variables track the main view output growing as sub-views insert their content. This lets developers reuse pieces like headers or footers easily by including them where needed.

Practice

1. What does the @include directive do in a Laravel Blade template?

easy

A. It creates a new database migration file.

B. It defines a new route in the web.php file.

C. It inserts a sub-view inside the current view to reuse code.

D. It compiles all CSS files into one.

Solution

1. Step 1: Understand the purpose of @include

   The @include directive is used in Blade templates to insert one view inside another, allowing code reuse.

2. Step 2: Identify what @include does not do

   It does not define routes, create migrations, or compile CSS files, which are unrelated tasks.

3. Final Answer:

   It inserts a sub-view inside the current view to reuse code. -> Option C

4. Quick Check:

   @include = Insert sub-view [OK]

Hint: Remember: @include inserts reusable view parts [OK]

Common Mistakes:

• Confusing @include with routing or migrations
• Thinking @include compiles assets
• Assuming @include creates new files

2. Which of the following is the correct syntax to include a Blade sub-view named header?

easy

A. @include('header')

B. @include:header

C. @include[header]

D. @include{header}

Solution

1. Step 1: Recall Blade include syntax

   The correct syntax uses parentheses and quotes: @include('viewname').

2. Step 2: Check each option format

   Only @include('header') uses the correct parentheses and quotes. Others use invalid symbols.

3. Final Answer:

   @include('header') -> Option A

4. Quick Check:

   Correct syntax uses parentheses and quotes [OK]

Hint: Use parentheses and quotes with @include [OK]

Common Mistakes:

• Using colons, brackets, or braces instead of parentheses
• Omitting quotes around view name
• Writing @include without parentheses

3. Given the following Blade code:

@include('nav')

and the nav.blade.php contains:

<nav>Menu</nav>

What will be the rendered output inside the main view?

medium

A. <nav>Menu</nav>

B. Menu

C. @include('nav')

D. Error: View not found

Solution

1. Step 1: Understand @include output

   The @include('nav') inserts the entire content of nav.blade.php into the main view.

2. Step 2: Check the content of nav.blade.php

   It contains the HTML <nav>Menu</nav>, so this exact HTML will appear in the output.

3. Final Answer:

   <nav>Menu</nav> -> Option A

4. Quick Check:

   @include inserts full sub-view content [OK]

Hint: Included view content appears exactly where @include is placed [OK]

Common Mistakes:

• Expecting only inner text without tags
• Thinking @include outputs the directive text
• Assuming an error if view exists

4. What is the error in this Blade code snippet?

@include('footer')

Assuming the file footer.blade.php does not exist in the views folder.

medium

A. Warning: Duplicate view inclusion.

B. No error, it renders nothing.

C. Syntax error due to missing semicolon.

D. Runtime error: View [footer] not found.

Solution

1. Step 1: Check if included view file exists

   The @include('footer') tries to load footer.blade.php. If it does not exist, Laravel throws an error.

2. Step 2: Identify the error type

   Laravel reports a runtime error stating the view is not found, not a syntax or warning error.

3. Final Answer:

   Runtime error: View [footer] not found. -> Option D

4. Quick Check:

   Missing view file causes runtime error [OK]

Hint: Ensure included view files exist to avoid runtime errors [OK]

Common Mistakes:

• Assuming no error if file missing
• Confusing syntax errors with missing files
• Expecting warnings instead of errors

5. How can you pass a variable named title with value 'Welcome' to a sub-view header using @include?

hard

A. @include('header')->with('title', 'Welcome')

B. @include('header', ['title' => 'Welcome'])

C. @include('header', title = 'Welcome')

D. @include('header', {title: 'Welcome'})

Solution

1. Step 1: Recall passing data syntax in @include

   To pass data, use an associative array as the second argument: @include('view', ['key' => value]).

2. Step 2: Check each option for correct syntax

   @include('header', ['title' => 'Welcome']) uses the correct array syntax. Options A, C, and D use invalid or unsupported syntax.

3. Final Answer:

   @include('header', ['title' => 'Welcome']) -> Option B

4. Quick Check:

   Pass data as array in second argument [OK]

Hint: Pass variables as array in second argument of @include [OK]

Common Mistakes:

• Using method chaining with @include
• Passing variables without array brackets
• Using object or JS-like syntax