# class-roll-call-system

**Repository Path**: kfu_peak_cloud/class-roll-call-system

## Basic Information

- **Project Name**: class-roll-call-system
- **Description**: 一个纯前端的，轻量高效的随机点名工具，支持名单导入、动态展示和状态管理，助力教师提升课堂效率。
- **Primary Language**: CSS
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-19
- **Last Updated**: 2025-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: class-roll-call-system, html-css-JavaScript

## README

<div align="center">
  <h1>🎓 班级点名系统</h1>
  <p>
    <a href="https://github.com/dcyyd/class-roll-call-system">
      <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License">
    </a>
    <a href="https://github.com/dcyyd/class-roll-call-system/releases">
      <img src="https://img.shields.io/badge/version-1.0.0-green" alt="版本">
    </a>
    <a href="https://github.com/dcyyd/class-roll-call-system/issues">
      <img src="https://img.shields.io/badge/accessibility-AA-success" alt="无障碍等级">
    </a>
    <a href="https://github.com/dcyyd/class-roll-call-system/stargazers">
      <img src="https://img.shields.io/github/stars/dcyyd/class-roll-call-system?style=social" alt="GitHub Repo stars">
    </a>
  </p>
  <p>✨ 轻量高效的随机点名工具，支持名单导入、动态展示和状态管理，助力教师提升课堂效率。</p>
</div>

### 🌟 **核心功能**

- 📤 **一键导入** - 支持 `.txt` 格式名单文件快速解析
- 🎲 **随机滚动** - 动态特效展示点名过程
- 💾 **状态持久化** - 自动标记已点名学生
- 📱💻 **多端适配** - 响应式设计兼容PC/移动设备
- 🔓 **开源免费** - MIT协议可自由二次开发


### 🚀 **快速开始**

#### 1. 环境准备

- 🌐 **浏览器要求**：Chrome 90+ / Edge 90+ / Firefox 88+
- ✏️ **文本编辑器**：用于准备学生名单（每行一个姓名）

#### 2. 基础用法

**2.1 导入名单**

1. 点击 **`📤 导入名单`** 按钮
2. 选择按行分隔的 `.txt` 文件（示例文件：[doc/name.txt](doc/name.txt)）
3. 等待成功提示后即可开始操作

**2.2 随机点名**

1. 单击 **`🎲 开始点名`**：启动随机滚动动画
2. 再次单击 **`⏹ 停止`**：锁定当前选中学生
3. 点击 **`🔄 重置`**：清空所有点名记录

**2.3 界面预览**

  2.3.1 **预览图片**

  - ![界面预览](./assets/images/ui-showcase.png)

  2.3.2 **在线演示**

  - **点击查看在线演示** [https://dcyyd.github.io/class-roll-call-system/](https://dcyyd.github.io/class-roll-call-system/)

### 🛠️ **项目结构**

```bash
class-roll-call-system/
├─ assets/
│  ├─ css/          # CSS 样式文件
│  ├─ fonts/        # 字体资源
│  ├─ images/       # 图片素材
│  └─ js/           # JavaScript 逻辑
├─ doc/              # 文档目录
│  └─ name.txt       # 示例名单文件
├─ .gitignore        # Git 忽略配置
├─ 404.html          # 404 错误页面
├─ index.html        # 主页文件
├─ LICENSE           # 开源协议
├─ README.md         # 说明文档
├─ robots.txt        # 爬虫规则
└─ sitemap.xml       # 网站地图
```

### 📥 **源码获取**

```bash
# 克隆仓库
git clone https://github.com/dcyyd/class-roll-call-system.git
# 进入项目目录
cd class-roll-call-system
# 启动主页
start index.html
```

### 📜 **开源协议**

本项目采用 **[MIT License](https://github.com/dcyyd/class-roll-call-system/blob/main/LICENSE)**，您可：

- ✅ 自由使用/修改代码
- ✅ 用于商业项目
- ✅ 保留版权声明即可

### 📮 **联系开发者**

如有问题或建议，欢迎通过以下方式联系：

- 🏠 [个人主页](https://dcyyd.github.io/)
- 📧 [电子邮箱](mailto:dcyyd_kcug@yeah.net)
- 📞 [联系电话](tel:17333963262)
- 💬 [GitHub Issues](https://github.com/dcyyd/class-roll-call-system/issues)

---

**✨ 让课堂互动更高效！** 🎉