Hooks ​

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

Hook 接入预览 ​

Hooks 的接入重点不是“能不能 import”，而是接入以后有没有把分页、排序和查询状态收成一套稳定的组合式返回值。
先跑一个列表分页 demo，再回头看参数和返回值，会更容易理解这个包的边界。

安装 ​

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 返回值通常是响应式状态和方法，适合直接接入列表、分页、筛选和请求流程。

可用能力 ​

常见场景 ​

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

注意事项 ​

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

下一步 ​

• usePagination
• Utils
• 开发指南