├── public ├── robots.txt ├── favicon.ico ├── logo192.png ├── logo512.png ├── manifest.json └── index.html ├── src ├── utils.js ├── setupTests.js ├── App.test.js ├── index.css ├── App.css ├── index.js ├── components │ ├── SelectDataKey.js │ ├── GlobalStats.js │ ├── CountriesChart.js │ ├── HistoryChartGroup.js │ └── HistoryChart.js ├── hooks │ └── useCoronaAPI.js ├── App.js ├── logo.svg └── serviceWorker.js ├── .gitignore ├── package.json └── README.md /public/robots.txt: -------------------------------------------------------------------------------- 1 | # https://www.robotstxt.org/robotstxt.html 2 | User-agent: * 3 | Disallow: 4 | -------------------------------------------------------------------------------- /public/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tuture-dev/covid-19-with-hooks/HEAD/public/favicon.ico -------------------------------------------------------------------------------- /public/logo192.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tuture-dev/covid-19-with-hooks/HEAD/public/logo192.png -------------------------------------------------------------------------------- /public/logo512.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tuture-dev/covid-19-with-hooks/HEAD/public/logo512.png -------------------------------------------------------------------------------- /src/utils.js: -------------------------------------------------------------------------------- 1 | export function transformHistory(timeline = {}) { 2 | return Object.entries(timeline).map((entry) => { 3 | const [time, number] = entry; 4 | return { time, number }; 5 | }); 6 | } 7 | -------------------------------------------------------------------------------- /src/setupTests.js: -------------------------------------------------------------------------------- 1 | // jest-dom adds custom jest matchers for asserting on DOM nodes. 2 | // allows you to do things like: 3 | // expect(element).toHaveTextContent(/react/i) 4 | // learn more: https://github.com/testing-library/jest-dom 5 | import '@testing-library/jest-dom/extend-expect'; 6 | -------------------------------------------------------------------------------- /src/App.test.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | import { render } from '@testing-library/react'; 3 | import App from './App'; 4 | 5 | test('renders learn react link', () => { 6 | const { getByText } = render(); 7 | const linkElement = getByText(/learn react/i); 8 | expect(linkElement).toBeInTheDocument(); 9 | }); 10 | -------------------------------------------------------------------------------- /src/index.css: -------------------------------------------------------------------------------- 1 | body { 2 | margin: 0; 3 | font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 4 | 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', 5 | sans-serif; 6 | -webkit-font-smoothing: antialiased; 7 | -moz-osx-font-smoothing: grayscale; 8 | } 9 | 10 | code { 11 | font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New', 12 | monospace; 13 | } 14 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files. 2 | 3 | # dependencies 4 | /node_modules 5 | /.pnp 6 | .pnp.js 7 | 8 | # testing 9 | /coverage 10 | 11 | # production 12 | /build 13 | 14 | # misc 15 | .DS_Store 16 | .env.local 17 | .env.development.local 18 | .env.test.local 19 | .env.production.local 20 | 21 | npm-debug.log* 22 | yarn-debug.log* 23 | yarn-error.log* 24 | 25 | .tuture -------------------------------------------------------------------------------- /src/App.css: -------------------------------------------------------------------------------- 1 | .App { 2 | width: 1200px; 3 | margin: auto; 4 | text-align: center; 5 | } 6 | 7 | .history-group { 8 | display: flex; 9 | justify-content: center; 10 | width: 1200px; 11 | margin: auto; 12 | } 13 | 14 | table, 15 | th, 16 | td { 17 | border: 1px solid #ccc; 18 | border-collapse: collapse; 19 | } 20 | 21 | th, 22 | td { 23 | padding: 5px; 24 | text-align: left; 25 | } 26 | 27 | .global-stats > table { 28 | margin: auto; 29 | margin-top: 0.5rem; 30 | margin-bottom: 1rem; 31 | } 32 | -------------------------------------------------------------------------------- /src/index.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | import ReactDOM from 'react-dom'; 3 | import './index.css'; 4 | import App from './App'; 5 | import * as serviceWorker from './serviceWorker'; 6 | 7 | ReactDOM.render( 8 | 9 | 10 | , 11 | document.getElementById('root') 12 | ); 13 | 14 | // If you want your app to work offline and load faster, you can change 15 | // unregister() to register() below. Note this comes with some pitfalls. 16 | // Learn more about service workers: https://bit.ly/CRA-PWA 17 | serviceWorker.unregister(); 18 | -------------------------------------------------------------------------------- /public/manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "short_name": "React App", 3 | "name": "Create React App Sample", 4 | "icons": [ 5 | { 6 | "src": "favicon.ico", 7 | "sizes": "64x64 32x32 24x24 16x16", 8 | "type": "image/x-icon" 9 | }, 10 | { 11 | "src": "logo192.png", 12 | "type": "image/png", 13 | "sizes": "192x192" 14 | }, 15 | { 16 | "src": "logo512.png", 17 | "type": "image/png", 18 | "sizes": "512x512" 19 | } 20 | ], 21 | "start_url": ".", 22 | "display": "standalone", 23 | "theme_color": "#000000", 24 | "background_color": "#ffffff" 25 | } 26 | -------------------------------------------------------------------------------- /src/components/SelectDataKey.js: -------------------------------------------------------------------------------- 1 | import React, { useContext } from "react"; 2 | import { AppDispatch } from "../App"; 3 | 4 | function SelectDataKey() { 5 | const dispatch = useContext(AppDispatch); 6 | 7 | function onChange(e) { 8 | dispatch({ type: "SET_KEY", key: e.target.value }); 9 | } 10 | 11 | return ( 12 | <> 13 | 14 | 21 | 22 | ); 23 | } 24 | 25 | export default SelectDataKey; 26 | -------------------------------------------------------------------------------- /src/hooks/useCoronaAPI.js: -------------------------------------------------------------------------------- 1 | import { useState, useEffect, useCallback } from "react"; 2 | 3 | const BASE_URL = "https://corona.lmao.ninja/v2"; 4 | 5 | export function useCoronaAPI( 6 | path, 7 | { initialData = null, converter = (data) => data, refetchInterval = null } 8 | ) { 9 | const [data, setData] = useState(initialData); 10 | const convertData = useCallback(converter, []); 11 | 12 | useEffect(() => { 13 | const fetchData = async () => { 14 | const response = await fetch(`${BASE_URL}${path}`); 15 | const data = await response.json(); 16 | setData(convertData(data)); 17 | }; 18 | fetchData(); 19 | 20 | if (refetchInterval) { 21 | const intervalId = setInterval(fetchData, refetchInterval); 22 | return () => clearInterval(intervalId); 23 | } 24 | }, [convertData, path, refetchInterval]); 25 | 26 | return data; 27 | } 28 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "covid-19-with-hooks", 3 | "version": "0.1.0", 4 | "private": true, 5 | "dependencies": { 6 | "@testing-library/jest-dom": "^4.2.4", 7 | "@testing-library/react": "^9.3.2", 8 | "@testing-library/user-event": "^7.1.2", 9 | "react": "^16.13.1", 10 | "react-dom": "^16.13.1", 11 | "react-scripts": "3.4.1", 12 | "recharts": "^1.8.5" 13 | }, 14 | "scripts": { 15 | "start": "react-scripts start", 16 | "build": "react-scripts build", 17 | "test": "react-scripts test", 18 | "eject": "react-scripts eject" 19 | }, 20 | "eslintConfig": { 21 | "extends": "react-app" 22 | }, 23 | "browserslist": { 24 | "production": [ 25 | ">0.2%", 26 | "not dead", 27 | "not op_mini all" 28 | ], 29 | "development": [ 30 | "last 1 chrome version", 31 | "last 1 firefox version", 32 | "last 1 safari version" 33 | ] 34 | } 35 | } 36 | -------------------------------------------------------------------------------- /src/components/GlobalStats.js: -------------------------------------------------------------------------------- 1 | import React from "react"; 2 | 3 | function Stat({ number, color }) { 4 | return {number}; 5 | } 6 | 7 | function GlobalStats({ stats }) { 8 | const { cases, deaths, recovered, active, updated } = stats; 9 | 10 | return ( 11 |
12 | Updated on {new Date(updated).toLocaleString()} 13 | 14 | 15 | 18 | 21 | 24 | 27 | 28 |
16 | Cases: 17 | 19 | Deaths: 20 | 22 | Recovered: 23 | 25 | Active: 26 |
29 |
30 | ); 31 | } 32 | 33 | export default GlobalStats; 34 | -------------------------------------------------------------------------------- /src/components/CountriesChart.js: -------------------------------------------------------------------------------- 1 | import React, { useContext } from "react"; 2 | import { 3 | BarChart, 4 | CartesianGrid, 5 | XAxis, 6 | YAxis, 7 | Tooltip, 8 | Legend, 9 | Bar, 10 | } from "recharts"; 11 | import { AppDispatch } from "../App"; 12 | 13 | function CountriesChart({ data, dataKey }) { 14 | const dispatch = useContext(AppDispatch); 15 | 16 | function onClick(payload = {}) { 17 | if (payload.activeLabel) { 18 | dispatch({ type: "SET_COUNTRY", country: payload.activeLabel }); 19 | } 20 | } 21 | 22 | return ( 23 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | ); 39 | } 40 | 41 | export default CountriesChart; 42 | -------------------------------------------------------------------------------- /src/components/HistoryChartGroup.js: -------------------------------------------------------------------------------- 1 | import React, { useContext } from "react"; 2 | 3 | import HistoryChart from "./HistoryChart"; 4 | import { transformHistory } from "../utils"; 5 | import { AppDispatch } from "../App"; 6 | 7 | function HistoryChartGroup({ history = {}, lastDays = {} }) { 8 | const dispatch = useContext(AppDispatch); 9 | 10 | function handleLastDaysChange(e, key) { 11 | dispatch({ type: "SET_LASTDAYS", key, days: e.target.value }); 12 | } 13 | 14 | return ( 15 |
16 | handleLastDaysChange(e, "cases")} 21 | /> 22 | handleLastDaysChange(e, "deaths")} 27 | /> 28 | handleLastDaysChange(e, "recovered")} 33 | /> 34 |
35 | ); 36 | } 37 | 38 | export default HistoryChartGroup; 39 | -------------------------------------------------------------------------------- /src/components/HistoryChart.js: -------------------------------------------------------------------------------- 1 | import React from "react"; 2 | import { 3 | AreaChart, 4 | CartesianGrid, 5 | XAxis, 6 | YAxis, 7 | Tooltip, 8 | Area, 9 | } from "recharts"; 10 | 11 | const TITLE2COLOR = { 12 | Cases: "#D0021B", 13 | Deaths: "#4A4A4A", 14 | Recovered: "#09C79C", 15 | }; 16 | 17 | function HistoryChart({ title, data, lastDays, onLastDaysChange }) { 18 | const colorKey = `color${title}`; 19 | const color = TITLE2COLOR[title]; 20 | 21 | return ( 22 |
23 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 46 | 47 |

{title}

48 | 55 | Last {lastDays} days 56 |
57 | ); 58 | } 59 | 60 | export default HistoryChart; 61 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # 用动画和实战打开 React Hooks 2 | 3 | ![](https://imgkr.cn-bj.ufileos.com/b5ec179c-fcf4-431f-a363-80ba2905f142.png) 4 | 5 | ## 运行项目 6 | 7 | 本项目用 [CRA](https://create-react-app.dev/) 搭建,因此启动项目非常简单: 8 | 9 | ```bash 10 | npm install && npm start 11 | ``` 12 | 13 | ## 为什么要写这一系列 Hooks 教程? 14 | 15 | 如何快速学习并掌握 React Hooks 一直是困扰很多新手或者老玩家的一个问题,而笔者在日常的学习和开发中也发现了以下头疼之处: 16 | 17 | - React 官方文档对 Hooks 的讲解偏应用,对原理的阐述一笔带过 18 | - 讲 React Hooks 的优秀文章很多,但大多专注于讲解一两个 Hook,要想一网打尽有难度 19 | - 看了很多使用方法甚至源码分析,但是没法和具体的使用场景对应起来,不了解怎么在实际开发中灵活运用 20 | 21 | 如果你也有同样的困惑,希望这一系列文章能帮助你拨开云雾,让 Hooks 成为你的称手兵器。我们将通过一个完整的 COVID-19 数据可视化项目,结合 Hooks 的动画原理讲解,让你真正地精通 React Hooks! 22 | 23 | 说实话,Hooks 的知识点相当分散,就像游乐园的游玩项目一样,选择一条完美的路线很难。但是不管怎么样,希望在接下来的旅程中,你能玩得开心😊! 24 | 25 | ## useState 与 useEffect 26 | 27 | 原文链接:https://tuture.co/2020/04/08/870a7b7/ 28 | 29 | 理解函数式组件的运行过程: 30 | 31 | ![](https://imgkr.cn-bj.ufileos.com/9a55a40e-ebd5-4ffb-9b8b-3cdd4e9161a3.gif) 32 | 33 | `useState` 使用浅析: 34 | 35 | ![](https://imgkr.cn-bj.ufileos.com/e09f2b4d-e20d-4bad-ba62-80d860f80e9f.gif) 36 | 37 | `useEffect` 使用浅析(每次重渲染都执行): 38 | 39 | ![](https://imgkr.cn-bj.ufileos.com/ad9b947f-77fe-43a0-bdee-a27d11246204.gif) 40 | 41 | `useEffect` 使用浅析(只在初次渲染后执行): 42 | 43 | ![](https://imgkr.cn-bj.ufileos.com/bd507a8c-bf75-4e06-be79-7c027cce6955.gif) 44 | 45 | `useState` 的本质(初次渲染): 46 | 47 | ![](https://imgkr.cn-bj.ufileos.com/af2ed210-08f7-4741-b17c-c2d4b67db3ff.gif) 48 | 49 | `useState` 的本质(重渲染): 50 | 51 | ![](https://imgkr.cn-bj.ufileos.com/799216d1-b91e-4cb6-9410-b8776ab82ff5.gif) 52 | 53 | `useEffect` 的本质: 54 | 55 | ![](https://imgkr.cn-bj.ufileos.com/ebb090f8-7471-46ad-9556-b773d1910d03.gif) 56 | 57 | ## 自定义 Hook 与 useCallback 58 | 59 | 写作中。 60 | 61 | ## useReducer 和 useContext 62 | 63 | 写作中。 64 | 65 | ## 敬请期待 66 | -------------------------------------------------------------------------------- /public/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 12 | 13 | 17 | 18 | 27 | React App 28 | 29 | 30 | 31 |
32 | 42 | 43 | 44 | -------------------------------------------------------------------------------- /src/App.js: -------------------------------------------------------------------------------- 1 | import React, { useReducer } from "react"; 2 | 3 | import "./App.css"; 4 | import GlobalStats from "./components/GlobalStats"; 5 | import CountriesChart from "./components/CountriesChart"; 6 | import SelectDataKey from "./components/SelectDataKey"; 7 | import { useCoronaAPI } from "./hooks/useCoronaAPI"; 8 | import HistoryChartGroup from "./components/HistoryChartGroup"; 9 | 10 | const initialState = { 11 | key: "cases", 12 | country: null, 13 | lastDays: { 14 | cases: 30, 15 | deaths: 30, 16 | recovered: 30, 17 | }, 18 | }; 19 | 20 | function reducer(state, action) { 21 | switch (action.type) { 22 | case "SET_KEY": 23 | return { ...state, key: action.key }; 24 | case "SET_COUNTRY": 25 | return { ...state, country: action.country }; 26 | case "SET_LASTDAYS": 27 | return { 28 | ...state, 29 | lastDays: { ...state.lastDays, [action.key]: action.days }, 30 | }; 31 | default: 32 | return state; 33 | } 34 | } 35 | 36 | // 用于传递 dispatch 的 React Context 37 | export const AppDispatch = React.createContext(null); 38 | 39 | function App() { 40 | const [state, dispatch] = useReducer(reducer, initialState); 41 | const { key, country, lastDays } = state; 42 | 43 | const globalStats = useCoronaAPI("/all", { 44 | initialData: {}, 45 | refetchInterval: 5000, 46 | }); 47 | 48 | const countries = useCoronaAPI(`/countries?sort=${key}`, { 49 | initialData: [], 50 | converter: (data) => data.slice(0, 10), 51 | }); 52 | 53 | const history = useCoronaAPI(`/historical/${country}`, { 54 | initialData: {}, 55 | converter: (data) => data.timeline, 56 | }); 57 | 58 | return ( 59 | 60 |
61 |

