petite-vue 基本使用指南

Yune_Neko發表於2024-06-28

前言

petite-vue 是為漸進增強而最佳化的另一種 Vue 發行版。它提供與標準 Vue 相同的模板語法和反應性心智模型。

不過,它專門針對在由伺服器框架呈現的現有 HTML 頁面上“散佈”少量互動進行了最佳化。

petite-vue,它在提供 vue 基本功能的同時,還能一個輕量級,簡單應用的微框架,這樣也能保證開發者有一個不錯的使用體驗。

  • 只有 ~6kb
  • 相容 Vue 的模板語法
  • 基於 DOM,就地變化
  • 由 @vue/reactivity 驅動
  • 無需構建

引入專案

CDN 引入

<div v-scope="{ count: 0 }">
  {{ count }}
  <button @click="count++">inc</button>
</div>

<script
  src="https://unpkg.com/petite-vue@0.4.1/dist/petite-vue.iife.js"
  defer
  init
></script>

當然也可以把該地址內部程式碼全部賦值到本地 js 檔案中使用

  • defer 屬性可使指令碼在文件被解析後執行

    如不使用 defer 則需手動初始化 PetiteVue.createApp().mount()

  • init 屬性會告訴 petite-vue 自動查詢和初始化頁面上所有具有 v-scope 的元素

  • v-scope 標記頁面上需要使用 petite-vue 渲染的地方

根作用域

使用 createApp 在頁面上註冊一個根作用域, 內容在 html 程式碼中可用. 可以理解為在 Vue 中的暴露至 template

<script type="module">
  import { createApp } from "../lib/petite-vue.js";
  createApp({
    // 暴露出的資料 直接寫在 createApp 內的是響應式資料
    count: 0,
    // getter
    get plusOne() {
      return this.count + 1;
    },
    // methods
    increment() {
      this.count++;
    },
  }).mount();
</script>
<div v-scope>
  <!-- 經典的插值表示式 -->
  <p>{{ count }}</p>
  <p>{{ plusOne }}</p>
  <!-- v-on也是可用的 -->
  <button @click="increment">increment</button>
</div>

全域性狀態管理

<script type="module">
  import { createApp, reactive } from "../lib/petite-vue.js";
  // 定義單獨一個物件存放資料 需要 reactive 來轉為響應式資料
  const store = reactive({
    count: 1,
  });
  function inc() {
    store.count++;
  }
  // 執行一次
  inc();
  createApp({
    store,
    inc,
  }).mount();
</script>

<div v-scope="{ localCount: 0 }">
  <p>Global {{ store.count }}</p>
  <button @click="inc">增加全域性資料</button>

  <p>Local {{ localCount }}</p>
  <button @click="localCount++">增加區域性變數</button>
</div>

生命週期

可以監聽掛載與解除安裝事件

<div
  v-if="show"
  @vue:mounted="console.log('mounted on: ', $el)"
  @vue:unmounted="console.log('unmounted: ', $el)"
></div>

元件

使用元件可以複用邏輯 但 petite-vue 的元件並不那麼好用

按照 Vue 的習慣, 也可以使用一個 js 檔案作為一個元件

// footer.js
// 可以傳遞 props
export default function (props) {
  return {
    // 元件模板
    $template: `<footer>頁尾元件</footer>`,
    msg: "A message",
    print() {
      console.log(props);
    },
  };
}

如果建立了一個獨立的 js 檔案作為元件, 則模板只能為字串形式

在官方的 README 中模板有template元素的用法. 但那種只能寫在 html 檔案中, 而寫在 html 檔案內的元件無法複用. 故在此不作展示

<!-- index.html -->
<!-- 使用元件 傳遞引數200 且在掛載時觸發方法 -->
<div v-scope="footer(200)" @vue:mounted="print"></div>
<script type="module" src="src/lib/petite-vue.js" defer int></script>
<script type="module">
  import { createApp } from "../lib/petite-vue.js";
  // 引入元件
  import footer from "../components/footer.js";
  createApp({
    footer, // 注入元件
  }).mount();
</script>

需要注意的是 @vue:mounted="print" 這個print方法的作用域是元件內的print

基本示例

<!-- 在頁面載入時執行函式 -->
<body v-scope @vue:mounted="loadArticle()">
  <!-- v-show 顯示控制 -->
  <ul v-show="!store.currentHash.includes('#4')">
    <li v-show="store.currentHash.includes('#1-')">
      <a href="javascript:;" class="nav-header">導航欄</a>
      <dl>
        <!-- v-on 與 class 的繫結 -->
        <dd :class="{'layui-this':store.currentHash === '#1-1'}">
          <a href="#1-1">1-1</a>
        </dd>
      </dl>
    </li>
  </ul>
  <script type="module" src="src/lib/petite-vue.js" defer int></script>
  <script type="module">
    import "../lib/layui/layui.js";
    import { createApp, reactive } from "../lib/petite-vue.js";
    // 全域性響應式資料
    const store = reactive({
      currentHash: "",
    });
    function loadArticle() {
      // do ...
    }
    // 當頁面雜湊改變時執行操作
    window.onhashchange = () => loadArticle();
    // 建立根作用域
    createApp({
      store,
      loadArticle,
    }).mount();
  </script>
</body>

參考連結

https://github.com/vuejs/petite-vue

相關文章