From c153ff93c73a305637828b0a3b83906ece6e9067 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sun, 8 Feb 2026 14:37:55 +0800
Subject: [PATCH] =?UTF-8?q?review=EF=BC=9A=E2=80=9C=E6=96=B0=E5=A2=9E=20if?=
 =?UTF-8?q?rame=20=E5=92=8C=E7=9C=81=E5=B8=82=E5=8C=BA=E9=80=89=E6=8B=A9?=
 =?UTF-8?q?=E5=99=A8=E7=BB=84=E4=BB=B6=E2=80=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../FormCreate/src/components/AreaSelect.vue  | 39 ++++++++-----------
 .../src/components/IframeComponent.vue        | 12 +++---
 .../src/config/useAreaSelectRule.ts           |  1 -
 .../FormCreate/src/config/useIframeRule.ts    |  1 -
 4 files changed, 22 insertions(+), 31 deletions(-)

diff --git a/src/components/FormCreate/src/components/AreaSelect.vue b/src/components/FormCreate/src/components/AreaSelect.vue
index 32ef3296..1633d7a9 100644
--- a/src/components/FormCreate/src/components/AreaSelect.vue
+++ b/src/components/FormCreate/src/components/AreaSelect.vue
@@ -18,6 +18,7 @@
 <script lang="ts" setup>
 import { onMounted, ref, watch } from 'vue'
 import { getAreaTree } from '@/api/system/area'
+// TODO @puhui999：这里 handleTree 貌似没用到
 import { handleTree } from '@/utils/tree'
 
 defineOptions({ name: 'AreaSelect' })
