useField
描述
主要用在自定义组件内读取当前字段属性,操作字段状态等,在所有 Field 组件的子树内都能使用,注意,拿到的是GeneralField,如果需要对不同类型的字段做处理,请使用Type Checker
WARNING
注意:如果要在自定义组件内使用 useField,并响应字段模型变化,需要使用 observer 包裹自定义组件
签名
ts
interface useField {
(): Ref<Field>
}用例
<script setup lang="tsx">
import type { Field as FieldType } from '@formily/core'
import { createForm, setValidateLanguage } from '@formily/core'
import { observer } from '@formily/reactive-vue'
import { Field, FormConsumer, FormProvider, useField } from '@silver-formily/vue'
import { ElButton, ElFormItem, ElInput } from 'element-plus'
import { defineComponent } from 'vue'
setValidateLanguage('en')
const FormItem = observer(
defineComponent({
setup(_props, { slots }) {
const fieldRef = useField<FieldType>()
return () => (
<ElFormItem
label={fieldRef.value?.title}
required={fieldRef.value?.required}
help={fieldRef.value?.selfErrors?.length ? fieldRef.value?.selfErrors : undefined}
extra={fieldRef.value?.description}
validateStatus={fieldRef.value?.validateStatus}
>
{slots?.default?.()}
</ElFormItem>
)
},
}),
)
const form = createForm({ validateFirst: true })
function log(values: string) {
console.warn('Form Submitted:', values)
}
</script>
<template>
<FormProvider :form="form">
<Form layout="vertical">
<Field
name="name"
title="Name"
required
:decorator="[FormItem]"
:component="[ElInput, { placeholder: 'Please ElInput' }]"
/>
<FormConsumer>
<template #default="{ form: _form }">
<div style="white-space: pre; margin-bottom: 16px">
{{ JSON.stringify(_form.values, null, 2) }}
</div>
<ElButton
type="primary"
@click="
() => {
form.submit(log)
}
"
>
Submit
</ElButton>
</template>
</FormConsumer>
</Form>
</FormProvider>
</template>