@haixing_hu/pinia-decorator NPM

pinia-decorator

pinia-decorator 是一个 JavaScript 库，它使用了 JavaScript 装饰器的第三阶段提案，简化了将 Pinia 存储与 Vue 类风格组件集成的过程。换句话说，它提供了类似于 vuex-class 和 pinia-class 库的功能。

该库受 vuex-class 和 pinia-class 的启发，但存在一些关键区别：

它是用纯 JavaScript 实现的，不需要 TypeScript 支持。
它支持 Vue 3。
它支持使用 vue3-class-component 实现的 JavaScript 类风格 Vue 组件，而 pinia-class 主要针对使用 vue-facing-decorator 实现的 TypeScript 类风格 Vue 组件。

安装

你可以通过 npm 或 yarn 安装 pinia-decorator：

npm install @haixing_hu/pinia-decorator

或

yarn add @haixing_hu/pinia-decorator

使用

pinia-decorator 为 Vue 3 类风格组件提供了以下装饰器：

@State：用于将只读状态从 Pinia 存储注入到组件中。
@WritableState：用于将可写状态从 Pinia 存储注入到组件中。
@Getter：用于将 getter 从 Pinia 存储注入到组件中。
@Action：用于将 action 从 Pinia 存储注入到组件中。
@Store：用于将整个 Pinia 存储注入到组件中。

`@State`

@State 装饰器用于将只读状态从 Pinia 存储注入到 Vue 类风格组件中。它允许你在组件内部访问和使用 Pinia 存储的状态。

@State 装饰器的语法如下：

@State(store: Object, stateName?: string)

store（必需）：使用 Pinia 的 defineStore() 函数定义的待注入的 Pinia 存储对象。
stateName（可选）：待注入的状态在 Pinia 存储中的名称。如果未提供，装饰器将使用被装饰的字段名作为待注入的状态的名称。

`@WritableState`

@WritableState 装饰器与 @State 类似，但它允许你将可写状态从 Pinia 存储注入到 Vue 类风格组件中。这意味着你可以在组件内部既读取又修改 Pinia 存储的状态值。

@WritableState 装饰器的语法如下：

@WritableState(store: Object, stateName?: string)

store（必需）：使用 Pinia 的 defineStore() 函数定义的待注入的 Pinia 存储对象。
stateName（可选）：待注入的状态在 Pinia 存储中的名称。如果未提供，装饰器将使用被装饰的字段名作为待注入的状态的名称。

`@Getter`

@Getter 装饰器用于将 getter 从 Pinia 存储注入到 Vue 类风格组件中。它允许你在组件内部调用 Pinia 存储的 getter 函数。

@Getter 装饰器的语法如下：

@Getter(store: Object, getterName?: string)

store（必需）：使用 Pinia 的 defineStore() 函数定义的待注入的 Pinia 存储对象。
getterName（可选）：待注入的 getter 在 Pinia 存储中的名称。如果未提供，装饰器将使用被装饰的字段名作为待注入的 getter 的名称。

`@Action`

@Action 装饰器用于将 action 从 Pinia 存储注入到 Vue 类风格组件中。它允许你在组件内部调用存储的 action 函数。

@Action 装饰器的语法如下：

@Action(store: Object, actionName?: string)

store（必需）：使用 Pinia 的 defineStore() 函数定义的待注入的 Pinia 存储对象。
actionName（可选）：待注入的 action 在 Pinia 存储中的名称。如果未提供，装饰器将使用被装饰的字段名作为待注入的 action 的名称。

`@Store`

@Store 装饰器用于将整个 Pinia 存储注入到 Vue 类风格组件中。它允许你访问存储的所有状态、 getter 和 action。

@Store 装饰器的语法如下：

@Store(store: Object)

store（必需）：使用 Pinia 的 defineStore() 函数定义的待注入的 Pinia 存储对象。

示例

以下是如何在 Vue 组件中使用这些装饰器的简单示例：

import { Component, toVue } from '@haixing_hu/vue3-class-component';
import { State, WritableState, Getter, Action, Store } from '@haixing_hu/pinia-decorator';
import { useMyStore } from './my-pinia-store-module';

@Component
export class MyComponent extends Vue {
  @State(useMyStore)
  myValue;
  
  @State(useMyStore, 'message')
  myMessage;

  @Getter(useMyStore) 
  myGetter

  @Getter(useMyStore, 'count')
  myCountGetter
  
  @Action(useMyStore)
  fetchData;
  
  @Action(useMyStore, 'sayMessage')
  mySayMessage;

  @Store(useMyStore) 
  store;
  
  someOtherMessage = 'Hello World!';
  
  callSayMessage() {
    console.log('MyComponent.callSayMessage');
    this.mySayMessage(this.myMessage);
  }
}

export default toVue(MyComponent);

有关更多详细信息，请查看以下演示项目：