From 8c1f4ec05eeeab22f67f25bf7afe752ac669d4d2 Mon Sep 17 00:00:00 2001
From: RISE <joeldecode@gmail.com>
Date: Wed, 14 Jan 2026 01:14:03 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E5=BE=88=E5=A4=9A?=
 =?UTF-8?q?=E9=A1=B5=E9=9D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/api/basic/basicstudentavatar.ts          |  14 ++
 src/views/basic/basicstudentavatar/index.vue | 161 +++++++++++++++++++
 2 files changed, 175 insertions(+)
 create mode 100644 src/api/basic/basicstudentavatar.ts
 create mode 100644 src/views/basic/basicstudentavatar/index.vue

diff --git a/src/api/basic/basicstudentavatar.ts b/src/api/basic/basicstudentavatar.ts
new file mode 100644
index 0000000..ed4e8b7
--- /dev/null
+++ b/src/api/basic/basicstudentavatar.ts
@@ -0,0 +1,14 @@
+import request from '/@/utils/request';
+
+/**
+ * 获取学生证件照列表（分页）
+ * @param query
+ */
+export const fetchList = (query?: any) => {
+	return request({
+		url: '/basic/basicstudent/avatar/page',
+		method: 'get',
+		params: query,
+	});
+};
+
diff --git a/src/views/basic/basicstudentavatar/index.vue b/src/views/basic/basicstudentavatar/index.vue
new file mode 100644
index 0000000..3931def
--- /dev/null
+++ b/src/views/basic/basicstudentavatar/index.vue
@@ -0,0 +1,161 @@
+<template>
+  <div class="layout-padding">
+    <div class="layout-padding-auto layout-padding-view">
+      <!-- 搜索表单 -->
+      <el-row v-show="showSearch">
+        <el-form :model="searchForm" ref="searchFormRef" :inline="true" @keyup.enter="handleSearch">
+          <el-form-item label="班级" prop="classCode">
+            <el-select 
+              v-model="searchForm.classCode" 
+              placeholder="请选择班级" 
+              clearable
+              filterable
+              style="width: 200px">
+              <el-option
+                v-for="item in classList"
+                :key="item.classCode"
+                :label="item.classNo"
+                :value="item.classCode">
+              </el-option>
+            </el-select>
+          </el-form-item>
+          <el-form-item>
+            <el-button type="primary" plain icon="Search" @click="handleSearch">查询</el-button>
+            <el-button icon="Refresh" @click="handleReset">重置</el-button>
+          </el-form-item>
+        </el-form>
+      </el-row>
+
+      <!-- 操作按钮 -->
+      <el-row>
+        <div class="mb8" style="width: 100%">
+          <right-toolbar  
+            v-model:showSearch="showSearch" 
+            class="ml10 mr20"
+            style="float: right;"
+            @queryTable="getDataList">
+          </right-toolbar>
+        </div>
+      </el-row>
+
+      <!-- 表格 -->
+      <el-table 
+        :data="state.dataList" 
+        v-loading="state.loading" 
+        border 
+        :cell-style="tableStyle.cellStyle" 
+        :header-cell-style="tableStyle.headerCellStyle"
+        @sort-change="sortChangeHandle">
+        <el-table-column type="index" label="序号" width="60" align="center" />
+        <el-table-column prop="stuNo" label="学号" show-overflow-tooltip />
+        <el-table-column prop="realName" label="姓名" show-overflow-tooltip />
+        <el-table-column prop="className" label="班级" show-overflow-tooltip />
+        <el-table-column prop="headImg" label="头像" width="120" align="center">
+          <template #default="scope">
+            <el-image
+              v-if="scope.row.headImg"
+              :src="scope.row.headImg"
+              :preview-src-list="[scope.row.headImg]"
+              fit="cover"
+              style="width: 80px; height: 100px; cursor: pointer;"
+              lazy>
+              <template #error>
+                <div class="image-slot">
+                  <el-icon><Picture /></el-icon>
+                </div>
+              </template>
+            </el-image>
+            <span v-else>-</span>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <!-- 分页 -->
+      <pagination 
+        @size-change="sizeChangeHandle" 
+        @current-change="currentChangeHandle" 
+        v-bind="state.pagination" />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts" name="BasicStudentAvatar">
+import { ref, reactive, onMounted } from 'vue'
+import { BasicTableProps, useTable } from "/@/hooks/table";
+import { fetchList } from "/@/api/basic/basicstudentavatar";
+import { getClassListByRole } from "/@/api/basic/basicclass";
+import { Picture } from '@element-plus/icons-vue'
+
+// 定义变量内容
+const searchFormRef = ref()
+const showSearch = ref(true)
+const classList = ref<any[]>([])
+
+// 搜索表单
+const searchForm = reactive({
+  classCode: ''
+})
+
+// 配置 useTable
+const state: BasicTableProps = reactive<BasicTableProps>({
+  queryForm: searchForm,
+  pageList: fetchList,
+  props: {
+    item: 'records',
+    totalCount: 'total'
+  },
+  createdIsNeed: true
+})
+
+// table hook
+const {
+  getDataList,
+  currentChangeHandle,
+  sizeChangeHandle,
+  sortChangeHandle,
+  tableStyle
+} = useTable(state)
+
+// 查询
+const handleSearch = () => {
+  getDataList()
+}
+
+// 重置
+const handleReset = () => {
+  searchFormRef.value?.resetFields()
+  searchForm.classCode = ''
+  getDataList()
+}
+
+// 获取班级列表
+const getClassListData = async () => {
+  try {
+    const res = await getClassListByRole()
+    if (res.data) {
+      classList.value = Array.isArray(res.data) ? res.data : []
+    }
+  } catch (err) {
+    console.error('获取班级列表失败', err)
+    classList.value = []
+  }
+}
+
+// 初始化
+onMounted(() => {
+  getClassListData()
+})
+</script>
+
+<style lang="scss" scoped>
+.image-slot {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  width: 100%;
+  height: 100%;
+  background: #f5f7fa;
+  color: #909399;
+  font-size: 30px;
+}
+</style>