feat(core): support field inject/invoke actions api (#3389)

packages/core/docs/api/models/Field.md

@@ -665,6 +665,34 @@ interface match {
 
 FormPathPattern API Reference [FormPath](/api/entry/form-path#formpathpattern)
 
+### inject
+
+#### Description
+
+Inject executable methods into field models
+
+#### Signature
+
+```ts
+interface inject {
+  (actions: Record<string, (...args: any[]) => any>): void
+}
+```
+
+### invoke
+
+#### Description
+
+Invoke an executable method injected by the field model via inject
+
+#### Signature
+
+```ts
+interface invoke {
+  (name: string, ...args: any[]): any
+}
+```
+
 ## Types of
 
 <Alert>

packages/core/docs/api/models/Field.zh-CN.md

@@ -665,6 +665,34 @@ interface match {
 
 FormPathPattern API 参考 [FormPath](/api/entry/form-path#formpathpattern)
 
+### inject
+
+#### 描述
+
+给字段模型注入可执行方法
+
+#### 签名
+
+```ts
+interface inject {
+  (actions: Record<string, (...args: any[]) => any>): void
+}
+```
+
+### invoke
+
+#### 描述
+
+调用字段模型通过 inject 注入的可执行方法
+
+#### 签名
+
+```ts
+interface invoke {
+  (name: string, ...args: any[]): any
+}
+```
+
 ## 类型
 
 <Alert>

packages/core/docs/api/models/VoidField.md

@@ -333,6 +333,34 @@ interface match {
 
 FormPathPattern API Reference [FormPath](/api/entry/form-path#formpathpattern)
 
+### inject
+
+#### Description
+
+Inject executable methods into field models
+
+#### Signature
+
+```ts
+interface inject {
+  (actions: Record<string, (...args: any[]) => any>): void
+}
+```
+
+### invoke
+
+#### Description
+
+Invoke an executable method injected by the field model via inject
+
+#### Signature
+
+```ts
+interface invoke {
+  (name: string, ...args: any[]): any
+}
+```
+
 ## Types of
 
 <Alert>

packages/core/docs/api/models/VoidField.zh-CN.md

@@ -333,6 +333,34 @@ interface match {
 
 FormPathPattern API 参考 [FormPath](/api/entry/form-path#formpathpattern)
 
+### inject
+
+#### 描述
+
+给字段模型注入可执行方法
+
+#### 签名
+
+```ts
+interface inject {
+  (actions: Record<string, (...args: any[]) => any>): void
+}
+```
+
+### invoke
+
+#### 描述
+
+调用字段模型通过 inject 注入的可执行方法
+
+#### 签名
+
+```ts
+interface invoke {
+  (name: string, ...args: any[]): any
+}
+```
+
 ## 类型
 
 <Alert>

packages/core/src/__tests__/field.spec.ts

@@ -2277,3 +2277,21 @@ test('onFieldReact with field destroyed', () => {
   obs.value = '111'
   expect(fn).toBeCalledTimes(2)
 })
+
+test('field actions', () => {
+  const form = attach(createForm())
+  const aa = attach(
+    form.createField({
+      name: 'aa',
+    })
+  )
+  expect(aa.actions).toEqual({})
+  aa.inject({
+    test: () => 123,
+  })
+  expect(aa.invoke('test')).toEqual(123)
+  aa.inject({
+    test: () => 321,
+  })
+  expect(aa.invoke('test')).toEqual(321)
+})

packages/core/src/models/BaseField.ts

@@ -1,11 +1,19 @@
-import { FormPath, FormPathPattern, isValid, toArr } from '@formily/shared'
+import {
+  FormPath,
+  FormPathPattern,
+  isValid,
+  toArr,
+  each,
+  isFn,
+} from '@formily/shared'
 import {
   JSXComponent,
   LifeCycleTypes,
   FieldDisplayTypes,
   FieldPatternTypes,
   FieldDecorator,
   FieldComponent,
+  IFieldActions,
 } from '../types'
 import { locateNode, destroy, initFieldUpdate } from '../shared/internals'
 import { Form } from './Form'
@@ -37,6 +45,8 @@ export class BaseField<Decorator = any, Component = any, TextType = any> {
 
   disposers: (() => void)[] = []
 
+  actions: IFieldActions = {}
+
   locate(address: FormPathPattern) {
     this.form.fields[address.toString()] = this as any
     locateNode(this as any, address)
@@ -309,4 +319,16 @@ export class BaseField<Decorator = any, Component = any, TextType = any> {
   match = (pattern: FormPathPattern) => {
     return FormPath.parse(pattern).matchAliasGroup(this.address, this.path)
   }
+
+  inject = (actions: IFieldActions) => {
+    each(actions, (action, key) => {
+      if (isFn(action)) {
+        this.actions[key] = action
+      }
+    })
+  }
+
+  invoke = (name: string, ...args: any[]) => {
+    return this.actions[name]?.(...args)
+  }
 }

packages/core/src/models/Field.ts

@@ -78,7 +78,6 @@ export class Field<
   feedbacks: IFieldFeedback[]
   caches: IFieldCaches = {}
   requests: IFieldRequests = {}
-
   constructor(
     address: FormPathPattern,
     props: IFieldProps<Decorator, Component, TextType, ValueType>,

packages/core/src/types.ts

@@ -433,3 +433,7 @@ export interface IFieldStateGetter {
   ): ReturnType<Getter>
   (pattern: FieldMatchPattern): IGeneralFieldState
 }
+
+export interface IFieldActions {
+  [key: string]: (...args: any[]) => any
+}