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,7 +177,7 @@ const emit = defineEmits<{
177 reset: [] 177 reset: []
178 }>() 178 }>()
179 179
180 -const visible = ref(false) 180 +const visible = ref(false) // 搜索弹窗显示状态
181 const formData = reactive({ 181 const formData = reactive({
182 #foreach($column in $columns) 182 #foreach($column in $columns)
183 #if ($column.listOperation) 183 #if ($column.listOperation)
@@ -201,7 +201,7 @@ const formData = reactive({ @@ -201,7 +201,7 @@ const formData = reactive({
201 #end 201 #end
202 #end 202 #end
203 #end 203 #end
204 -}) 204 +}) // 搜索表单数据
205 205
206 /** 搜索条件 placeholder 拼接 */ 206 /** 搜索条件 placeholder 拼接 */
207 const placeholder = computed(() => { 207 const placeholder = computed(() => {
@@ -237,21 +237,20 @@ const placeholder = computed(() => { @@ -237,21 +237,20 @@ const placeholder = computed(() => {
237 }) 237 })
238 238
239 #if ($hasDateTimeBetween == 1) 239 #if ($hasDateTimeBetween == 1)
240 -// 时间范围选择器状态  
241 #foreach($column in $columns) 240 #foreach($column in $columns)
242 #if ($column.listOperation && $column.htmlType == "datetime" && $column.listOperationCondition == "BETWEEN") 241 #if ($column.listOperation && $column.htmlType == "datetime" && $column.listOperationCondition == "BETWEEN")
243 #set ($javaField = $column.javaField) 242 #set ($javaField = $column.javaField)
244 #set ($AttrName = $javaField.substring(0,1).toUpperCase() + ${javaField.substring(1)}) 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 function handle${AttrName}0Confirm() { 248 function handle${AttrName}0Confirm() {
250 formData.${javaField} = [temp${AttrName}.value[0], formData.${javaField}?.[1]] 249 formData.${javaField} = [temp${AttrName}.value[0], formData.${javaField}?.[1]]
251 visible${AttrName}.value[0] = false 250 visible${AttrName}.value[0] = false
252 } 251 }
253 252
254 -/** ${column.columnComment}[1]确认 */ 253 +/** 确认${column.columnComment}结束日期 */
255 function handle${AttrName}1Confirm() { 254 function handle${AttrName}1Confirm() {
256 formData.${javaField} = [formData.${javaField}?.[0], temp${AttrName}.value[1]] 255 formData.${javaField} = [formData.${javaField}?.[0], temp${AttrName}.value[1]]
257 visible${AttrName}.value[1] = false 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,8 +87,8 @@ definePage({
87 87
88 const { hasAccessByCodes } = useAccess() 88 const { hasAccessByCodes } = useAccess()
89 const toast = useToast() 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 function handleBack() { 94 function handleBack() {
yudao-module-infra/src/main/resources/codegen/vue3_admin_uniapp/views/form/index.vue.vm
@@ -175,7 +175,7 @@ definePage({ @@ -175,7 +175,7 @@ definePage({
175 175
176 const toast = useToast() 176 const toast = useToast()
177 const getTitle = computed(() => props.id ? '编辑${table.classComment}' : '新增${table.classComment}') 177 const getTitle = computed(() => props.id ? '编辑${table.classComment}' : '新增${table.classComment}')
178 -const formLoading = ref(false) 178 +const formLoading = ref(false) // 表单提交状态
179 const formData = ref<${simpleClassName}>({ 179 const formData = ref<${simpleClassName}>({
180 #foreach($column in $columns) 180 #foreach($column in $columns)
181 #if (($column.createOperation || $column.updateOperation) || $column.primaryKey) 181 #if (($column.createOperation || $column.updateOperation) || $column.primaryKey)
@@ -195,7 +195,7 @@ const formData = ref&lt;${simpleClassName}&gt;({ @@ -195,7 +195,7 @@ const formData = ref&lt;${simpleClassName}&gt;({
195 #end 195 #end
196 #end 196 #end
197 #end 197 #end
198 -}) 198 +}) // 表单数据
199 const formRules = { 199 const formRules = {
200 #foreach($column in $columns) 200 #foreach($column in $columns)
201 #set ($javaFieldLower = $column.javaField.toLowerCase()) 201 #set ($javaFieldLower = $column.javaField.toLowerCase())
@@ -204,8 +204,8 @@ const formRules = { @@ -204,8 +204,8 @@ const formRules = {
204 ${column.javaField}: [{ required: true, message: '${column.columnComment}不能为空' }], 204 ${column.javaField}: [{ required: true, message: '${column.columnComment}不能为空' }],
205 #end 205 #end
206 #end 206 #end
207 -}  
208 -const formRef = ref<FormInstance>() 207 +} // 表单校验规则
  208 +const formRef = ref<FormInstance>() // 表单组件引用
209 209
210 /** 返回上一页 */ 210 /** 返回上一页 */
211 function handleBack() { 211 function handleBack() {
yudao-module-infra/src/main/resources/codegen/vue3_admin_uniapp/views/index.vue.vm
@@ -130,13 +130,13 @@ definePage({ @@ -130,13 +130,13 @@ definePage({
130 }) 130 })
131 131
132 const { hasAccessByCodes } = useAccess() 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 const queryParams = ref({ 136 const queryParams = ref({
137 pageNo: 1, 137 pageNo: 1,
138 pageSize: 10, 138 pageSize: 10,
139 -}) 139 +}) // 查询参数
140 140
141 /** 返回上一页 */ 141 /** 返回上一页 */
142 function handleBack() { 142 function handleBack() {