RecordScope

描述

标准作用域注入组件，向子树的 Schema 表达式注入以下内置变量：

$record 当前记录数据
$record.$lookup 当前记录的父级记录，可以一直往上查找
$record.$index 当前记录的索引
$index 当前记录索引，等同于 $record.$index，考虑到记录数据如果不是对象，则需要独立读取
$lookup 当前记录的父级记录，等同于 $record.$lookup，考虑到记录数据如果不是对象，则需要独立读取

主要用于自增列表、表格等需要携带行数据递归渲染的场景，通常与 RecordsScope 搭配使用。

使用约定

任何自增列表扩展组件，内部都应该使用 RecordScope，用于传递记录作用域变量。

用例

tsx

import { createForm } from '@silver-formily/core'
import { createSchemaField, FormProvider, RecordScope } from '@silver-formily/react'
import { Input } from 'antd'

const form = createForm()

function MyCustomComponent(props) {
  return (
    <RecordScope getRecord={() => props.record} getIndex={() => props.index}>
      {props.children}
    </RecordScope>
  )
}

const SchemaField = createSchemaField({
  components: {
    Input,
    MyCustomComponent,
  },
})

export default () => (
  <FormProvider form={form}>
    <SchemaField
      schema={{
        type: 'object',
        properties: {
          lookup: {
            'type': 'void',
            'x-component': 'MyCustomComponent',
            'x-component-props': {
              record: {
                name: 'Lookup Name',
                code: 'Lookup Code',
              },
              index: 1,
            },
            'properties': {
              record: {
                'type': 'void',
                'x-component': 'MyCustomComponent',
                'x-component-props': {
                  record: {
                    name: 'Name',
                    code: 'Code',
                  },
                  index: 0,
                },
                'properties': {
                  input: {
                    'type': 'string',
                    'x-component': 'Input',
                    'x-value': `{{\`\${$record.name} \${$record.code} \${$record.$index} \${$record.$lookup.name} \${$record.$lookup.code} \${$index} \${$lookup.name} \${$lookup.code} \`}}`,
                  },
                },
              },
            },
          },
        },
      }}
    />
  </FormProvider>
)

查看源码

API

属性	说明	类型	默认值
getRecord	返回当前行记录的函数	`Function`	-
getIndex	返回当前行索引的函数	`Function`	-
children	子节点	`React.ReactNode`	-

getRecord 必填，getIndex 与 children 可选。未提供 getIndex 时 $index 为 undefined。这些变量通过 getter 读取最新值；非对象记录直接返回，不会附加 $lookup / $index 属性。

RecordScope ​

描述 ​

使用约定 ​

用例 ​

API ​

RecordScope

描述

使用约定

用例

API