From 956a3e56e684ca3274cdbc116fe4175121b91d97 Mon Sep 17 00:00:00 2001
From: hxr <1490493387@qq.com>
Date: Tue, 25 Jun 2024 22:40:04 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20:memo:=20=E5=AE=8C=E5=96=84=20app=20?=
 =?UTF-8?q?=E7=8A=B6=E6=80=81=E7=AE=A1=E7=90=86=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/store/modules/app.ts | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/src/store/modules/app.ts b/src/store/modules/app.ts
index 747f9945..46f37386 100644
--- a/src/store/modules/app.ts
+++ b/src/store/modules/app.ts
@@ -7,19 +7,23 @@ import { store } from "@/store";
 import { DeviceEnum } from "@/enums/DeviceEnum";
 import { SidebarStatusEnum } from "@/enums/SidebarStatusEnum";
 
-// setup
 export const useAppStore = defineStore("app", () => {
-  // state
+  // 设备类型
   const device = useStorage("device", DeviceEnum.DESKTOP);
+  // 布局大小
   const size = useStorage("size", defaultSettings.size);
+  // 语言
   const language = useStorage("language", defaultSettings.language);
+  // 侧边栏状态
   const sidebarStatus = useStorage("sidebarStatus", SidebarStatusEnum.CLOSED);
-
   const sidebar = reactive({
     opened: sidebarStatus.value === SidebarStatusEnum.OPENED,
     withoutAnimation: false,
   });
+
+  // 顶部菜单激活路径
   const activeTopMenuPath = useStorage("activeTopMenuPath", "");
+
   /**
    * 根据语言标识读取对应的语言包
    */
@@ -31,7 +35,7 @@ export const useAppStore = defineStore("app", () => {
     }
   });
 
-  // actions
+  // 切换侧边栏
   function toggleSidebar() {
     sidebar.opened = !sidebar.opened;
     sidebarStatus.value = sidebar.opened
@@ -39,20 +43,28 @@ export const useAppStore = defineStore("app", () => {
       : SidebarStatusEnum.CLOSED;
   }
 
+  // 关闭侧边栏
   function closeSideBar() {
     sidebar.opened = false;
     sidebarStatus.value = SidebarStatusEnum.CLOSED;
   }
 
+  // 打开侧边栏
   function openSideBar() {
     sidebar.opened = true;
     sidebarStatus.value = SidebarStatusEnum.OPENED;
   }
 
+  // 切换设备
   function toggleDevice(val: string) {
     device.value = val;
   }
 
+  /**
+   * 改变布局大小
+   *
+   * @param val 布局大小 default | small | large
+   */
   function changeSize(val: string) {
     size.value = val;
   }