Skip to content

组合式 API(ljf-hooks)

ljf-hooks 是基于 Vue 3 Composition API 的工具函数集合,提供常用的响应式 hooks。


介绍

ljf-hooks 作为独立的 npm 包发布,同时其文档和 demo 集成在知识库中。每个 hook 都配有实时演示和源码展示。

安装

bash
pnpm add ljf-hooks

使用

ts
import { useDebounceFn, useEventListener, useToggle } from 'ljf-hooks'

Hooks 列表

函数控制

Hook说明
useDebounceFn防抖函数,延迟执行,重复触发时重新计时
useThrottleFn节流函数,固定时间间隔执行

事件与生命周期

Hook说明
useEventListener自动注册/移除事件监听,支持响应式目标
tryOnMounted安全执行挂载回调,组件内外均可

状态管理

Hook说明
useToggle布尔切换器,返回响应式值和切换函数
useVModelv-model 快捷绑定,props + emit → ref
useCloned响应式克隆,支持自定义克隆函数和手动同步

元素与交互

Hook说明
useScroll响应式滚动状态,检测方向和边界
useDraggable元素拖拽,支持轴向约束和容器边界

工具函数

Hook说明
useToString将响应式值转换为字符串
useToNumber将字符串响应式值转换为数字

其他

Hook说明
useArray响应式数组操作方法(规划中)
useDemo示例 hook,用于验证 demo 机制