<template>
  <!-- 使用 el-card 组件创建一个表单容器卡片，设置阴影效果为无 -->
  <el-card class="form-container" shadow="never">
    <!-- el-form 表单组件，绑定了 menu 数据对象作为表单数据模型，同时指定了表单验证规则、表单引用以及标签宽度 -->
    <el-form :model="menu"
             :rules="rules"
             ref="menuFrom"
             label-width="150px">
      <!-- 表单项目，标签为“菜单名称：”，并指定了对应的数据验证属性 prop 为“title”，内部的输入框双向绑定 menu.title -->
      <el-form-item label="菜单名称：" prop="title">
        <el-input v-model="menu.title"></el-input>
      </el-form-item>
      <!-- 表单项目，标签为“上级菜单：”，内部是一个下拉选择框，双向绑定 menu.parentId，设置了占位符 -->
      <el-form-item label="上级菜单：">
        <el-select v-model="menu.parentId"
                   placeholder="请选择菜单">
          <!-- 通过 v-for 循环渲染下拉选项，每个选项的 key、label 和 value 分别对应 item 的 id、title 和 id，数据来源于 selectMenuList -->
          <el-option
            v-for="item in selectMenuList"
            :key="item.id"
            :label="item.title"
            :value="item.id">
          </el-option>
        </el-select>
      </el-form-item>
      <!-- 表单项目，标签为“前端名称：”，并指定了对应的数据验证属性 prop 为“name”，内部的输入框双向绑定 menu.name -->
      <el-form-item label="前端名称：" prop="name">
        <el-input v-model="menu.name"></el-input>
      </el-form-item>
      <!-- 表单项目，标签为“前端图标：”，并指定了对应的数据验证属性 prop 为“icon”，内部包含一个输入框双向绑定 menu.icon 以及一个 svg-icon 组件，用于根据输入的图标类名显示图标 -->
      <el-form-item label="前端图标：" prop="icon">
        <el-input v-model="menu.icon" style="width: 80%"></el-input>
        <svg-icon style="margin-left: 8px" :icon-class="menu.icon"></svg-icon>
      </el-form-item>
      <!-- 表单项目，标签为“是否显示：”，内部是一个单选按钮组，双向绑定 menu.hidden，用于选择是否显示该菜单 -->
      <el-form-item label="是否显示：">
        <el-radio-group v-model="menu.hidden">
          <el-radio :label="0">是</el-radio>
          <el-radio :label="1">否</el-radio>
        </el-radio-group>
      </el-form-item>
      <!-- 表单项目，标签为“排序：”，内部的输入框双向绑定 menu.sort -->
      <el-form-item label="排序：">
        <el-input v-model="menu.sort"></el-input>
      </el-form-item>
      <!-- 表单项目，包含两个按钮，提交按钮为主要类型（primary），点击时调用 onSubmit 方法并传入表单引用名；重置按钮在非编辑状态（!isEdit）下显示，点击时调用 resetForm 方法并传入表单引用名 -->
      <el-form-item>
        <el-button type="primary" @click="onSubmit('menuFrom')">提交</el-button>
        <el-button v-if="!isEdit" @click="resetForm('menuFrom')">重置</el-button>
      </el-form-item>
    </el-form>
  </el-card>
</template>
<script>
// 从 @/api/menu 模块中导入多个 API 函数，用于获取菜单列表、创建菜单、更新菜单以及获取单个菜单信息等操作
import {fetchList, createMenu, updateMenu, getMenu} from '@/api/menu';

// 默认的菜单对象，包含各个菜单相关属性的初始值，如标题、上级菜单 ID、前端名称、前端图标、是否隐藏、排序等
const defaultMenu = {
  title: '',
  parentId: 0,
  name: '',
  icon: '',
  hidden: 0,
  sort: 0
};

