Skip to content

组合式 API

介绍

Vant 底层依赖了 @vant/use 包,其中内置了一系列的组合式 API。对于使用了 Vant 的项目,可以复用这些 API 进行开发。

安装

虽然 Vant 的依赖中已经包含了 @vant/use,但我们仍然推荐显式地安装它:

shell
# with npm
npm i @vant/use

# with yarn
yarn add @vant/use

# with pnpm
pnpm add @vant/use

# with Bun
bun add @vant/use

示例

下面是一个 Vant 组合式 API 的用法示例,我们从 @vant/use 这个包中引入 useWindowSize 方法,然后进行调用,即可获取到当前 Window 的宽度和高度。

js
import { useWindowSize } from '@vant/use';

const { width, height } = useWindowSize();

console.log(width.value); // -> 窗口宽度
console.log(height.value); // -> 窗口高度

API 列表

下面是 Vant 对外提供的所有组合式 API,点击名称可以查看详细介绍:

名称描述
useClickAway监听点击元素外部的事件
useCountDown提供倒计时管理能力
useCustomFieldValue自定义表单组件中的表单项
useEventListener方便地进行事件绑定
usePageVisibility获取页面的可见状态
useRect获取元素的大小及其相对于视口的位置
useRelation建立父子组件之间的关联关系
useScrollParent获取元素最近的可滚动父元素
useToggle用于在布尔值之间进行切换
useWindowSize获取浏览器窗口的视口宽度和高度
useRaf提供requestAnimationFrame管理能力

基于Vant构建的企业级移动端解决方案