Appearance
组合式 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 | 布尔切换器,返回响应式值和切换函数 |
| useVModel | v-model 快捷绑定,props + emit → ref |
| useCloned | 响应式克隆,支持自定义克隆函数和手动同步 |
元素与交互
| Hook | 说明 |
|---|---|
| useScroll | 响应式滚动状态,检测方向和边界 |
| useDraggable | 元素拖拽,支持轴向约束和容器边界 |
工具函数
| Hook | 说明 |
|---|---|
| useToString | 将响应式值转换为字符串 |
| useToNumber | 将字符串响应式值转换为数字 |
其他
| Hook | 说明 |
|---|---|
| useArray | 响应式数组操作方法(规划中) |
| useDemo | 示例 hook,用于验证 demo 机制 |