Pinia最初是在 2019 年 11 月左右重新設計使用 Composition API的 Vue Store 外觀的實驗。從那時起,最初的原則仍然相同,但 Pinia 適用於 Vue 2 和 Vue 3 ,並且不需要你使用組合 API。除了安裝和SSR之外,兩者的 API 都是相同的,並且這些檔案針對 Vue 3 ,並在必要時提供有關 Vue 2 的註釋,以便 Vue 2 和 Vue 3 使用者可以閱讀!【相關推薦:】
Pinia 是 Vue 的儲存庫,它允許您跨元件/頁面共用狀態。ç 這對於單頁應用程式來說是正確的,但如果它是伺服器端呈現的,則會將您的應用程式暴露給安全漏洞。 但即使在小型單頁應用程式中,您也可以從使用 Pinia 中獲得很多好處:
開發工具支援
熱模組更換
外掛:使用外掛擴充套件 Pinia 功能
為 JS 使用者提供適當的 TypeScript 支援或自動完成功能
伺服器端渲染支援
這就是使用 pinia 在 API 方面的樣子(請務必檢視入門以獲取完整說明)。您首先建立一個商店:
// stores/counter.js import { defineStore } from 'pinia' export const useCounterStore = defineStore('counter', { state: () => { return { count: 0 } }, // could also be defined as // state: () => ({ count: 0 }) actions: { increment() { this.count++ }, }, })
然後在元件中使用它:
import { useCounterStore } from '@/stores/counter' export default { setup() { const counter = useCounterStore() counter.count++ // with autocompletion ✨ counter.$patch({ count: counter.count + 1 }) // or using an action instead counter.increment() }, }
你甚至可以使用一個函數(類似於一個元件setup()
)來為更高階的用例定義一個 Store:
export const useCounterStore = defineStore('counter', () => { const count = ref(0) function increment() { count.value++ } return { count, increment } })
如果您仍然不熟悉setup()
Composition API,請不要擔心,Pinia 還支援一組類似的地圖助手,例如 Vuex。您以相同的方式定義儲存,但隨後使用mapStores()
、mapState()
或mapActions()
:
const useCounterStore = defineStore('counter', { state: () => ({ count: 0 }), getters: { double: (state) => state.count * 2, }, actions: { increment() { this.count++ } } }) const useUserStore = defineStore('user', { // ... }) export default { computed: { // other computed properties // ... // gives access to this.counterStore and this.userStore ...mapStores(useCounterStore, useUserStore) // gives read access to this.count and this.double ...mapState(useCounterStore, ['count', 'double']), }, methods: { // gives access to this.increment() ...mapActions(useCounterStore, ['increment']), }, }
您將在核心概念中找到有關每個地圖助手的更多資訊。
Pinia(發音為/piːnjʌ/
,如英語中的「peenya」)是最接近piña(西班牙語中的菠蘿)的詞,它是一個有效的包名稱。菠蘿實際上是一組單獨的花朵,它們結合在一起形成多個水果。與商店類似,每一家都是獨立誕生的,但最終都是相互聯絡的。它也是一種美味的熱帶水果,原產於南美洲。
這是一個更完整的 API 範例,您將在 Pinia中使用型別,即使在 JavaScript 中也是如此。對於某些人來說,這可能足以在不進一步閱讀的情況下開始使用,但我們仍然建議您檢視檔案的其餘部分,甚至跳過此範例並在閱讀完所有核心概念後返回。
import { defineStore } from 'pinia' export const todos = defineStore('todos', { state: () => ({ /** @type {{ text: string, id: number, isFinished: boolean }[]} */ todos: [], /** @type {'all' | 'finished' | 'unfinished'} */ filter: 'all', // type will be automatically inferred to number nextId: 0, }), getters: { finishedTodos(state) { // autocompletion! ✨ return state.todos.filter((todo) => todo.isFinished) }, unfinishedTodos(state) { return state.todos.filter((todo) => !todo.isFinished) }, /** * @returns {{ text: string, id: number, isFinished: boolean }[]} */ filteredTodos(state) { if (this.filter === 'finished') { // call other getters with autocompletion ✨ return this.finishedTodos } else if (this.filter === 'unfinished') { return this.unfinishedTodos } return this.todos }, }, actions: { // any amount of arguments, return a promise or not addTodo(text) { // you can directly mutate the state this.todos.push({ text, id: this.nextId++, isFinished: false }) }, }, })
Pinia 試圖儘可能地接近 Vuex 的理念。它旨在測試 Vuex 下一次迭代的提案,並且取得了成功,因為我們目前有一個針對 Vuex 5 的開放 RFC,其 API 與 Pinia 使用的 API 非常相似。請注意,我 (Eduardo),Pinia 的作者,是 Vue.js 核心團隊的一員,並積极參與了 Router 和 Vuex 等 API 的設計。我個人對這個專案的意圖是重新設計使用全球商店的體驗,同時保持 Vue 的平易近人的理念。我保持 Pinia 的 API 與 Vuex 一樣接近,因為它不斷向前發展,以使人們更容易遷移到 Vuex,甚至在未來融合兩個專案(在 Vuex 下)。
雖然 Vuex 通過 RFC 從社群收集儘可能多的反饋,但 Pinia 沒有。我根據我開發應用程式、閱讀其他人的程式碼、為使用 Pinia 的客戶工作以及在 Discord 上回答問題的經驗來測試想法。這使我能夠提供一種適用於各種情況和應用程式大小的有效解決方案。我經常釋出並在保持其核心 API 不變的同時使庫不斷髮展。
Vuex 3.x 是 Vuex 的 Vue 2 而 Vuex 4.x 是 Vue 3
Pinia API 與 Vuex ≤4 有很大不同,即:
有關如何將現有 Vuex ≤4 專案轉換為使用 Pinia 的更詳細說明,請參閱從 Vuex 遷移指南。
更多程式設計相關知識,請存取:!!
以上就是什麼是pinia?Vue中怎麼使用它?的詳細內容,更多請關注TW511.COM其它相關文章!