particles在vue3中的基本使用

639 阅读3分钟

particles在vue3中的基本使用

第三方库地址

particles.vue3 - npm

1.安装插件

npm i particles.vue3
npm i tsparticles

2.在main.js中引入

import Particles from 'particles.vue3'
app.use(Particles) // 配置相关的文件
 

常用 api

particles.number.value>粒子的数量
particles.number.density粒子的稀密程度
particles.number.density.enable启用粒子的稀密程度 (true 或 false)
particles.number.density.value_area每一个粒子占据的空间(启用粒子密度,才可用)
particles.color.value粒子的颜色 (支持 16 进制”#b61924”,rgb”{r:182, g:25, b:36}”,hsl,以及 random)
particles.shape.type粒子的形状 (”circle” “edge” “triangle” “polygon” “star” “image”)
particles.opacity.value粒子的透明度
particles.size.anim.enable是否启用粒子速度(true/false)
particles.size.anim.speed粒子动画频率
particles.size.anim.sync粒子运行速度与动画是否同步
particles.move.speed粒子移动速度

参数

键值参数选项 / 说明实例
particles.number.valuenumber   数量40
particles.number.density.enablebooleantrue/false
particles.number.density.value_areanumber   区域散布密度大小800
particles.color.valueHEX (string)
RGB (object)
HSL (object)
array selection (HEX)
random (string)

原子的颜色 | #b61924"
{r:182, g:25, b:36}
{h:356, s:76, l:41}
["#b61924", "#333333", "999999"]
"random" | | particles.shape.type | string
array selection 原子的形状 | "circle"
"edge"
"triangle"
"polygon"
"star"
"image"
["circle", "triangle", "image"] | | particles.shape.stroke.width | number      原理的宽度 | 2 | | particles.shape.stroke.color | HEX (string)  原子颜色 | "#222222" | | particles.shape.polygon.nb_slides | number       原子的多边形边数 | 5 | | particles.shape.image.src | path link
svg /png/gif /jpg  原子的图片可以使用自定义图片 | "assets/img/yop.svg"
"mywebsite.com/assets/img/…" | | particles.shape.image.width | number
(for aspect ratio)    图片宽度 | 100 | | particles.shape.image.height | number
(for aspect ratio) 图片高度 | 100 | | particles.opacity.value | number (0 to 1)   不透明度 | 0.75 | | particles.opacity.random | boolean     随机不透明度 | true / false | | particles.opacity.anim.enable | boolean            渐变动画 | true / false | | particles.opacity.anim.speed | number            渐变动画速度 | 3 | | particles.opacity.anim.opacity_min | number (0 to 1)       渐变动画不透明度 | 0.25 | | particles.opacity.anim.sync | boolean | true / false | | particles.size.value | number       原子大小 | 20 | | particles.size.random | boolean       原子大小随机 | true / false | | particles.size.anim.enable | boolean      原子渐变 | true / false | | particles.size.anim.speed | number     原子渐变速度 | 3 | | particles.size.anim.size_min | number | 0.25 | | particles.size.anim.sync | boolean | true / false | | particles.line_linked.enable | boolean       连接线 | true / false | | particles.line_linked.distance | number       连接线距离 | 150 | | particles.line_linked.color | HEX (string)   连接线颜色 | #ffffff | | particles.line_linked.opacity | number (0 to 1)    连接线不透明度 | 0.5 | | particles.line_linked.width | number     连接线的宽度 | 1.5 | | particles.move.enable | boolean     原子移动 | true / false | | particles.move.speed | number     原子移动速度 | 4 | | particles.move.direction | string              原子移动方向 | "none"
"top"
"top-right"
"right"
"bottom-right"
"bottom"
"bottom-left"
"left"
"top-left" | | particles.move.random | boolean              移动随机方向 | true / false | | particles.move.straight | boolean              直接移动 | true / false | | particles.move.out_mode | string
(out of canvas)        是否移动出画布 | "out"
"bounce" | | particles.move.bounce | boolean
(between particles)   是否跳动移动 | true / false | | particles.move.attract.enable | boolean           原子之间吸引 | true / false | | particles.move.attract.rotateX | number   原子之间吸引 X 水平距离 | 3000 | | particles.move.attract.rotateY | number  y 垂直距离 | 1500 | | interactivity.detect_on | string        原子之间互动检测 | "canvas", "window" | | interactivity.events.onhover.enable | boolean    悬停 | true / false | | interactivity.events.onhover.mode | string
array selection

悬停模式 | "grab"     抓取临近的
"bubble"  泡沫球效果
"repulse"  击退效果
["grab", "bubble"] | | interactivity.events.onclick.enable | boolean  点击效果 | true / false | | interactivity.events.onclick.mode | string
array selection

点击效果模式 | "push"
"remove"
"bubble"
"repulse"
["push", "repulse"] | | interactivity.events.resize | boolean         互动事件调整 | true / false | | interactivity.events.modes.grab.distance | number        原子互动抓取距离 | 100 | | interactivity.events.modes.grab.line_linked.opacity | number (0 to 1)        原子互动抓取距离连线不透明度 | 0.75 | | interactivity.events.modes.bubble.distance | number       原子抓取泡沫效果之间的距离 | 100 | | interactivity.events.modes.bubble.size | number       原子抓取泡沫效果之间的大小 | 40 | | interactivity.events.modes.bubble.duration | number    原子抓取泡沫效果之间的持续事件
(second) | 0.4 | | interactivity.events.modes.repulse.distance | number       击退效果距离 | 200 | | interactivity.events.modes.repulse.duration | number      击退效果持续事件
(second) | 1.2 | | interactivity.events.modes.push.particles_nb | number         粒子推出的数量 | 4 | | interactivity.events.modes.push.particles_nb | number | 4 | | retina_detect | boolean | true / false |

代码

<template>
    <div>
        <Particles id="tsparticles" :particlesInit="particlesInit" :particlesLoaded="particlesLoaded" :options="options" />
    </div>
</template>
<script setup>
import { loadFull } from "tsparticles";
 
const options = {
    background: {
        color: {
            value: '#2d3a4b'
        }
    },
    fpsLimit: 120,
    interactivity: {
        events: {
            onClick: {
                enable: true,
                mode: 'push'
            },
            onHover: {
                enable: true,
                mode: 'repulse'
            },
            resize: true
        },
        modes: {
            bubble: {
                distance: 400,
                duration: 2,
                opacity: 0.8,
                size: 40
            },
            push: {
                quantity: 4
            },
            repulse: {
                distance: 200,
                duration: 0.4
            }
        }
    },
    particles: {
        color: {
            value: '#ffffff'
        },
        links: {
            color: '#ffffff',
            distance: 150,
            enable: true,
            opacity: 0.5,
            width: 1
        },
        collisions: {
            enable: true
        },
        move: {
            direction: 'none',
            enable: true,
            outModes: {
                default: 'bounce'
            },
            random: false,
            speed: 6,
            straight: false
        },
        number: {
            density: {
                enable: true,
                area: 800
            },
            value: 80
        },
        opacity: {
            value: 0.5
        },
        shape: {
            type: 'circle'
        },
        size: {
            value: { min: 1, max: 5 },
        }
    },
    detectRetina: true
 
}
const particlesInit = async engine => {
    await loadFull(engine);
};
 
const particlesLoaded = async container => {
    console.log("Particles container loaded", container);
};
</script>