React入门实战（一）联系人列表Contact（附完整代码）

前言

React入门实战项目——联系人列表Contact，通过该实战学习以下知识点：

1. 列表渲染
2. props：父向子传值、函数
3. 容器组件的使用与接收props
4. 事件使用

实战实现的功能：

• 展示联系人列表
• 新增联系人
• 删除联系人

涉及到的组件：

组件名（文件名）	描述
App.js	主组件
Contacts.js	展示联系人和删除联系人
AddContact.js	新增联系人

联系人的数据Contact包含了姓名name、年龄age、性别sex，还有一个标识id

Contact: [
    { id: 1, name: "ccy", age: 24, sex: "female" },
    { id: 2, name: "ccy1", age: 23, sex: "male" },
    { id: 3, name: "ccy2", age: 25, sex: "female" }
]

---

基本搭建

项目基本搭建请看我的上一篇文章：here

此处我们新建了一个Contacts.js文件，用来展示联系人数据和删除联系人，该组件为类组件，框架是这样的：

import React from 'react'

const Contacts = () => {

}

export default Contacts;

在主组件App.js中引入并通过props把Contact数据传过来

// 引入react
import React, { Component } from 'react'
// 引入Contact
import Contacts from './Contacts';

// 创建类组件App
class App extends Component {
    state = {
        Contact: [
            { id: 1, name: "ccy", age: 24, sex: "female" },
            { id: 2, name: "ccy1", age: 23, sex: "male" },
            { id: 3, name: "ccy2", age: 25, sex: "female" }
        ]
    }

    render() {
        // 使用Contacts
        return (
            <div className='container'>
                <Contacts contactList = {this.state.Contact} />
            </div>
        )
    }
}

export default App;

子组件Contact接收props

import React from 'react'

const Contacts = (props) => {

    // 解构时的命名需要与传递过来的变量名一致
    const { contactList } = props;
    console.log(contactList);

    return (
        <div className='container'>
            <h3>联系人列表</h3>
        </div>

    )
}

export default Contacts;

效果：可以看到，App.js传递过来的三条记录已经拿到了

---

展示联系人

列表渲染，重点是使用map逐一解析每一条记录，并用JSX语法包装

• 一条记录用一个div包裹
• 每一条记录都需要一个唯一id标识

_{注：Contact.js文件中解构出props的contactList之后添加这段代码}

	// 如果传过来的contactList有数据时逐条解析，没有时提示没有联系人
    const contactShow = contactList.length ? (
        contactList.map(contact => {
                return (
                    <div className='collection-item' key={contact.id}>
                        <h4>Name: {contact.name}</h4>
                        <p>Age: {contact.age}</p>
                        <p>Sex: {contact.sex}</p>
                    </div>
                )
        })

    ) : (
        <div>抱歉，没有找到要展示的联系人</div>
    )
	// 返回待渲染的代码
	return (
        <div className='container'>
            <h3>联系人列表</h3>
            <div className='collection'>
                {contactShow}
            </div>
        </div>

    )

效果：数据已展示，3条记录

---

删除联系人

给Contacts.js组件添加一个删除功能

• 增加“ 删除 ”按钮，点击该按钮，对应记录就会被删除
• 点击按钮后，将这条记录的id传递给主组件
• 主组件根据该id删除state的记录，更新展示的内容

由于数据存在App.js里，因此最终删除操作是由App.js完成的
在App.js文件中定义删除函数：

    // 根据id删除记录，更新state
    deleteContact = (id)=>{
    	// 如果id匹配，代表是要删除的记录，就不保留
        let contactForm = this.state.Contact.filter(contact=>{
            return contact.id !== id
        })
        this.setState({
            Contact:contactForm
        })
    }

将此函数通过props传给Contacts组件，让Contacts返回需要删除的id

    render() {
        return (
            <div className='container'>
                <Contacts contactList = {this.state.Contact} deleteContact={this.deleteContact} />
            </div>
        )
    }

Contacts组件接收props传来的变量

	// App.js多传递了一个变量deleteContact，也需要解构出来
    const { contactList,deleteContact } = props;

当用户点击“删除”按钮时，触发点击事件，调用App.js传来的函数deleteContact，将id传递出去

<button onClick={()=>{deleteContact(contact.id)}}>删除</button>

效果：

---

新增联系人

新建一个AddContact.js文件，用于实现新增联系人的功能

• 用户在文本框内输入联系人的信息
• 点击“提交”，更新state数据

最终数据添加的任务是由App.js完成的，添加联系人的函数写在App.js中，并通过props将函数接口传给AddContact

    // 添加一条联系人记录
    addContactFunc = (contact)=>{
        // 给新记录添加一个随机唯一id
        contact.id = Math.random();
        // 更新到state中
        let contactForm = [...this.state.Contact, contact];
        this.setState({
            Contact: contactForm
        })
    }

	render() {
        return (
            <div className='container'>
                <Contacts contactList = {this.state.Contact} deleteContact={this.deleteContact} />
                <AddContact addContact={this.addContactFunc} />
            </div>
        )
    }

