React のフォームにおける制御コンポーネントと非制御コンポーネントは、日常の開発で頻繁に直面する課題だ。本記事では実際のプロジェクトに基づき、具体的な実装方法と経験を共有する。

基本的な使い方

基本的な使い方から見ていこう。

{% raw %}
<template>
  <div>
    <p>{{ message }}</p>
    <button @click="reverse">反转</button>
  </div>
</template>

<script>
export default {
  data() {
    return { message: 'Hello Vue 2' }
  },
  methods: {
    reverse() {
      this.message = this.message.split('').reverse().join('')
    }
  }
}
</script>
{% endraw %}

この書き方は簡潔で分かりやすく、大半の場面に向いている。

応用テクニック

中核となるコードは以下の通りだ。

export default {
  props: ['items'],
  computed: {
    sorted() {
      return [...this.items].sort((a, b) => b.score - a.score)
    },
    count() {
      return this.items.length
    }
  },
  filters: {
    formatDate(val) {
      return new Date(val).toLocaleDateString('zh-CN')
    }
  }
}

実際のプロジェクトでは、境界条件や例外処理も考慮する必要がある。

実践事例

以下は実際の例だ。

export default {
  directives: {
    focus: {
      inserted(el) {
        el.focus()
      }
    },
    loading: {
      bind(el, binding) {
        if (binding.value) {
          el.classList.add('loading')
        }
      },
      update(el, binding) {
        el.classList.toggle('loading', binding.value)
      }
    }
  }
}

このパターンをチームに広めたところ効果が高く、保守コストが大きく下がった。

注意事項

以下のアプローチで実現できる。

import React, { Component } from 'react'

class DataList extends Component {
  state = { items: [], loading: true }

  async componentDidMount() {
    const res = await fetch('/api/items')
    const items = await res.json()
    this.setState({ items, loading: false })
  }

  render() {
    const { items, loading } = this.state
    if (loading) return <div>加载中...</div>
    return (
      <ul>
        {items.map(item => (
          <li key={item.id}>{item.name}</li>
        ))}
      </ul>
    )
  }
}

上のコードにあるパフォーマンス上の細部に注意し、不要な計算を避けること。

基本的な使い方

具体的な実装は以下のコードを参照。

import React, { Component } from 'react'

class Form extends Component {
  state = { name: '', email: '', errors: {} }

  handleChange = (e) => {
    this.setState({ [e.target.name]: e.target.value })
  }

  handleSubmit = (e) => {
    e.preventDefault()
    const errors = this.validate()
    if (Object.keys(errors).length === 0) {
      this.props.onSubmit(this.state)
    } else {
      this.setState({ errors })
    }
  }

  validate() {
    const errors = {}
    if (!this.state.name) errors.name = '必填'
    if (!this.state.email.includes('@')) errors.email = '格式错误'
    return errors
  }

  render() {
    return <form onSubmit={this.handleSubmit}>...</form>
  }
}

本番環境での検証を経て、このアプローチは安定して動作している。

まとめ

• React フォームの制御・非制御コンポーネントで肝心なのは本質的な概念を理解することで、表面的な使い方にとどまってはいけない
• 実際のプロジェクトでは、場面に応じて適切なアプローチを選ぶ
• チームでは、完璧な実装を追い求めるよりも、統一された取り決めの方が重要になる