├── .github └── FUNDING.yml ├── .gitignore ├── .prettierrc ├── .travis.yml ├── README.md ├── package-lock.json ├── package.json ├── public ├── favicon.ico ├── index.html └── manifest.json └── src ├── App.js ├── App.test.js ├── Components ├── Checkbox.js ├── NumberInput.js ├── Radio.js ├── Select.js ├── StandaloneTextInput.js └── TextInput.js ├── index.js └── registerServiceWorker.js /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: rwieruch 4 | patreon: # rwieruch 5 | open_collective: # Replace with a single Open Collective username 6 | ko_fi: # Replace with a single Ko-fi username 7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel 8 | community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry 9 | liberapay: # Replace with a single Liberapay username 10 | issuehunt: # Replace with a single IssueHunt username 11 | otechie: # Replace with a single Otechie username 12 | custom: # Replace with a single custom sponsorship URL 13 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # See https://help.github.com/ignore-files/ for more about ignoring files. 2 | 3 | # dependencies 4 | /node_modules 5 | 6 | # testing 7 | /coverage 8 | 9 | # production 10 | /build 11 | 12 | # misc 13 | .DS_Store 14 | .env.local 15 | .env.development.local 16 | .env.test.local 17 | .env.production.local 18 | 19 | npm-debug.log* 20 | yarn-debug.log* 21 | yarn-error.log* 22 | -------------------------------------------------------------------------------- /.prettierrc: -------------------------------------------------------------------------------- 1 | 2 | { 3 | "semi": true, 4 | "trailingComma": "es5", 5 | "singleQuote": true, 6 | "printWidth": 70, 7 | } 8 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | language: node_js 2 | 3 | node_js: 4 | - stable 5 | 6 | install: 7 | - npm install 8 | 9 | script: 10 | - npm test -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # react-controlled-components-examples 2 | 3 | [![Build Status](https://travis-ci.org/the-road-to-learn-react/react-controlled-components-examples.svg?branch=master)](https://travis-ci.org/the-road-to-learn-react/react-controlled-components-examples) [![Slack](https://slack-the-road-to-learn-react.wieruch.com/badge.svg)](https://slack-the-road-to-learn-react.wieruch.com/) [![Greenkeeper badge](https://badges.greenkeeper.io/the-road-to-learn-react/react-controlled-components-examples.svg)](https://greenkeeper.io/) 4 | 5 | Demonstrating how different input elements are implemented as controlled (uncontrolled) components in React. [Read more about it](https://www.robinwieruch.de/react-controlled-components/). 6 | 7 | ## Installation 8 | 9 | * `git clone git@github.com:the-road-to-learn-react/react-controlled-components-examples.git` 10 | * cd react-controlled-components-examples 11 | * npm install 12 | * npm start 13 | * visit `http://localhost:3000/` 14 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "react-controlled-components-examples", 3 | "version": "0.1.0", 4 | "private": true, 5 | "dependencies": { 6 | "react": "^16.8.6", 7 | "react-dom": "^16.8.6", 8 | "react-scripts": "3.1.0" 9 | }, 10 | "scripts": { 11 | "start": "react-scripts start", 12 | "build": "react-scripts build", 13 | "test": "react-scripts test --env=jsdom", 14 | "eject": "react-scripts eject" 15 | }, 16 | "browserslist": [ 17 | ">0.2%", 18 | "not dead", 19 | "not ie <= 11", 20 | "not op_mini all" 21 | ] 22 | } 23 | -------------------------------------------------------------------------------- /public/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/the-road-to-learn-react/react-controlled-components-examples/8dccad4d3c240d55a1d9959ff5f2477fa205fdeb/public/favicon.ico -------------------------------------------------------------------------------- /public/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 11 | 12 | 13 | 22 | React App 23 | 24 | 25 | 28 |
29 | 39 | 40 | 41 | -------------------------------------------------------------------------------- /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 | "start_url": "./index.html", 12 | "display": "standalone", 13 | "theme_color": "#000000", 14 | "background_color": "#ffffff" 15 | } 16 | -------------------------------------------------------------------------------- /src/App.js: -------------------------------------------------------------------------------- 1 | import React, { useState } from 'react'; 2 | 3 | // component manages itself without external API 4 | // not useful for real applications, 5 | // but just for the sake of demonstrating uncontrolled/controlled components 6 | 7 | import StandaloneTextInput from './Components/StandaloneTextInput'; 8 | 9 | // components managed from outside (e.g. App component) 10 | 11 | import TextInput from './Components/TextInput'; 12 | import Select from './Components/Select'; 13 | import NumberInput from './Components/NumberInput'; 14 | import Checkbox from './Components/Checkbox'; 15 | import Radio from './Components/Radio'; 16 | 17 | const App = () => { 18 | const [textInputValue, setTextInputValue] = useState('Hello World'); 19 | const [selectValue, setSelectValue] = useState('grapefruit'); 20 | const [numberInputValue, setNumberInputValue] = useState(0); 21 | const [checkboxValue, setCheckboxValue] = useState(true); 22 | const [radioValue, setRadioValue] = useState('small'); 23 | 24 | const handleTextInputChange = value => { 25 | setTextInputValue(value); 26 | }; 27 | 28 | const handleSelectChange = value => { 29 | setSelectValue(value); 30 | }; 31 | 32 | const handleNumberInputChange = value => { 33 | setNumberInputValue(value); 34 | }; 35 | 36 | const handleCheckboxChange = value => { 37 | setCheckboxValue(value); 38 | }; 39 | 40 | const handleRadioChange = value => { 41 | setRadioValue(value); 42 | }; 43 | 44 | return ( 45 |
46 | {/* Uncontrolled and Controlled Input Example, State/Functions managed within Component */} 47 |
48 | 49 |
50 | 51 |
52 | 53 | {/* Different Controlled Inputs, State/Callbacks managed in App Components */} 54 |
55 | 59 | Type a text 60 | 61 |

