@lzk-lib/vue
v0.7.0
Published
LZK Motion vue animation library
Readme
@lzk-lib/vue
0.7.0 的 Vue 3 动画与材质组件。四种上游光学模式通过 opticalMode 切换:standard(默认)、polar、prominent、shader(实验性)。六种扩展透镜通过 lens 切换;显式 opticalMode 优先。默认白色透明、静止,悬停不位移缩放;需要持续流动时显式设置 flow / flowSpeed。导出 GlassButton、GlassCard、GlassDialog、GlassDropdown、GlassInput、GlassSwitch、GlassTabs、GlassToolbar,以及 LiquidGlass、Motion、MotionScene、AnimatedDialog、AnimatedDropdown、AnimatedInput、GradientBorder、PageTransition,以及 TiltCard、Magnetic、Reveal、Spotlight。
<script setup lang="ts">
import { LiquidGlass } from '@lzk-lib/vue';
import '@lzk-lib/core/style.css';
</script>
<template>
<LiquidGlass :radius="28" :refraction="60" style="padding: 24px">
<h2>你自己的内容</h2>
<button>继续</button>
</LiquidGlass>
</template>八种 Glass 组件通过 glass 接收材质参数,支持 unstyled 与部位样式。GlassSwitch 提供真实布尔值切换,GlassTabs 提供键盘选择和业务内容面板。
弹窗、下拉、输入、渐变边框、页面过渡支持 unstyled、classNames / styles 部位映射。弹窗提供 header / content 插槽,下拉提供 trigger / option 插槽,输入提供 label / prefix / suffix 插槽。自定义外观保留真实控件、动画与键盘行为。
当前未发布到 npm。安装仓库生成的 lzk-lib-core-0.7.0.tgz 和 lzk-lib-vue-0.7.0.tgz,或使用同一 workspace 的本地包;Vue 3.5+ 由业务项目提供。不需要运行预览站或独立服务。浏览器逻辑在挂载后初始化,可服务端渲染。
液态玻璃预览:/vue/glass/。完整部位表、插槽字段与示例见仓库 docs/advanced.md。
常规组件预览 /vue/components/ 已有 58 项,整个包共有 79 个组件导出。0.7.0 新增 16 个表单控件、14 个数据/布局组件、12 个复杂交互组件和 6 个内容动画组件;原有十种基础组件继续保留。
表单包括 Input、Select、Checkbox、RadioGroup、Switch、Slider、NumberInput、PinInput、FileUpload 等;数据包括可排序/勾选的 Table、Avatar、Steps、Timeline;复杂交互包括 Combobox、MultiSelect、Calendar、DatePicker、Drawer、AlertDialog、CommandMenu、TreeView 等。TextReveal、AnimatedNumber、Typewriter、Stagger、Marquee、Shimmer 可以直接接业务内容。
受控值使用 value 和 @change;开关也遵循这一接口,原有 GlassSwitch 的 checked 接口继续保留。支持 unstyled、classNames、styles 和组件文档中的插槽。API 与边界见仓库 docs/components.md、docs/components-forms.md、docs/components-data.md、docs/components-advanced.md、docs/content-motion.md。FileUpload 不发起网络上传,Table 不内置服务端数据或虚拟滚动。
Icon 渲染单独导入的 SVG 数据。额外安装 lzk-lib-icons-0.7.0.tgz 后,可从 @lzk-lib/icons/outline/search 等路径导入单个图标,传给 <Icon :icon="search" title="搜索" />。图标目录共 6,220 项,预览在 /vue/icons/。
