@fxshelf/starfield
Canvas 2D starfield tunnel for React and Vue — perspective fly-through, glitter flashes, additive trails. Zero animation-lib deps. Copy-as-source friendly.
302
| Install | |
|---|---|
npm install @fxshelf/starfield |
|
| Latest Version: | 0.1.1 |
| Vue: | 3 |
| License: | MIT |
| Last Updated: | Sep 13, 2026 |
| Links: | GitHub · npm |
Maintainer: zhaotianlu
@fxshelf/starfield
面向 React / Vue 的 Canvas 2D 星空隧道 —— 星星以透视投影飞向镜头,带闪烁与叠加拖尾。零 Framer / GSAP / particles.js 依赖。
属于 fxshelf 动效书架中的一个可独立安装包。
| 文档 / Demo | luzhaotian.github.io/fxshelf |
| npm | @fxshelf/starfield@0.1.1 |
| CDN | unpkg · jsDelivr |
支持 npm、CDN <script>、复制源码。详细用法见站点文档或 docs/使用说明.md。
安装
npm install @fxshelf/starfield
| 使用方 | Peer |
|---|---|
| React | react / react-dom ≥ 18 |
| Vue | vue ≥ 3.3,且能编译 .vue(如 Vite) |
用法 — React
import { Starfield } from '@fxshelf/starfield'
export function Hero() {
return (
<Starfield
style={{ height: 420, background: '#0f0f12' }}
particleCount={263}
brightness={73}
>
<h1 style={{ color: '#fff', padding: 32 }}>Hello</h1>
</Starfield>
)
}
用法 — Vue
入口为源码 SFC:@fxshelf/starfield/vue。
<script setup lang="ts">
import { Starfield } from '@fxshelf/starfield/vue'
</script>
<template>
<Starfield
:style="{ height: '420px', background: '#0f0f12' }"
:particle-count="263"
:brightness="73"
>
<h1 style="color:#fff;padding:32px">Hello</h1>
</Starfield>
</template>
常用 props
| prop | 默认 | 说明 |
|---|---|---|
particleCount |
263 |
星星数量 |
speed |
1 |
飞近速度 |
density |
48 |
径向疏密 |
starSize |
8 |
基础尺寸 |
brightness |
73 |
亮度 0–100 |
glitterIntensity |
4 |
闪烁强度 |
trailAmount |
26 |
尾迹残留 |
color1 / color2 / color3 |
#ffffff |
三色调色板 |
reverse |
false |
反向飞离 |
复制源码
不经过 npm 时,从本包 src/(或 node_modules/@fxshelf/starfield/)拷贝:
core/ # 必拷
react/ # React 项目
vue/ # Vue 项目
License
MIT
Related Packages
@fxshelf/word-tunnel
3D keyword tunnel word-cloud for React and Vue — perspective fly-through text. Z...
360
0
@fxshelf/glyph-rain
Matrix-style glyph rain with cursor stir and drop-head lighting for React and Vu...
295
0
@fxshelf/button-kit
Animated button shelf for React and Vue — switch styles by variant string. Zero...
503
0
@twallpaper/vue
🌈 Multicolor gradient wallpaper created algorithmically and shimmers smoothly.
549
117
@russellio/vue-background-stars
A beautiful animated starry night sky background component for Vue 3 with option...
1,906
1
Version History
| Version | Released | Vue | License |
|---|---|---|---|
| 0.1.1 | >=3.3 | MIT | |
| 0.1.0 | >=3.3 | MIT |