@veltra/desktop 1.7.9 → 1.7.11

package/src/types/drawer.ts

@@ -15,16 +15,19 @@ export interface DrawerProps {
 
   /** 是否显示关闭按钮 */
   showClose?: boolean
-  /** 抽屉标题 */
+  /**
+   * 抽屉标题；传入时在内容区上方渲染标题栏
+   * @description 不传则不渲染标题栏，内容仍全部来自默认插槽
+   */
   title?: string
 }
 
 /** 抽屉组件定义的事件 */
 export interface DrawerEmits {
   (e: 'update:modelValue', value: boolean): void
-  /** 关闭时触发 */
+  /** 开始关闭时触发（点遮罩、点关闭按钮） */
   (e: 'close'): void
-  /** 完全关闭后触发 */
+  /** 完全关闭后触发：抽屉与遮罩的退出动画结束、节点已移除时 */
   (e: 'closed'): void
 }
 

package/src/types/form-item.ts

@@ -9,7 +9,10 @@ export interface FormItemProps extends FormComponentProps {
 }
 
 /** 组件项组件定义的事件 */
-export interface FormItemEmits {}
+export interface FormItemEmits {
+  /** 内部控件 change，参数与控件一致 */
+  (e: 'change', ...args: any[]): void
+}
 
 /** 组件项组件暴露的属性和方法 */
 export interface FormItemExposed {}

package/src/types/form.ts

@@ -10,7 +10,12 @@ export interface FormProps extends ComponentProps {
   cols?: number
   /** 表单数据 */
   model?: Record<string, any>
-  // showModified?: boolean
+  /** 开启后，字段当前值与基准值不同时，在控件下方展示「变更前」 */
+  showModified?: boolean
+  /** 「变更前」标签文案，默认「变更前：」 */
+  modifiedLabel?: string
+  /** 变更前基准数据；未传时回退到 model 引用首次传入时的快照（与 reset 一致） */
+  initialModel?: Record<string, any>
   /** 表单项label宽度 */
   labelWidth?: string | number
   /** 表单项 label 位置 */
@@ -24,7 +29,10 @@ export interface FormProps extends ComponentProps {
 }
 
 export interface FormEmits {
-  (e: 'field:change', field: string, value: any): void
+  /** 控件 change 事件，仅用户操作触发 */
+  (e: 'field:change', field: string, ...args: any[]): void
+  /** model 字段值更新，含编程写入 */
+  (e: 'field:update', field: string, value: any): void
 }
 
 export interface _FormExposed {

package/src/types/layout.ts

@@ -18,6 +18,8 @@ export interface LayoutProps {
    * const cols = ['200px', '1fr']
    * ```
    * [fr是什么?](https://developer.mozilla.org/zh-CN/docs/Web/CSS/flex_value)
+   * @description 默认插槽的每个直接子元素按顺序占一列，用自定义组件包一层时该组件必须是单根元素；
+   * 子元素渲染出 0 个（`v-if` 为假）或多个根节点时会挤动后面的列，此时自行给子元素写 `grid-column`
    */
   cols?: string[] | string