import{ax as i,z as a,A as n,b5 as h}from"./chunks/framework.V2ssSR2R.js";const E=JSON.parse('{"title":"EventSelect 事件选择器","description":"","frontmatter":{},"headers":[],"relativePath":"form-config/editor-fields/event-select.md","filePath":"form-config/editor-fields/event-select.md"}'),t={name:"form-config/editor-fields/event-select.md"};function k(l,s,p,e,d,r){return n(),a("div",null,[...s[0]||(s[0]=[h(`

EventSelect 事件选择器

用于配置组件或数据源事件的选择器。

注意

此组件仅在编辑器环境中可用,需要配合 @tmagic/editor 使用。

基础用法

js
{
  type: 'event-select',
  name: 'events',
  text: '事件配置',
  src: 'component'
}

数据源事件

js
{
  type: 'event-select',
  name: 'events',
  text: '事件配置',
  src: 'datasource'
}

Attributes

参数说明类型可选值默认值
name绑定值string
text表单标签string
disabled是否禁用boolean / FilterFunctionfalse
src事件来源stringdatasource/component
labelWidth标签宽度string
eventNameConfig事件名称表单配置FormItem
actionTypeConfig动作类型配置FormItem
targetCompConfig联动组件配置FormItem
compActionConfig联动组件动作配置FormItem
codeActionConfig联动代码配置FormItem
dataSourceActionConfig联动数据源配置FormItem
onChange值变化时触发的函数OnChangeHandler-
查看 FilterFunction / OnChangeHandler 及关联类型定义
ts
export type FilterFunction<T = boolean> = (
  mForm: FormState | undefined,
  data: {
    model: FormValue;
    values: FormValue;
    parent?: FormValue;
    formValue: FormValue;
    prop: string;
    config: any;
    index?: number;
    getFormValue: (prop: string) => any;
  },
) => T;
ts
export type OnChangeHandler = (mForm: FormState | undefined, value: any, data: OnChangeHandlerData) => any;
ts
export interface OnChangeHandlerData {
  model: FormValue;
  values?: Readonly<FormValue> | null;
  parent?: FormValue;
  formValue?: FormValue;
  config: Readonly<any>;
  prop: string;
  changeRecords: ChangeRecord[];
  setModel: (prop: string, value: any) => void;
  setFormValue: (prop: string, value: any) => void;
}
ts
export interface ChangeRecord {
  propPath?: string;
  value: any;
}
ts
export type FormValue = Record<string | number, any>;

配置类型

查看 EventSelectConfig 配置类型定义
ts
export interface EventSelectConfig extends FormItem {
  name: string;
  type: 'event-select';
  src: 'datasource' | 'component';
  labelWidth?: string;
  /** 事件名称表单配置 */
  eventNameConfig?: FormItem;
  /** 动作类型配置 */
  actionTypeConfig?: FormItem;
  /** 联动组件配置 */
  targetCompConfig?: FormItem;
  /** 联动组件动作配置 */
  compActionConfig?: FormItem;
  /** 联动代码配置 */
  codeActionConfig?: FormItem;
  /** 联动数据源配置 */
  dataSourceActionConfig?: FormItem;
}
ts
export interface FormItem {
  /** vnode的key值,默认是遍历数组时的index */
  __key?: string | number;
  /** 表单域标签的的宽度,例如 '50px'。支持 auto。 */
  labelWidth?: string | number;
  /** label 标签的title属性 */
  labelTitle?: string;
  className?: string;
  /** 字段名 */
  name?: string | number;
  /** 额外的提示信息,和 help 类似,当提示文案同时出现时,可以使用这个。 */
  extra?: string | FilterFunction<string>;
  /** 配置提示信息 */
  tooltip?: ToolTipConfigType | FilterFunction<ToolTipConfigType>;
  /** 是否置灰 */
  disabled?: boolean | FilterFunction;
  /** 使用表单中的值作为key,例如配置了text,则使用model.text作为key */
  key?: string;
  /** 是否显示 */
  display?: boolean | 'expand' | FilterFunction<boolean | 'expand'>;
  /** 值发生改变时调用的方法 */
  onChange?: OnChangeHandler;
  /** label 标签的文本 */
  text?: string | FilterFunction<string>;
  /** 右侧感叹号 */
  tip?: string;

  filter?: 'number' | OnChangeHandler;
  /** 是否去除首尾空格 */
  trim?: boolean;
  /** 默认值 */
  defaultValue?: any | DefaultValueFunction;
  /** 表单验证规则 */
  rules?: Rule[];
  extensible?: boolean;
  dynamicKey?: string;
  /** 是否需要显示\`展开更多配置\` */
  expand?: boolean;
  style?: Record<string, any>;
  fieldStyle?: Record<string, any>;
  labelPosition?: 'top' | 'left' | 'right';
}

src说明

`,14)])])}const F=i(t,[["render",k]]);export{E as __pageData,F as default};