输入关键词,开始搜索

↑↓ 选择 打开 esc 关闭
沉浸

开屏页

开屏页

开屏页(Splash)是访客首次进入网站时看到的全屏展示页面,支持背景图轮播、渐变遮罩和自定义导航按钮。

效果

开屏页会覆盖整个视口,展示大标题、副标题和一组导航按钮。背景支持多张图片自动轮播切换,配合半透明遮罩确保文字可读。

配置方法

src/data/config/splash.ts 中修改 splash 字段:

splash: {
    enabled: true,
    backgroundImage: [
        'https://images.unsplash.com/photo-1506744038136-46273834b3fb?w=1920&q=80',
        'https://images.unsplash.com/photo-1470071459604-3b5ec3a7fe05?w=1920&q=80',
    ],
    overlay: 'rgba(0,0,0,0.1)',
    textShadow: true,
    fallbackBg: 'bg-black',
    gradientColor: '#2d2d2d',
    gradientHeight: 'h-56',
    backdropBlur: '12px',
    slideDuration: 12,
    title: 'Vergil',
    description: '面向创作者的 Astro 建站框架',
    nav: [
        { text: 'Github', href: 'https://github.com', icon: 'github' },
        { text: '友链', href: '/links', icon: 'link' },
        { text: '关于', href: '/about', icon: 'user' },
    ]
}

字段说明

字段必填说明
enabledtrue 启用开屏页,false 关闭
backgroundImage背景图片 URL 数组,多张会自动轮播。留空则不显示背景图
overlayCSS 颜色值,覆盖在背景图上降低亮度,确保文字可读
textShadow是否给标题和副标题添加文字阴影
fallbackBg图片加载失败时的 Tailwind 背景类
gradientColor底部过渡渐变的颜色值
gradientHeight渐变区域高度,如 h-56h-32
backdropBlur内容区上方的毛玻璃模糊程度
slideDuration轮播切换间隔,单位秒
title主标题
description副标题/描述
nav底部导航按钮数组

导航按钮

nav 是一个对象数组,每个按钮支持:

字段必填说明
text按钮文字
href跳转链接,支持相对路径和外部链接
icon图标名称(Iconify 格式),如 githublinkuser

关闭开屏页

如果不需要开屏页,将 enabled 设为 false 即可:

splash: {
    enabled: false,
}

关闭后,访客将直接进入网站首页。

未知标题
00:00
00:00
播放列表