首頁 > 軟體

Pinia入門學習之實現簡單的使用者狀態管理

2022-12-01 14:02:29

Store是什麼?

全域性狀態,用於在所有元件中,同步資料。

Store的應用場景?

在整個應用程式中存取的資料(且不需要被持久化),例如導航欄中顯示的使用者資訊,以及需要通過頁面保留的資料,例如一個非常複雜的多步驟表格。

pinia是什麼?

簡單一句介紹,vuex的升級版,拋棄了煩人的Mutation。

其他優點

  • action支援同步和非同步;
  • 良好的TypeScript支援;
  • 支援用外掛擴充套件功能;
  • 扁平架構,沒有巢狀;
  • 伺服器端渲染支援。

應用範例

下面我們以一個管理平臺的員工賬號資訊為例,展示Pinia的使用方式。

本文作者認為setup是更好的組織程式碼的方式,所以都用setup編寫下面的範例。

安裝和掛載部分,直接看檔案

定義Store

import { defineStore } from 'pinia'

// 第一個引數是應用程式中 store 的唯一 id
export const useUserStore = defineStore('user', {
  // other options...
})

使用Store

import { useUserStore } from '@/stores/user'

export default {
  setup() {
    const userStore = useUserStore()

    return {
      // 您可以返回整個 store 範例以在模板中使用它
      userStore,
    }
  },
}

(如果習慣用選項式API,還是可以配合map helpers,宣告各種map來存取store。)

獲取store的響應式資料

直接解構會破壞響應式,需要用storeToRefs()提取屬性並保持響應式。

import { storeToRefs } from 'pinia'

export default defineComponent({
  setup() {
    const userStore = useUserStore()
    // ❌ 這不起作用,因為它會破壞響應式
    // 這和從 props 解構是一樣的
    const { userName } = userStore
    
    // 這樣可以保持響應式
    const { userId } = storeToRefs(userStore)

    userName // "lucio"
    userId // "001"

    return {
      // 一直會是 "lucio"
      userName,
      // 這將是響應式的
      userId,
      // 這將是響應式的
      realUserName: computed(() => userStore.userName),
      }
  },
})

State

返回初始狀態的函數。

我們補全一下上面的定義Store部分的程式碼。

初始化

import { defineStore } from 'pinia'

// 第一個引數是應用程式中 store 的唯一 id
export const useUserStore = defineStore('user', {
  state: () => {
    return {
      // 所有這些屬性都將自動推斷其型別
      userName: 'lucio',
      userId: '001',
    }
  },
})

讀取和寫入state

  • 通過store範例,可讀寫。
const userStore = useUserStore()
userStore.userId = '002'
userStore.$reset()
return { userStore }
  • 通過$patch修改多個資料,引數可以是物件或者函數。
// 一次修改多個資料
userStore.$patch({
  userId: '002',
  userName: 'lucy',
})
// 適合對陣列進行修改
userStore.$patch((state) => {
  state.roles.push({ name: 'admin', priority: 1 })
})
  • 替換整個state
userStore.$state = { userId: '002', userName: 'lucy'}
// 或者通過pinia範例替換整個應用程式的狀態
pinia.state.value = {}

訂閱state變化

可以通過 store 的 $subscribe() 方法檢視狀態及其變化,其只在patch之後觸發一次。

預設情況下,元件解除安裝後,訂閱會被刪除。如果想保留,設定設定項detached為true。

userStore.$subscribe((mutation, state) => {
  // import { MutationType } from 'pinia'
  mutation.type // 'direct' | 'patch object' | 'patch function'
  // 與 userStore.$id 相同
  mutation.storeId // 'user'
  // 僅適用於 mutation.type === 'patch object'
  mutation.payload // 修補程式物件傳遞給 to userStore.$patch()

  // 每當它發生變化時,將整個狀態持久化到本地儲存
  localStorage.setItem('user', JSON.stringify(state))
	},
	{ detached: true }, // detached為true,解除安裝元件後保留訂閱
)

Getters

返回狀態的計算值

定義getter

import { defineStore } from 'pinia'

// 第一個引數是應用程式中 store 的唯一 id
export const useUserStore = defineStore('user', {
  state: () => {
    return {
      // 所有這些屬性都將自動推斷其型別
      userName: 'lucio',
      userId: '001',
    }
  },
  getters: {
    // 自動推斷返回型別為字串
    userText: (state) => `User: ${state.userName}`,
    // 也可以使用其他getter, 用this存取store範例,必須要定義返回型別
    userTextPlus: (): string => `The name of ${this.userText}`,
  }
})

存取getter

直接用store的範例存取。

userStore.userText

(getters也可以傳遞引數,不是很常用的場景,這裡就不範例了。)

(在A store中,也可以使用B store的getter)

Actions

相當於元件中的methods,適合用於定義元件的業務邏輯。

定義action

下面我們繼續補全上面的範例,在userStore中通過網路請求獲取使用者資料。

import { defineStore } from 'pinia'

export const useUserStore = defineStore('user', {
  state: () => {
    return {
      userName: 'lucio',
      userId: '001',
      userData: null,
    }
  },
  getters: {
    // ...
  },
  actions: {
  	async loginAndGetUserInfo(password) {
  		try {
  			this.userData = await api.login({password});
  			showToast('Login success');
  		} catch(error) {
  			showToast(error);
  			return error;
  		}
  	}
  }
})

訂閱action

可以使用 store.$onAction() 訂閱 action 及其結果。

下面對userStore新增一個訂閱,記錄上面的登陸操作,所用的時間

const unsubscribe = userStore.$onAction(
  ({
    name, // action 的名字
    store, // store 範例
    args, // 呼叫這個 action 的引數
    after, // 在這個 action 執行完畢之後,執行這個函數
    onError, // 在這個 action 丟擲異常的時候,執行這個函數
  }) => {
    // 記錄開始的時間變數
    const startTime = Date.now()
    // 這將在 `store` 上的操作執行之前觸發
    console.log(`Start "${name}" with params [${args.join(', ')}].`)

    // 如果 action 成功並且完全執行後,after 將觸發。
    // 它將等待任何返回的 promise
    after((result) => {
      console.log(
        `Finished "${name}" after ${
          Date.now() - startTime
        }ms.nResult: ${result}.`
      )
    })

    // 如果 action 丟擲或返回 Promise.reject ,onError 將觸發
    onError((error) => {
      console.warn(
        `Failed "${name}" after ${Date.now() - startTime}ms.nError: ${error}.`
      )
    })
  }
)

// 手動移除訂閱
unsubscribe()

和訂閱state一樣,元件解除安裝時,訂閱將被刪除,可以新增設定第二個引數detach為true,在解除安裝元件後仍然保留訂閱。

export default {
  setup() {
    const someStore = useSomeStore()

    // 此訂閱將在元件解除安裝後保留
    someStore.$onAction(callback, true)

    // ...
  },
}

總結

到此這篇關於Pinia入門學習之實現簡單的使用者狀態管理的文章就介紹到這了,更多相關Pinia使用者狀態管理內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!


IT145.com E-mail:sddin#qq.com