62 | Result: {textInputValue} 63 |

64 |
65 | 66 |
67 | 68 |
69 | 75 |

76 | Result: {selectValue} 77 |

78 |
79 | 80 |
81 | 82 |
83 | 89 | Choose a number 90 | 91 |

92 | Result: {numberInputValue} 93 |

94 |
95 | 96 |
97 | 98 |
99 | 103 | Check the box 104 | 105 |

106 | Result: {checkboxValue.toString()} 107 |

108 |
109 | 110 |
111 | 112 |
113 | 114 | Choose a size 115 | 116 |

117 | Result: {radioValue} 118 |

119 |
120 |
121 | ); 122 | }; 123 | 124 | export default App; 125 | -------------------------------------------------------------------------------- /src/App.test.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | import ReactDOM from 'react-dom'; 3 | import App from './App'; 4 | 5 | it('renders without crashing', () => { 6 | const div = document.createElement('div'); 7 | ReactDOM.render(, div); 8 | ReactDOM.unmountComponentAtNode(div); 9 | }); 10 | -------------------------------------------------------------------------------- /src/Components/Checkbox.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | 3 | const Checkbox = ({ value, onCheckboxChange, children }) => { 4 | const handleChange = event => { 5 | onCheckboxChange(event.target.checked); 6 | }; 7 | 8 | return ( 9 | 17 | ); 18 | }; 19 | 20 | export default Checkbox; 21 | -------------------------------------------------------------------------------- /src/Components/NumberInput.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | 3 | function getValue(value, min, max) { 4 | if (value > max) { 5 | value = max; 6 | } 7 | 8 | if (value < min) { 9 | value = min; 10 | } 11 | 12 | return value; 13 | } 14 | 15 | const NumberInput = ({ 16 | value, 17 | min, 18 | max, 19 | children, 20 | onNumberInputChange, 21 | }) => { 22 | const handleChange = event => { 23 | onNumberInputChange(getValue(event.target.value, min, max)); 24 | }; 25 | 26 | const increment = () => { 27 | onNumberInputChange(getValue(value + 1, min, max)); 28 | }; 29 | 30 | const decrement = () => { 31 | onNumberInputChange(getValue(value - 1, min, max)); 32 | }; 33 | 34 | return ( 35 | 51 | ); 52 | }; 53 | 54 | export default NumberInput; 55 | -------------------------------------------------------------------------------- /src/Components/Radio.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | 3 | const Radio = ({ value, children, onRadioChange }) => { 4 | const handleChange = event => { 5 | onRadioChange(event.target.value); 6 | }; 7 | 8 | return ( 9 | 10 | {children}: 11 | 20 | 29 | 38 | 39 | ); 40 | }; 41 | 42 | export default Radio; 43 | -------------------------------------------------------------------------------- /src/Components/Select.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | 3 | const Select = ({ value, children, onSelectChange }) => { 4 | const handleChange = event => { 5 | onSelectChange(event.target.value); 6 | }; 7 | 8 | return ( 9 | 18 | ); 19 | }; 20 | 21 | export default Select; 22 | -------------------------------------------------------------------------------- /src/Components/StandaloneTextInput.js: -------------------------------------------------------------------------------- 1 | import React, { useState } from 'react'; 2 | 3 | // const StandaloenTextInput = () => ( 4 | //
5 | // 8 | //
9 | // ); 10 | 11 | // const StandaloenTextInput = () => { 12 | // const [value, setValue] = useState('Hello React'); 13 | 14 | // const handleChange = event => setValue(event.target.value); 15 | 16 | // return ( 17 | //
18 | // 22 | 23 | //

24 | // Output: {value} 25 | //

26 | //
27 | // ); 28 | // }; 29 | 30 | const StandaloenTextInput = () => { 31 | const [value, setValue] = useState('Hello React'); 32 | 33 | const handleChange = event => setValue(event.target.value); 34 | 35 | return ( 36 |
37 | 41 | 42 |

43 | Output: {value} 44 |