AddContact.js：
使用的也是类组件，先定义一下文本框，将label与input绑定 ——htmlFor属性：

import React, {Component} from 'react'

class AddContact extends Component {
    // 初始化state，用来存储联系人信息
    state = {
        name:"",
        age:"",
        sex:""
    }
    
    render(){
        return(
            <div className='container'>
                <form onSubmit={this.handleSubmit}>
                    <label htmlFor='name'>Name:</label>
                    <input type='text' id='name' onChange={this.handleChange} value={this.state.name} />

                    <label htmlFor='age'>Age:</label>
                    <input type='text' id='age' onChange={this.handleChange} value={this.state.age} />

                    <label htmlFor='sex'>Sex:</label>
                    <input type='text' id='sex' onChange={this.handleChange} value={this.state.sex} />

                    <button>提交</button>
                </form>
            </div>
            
        )
    }
}

export default AddContact;

• 当用户输入数据时，及时更新到state中 ——onChange事件；
• 提交时，传递给App.js ——onSubmit事件:

	// 文本框有改变，就更新state
    handleChange = (e)=>{
        this.setState({
            [e.target.id] : e.target.value
        })
    }
    // 点击提交时，将数据传递给主组件，并重置文本框
    handleSubmit = (e)=>{
        e.preventDefault();
        this.props.addContact(this.state);
        this.setState({
            name:"",
            age:"",
            sex:""
        })
    }

效果：

---

完整代码：

App.js:

// 引入react
import React, { Component } from 'react'

import Contacts from './Contacts';
import AddContact from './AddContact';

// 创建类组件App
class App extends Component {
    state = {
        Contact: [
            { id: 1, name: "ccy", age: 24, sex: "female" },
            { id: 2, name: "ccy1", age: 23, sex: "male" },
            { id: 3, name: "ccy2", age: 25, sex: "female" }
        ]
    }

    // 添加一条联系人记录
    addContactFunc = (contact)=>{
        // 给新记录添加一个随机唯一id
        contact.id = Math.random();
        // 更新到state中
        let contactForm = [...this.state.Contact, contact];
        this.setState({
            Contact: contactForm
        })
    }

    // 根据id删除记录
    deleteContact = (id)=>{
        let contactForm = this.state.Contact.filter(contact=>{
            return contact.id !== id
        })
        this.setState({
            Contact:contactForm
        })
    }
    
    render() {
        
        return (
            <div className='container'>
                <Contacts contactList = {this.state.Contact} deleteContact={this.deleteContact} />
                <AddContact addContact={this.addContactFunc} />
            </div>
        )
    }
}

export default App;

Contacts.js:

import React from 'react'

const Contacts = (props) => {

    // 解构时的命名需要与传递过来的变量名一致
    const { contactList,deleteContact } = props;
    console.log(contactList);

    const contactShow = contactList.length ? (
        contactList.map(contact => {
                return (
                    <div className='collection-item' key={contact.id}>
                        <h4>Name: {contact.name}</h4>
                        <p>Age: {contact.age}</p>
                        <p>Sex: {contact.sex}</p>
                        <button onClick={()=>{deleteContact(contact.id)}}>删除</button>
                    </div>
                )
        })

    ) : (
        <div>抱歉，没有找到要展示的联系人</div>
    )
    return (
        <div className='container'>
            <h3>联系人列表</h3>
            <div className='collection'>
                {contactShow}
            </div>
        </div>

    )
}

export default Contacts;

AddContact.js:

import React, {Component} from 'react'

class AddContact extends Component {
    // 初始化state，用来存储联系人信息
    state = {
        name:"",
        age:"",
        sex:""
    }
    // 文本框有改变，就更新state
    handleChange = (e)=>{
        this.setState({
            [e.target.id] : e.target.value
        })
    }
    // 点击提交时，将数据传递给主组件，并重置文本框
    handleSubmit = (e)=>{
        e.preventDefault();
        this.props.addContact(this.state);
        this.setState({
            name:"",
            age:"",
            sex:""
        })
    }

    render(){
        return(
            <div className='container'>
                <form onSubmit={this.handleSubmit}>
                    <label htmlFor='name'>Name:</label>
                    <input type='text' id='name' onChange={this.handleChange} value={this.state.name} />

                    <label htmlFor='age'>Age:</label>
                    <input type='text' id='age' onChange={this.handleChange} value={this.state.age} />

                    <label htmlFor='sex'>Sex:</label>
                    <input type='text' id='sex' onChange={this.handleChange} value={this.state.sex} />

                    <button>提交</button>
                </form>
            </div>
            
        )
    }
}

export default AddContact;