@lzk-lib/core
v0.7.0
Published
LZK Motion core animation library
Readme
@lzk-lib/core
0.7.0 增加表单重置与校验工具、排序与选择模型、日期/组合选择/目录等共享交互模型,以及 createSequenceMotion、createNumberTween、createLoopMotion 内容动画控制器。React/Vue 组件使用相同核心逻辑,新增样式已包含在 style.css;均使用命名空间选择器,不引入全局 reset。
0.7.0 的框架无关 Web 动画核心。动画目录按弹窗、下拉、输入、边框、页面等功能分类;createMotion 播放单元素预设,createMotionScene 播放多层场景,createLiquidGlass 为业务元素添加液态玻璃材质。导出 glassOpticalModes 四种上游光学模式目录,opticalMode 可选 standard(默认)、polar、prominent、shader(实验性)。另有 glassMaterials 六种扩展材质目录,使用 lens 选择 rim / convex / concave / prism / ripple / wave。六种材质默认白色透明、静止,悬停不位移缩放;可显式开启 flow、调整 flowSpeed。另有 createTilt、createMagnetic、createReveal、createSpotlight 四个基础工厂。
import { createLiquidGlass } from '@lzk-lib/core';
import '@lzk-lib/core/style.css';
// 在元素挂载后调用。
const glass = createLiquidGlass(element, { lens: 'wave', radius: 28, refraction: 60 });
glass.update({ blur: 2 });
// 卸载时调用 glass.destroy()。导出 LiquidGlassOptions、LiquidGlassMode、LiquidGlassOpticalMode、LiquidGlassLens、GlassMaterial、LiquidGlassController;材质控制器的 mode 返回实际使用的 refraction / blur。不支持折射时自动降级为模糊。SSR 可安全导入,控制器需在浏览器元素挂载后创建。
静态玻璃的四种光学模式、三张原始位移图、shader 生成算法、RGB 位移与边缘合成流程及双层高光描边移植自 rdev/liquid-glass-react 的固定提交。保留本库六种扩展位移图及生命周期管理;鼠标晃动和上游布局定位没有原样移植,默认保持白色静止。来源与完整 MIT 许可见随包分发的 THIRD_PARTY_NOTICES.md。
当前未发布到 npm。使用仓库生成的 artifacts/lzk-lib-core-0.7.0.tgz 或同一 workspace 的本地包,不需要独立动画服务。样式只需引入一次,时间单位为毫秒。完整用法见仓库 README.md 和 docs/advanced.md。
