Laravel Blade 教學:用 @push 和 @stack 優雅插入 CSS 與 JavaScript

在使用 Laravel 開發網站時,我們常常會遇到這樣的需求:

  • 在某些頁面插入額外的 CSS 或 JavaScript

  • 不要修改主版面(layout)

  • 保持 Blade 模板整潔又彈性

這時候 Laravel Blade 提供的 @push@stack 指令,就是最好的解決方案!

 

為什麼要用 @push@stack

假設你在一個網頁頁面中需要使用幻燈片插件(如 Glide.js),你可能會在 <head> 加上 <style>,在 <body> 底部加上 <script>

但如果這些東西只是特定頁面才需要,硬寫在主版面會造成污染,也不利維護。

這時候你可以用:

  • @push('styles'):把 CSS 推進「樣式堆疊區」

  • @stack('styles'):在 <head> 中輸出這些堆疊的 CSS

 

基本範例

主版面:layouts/app.blade.php

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>我的 Laravel 網站</title>
    @stack('styles') {{-- 所有子頁面的 CSS 都會集中輸出在這裡 --}}
</head>
<body>

    @yield('content')

    @stack('scripts') {{-- 所有子頁面的 JS 都會集中輸出在這裡 --}}
</body>
</html>

 

子頁面:例如 resources/views/home.blade.php

@extends('layouts.app')

@section('content')
    <h1>首頁</h1>

    <div class="glide">
        <!-- 幻燈片內容 -->
    </div>
@endsection

{{-- 推送 CSS 到 styles 區塊 --}}
@push('styles')
<style>
  .glide { width: 100%; }
  .glide__slide { background: #eee; padding: 50px; text-align: center; }
</style>
@endpush

{{-- 推送 JS 到 scripts 區塊 --}}
@push('scripts')
<script src="https://cdn.jsdelivr.net/npm/@glidejs/glide"></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    new Glide('.glide').mount();
  });
</script>
@endpush

 

多個區塊都可以 @push

你可以在一個頁面中多次使用 @push('scripts'),Blade 會自動依照順序「累加」進同一個 @stack 裡,而不會覆蓋彼此。

@push('scripts')
<script src="js/one.js"></script>
@endpush

@push('scripts')
<script src="js/two.js"></script>
@endpush

這樣在主版面 @stack('scripts') 就會輸出兩個 <script>

 

結合 @include 更好用

你甚至可以在 @include 的元件中寫 @push,達到元件化時自動帶入所需的 CSS/JS。

例如 resources/views/components/slider.blade.php

<div class="glide">
    <!-- 幻燈片內容 -->
</div>

@push('styles')
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@glidejs/glide/dist/css/glide.core.min.css">
@endpush

@push('scripts')
<script src="https://cdn.jsdelivr.net/npm/@glidejs/glide"></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    new Glide('.glide').mount();
  });
</script>
@endpush

 

小提醒

  • 如果 @push 了某個區塊,但主版面沒有對應的 @stack,那內容就不會輸出。

  • 你也可以搭配 @once 使用,避免重複輸出相同資源。

@once
@push('scripts')
<script src="..."></script>
@endpush
@endonce

 

結語

使用 @push@stack 可以讓你的 Laravel Blade 更加模組化與乾淨,特別是當你在開發大型網站、或有很多子元件需要引入各自的資源時。

這個技巧非常適合與元件搭配使用,讓 CSS、JS 不再集中在 layout 裡,也不會污染其他頁面!

 

課程推薦

用 AI 生成網站? AI 高效網站設計實戰課:ChatGPT X HTML X SEO

用 AI 生成網站? AI 高效網站設計實戰課:ChatGPT X HTML X SEO

利用 AI 提升網站設計效率與 SEO 排名!了解如何透過 ChatGPT 等工具快速建立 HTML 架構,優化關鍵字與用戶體驗,讓網站更具競爭力。

輸入折扣碼 TC1533SL 還可以額外獲得 NT$500 優惠喔。

AI工作術全面學習實戰營:6 堂精選課程,學會最好用 AI 工具,翻轉你的人生

AI工作術全面學習實戰營:6 堂精選課程,學會最好用 AI 工具,翻轉你的人生

《PChome雜誌》攜手 5 位在 AI 領域的專業講師,打造上述 6 堂實用課程,教你學會時下最好用的 AI 工具,導入生成式 AI 來產製工作內容,改造並升級你的工作流程。

輸入折扣碼 ZERO2024 還可以額外獲得 NT$400 優惠喔。

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

本課程專為希望深入了解 HTML 並有效結合 SEO 策略的學員設計。我們將重點放在 HTML 的深度學習與應用上,同時穿插介紹如何透過搜索引擎優化提升網站能見度。透過即時互動式的直播教學,加上 ChatGPT 的輔助,您將學習到如何建立一個結構優良、美觀且符合 SEO 標準的網站。這不僅會提升網站的用戶體驗,還會大幅提高網站的搜索引擎排名,進而增加訪客流量和潛在客戶。
用AI強化職場競爭力 ChatGPT、Midjourney從入門到精通

用AI強化職場競爭力 ChatGPT、Midjourney從入門到精通

在快速變遷的職場中,提升競爭力成為關鍵。透過引領潮流的AI技術,ChatGPT和Midjourney將助您勇攀高峰。無論您是AI新手還是專家,這個課程將引導您從入門到精通,解密AI的奧秘,並學習如何運用於職場。
GitHub Copilot AI 程式碼編輯工具應用實務班

GitHub Copilot AI 程式碼編輯工具應用實務班

讓學員瞭解有效地使用該工具來加速開發流程、提高程式碼品質和生產力。課程重點放在以 JavaScript 程式語言為例,介紹 Copilot 的基本原理、使用方法和最佳實踐。

輸入折扣碼 TC1456JA 還可以額外獲得 NT$500 優惠喔。

ChatGPT X Clipchamp AI 生成影片、配音與字幕應用實戰班

ChatGPT X Clipchamp AI 生成影片、配音與字幕應用實戰班

掌握Clipchamp AI的操作技巧,靈活運用Clipchamp AI進行影片編輯和創作,實現創意表達和傳播目的。

輸入折扣碼 TC1451JAN 還可以額外獲得 NT$500 優惠喔。

如何串接多種數位工具資訊?Looker Studio 資料視覺化實戰班|GoogleAds x FB廣告 x GA流量數據

如何串接多種數位工具資訊?Looker Studio 資料視覺化實戰班|GoogleAds x FB廣告 x GA流量數據

Looker Studio除了可協助使用者監控網站流量、廣告成效、選擇匯入資源的管道之外,還可以將數據資料多平台整合、數據報表即時更新、數據範本可重複套用的效益,透過自動化系統,將數據全部匯入同一個報表平台,是企業不可或缺的重要工具。

輸入折扣碼 TC1270JIA 還可以額外獲得 NT$500 優惠喔。

和我們交流

加入我們的社群,裡面會有一些技術的內容、有趣的技術梗,以及職缺的分享,歡迎和我們一起討論。