@gluhar/app
格卢哈尔主包. 将@gluhar/them,@gluhar/i18n,@gluhar/sanity和@gluhar/core组合成一个主包. 提供众多的组件,可堆肥,利用和类型.
安装
用一个命令将模块安装到您的 Nuxt 应用程序 :
npx nuxi module add @gluhar/app
使用量
页面转换( E)usePageTransition(中文(简体) )
路由器驱动的页面转换. 航行前请假,一直到
时间线完成; 输入等待到进入的页面 已执行 (纽斯特的)
page:finish,所以一个页面等待 useFetch 编号 : useSinglePage 在屏幕上先,盖上
以 readyTimeout。用它来包装页面,从不每页:
<!-- components/layout/PageTransition.vue -->
<script setup lang="ts">
const wrapper = ref<HTMLElement>();
const overlay = ref<HTMLElement>();
usePageTransition({
// Forward = leave (visible → hidden), reversed = enter. The project owns the look.
timeline: (gsap) =>
gsap
.timeline()
.fromTo(wrapper.value!, { opacity: 1 }, { opacity: 0, duration: 0.5 })
.fromTo(overlay.value!, { autoAlpha: 0 }, { autoAlpha: 1, duration: 0.5 }, 0),
});
</script>
<template>
<div ref="wrapper"><slot /></div>
<div ref="overlay" class="pointer-events-none fixed inset-0 invisible bg-white" />
</template>
这里滚动不需要什么: Nuxt 的路由器将窗口滚动到顶端( 或散列) 一旦新的页面被打开 列尼斯被暂停休假 并恢复进入, 重新同步到那个位置 .
<!-- layouts/default.vue: no :key on the wrapper, it must not remount per route -->
<PageTransition><main><slot /></main><Footer /></PageTransition>
| 选项 | 默认 | |
|---|---|---|
timeline(gsap) | 所需经费 | 内建 onMounted (意见已设定). 别设了 paused 编号 : onComplete 编号 : onReverseComplete: 可调和的暂停 kill()打开它 |
onEnter(to) | —— 说 | 运行在所提供新页面和路由器滚动后, 在输入播放之前 |
skip(to, from) | —— 说 | 航行让无动于衷。 同路径( 仅用hash/ 查询) 导航从不过渡 |
firstEnter | "none" | "none": 服务器发送的页面显示为原样( 无闪光, LCP 中无保留) . "manual": 开始隐藏直到 usePageTransitionStore().allowFirstEnter(),例如从装载器中 |
readyTimeout | 3000 | 在输入前最长时间等待到的页面 |
在休假开始后中止或丢弃的导航带入当前页面
回来. usePageTransitionStore() 曝光情况 phase (单位:千美元)idle 编号 : leaving 编号 : entering 编号 :
entered, (中文(简体) ), entered, (中文(简体) ), transitioning, (中文(简体) ), enterCycle 编号 : leaveCycle (每个完成的跳出)
输入/ 离开, 以重放一节的入声)和 setDelay(ms) (保持下一个输入).
平滑滚动( E)gluhar.lenis(中文(简体) )
列尼斯语Name 编辑 窗口,默认情况下:
// nuxt.config.ts
gluhar: {
lenis: { lerp: 0.1, wheelMultiplier: 1 }, // or true (defaults) / false (native scrolling)
}
- 由GSAP的计时器驱动
ScrollTrigger.update每个卷轴上,都有钉住的 被擦拭的相片与卷轴保持同一框. - 列尼斯荣誉
prefers-reduced-motion本身,然后在本地滚动. - 选项被序列化为运行时配置, 因此函数( S) :
easing, (中文(简体) ),prevent, (中文(简体) ),virtualScroll),元素不能在此设置. 配置实例. useLenis()返回时{ lenis },一个计算的例子。 没错null编辑 服务器,使用lenis: false,或者在客户端插件运行之前,所以总是选择链 内容:lenis.value?.scrollTo("#faq", { offset: -80 })。 。 。 .- 在页面中滚动
lenis.value.scrollTo当它运行时,从没有GSAP的twen 窗口:两个争夺位置. - 要让列尼斯远离一个本土可滚动元素(地图,代码块),请添加
data-lenis-prevent。 。 。 .
页面本身总是在窗口上滚动. 没有页面级滚动容器
(单位:千美元)useLenis("#scroller"):一个断了本地锚,路由器的卷轴还原,
position: sticky 和每个不命名为
联合国 scroller。 。 。 .
薄膜平滑滚动( N)<GLenisScroller>(中文(简体) )
对于在页面内自行滚动的区域(模式正文、侧面板、 水平条),带有自己的列尼斯:
<GLenisScroller class="h-[60svh]" content-class="p-6" :options="{ lerp: 0.12 }">
…
</GLenisScroller>
- 该元素需要一个有限度的大小(高度,或弹性/网格大小)来滚动.
- 它携带
data-lenis-prevent,所以窗口 Lenis 忽略了轮子和触摸事件 里面还有两个从不同时滚动的 和我们一起工作gluhar.lenis: false我也一样. - 展览
lenis, (中文(简体) ),scrollerRef财务报告和审定财务报表contentRef。其内部的 ScrollTrigger 必须命名 元素:scroller: scroller.value.scrollerRef。 。 。 . - 事实并非如此
useLenis()返回,且页面转换不会暂停.
卫生图像( N)<SanityImg>(中文(简体) )
过 sizes 用于响应服务器的图像 : srcset 结束 widths (从来没有过去)
原始的宽度, auto=format质量75, loading="lazy" (与
loading="eager" + 键 fetchpriority="high" 第一个图像)和 object-position 从
热点. placeholder 添加 lqip 作为模糊的背景, 直到图像装入( 那么它就是)
被删除,所以它从来没有显示 object-contain )),字母收发. 查找资产
维度和方位: photo{ ..., asset->{ _id, metadata { lqip, dimensions } } }。 。 。 .
<SanityImg class="absolute inset-0 size-full" :image="photo" sizes="(min-width: 48rem) 33vw, 100vw" />
无 sizes 它保持了旧的行为: 上载后 URL 大小为元素
(无) src 在服务器上,所以更喜欢 sizes 上面的列表和任何东西.
SEO 和链接预览useSeo(中文(简体) )
useSeo(seo?) 设置标题、描述和 OG / Twitter 集、 服务器已交付并保存在内
在客户端上同步,返回默认的 SEO 文档字段。 传个接通
对于依赖于状态(被过滤的视图)、平方字符串或本地字段的值,a
ogImage 卫生图像(其热点上1200×630个作物由资产建造;a
asset.url 绝对 url 页:1 og:url数字 :
useSeo(() => ({ title: viewTitle.value, ogImage: first.value?.photos?.[0], url: absoluteUrl.value }));
目标
gsap 属于 @gluhar/app。滚动拖取器和滚动拖取器已注册
在客户端。 导入( E)import { gsap } from "gsap")或使用自动进口
useGSAP() 财务报告和审定财务报表 useScrollTrigger(),返回相同的对象。 增加的项目
gsap 本身应该保持相同的范围,所以 npm 安装一个副本:两个副本意味着
两下,莱尼斯会更新一个ScrollTrigger 没有人听.
v- gsap- nuxt 未安装( 因为 6.0.0-next.10) (中文(简体) ).
配置
捐款
地方发展
# Install dependencies
npm install
# Generate type stubs
npm run dev:prepare
# Develop with the playground
npm run dev
# Build the playground
npm run dev:build
# Run ESLint
npm run lint
# Run Vitest
npm run test
npm run test:watch
# Release new version
npm run release