COVID-19

62 | 63 | 64 | 65 | 66 | {country ? ( 67 | <> 68 |

History for {country}

69 | 70 | 71 | ) : ( 72 |

Click on a country to show its history.

73 | )} 74 |
75 |
76 | ); 77 | } 78 | 79 | export default App; 80 | -------------------------------------------------------------------------------- /src/logo.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /src/serviceWorker.js: -------------------------------------------------------------------------------- 1 | // This optional code is used to register a service worker. 2 | // register() is not called by default. 3 | 4 | // This lets the app load faster on subsequent visits in production, and gives 5 | // it offline capabilities. However, it also means that developers (and users) 6 | // will only see deployed updates on subsequent visits to a page, after all the 7 | // existing tabs open on the page have been closed, since previously cached 8 | // resources are updated in the background. 9 | 10 | // To learn more about the benefits of this model and instructions on how to 11 | // opt-in, read https://bit.ly/CRA-PWA 12 | 13 | const isLocalhost = Boolean( 14 | window.location.hostname === 'localhost' || 15 | // [::1] is the IPv6 localhost address. 16 | window.location.hostname === '[::1]' || 17 | // 127.0.0.0/8 are considered localhost for IPv4. 18 | window.location.hostname.match( 19 | /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/ 20 | ) 21 | ); 22 | 23 | export function register(config) { 24 | if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) { 25 | // The URL constructor is available in all browsers that support SW. 26 | const publicUrl = new URL(process.env.PUBLIC_URL, window.location.href); 27 | if (publicUrl.origin !== window.location.origin) { 28 | // Our service worker won't work if PUBLIC_URL is on a different origin 29 | // from what our page is served on. This might happen if a CDN is used to 30 | // serve assets; see https://github.com/facebook/create-react-app/issues/2374 31 | return; 32 | } 33 | 34 | window.addEventListener('load', () => { 35 | const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`; 36 | 37 | if (isLocalhost) { 38 | // This is running on localhost. Let's check if a service worker still exists or not. 39 | checkValidServiceWorker(swUrl, config); 40 | 41 | // Add some additional logging to localhost, pointing developers to the 42 | // service worker/PWA documentation. 43 | navigator.serviceWorker.ready.then(() => { 44 | console.log( 45 | 'This web app is being served cache-first by a service ' + 46 | 'worker. To learn more, visit https://bit.ly/CRA-PWA' 47 | ); 48 | }); 49 | } else { 50 | // Is not localhost. Just register service worker 51 | registerValidSW(swUrl, config); 52 | } 53 | }); 54 | } 55 | } 56 | 57 | function registerValidSW(swUrl, config) { 58 | navigator.serviceWorker 59 | .register(swUrl) 60 | .then(registration => { 61 | registration.onupdatefound = () => { 62 | const installingWorker = registration.installing; 63 | if (installingWorker == null) { 64 | return; 65 | } 66 | installingWorker.onstatechange = () => { 67 | if (installingWorker.state === 'installed') { 68 | if (navigator.serviceWorker.controller) { 69 | // At this point, the updated precached content has been fetched, 70 | // but the previous service worker will still serve the older 71 | // content until all client tabs are closed. 72 | console.log( 73 | 'New content is available and will be used when all ' + 74 | 'tabs for this page are closed. See https://bit.ly/CRA-PWA.' 75 | ); 76 | 77 | // Execute callback 78 | if (config && config.onUpdate) { 79 | config.onUpdate(registration); 80 | } 81 | } else { 82 | // At this point, everything has been precached. 83 | // It's the perfect time to display a 84 | // "Content is cached for offline use." message. 85 | console.log('Content is cached for offline use.'); 86 | 87 | // Execute callback 88 | if (config && config.onSuccess) { 89 | config.onSuccess(registration); 90 | } 91 | } 92 | } 93 | }; 94 | }; 95 | }) 96 | .catch(error => { 97 | console.error('Error during service worker registration:', error); 98 | }); 99 | } 100 | 101 | function checkValidServiceWorker(swUrl, config) { 102 | // Check if the service worker can be found. If it can't reload the page. 103 | fetch(swUrl, { 104 | headers: { 'Service-Worker': 'script' }, 105 | }) 106 | .then(response => { 107 | // Ensure service worker exists, and that we really are getting a JS file. 108 | const contentType = response.headers.get('content-type'); 109 | if ( 110 | response.status === 404 || 111 | (contentType != null && contentType.indexOf('javascript') === -1) 112 | ) { 113 | // No service worker found. Probably a different app. Reload the page. 114 | navigator.serviceWorker.ready.then(registration => { 115 | registration.unregister().then(() => { 116 | window.location.reload(); 117 | }); 118 | }); 119 | } else { 120 | // Service worker found. Proceed as normal. 121 | registerValidSW(swUrl, config); 122 | } 123 | }) 124 | .catch(() => { 125 | console.log( 126 | 'No internet connection found. App is running in offline mode.' 127 | ); 128 | }); 129 | } 130 | 131 | export function unregister() { 132 | if ('serviceWorker' in navigator) { 133 | navigator.serviceWorker.ready 134 | .then(registration => { 135 | registration.unregister(); 136 | }) 137 | .catch(error => { 138 | console.error(error.message); 139 | }); 140 | } 141 | } 142 | --------------------------------------------------------------------------------