React-hook-form Demo之外——实际的用法

control的应用

在react-hook-form的API中,有着controluseControl两个接口。官方文档描述的太过于简陋,以至于并不能帮你解决什么问题。

实际上,control被用于复杂表单下的这些场景,如果你有以下场景的需求,看下去:

  • 自定义Input组件
  • 子区域抽成组件

出现这样的需求往往是由于html的原生组件不能满足我们的需求,而一些组件库的风格又比较固定,不太好改成符合我们自己的界面风格。和实际业务场景中的表单十分复杂,为了达到结构简化和复用等目的,我们需要将其中子区域抽成一个组件,但是又要在一个form内受useForm的控制。

所以,当需要将关联在一起的input组合成一个组件,我们一般会这么写:

// 示例只含control的用法,未写useForm的相关用法,参照官方文档即可
// yourFomComponent.tsx
const { register, setValue, getValues, control } = useForm<FormValue>();
<form>
    <ColorEditor name="color" defaultValue="#FFFFFFF" control={control}></ColorEditor>
</form>

// yourComponent.tsx
export const ColorEditor = (props: UseControllerProps) => {
    const { field, fieldState } = useController(props);

    return (
        <div>
            <input type="color" {...field}></input>
            <input type="text" {...field}></input>
        </div >
    );
};

可以看到,在使用的时候control由useForm创建,useForm将一系列框架的方法和事件打包在其中用于作为参数传入。name,defaultVlue,control是UseControllerProps定义的参数,然后通过useController将control解包出来成了field,它与外部的register()的返回值一致。

但是,你说都抽成组件了,还是和外面的用法一样,control只是过了一道手而已,我想自己在中间加入我的控制怎么办。这个时候官方文档就不会告诉你怎么写,所以我们举个两个复杂例子:

场景一:自定义参数,不使用control的参数定义
// 示例只含control的用法,不含useForm的相关用法,参照官方文档即可

// yourFomComponent.tsx
const { register, setValue, getValues, control } = useForm<FormValue>();
<form>
    <CheckBox id={yourId} defaultValue={yourValue} 
        name="yourPropertyName" text="选择我" control={control}>
    </CheckBox>
</form>

// yourComponent.tsx
type Props = {
    id: string,
    name: string,
    text: string,
    defaultValue: boolean,
    control: Control
};
export const CheckBox = (props: Props) => {
    const { field } = useController({
        name: props.name,
        control: props.control
    });

    return (
        <div>
            <input id={props.id} type="checkbox" checked={props.defaultValue} {...field}></input>
            <label htmlFor={props.id}>{props.text}</label>
        </div >
    );
};
场景二:自定义操作,不使用control的默认方法
// 示例只含control的用法,不含useForm的相关用法,参照官方文档即可

// yourFomComponent.tsx
const { register, setValue, getValues, control } = useForm<FormValue>();
<form>
    <Number name="yourNumber" control={control} defaultValue={number}></Number>
</form>

// yourComponent.tsx
export const Number = (props: UseControllerProps) => {
    const { field, fieldState } = useController(props);
    const [editorValue, setEditorValue] = React.useState(props.defaultValue);
    const [mouseButton, setMouseButton] = React.useState(0);

    // 观察外部有没有使用 setValues()设置当前值 
    {
        const watchValue = useWatch({
            control: props.control,
            name: props.name,
            defaultValue: props.defaultValue
        });

        React.useEffect(() => {
            // 当观察值改变时,设置当前的编辑状态,触发重新渲染
            setEditorValue(watchValue);
        }, [watchValue]);
    }

    const handleMouseDownUp = (e: React.MouseEvent<HTMLInputElement>) => etMouseButton(e.buttons);
    const handleMouseLeave = (e: React.MouseEvent<HTMLInputElement>) => {
        if (e.buttons == 1)  setMouseButton(0);
    }
    const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
        // 当值改变时重设状态值,保持input可编辑
        setEditorValue(e.target.value);

        if (mouseButton == 1) 
            field.onChange(e);
        else 
            e.stopPropagation(); // 阻止keyDown冒泡
    };

    const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
        if (e.key === "Enter")
            field.onChange(e);
    }

    return <input type="number" name={field.name}
        value={editorValue} ref={field.ref}
        onBlur={field.onBlur}
        onChange={handleChange}
        onKeyDown={handleKeyDown}
        onMouseDown={handleMouseDownUp}
        onMouseUp={handleMouseDownUp}
        onMouseLeave={handleMouseLeave}
    ></input>;
};

这个例子就复杂很多,它是一个数字的编辑器,在输入后按回车和点击上下箭头调整数字时触发change事件。
要实现这个就解决三个问题,

1. 内部事件的拦截

拦截input的onChange事件,在其中判断用户时鼠标点击还是在键盘输入。同时,处理onKeyDown事件,在用户按下回车时,触发change。

2. 使控件可编辑

我们知道input控件实现值编辑就是通过onChange事件改变状态后重新render实现的,但是在这个场景下,我们拦截了onChange事件,这样input就处于不可编辑的状态。所以添加一个内部状态editorValue作为编辑值,在onChange事件中修改状态,保证input可编辑。

3. 使控件响应setValue()

当前编辑值改为内部状态后,我们就和form中的值失去了联系了。除了从defaultValue传入的初始值之外,外部setValue()当前name的时候,控件就不会有任何响应。我们通过useWatch来监视当前name来,当外部setValue时,我们收到消息,改变input控件的状态值。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342

推荐阅读更多精彩内容