45 |
46 | ); 47 | }; 48 | 49 | export default StandaloenTextInput; 50 | -------------------------------------------------------------------------------- /src/Components/TextInput.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | 3 | const TextInput = ({ value, onTextInputChange, children }) => { 4 | const handleChange = event => { 5 | onTextInputChange(event.target.value); 6 | }; 7 | 8 | return ( 9 | 13 | ); 14 | }; 15 | 16 | export default TextInput; 17 | -------------------------------------------------------------------------------- /src/index.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | import ReactDOM from 'react-dom'; 3 | import App from './App'; 4 | import registerServiceWorker from './registerServiceWorker'; 5 | 6 | ReactDOM.render(, document.getElementById('root')); 7 | registerServiceWorker(); 8 | -------------------------------------------------------------------------------- /src/registerServiceWorker.js: -------------------------------------------------------------------------------- 1 | // In production, we register a service worker to serve assets from local cache. 2 | 3 | // This lets the app load faster on subsequent visits in production, and gives 4 | // it offline capabilities. However, it also means that developers (and users) 5 | // will only see deployed updates on the "N+1" visit to a page, since previously 6 | // cached resources are updated in the background. 7 | 8 | // To learn more about the benefits of this model, read https://goo.gl/KwvDNy. 9 | // This link also includes instructions on opting out of this behavior. 10 | 11 | const isLocalhost = Boolean( 12 | window.location.hostname === 'localhost' || 13 | // [::1] is the IPv6 localhost address. 14 | window.location.hostname === '[::1]' || 15 | // 127.0.0.1/8 is considered localhost for IPv4. 16 | window.location.hostname.match( 17 | /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/ 18 | ) 19 | ); 20 | 21 | export default function register() { 22 | if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) { 23 | // The URL constructor is available in all browsers that support SW. 24 | const publicUrl = new URL(process.env.PUBLIC_URL, window.location); 25 | if (publicUrl.origin !== window.location.origin) { 26 | // Our service worker won't work if PUBLIC_URL is on a different origin 27 | // from what our page is served on. This might happen if a CDN is used to 28 | // serve assets; see https://github.com/facebookincubator/create-react-app/issues/2374 29 | return; 30 | } 31 | 32 | window.addEventListener('load', () => { 33 | const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`; 34 | 35 | if (isLocalhost) { 36 | // This is running on localhost. Lets check if a service worker still exists or not. 37 | checkValidServiceWorker(swUrl); 38 | 39 | // Add some additional logging to localhost, pointing developers to the 40 | // service worker/PWA documentation. 41 | navigator.serviceWorker.ready.then(() => { 42 | console.log( 43 | 'This web app is being served cache-first by a service ' + 44 | 'worker. To learn more, visit https://goo.gl/SC7cgQ' 45 | ); 46 | }); 47 | } else { 48 | // Is not local host. Just register service worker 49 | registerValidSW(swUrl); 50 | } 51 | }); 52 | } 53 | } 54 | 55 | function registerValidSW(swUrl) { 56 | navigator.serviceWorker 57 | .register(swUrl) 58 | .then(registration => { 59 | registration.onupdatefound = () => { 60 | const installingWorker = registration.installing; 61 | installingWorker.onstatechange = () => { 62 | if (installingWorker.state === 'installed') { 63 | if (navigator.serviceWorker.controller) { 64 | // At this point, the old content will have been purged and 65 | // the fresh content will have been added to the cache. 66 | // It's the perfect time to display a "New content is 67 | // available; please refresh." message in your web app. 68 | console.log('New content is available; please refresh.'); 69 | } else { 70 | // At this point, everything has been precached. 71 | // It's the perfect time to display a 72 | // "Content is cached for offline use." message. 73 | console.log('Content is cached for offline use.'); 74 | } 75 | } 76 | }; 77 | }; 78 | }) 79 | .catch(error => { 80 | console.error('Error during service worker registration:', error); 81 | }); 82 | } 83 | 84 | function checkValidServiceWorker(swUrl) { 85 | // Check if the service worker can be found. If it can't reload the page. 86 | fetch(swUrl) 87 | .then(response => { 88 | // Ensure service worker exists, and that we really are getting a JS file. 89 | if ( 90 | response.status === 404 || 91 | response.headers.get('content-type').indexOf('javascript') === -1 92 | ) { 93 | // No service worker found. Probably a different app. Reload the page. 94 | navigator.serviceWorker.ready.then(registration => { 95 | registration.unregister().then(() => { 96 | window.location.reload(); 97 | }); 98 | }); 99 | } else { 100 | // Service worker found. Proceed as normal. 101 | registerValidSW(swUrl); 102 | } 103 | }) 104 | .catch(() => { 105 | console.log( 106 | 'No internet connection found. App is running in offline mode.' 107 | ); 108 | }); 109 | } 110 | 111 | export function unregister() { 112 | if ('serviceWorker' in navigator) { 113 | navigator.serviceWorker.ready.then(registration => { 114 | registration.unregister(); 115 | }); 116 | } 117 | } 118 | --------------------------------------------------------------------------------