Hooks ​

@qxs-bns/hooks 是面向 Vue 3 Composition API 的可复用逻辑集合，当前以分页等业务常用 Hook 为主。

安装 ​

pnpm add @qxs-bns/hooks

基础引入 ​

<script setup lang="ts">
import { usePagination } from '@qxs-bns/hooks'

const { pagination, getParams } = usePagination({
  currentPage: 1,
  pageSize: 10,
  total: 0,
})
</script>

该包面向 Vue 3 使用，建议在 <script setup> 中按需导入。Hook 返回值通常是响应式状态和方法，适合直接接入列表、分页、筛选和请求流程。

Hook 概览 ​

适用场景 ​

• 列表分页、查询条件、表格交互等复用逻辑。
• 希望把组件状态逻辑抽离成组合式函数的 Vue 3 项目。

使用建议 ​

• 如果项目同时使用组件库和工具库，可以按需组合 @qxs-bns/components 与 @qxs-bns/utils。
• 优先在页面级或业务模块级封装 Hook，避免把视图细节耦合进通用组合逻辑。
• 当前文档以已经稳定的 Hook 为主，新增 Hook 建议补齐类型、示例和测试后再开放。

下一步阅读 ​

• usePagination
• Utils
• 开发指南