@@ -34,7 +35,7 @@ interface AreaVO {
 
 interface Props {
   modelValue?: number[] | string[]
-  level?: 1 | 2 | 3 // 1-省 2-市 3-区
+  level?: 1 | 2 | 3 // 1-省 2-市 3-区 TODO @puhui999：这里是不是放到枚举类里？
   disabled?: boolean
   placeholder?: string
   clearable?: boolean
@@ -45,7 +46,7 @@ interface Props {
 
 const props = withDefaults(defineProps<Props>(), {
   modelValue: undefined,
-  level: 3,
+  level: 3, // TODO @puhui999：枚举类；
   disabled: false,
   placeholder: '请选择省市区',
   clearable: true,
@@ -57,28 +58,23 @@ const emit = defineEmits<{
   (e: 'update:modelValue', value: number[] | string[] | undefined): void
 }>()
 
-// Element Plus Cascader 的 props 配置
 const cascaderProps = {
   label: 'name',
   value: 'id',
   children: 'children',
   checkStrictly: true, // 允许选择任意级别
   emitPath: true // 返回完整路径
-}
+} // Element Plus Cascader 的 props 配置
 
-// 地区树形数据
-const areaTree = ref<AreaVO[]>([])
-// 当前选中值
-const selectedValue = ref<number[] | undefined>()
-// 加载状态
-const loading = ref(false)
+const areaTree = ref<AreaVO[]>([]) // 地区树形数据
+const selectedValue = ref<number[] | undefined>() // 当前选中值
+const loading = ref(false) // 加载状态
 
-// 加载地区树形数据
+/** 加载地区树形数据 */
 async function loadAreaTree(): Promise<void> {
   try {
     loading.value = true
     const data = await getAreaTree()
-
     // 根据 level 限制层级
     areaTree.value = filterTreeByLevel(data || [], props.level)
   } catch (error) {
@@ -89,13 +85,13 @@ async function loadAreaTree(): Promise<void> {
   }
 }
 
-// 根据层级过滤树形数据
+/** 根据层级过滤树形数据 */
 function filterTreeByLevel(tree: AreaVO[], maxLevel: number): AreaVO[] {
-  if (maxLevel <= 0) return []
-
+  if (maxLevel <= 0) {
+    return []
+  }
   return tree.map((node) => {
     const newNode = { ...node }
-
     // 如果当前是最后一层，移除 children
     if (maxLevel === 1) {
       delete newNode.children
@@ -103,25 +99,22 @@ function filterTreeByLevel(tree: AreaVO[], maxLevel: number): AreaVO[] {
       // 递归处理子节点
       newNode.children = filterTreeByLevel(node.children, maxLevel - 1)
     }
-
     return newNode
   })
 }
 
-// 处理选中值变化
+/** 处理选中值变化 */
 function handleChange(value: number[] | undefined): void {
   if (value === undefined || value === null) {
     emit('update:modelValue', undefined)
     return
   }
-
   emit('update:modelValue', value)
 }
 
-// 同步 modelValue 到内部选中值
+/** 同步 modelValue 到内部选中值 */
 function syncSelectedValue(): void {
   const newValue = props.modelValue
-
   if (newValue === undefined || newValue === null) {
     selectedValue.value = undefined
     return
@@ -135,10 +128,10 @@ function syncSelectedValue(): void {
   }
 }
 
-// 监听 modelValue 变化
+/** 监听 modelValue 变化 */
 watch(() => props.modelValue, syncSelectedValue, { immediate: true })
 
-// 组件挂载时加载数据
+/** 组件挂载时加载数据 */
 onMounted(async () => {
   await loadAreaTree()
 })
diff --git a/src/components/FormCreate/src/components/IframeComponent.vue b/src/components/FormCreate/src/components/IframeComponent.vue
index 49ac1a88..57b4358a 100644
--- a/src/components/FormCreate/src/components/IframeComponent.vue
+++ b/src/components/FormCreate/src/components/IframeComponent.vue
@@ -23,6 +23,7 @@
 </template>
 
 <script lang="ts" setup>
+// TODO @AI：多余的变量，需要删除；
 import { computed, ref, watch } from 'vue'
 
 defineOptions({ name: 'IframeComponent' })
@@ -50,19 +51,18 @@ const props = withDefaults(defineProps<Props>(), {
   sandbox: ''
 })
 
+// TODO @puhui999：这里貌似暂时没用到？
 const emit = defineEmits<{
   (e: 'update:modelValue', value: string): void
 }>()
 
-// 显示的 URL（优先使用 url prop，其次使用 modelValue）
-const displayUrl = computed(() => props.url || props.modelValue || '')
-
-// 是否显示预览
+const displayUrl = computed(() => props.url || props.modelValue || '') // 显示的 URL（优先使用 url prop，其次使用 modelValue）
 const showPreview = computed(() => {
   return displayUrl.value && isValidUrl(displayUrl.value)
-})
+}) // 是否显示预览
 
-// URL 验证
+// TODO @puhui999：看看全局是不是有可复用的方法；
+/** URL 验证 */
 function isValidUrl(url: string): boolean {
   if (!url || url.trim() === '') return false
   try {
diff --git a/src/components/FormCreate/src/config/useAreaSelectRule.ts b/src/components/FormCreate/src/config/useAreaSelectRule.ts
index 59405da6..6f2bd35c 100644
--- a/src/components/FormCreate/src/config/useAreaSelectRule.ts
+++ b/src/components/FormCreate/src/config/useAreaSelectRule.ts
@@ -7,7 +7,6 @@ import { localeProps, makeRequiredRule } from '@/components/FormCreate/src/utils
 export const useAreaSelectRule = () => {
   const label = '省市区选择器'
   const name = 'AreaSelect'
-
   return {
     icon: 'icon-location',
     label,
diff --git a/src/components/FormCreate/src/config/useIframeRule.ts b/src/components/FormCreate/src/config/useIframeRule.ts
index 5a3e4787..da75cd78 100644
--- a/src/components/FormCreate/src/config/useIframeRule.ts
+++ b/src/components/FormCreate/src/config/useIframeRule.ts
@@ -7,7 +7,6 @@ import { localeProps, makeRequiredRule } from '@/components/FormCreate/src/utils
 export const useIframeRule = () => {
   const label = '网页 iframe'
   const name = 'IframeComponent'
-
   return {
     icon: 'icon-link',
     label,