export default {
  name: "MenuDetail",
  // 定义组件的 props 属性，接收一个名为 isEdit 的布尔类型属性，默认值为 false，用于判断当前是编辑状态还是新建状态
  props: {
    isEdit: {
      type: Boolean,
      default: false
    }
  },
  data() {
    return {
      // 菜单数据对象，初始化为 defaultMenu 的副本，用于存储当前操作的菜单相关数据
      menu: Object.assign({}, defaultMenu),
      // 用于存储上级菜单列表数据，供下拉选择框使用
      selectMenuList: [],
      // 表单验证规则对象，定义了菜单名称、前端名称、前端图标等字段的验证要求，如必填、长度范围等，以及触发验证的时机（如失去焦点时触发）
      rules: {
        title: [
          {required: true, message: '请输入菜单名称', trigger: 'blur'},
          {min: 2, max: 140, message: '长度在 2 到 140 个字符', trigger: 'blur'}
        ],
        name: [
          {required: true, message: '请输入前端名称', trigger: 'blur'},
          {min: 2, max: 140, message: '长度在 2 到 140 个字符', trigger: 'blur'}
        ],
        icon: [
          {required: true, message: '请输入前端图标', trigger: 'blur'},
          {min: 2, max: 140, message: '长度在 2 到 140 个字符', trigger: 'blur'}
        ]
      }
    }
  },
  created() {
    // 判断当前是否为编辑状态（通过 props 传入的 isEdit 属性判断）
    if (this.isEdit) {
      // 如果是编辑状态，调用获取单个菜单信息的 API 函数，传入从路由参数中获取的菜单 ID，成功后将获取到的菜单数据赋值给 menu 对象
      getMenu(this.$route.query.id).then(response => {
        this.menu = response.data;
      });
    } else {
      // 如果不是编辑状态，将菜单数据对象重置为默认值
      this.menu = Object.assign({}, defaultMenu);
    }
    // 调用获取上级菜单列表的方法，用于初始化上级菜单下拉选择框的数据
    this.getSelectMenuList();
  },
  methods: {
    getSelectMenuList() {
      // 调用获取菜单列表的 API 函数，传入分页相关参数（这里固定获取第一页，每页 100 条数据）
      fetchList(0, {pageSize: 100, pageNum: 1}).then(response => {
        // 将获取到的菜单列表数据赋值给 selectMenuList 属性，用于在下拉选择框中展示
        this.selectMenuList = response.data.list;
        // 在上级菜单列表数据开头插入一个默认选项，表示“无上级菜单”，方便用户选择
        this.selectMenuList.unshift({id: 0, title: '无上级菜单'});
      });
    },
    onSubmit(formName) {
      // 通过表单引用调用表单的验证方法，传入一个回调函数，验证结果作为参数传入该回调函数
      this.$refs[formName].validate((valid) => {
        if (valid) {
          // 如果表单验证通过，弹出确认框，询问是否提交数据
          this.$confirm('是否提交数据', '提示', {
            confirmButtonText: '确定',
            cancelButtonText: '取消',
            type: 'warning'
          }).then(() => {
            // 判断当前是否为编辑状态
            if (this.isEdit) {
              // 如果是编辑状态，调用更新菜单的 API 函数，传入从路由参数中获取的菜单 ID 和当前的菜单数据对象
              // 成功后显示修改成功的提示消息，停留 1000 毫秒后返回上一页（路由操作）
              updateMenu(this.$route.query.id, this.menu).then(response => {
                this.$message({
                  message: '修改成功',
                  type: 'success',
                  duration: 1000
                });
                this.$router.back();
              });
            } else {
              // 如果不是编辑状态，调用创建菜单的 API 函数，传入当前的菜单数据对象
              // 成功后先重置表单字段，再调用 resetForm 方法（重置相关数据），显示提交成功的提示消息，停留 1000 毫秒后返回上一页（路由操作）
              createMenu(this.menu).then(response => {
                this.$refs[formName].resetFields();
                this.resetForm(formName);
                this.$message({
                  message: '提交成功',
                  type: 'success',
                  duration: 1000
                });
                this.$router.back();
              });
            }
          });

        } else {
          // 如果表单验证失败，显示验证失败的提示消息，停留 1000 毫秒，并返回 false 阻止后续操作
          this.$message({
            message: '验证失败',
            type: 'error',
            duration: 1000
          });
          return false;
        }
      });
    },
    resetForm(formName) {
      // 通过表单引用调用表单的重置字段方法，重置表单所有字段
      this.$refs[formName].resetFields();
      // 将菜单数据对象重置为默认值
      this.menu = Object.assign({}, defaultMenu);
      // 重新调用获取上级菜单列表的方法，刷新上级菜单下拉选择框的数据
      this.getSelectMenuList();
    },
  }
}
</script>
<style scoped>
/* scoped 属性表示样式仅作用于当前组件内的元素，避免样式冲突 */
</style>
