Skip to content

sakura-fall

@night-tea/sakura-fall 是一个基于 Canvas 的飘落装饰库。它提供原生 TypeScript API 和 Vue 组件,内置 12 张透明水彩素材,并支持按月份自动切换。

安装

sh
pnpm add @night-tea/sakura-fall

原生用法

ts
import { createSakuraFall } from "@night-tea/sakura-fall";

const fall = createSakuraFall({
  image: "month",
  count: 15,
});

fall.stop();
fall.start();
await fall.setImage("03-sakura");
fall.setCount(20);
fall.destroy();

Vue 用法

vue
<script setup lang="ts">
import { SakuraFall } from "@night-tea/sakura-fall/vue";
</script>

<template>
  <SakuraFall image="month" :count="15" />
</template>

自定义图片

image 也可以使用自定义图片 URL:

ts
createSakuraFall({
  image: "https://example.com/custom-petal.png",
});

月份素材

月份素材名元素
101-snow-crystal雪晶
202-plum-blossom梅花
303-sakura樱花
404-willow-leaf柳叶
505-dandelion蒲公英
606-raindrop雨滴
707-bubble气泡
808-lotus荷花
909-maple-leaf枫叶
1010-ginkgo-leaf银杏
1111-fallen-leaf落叶
1212-snowflake雪花
夜茶 2020 ~ 2026