Lecture 4
Assignment 2 (due 3/23 4:59pm on CMS)
Your First Component
type Props = { readonly name: string; readonly githubLink: string };
const ContactCard = ({ name, githubLink }: Props) => (
<div>
You can reach {name} at
<a href={githubLink}>{githubLink}</a>
</div>
);
Wat! What's going on
Functional Component
The simplest component in React is a functional component. A functional component does not have any internal state. You can think of it as a function whose inputs are some JavaScript object and the output is some HTML code that is generated from the data.
In React, we call the JavaScript object props
, so you can see code like this:
type Props = { readonly name: string; readonly githubLink: string };
const ContactCard = (props: Props) => (
<div>
You can reach {props.name} at
<a href={props.githubLink}>{props.githubLink}</a>
</div>
);
Just calling the input props
is not good for documentation purpose, so we
usually use object destructuring to make it more explicit:
type Props = { readonly name: string; readonly githubLink: string };
const ContactCard = ({ name, githubLink }: Props) => (
<div>
You can reach {name} at
<a href={githubLink}>{githubLink}</a>
</div>
);
In order for this component to be reused in another file, we need to export it:
type Props = { readonly name: string; readonly githubLink: string };
const ContactCard = ({ name, githubLink }: Props) => (
<div>
You can reach {name} at
<a href={githubLink}>{githubLink}</a>
</div>
);
export default ContactCard;
React does not care about the arrow function syntax, so you can also write it in function definition syntax:
type Props = { readonly name: string; readonly githubLink: string };
function ContactCard({ name, githubLink }: Props) {
return (
<div>
You can reach {name} at
<a href={githubLink}>{githubLink}</a>
</div>
);
}
export default ContactCard;
For this course, we prefer that you use arrow function syntax.
Stateful Component
Imagine you are writing a contacts app and you need to implement an editor.
Unlike the previous components, you need to maintain state. In React, you will
need hooks
. Hooks are functions that use state and lifecycle methods inside
functional components. The useState
hook is the hook for maintaining state.
Note that the general naming convention of a hook is useXXXX
.
import { useState, ChangeEvent } from 'react';
const NewContact = () => {
// name is the variable for the state, setName is the function you can use
// to change the state.
const [name, setName] = useState('');
const handleChange = (event: ChangeEvent<HTMLInputElement>) => {
// To extract the value from input box, use the following line.
const n = event.currentTarget.value;
setName(n);
};
return (
<div>
<p>Name: {name}</p>
<input
type="text"
placeholder="enter the name here"
value={name}
onChange={handleChange}
/>
</div>
);
};
export default NewContact;
useState
returns a length-2 array that includes the following elements (in order):
- a state variable that is always synchronized (in a consistent state everywhere any time)
- a function that can be used to update the state variable.
Note that the names of the two should always be in the form x, setX.
const [prosAndCons, setProsAndCons] = useState([]);
The useState
statement above uses array destructuring syntax, which is explained below.
Aside: array destructuring syntax
const [firstElement, secondElement, ...rest] = [1, 2, 3, 4, 5, 6];
const [...rest, beforeTailElement, tailElement] = [1, 2, 3, 4, 5, 6];
Array destructuring is a shorthand that allows you to store the contents of specific element in an array into a variable, without the cumbersome syntax of manually indexing into an array. The ...rest
expression uses the spread (...
) operator to capture the remaining contents of the array (as a subset).
In TypeScript, we can parametrize the useState hook to be of a certain type. (useState
is called a “generic” function because it can handle any type that you specify.) This is good because in TypeScript (and other typed languges), we work to restrict the scope of possible types of our code in order to reduce the space for errors.
const [prosAndCons, setProsAndCons] = useState<Array<Pro | Con>>([
new Pro('yummy'),
new Con('unhealthy'),
]);
Rendering lists
You may want to render a list of YourAwesomeComponent
. Here are some examples
to show how you can achieve this in different ways.
// Suppose you have a ContactCard component defined there.
import ContactCard from './ContactCard';
type Contact = { name: string; githubLink: string };
const data: Contact[] = [
{ name: 'Jason', githubLink: 'www.github.com/guessJason' },
{ name: 'Peter', githubLink: 'www.github.com/peterIsCool' },
{ name: 'Enoch', githubLink: 'www.github.com/eno' },
];
const ListBySimpleMap = () => (
<div>
{data.map((contact: Contact) => (
<ContactCard
key={contact.name}
name={contact.name}
githubLink={contact.githubLink}
/>
))}
</div>
);
const ListBySimpleMapWithObjectDestructing = () => (
<div>
{data.map(({ name, githubLink }) => (
<ContactCard key={name} name={name} githubLink={githubLink} />
))}
</div>
);
const ListBySimpleMapWithSpread = () => (
<div>
{data.map((contact: Contact) => (
<ContactCard key={contact.name} {...contact} />
))}
</div>
);
Note that we always need a key
prop. Without this, React will give you
warnings in the console. React needs a unique key
for each item in the list to
help it avoid rerendering everything when only one item in the list changes.
In this particular example, you should only use name
as the key if you know
that the property name
is unique. However, if there are multiple objects with
the same name in the list that are used as a key, it would confuse React.
Modifying State
We can use the useEffect
hook. Using useEffect
+ setStateVar
(state variable setter) allows state variables to “hook into” the React component and “ride along” other changes that occur. 🤠🏇 Here is how!
useEffect(effect_function)
=> useEffect(() => {})
Whenever the component updates/re-renders, useEffect runs the argument (a function).
useEffect(() => {setCount(count + 1)})
The function can have any arbitrary logic/function calls… such as the setCount
state variable update function! But setCount
also triggers another component update so…
Optimizing useEffect
useEffect(function, filters)
useEffect
triggers the function at every component update, but you can restrict this to occur only when the variables in the filters
array update. This makes your React component more optimized. You could say that these variables are a dependency of the useEffect
statement. Example below:
useEffect(function, [prop1, observable])
As a fun fact, it is possible to enter an infinite loop if the dependencies are state variables that are also set inside the effect. Don't do this!
Cleanup
A good use of useEffect is to hook into file streams, WebSockets, Firebase hooks, or some other Observable-like API in order to make your component reactive to changes in data. (when the observed data/value/file stream updates, the React component should update.) In order to use an API for this purpose, it is often necessary to open up an initial connection or subscription. It is good manners to cleanup by closing or unsubscribing. In a useEffect
statement, the cleanup code is stored in a function that is returned by the effect (function).
useEffect(() => {
return () => {
cleanup();
};
});
Example usage below:
useEffect(() => {
return () => {
ObservableAPI.unsubscribe()
});
}, [valueFromObservableApi]);
useEffect(() => {
return () => {
dataStream.close()
});
}, [dataStreamContents]);