OL-LearnPlatform-Frontend/docs/Banner-Image-Setup.md
2025-08-10 23:09:36 +08:00

159 lines
3.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 活动页面横幅图片设置指南
## 📋 概述
活动页面的横幅区域已经改为支持一整张图片的形式。目前显示占位内容,您可以按照以下步骤添加横幅图片。
## 🖼️ 当前状态
- ✅ 横幅区域已改为图片容器
- ✅ 响应式设计已适配
- ✅ 占位内容显示中
- ⏳ 等待提供横幅图片
## 📐 图片规格建议
### 推荐尺寸
- **桌面端**: 1200px × 400px
- **平板端**: 1024px × 350px
- **移动端**: 768px × 300px
### 文件格式
- **推荐**: JPG/JPEG (文件小,加载快)
- **支持**: PNG (支持透明背景)
- **支持**: WebP (现代浏览器,更小文件)
### 文件大小
- **建议**: < 500KB
- **最大**: < 1MB
## 🚀 添加图片的方法
### 方法一:直接替换(推荐)
1. **将图片文件放到项目中**
```
public/images/activities-banner.jpg
```
2. **修改 Activities.vue 文件**
```typescript
// 在 onMounted 中取消注释并设置图片路径
onMounted(() => {
setTimeout(() => {
loading.value = false
}, 800)
// 设置横幅图片路径
setBannerImage('/images/activities-banner.jpg')
})
```
### 方法二:直接设置变量
在 `src/views/Activities.vue` 中找到这一行:
```typescript
const bannerImageSrc = ref('')
```
改为:
```typescript
const bannerImageSrc = ref('/images/activities-banner.jpg')
```
## 📁 推荐的文件结构
```
public/
├── images/
│ ├── activities-banner.jpg # 横幅图片
│ ├── activities-banner-tablet.jpg # 平板版本(可选)
│ └── activities-banner-mobile.jpg # 移动版本(可选)
```
## 🎨 图片内容建议
根据原设计图,横幅图片应该包含:
- 蓝色渐变背景
- "理工/消安/药师/中经" 分类文字
- "免费海量题库" 主标题
- "小程序" 橙色标签
- "优质试题 | 无需下载 | 随时刷题" 特色说明
- 右侧人物和手机界面插图
## 🔧 技术实现细节
### 当前代码结构
```vue
<template>
<div class="hero-banner">
<div class="banner-image-container">
<!-- 实际图片 -->
<img
v-if="hasBannerImage"
:src="bannerImageSrc"
alt="活动横幅"
class="banner-image"
/>
<!-- 占位区域 -->
<div v-else class="banner-placeholder">
<!-- 占位内容 -->
</div>
</div>
</div>
</template>
```
### 响应式适配
- 桌面端400px 高度
- 平板端350px 高度
- 移动端300px 高度
- 小屏手机250px 高度
### CSS 样式
```css
.banner-image {
width: 100%;
height: 100%;
object-fit: cover; /* 保持比例,裁剪多余部分 */
object-position: center; /* 居中显示 */
}
```
## ⚡ 性能优化建议
1. **图片压缩**: 使用工具压缩图片文件
2. **懒加载**: 大图片可考虑懒加载
3. **多尺寸**: 为不同设备提供不同尺寸的图片
4. **WebP格式**: 现代浏览器使用WebP格式
## 🔄 更新步骤
当您准备好横幅图片时:
1. **准备图片文件**
- 确保图片符合推荐规格
- 压缩图片文件大小
2. **上传图片**
- 将图片放到 `public/images/` 目录
3. **更新代码**
- 按照上述方法一或方法二设置图片路径
4. **测试效果**
- 刷新浏览器查看效果
- 测试不同设备的显示效果
## 📞 需要帮助?
如果您在设置横幅图片时遇到任何问题
1. 检查图片路径是否正确
2. 确认图片文件是否存在
3. 查看浏览器控制台是否有错误信息
4. 联系开发人员获取技术支持
---
**注意**: 当前页面显示占位内容一旦您提供横幅图片并按照上述步骤设置占位内容将自动被实际图片替换