@gfazioli/mantine-scene

中文文档
2.2.18发布于 2026/11/09MITTypeScriptESM + CJS近 30 天下载 9281

由Mantine所建的React应用程序的可相容装饰背景组件. 地层梯度、发光地块、点网格、网状梯度、噪音、星地、流星、雪地、雨地、孔雀花地、伞形SVG波、雷达脉冲、横梁等

中文使用文档
文档目录6 节
  1. 概览
  2. 次级组件
  3. 特征
  4. 安装
  5. 使用量
  6. 发起人

曼汀场景组件

Mantine Scene

mantine-scene at a glance, refreshed daily: commits, releases, stars, issues and pull requests, a year of commit activity, the weekly rhythm, languages, latest commits and releases, contributors
制造的 外观卡 * 每日刷新

概览

此组件创建于 曼汀语Name 图书馆. 这需要 曼汀 9.x (英语) 财务报告和审定财务报表 反应 19。 。 。 .

曼汀场景 是一个装饰性背景容器,它组成多个视觉层,为您的反应应用创造丰富的大气背景。 放在内容后面,结合子组件来构建从微妙梯度到全星域环境的任何东西.

次级组件

构成部分说明
Scene.Gradient具有可选旋转/脉动动动画的辐射、线性或二次曲线梯度
Scene.Glow浮出水面,动画发光出自浮出水面/脉冲/呼吸变体
Scene.DotGrid重复点形图案,并有交错相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相相接相相接相接相相接相接相接相相相接相接相接相接相接相接相相接相接相相接相相相接相相相相相
Scene.Mesh多站射线梯度覆盖模拟网格梯度
Scene.Noise基于 SVG 的胶片粒纹理, 有可配置种子、 类型和彩色锡
Scene.StarFieldCSS- 唯一具有确定性PRNG定位和闪烁动画的恒星场
Scene.StarWarp具有可配置的焦点和方向的超空间曲速效应
Scene.ShootingStar动画流星在可配置角度和相距上的踪迹
Scene.Snow有横向漂流和风能控制的倒下雪花
Scene.Rain带有可选底端喷出效果的愤怒雨花
Scene.Confetti连续或爆裂的多形状相接( 矩形、 圆形、 三角形)onComplete模式和可配置来源(top编号 :bottom(中文(简体) )
Scene.Waves具有可配置方向、可截面强度和无缝水平平板的 Parallax SVG波层
Scene.Aurora有波浪动画的微光极光波波段
Scene.Radar有弧或圆形和智能-默认源的同心Wi-Fi / 雷达脉冲
Scene.Beams以循环颜色和可配置角半径扫射光柱或行
Scene.Globe交互式 三维点球( 由 蜘蛛头 ——可选对等分解) 有标记,弧(飞行路径),拖放,惯性,跟随曲线,焦点

特征

  • 🎨 主题集成:所有颜色道具接受曼汀主题颜色(MantineColor(中文(简体) )
  • 🧩 可编曲: 任意合并任意数量的子组件——层顺序遵循 DOM 顺序
  • ✨ 丰富的动画: GPU加速CSS动画(变形/不透明),每个组件都有控制
  • 🌍 三维环球: 交互式WebGL Global 有标记,弧,拖动,惯性,以及后续的cursor- cobe 船是可选的对等级,所以它从来不重于不使用它的消费者
  • 🖱️ 交互式模式: 启用鼠标跟踪——Glow,Gradient,StarWarp和环球对光标位置的反应可配置的LERP宽松. 使用 onMousePosition 以管道平滑坐标到外部 UI
  • 💤 懒惰模式: 可选 lazy 道具在现场离开取景口时暂停每个儿童动画和内部 RAF 循环(通过) IntersectionObserver)——零回放回放
  • 📱 响应道具:尺寸道具size, (中文(简体) ), blur, (中文(简体) ), spacing使用曼汀的原生语言 StyleProp<T> 与 InlineStyles + 媒体查询——在调整大小时零重置,模式与 SimpleGrid
  • ♿ 无障碍数字 : aria-hidden="true" 默认; 尊重 prefers-reduced-motion 可配置 reducedMotion 道具
  • 🖥️ 全屏设置 fullscreen 覆盖整个取景口 position: fixed
  • 🎨 样式 API: 对所有子组件的全曼汀样式 API 支持
  • 📦 类型脚本: 具有导出道具接口和工厂类型的完整类型安全

[!注]

→ 演示文稿和文件 → 更多曼汀组件

安装

npm install @gfazioli/mantine-scene

或者说

yarn add @gfazioli/mantine-scene

在应用程序根部安装导入包样式后:

import '@gfazioli/mantine-scene/styles.css';

使用量

import { Scene } from '@gfazioli/mantine-scene';
import { Box, Text } from '@mantine/core';

function Demo() {
  return (
    <Box pos="relative" h={400}>
      <Scene>
        <Scene.StarField count={{ base: 50, md: 100 }} twinkle />
        <Scene.Gradient from="violet" fromOpacity={0.15} />
        <Scene.Glow color="violet" size={400} blur={120} opacity={0.3} top="20%" left="30%" />
        <Scene.DotGrid color="gray" opacity={0.3} spacing={24} />
        <Scene.Noise opacity={0.025} />
      </Scene>
      <Box pos="relative" style={{ zIndex: 1 }} p="xl">
        <Text size="xl" fw={700} c="white">Your content here</Text>
      </Box>
    </Box>
  );
}

发起人

你的支持帮助了我:

  • 积极维护项目,及时修复错误并更新安全信息
  • 添加新特性, 提高性能,并完善开发者的经验
  • 扩大测试范围和文件,以更顺利地采用
  • 确保长期可持续性而不依赖临时自由时间
  • 优先处理最重要的社区请求和路线图项目

开放源码的繁荣,如果受益的人能够回报——即使每月的小额捐款也会产生真正的变化。 赞助有助于覆盖维护时间、基础设施和无数使项目保持健康的无形任务.

你的帮助真的很重要.

💚 成为提案国 今天,帮助我保持这一项目的可靠性,更新,并为每个人成长.

版本与发布记录

@gfazioli/mantine-scene 共发布 24 个版本,首次发布于 2026/03/14;过去 12 个月发布了 24 个版本。

版本发布日期距今
2.2.18latest2026/11/096 天前
2.2.172026/11/069 天前
2.2.162026/10/2621 天前
2.2.152026/10/2224 天前
2.2.142026/10/131 个月前
2.2.132026/10/101 个月前

关于 @gfazioli/mantine-scene 的常见问题

@gfazioli/mantine-scene 是什么?

由Mantine所建的React应用程序的可相容装饰背景组件. 地层梯度、发光地块、点网格、网状梯度、噪音、星地、流星、雪地、雨地、孔雀花地、伞形SVG波、雷达脉冲、横梁等

如何安装 @gfazioli/mantine-scene?

在项目目录运行 npm install @gfazioli/mantine-scene,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.x || ^19.x)、react-dom(^18.x || ^19.x)、@mantine/core(>=9.0.0)、@mantine/hooks(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfazioli/mantine-scene 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gfazioli/mantine-scene 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gfazioli/mantine-scene 可以商用吗?

@gfazioli/mantine-scene 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gfazioli/mantine-scene 的下载量有多少?

根据 npm 官方下载统计,@gfazioli/mantine-scene 在 2026/10/17 – 2026/11/15 这 30 天内被下载 9,281 次,日均约 309 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gfazioli/mantine-scene 还在维护吗?

最新版本 2.2.18 发布于 2026/11/09(6 天前);至今共发布 24 个版本,其中过去 12 个月发布了 24 个;首次发布于 2026/03/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。