Commit e72c02497f6304f0d88490a1e39a8ea203ff2f61

Authored by YunaiV
1 parent 574f90d9

feat(infra): 优化 uni-app 生成模板变量注释

- 为列表、表单、详情、搜索模板补充简洁尾注释
- 将变量注释调整为当前模块上下文内的短描述
- 优化时间范围选择器确认方法注释
yudao-module-infra/src/main/resources/codegen/vue3_admin_uniapp/components/search-form.vue.vm
... ... @@ -177,7 +177,7 @@ const emit = defineEmits<{
177 177 reset: []
178 178 }>()
179 179  
180   -const visible = ref(false)
  180 +const visible = ref(false) // 搜索弹窗显示状态
181 181 const formData = reactive({
182 182 #foreach($column in $columns)
183 183 #if ($column.listOperation)
... ... @@ -201,7 +201,7 @@ const formData = reactive({
201 201 #end
202 202 #end
203 203 #end
204   -})
  204 +}) // 搜索表单数据
205 205  
206 206 /** 搜索条件 placeholder 拼接 */
207 207 const placeholder = computed(() => {
... ... @@ -237,21 +237,20 @@ const placeholder = computed(() => {
237 237 })
238 238  
239 239 #if ($hasDateTimeBetween == 1)
240   -// 时间范围选择器状态
241 240 #foreach($column in $columns)
242 241 #if ($column.listOperation && $column.htmlType == "datetime" && $column.listOperationCondition == "BETWEEN")
243 242 #set ($javaField = $column.javaField)
244 243 #set ($AttrName = $javaField.substring(0,1).toUpperCase() + ${javaField.substring(1)})
245   -const visible${AttrName} = ref<[boolean, boolean]>([false, false])
246   -const temp${AttrName} = ref<[number, number]>([Date.now(), Date.now()])
  244 +const visible${AttrName} = ref<[boolean, boolean]>([false, false]) // ${column.columnComment}选择器状态
  245 +const temp${AttrName} = ref<[number, number]>([Date.now(), Date.now()]) // ${column.columnComment}临时值
247 246  
248   -/** ${column.columnComment}[0]确认 */
  247 +/** 确认${column.columnComment}开始日期 */
249 248 function handle${AttrName}0Confirm() {
250 249 formData.${javaField} = [temp${AttrName}.value[0], formData.${javaField}?.[1]]
251 250 visible${AttrName}.value[0] = false
252 251 }
253 252  
254   -/** ${column.columnComment}[1]确认 */
  253 +/** 确认${column.columnComment}结束日期 */
255 254 function handle${AttrName}1Confirm() {
256 255 formData.${javaField} = [formData.${javaField}?.[0], temp${AttrName}.value[1]]
257 256 visible${AttrName}.value[1] = false
... ...
yudao-module-infra/src/main/resources/codegen/vue3_admin_uniapp/views/detail/index.vue.vm
... ... @@ -87,8 +87,8 @@ definePage({
87 87  
88 88 const { hasAccessByCodes } = useAccess()
89 89 const toast = useToast()
90   -const formData = ref<${simpleClassName}>()
91   -const deleting = ref(false)
  90 +const formData = ref<${simpleClassName}>() // 详情数据
  91 +const deleting = ref(false) // 删除状态
92 92  
93 93 /** 返回上一页 */
94 94 function handleBack() {
... ...
yudao-module-infra/src/main/resources/codegen/vue3_admin_uniapp/views/form/index.vue.vm
... ... @@ -175,7 +175,7 @@ definePage({
175 175  
176 176 const toast = useToast()
177 177 const getTitle = computed(() => props.id ? '编辑${table.classComment}' : '新增${table.classComment}')
178   -const formLoading = ref(false)
  178 +const formLoading = ref(false) // 表单提交状态
179 179 const formData = ref<${simpleClassName}>({
180 180 #foreach($column in $columns)
181 181 #if (($column.createOperation || $column.updateOperation) || $column.primaryKey)
... ... @@ -195,7 +195,7 @@ const formData = ref&lt;${simpleClassName}&gt;({
195 195 #end
196 196 #end
197 197 #end
198   -})
  198 +}) // 表单数据
199 199 const formRules = {
200 200 #foreach($column in $columns)
201 201 #set ($javaFieldLower = $column.javaField.toLowerCase())
... ... @@ -204,8 +204,8 @@ const formRules = {
204 204 ${column.javaField}: [{ required: true, message: '${column.columnComment}不能为空' }],
205 205 #end
206 206 #end
207   -}
208   -const formRef = ref<FormInstance>()
  207 +} // 表单校验规则
  208 +const formRef = ref<FormInstance>() // 表单组件引用
209 209  
210 210 /** 返回上一页 */
211 211 function handleBack() {
... ...
yudao-module-infra/src/main/resources/codegen/vue3_admin_uniapp/views/index.vue.vm
... ... @@ -130,13 +130,13 @@ definePage({
130 130 })
131 131  
132 132 const { hasAccessByCodes } = useAccess()
133   -const total = ref(0)
134   -const list = ref<${simpleClassName}[]>([])
135   -const loadMoreState = ref<LoadMoreState>('loading')
  133 +const total = ref(0) // 列表总数
  134 +const list = ref<${simpleClassName}[]>([]) // 列表数据
  135 +const loadMoreState = ref<LoadMoreState>('loading') // 分页加载状态
136 136 const queryParams = ref({
137 137 pageNo: 1,
138 138 pageSize: 10,
139   -})
  139 +}) // 查询参数
140 140  
141 141 /** 返回上一页 */
142 142 function handleBack() {
... ...