跳至內容

MPA 模式 實驗性

MPA(多頁面應用程式)模式可透過命令列使用 vitepress build --mpa 啟用,或透過設定中的 mpa: true 選項啟用。

在 MPA 模式中,所有頁面在預設情況下都會在沒有任何 JavaScript 的情況下呈現。因此,製作網站很可能會從稽核工具獲得更好的首次造訪效能評分。

然而,由於沒有 SPA 導覽,跨頁面連結將導致整個頁面重新載入。MPA 模式中的載入後導覽不會像在 SPA 模式中那樣即時。

另請注意,預設不使用 JS 表示您基本上將 Vue 純粹用作伺服器端範本語言。瀏覽器中不會附加任何事件處理常式,因此不會有互動性。若要載入用戶端 JavaScript,您需要使用特殊的 <script client> 標籤

html
<script client>
document.querySelector('h1').addEventListener('click', () => {
  console.log('client side JavaScript!')
})
</script>

# Hello

<script client> 是 VitePress 獨有的功能,而不是 Vue 的功能。它可以在 .md.vue 檔案中使用,但僅限於 MPA 模式。所有佈景主題元件中的用戶端腳本將會一起打包,而特定頁面的用戶端腳本將僅針對該頁面進行拆分。

請注意,<script client> 不會作為 Vue 元件程式碼進行評估:它會被視為一個純粹的 JavaScript 模組。因此,只有在您的網站絕對需要最少的用戶端互動時,才應該使用 MPA 模式。

在 MIT 授權條款下發布。