Мышление в стиле React
год назад·10 мин. на чтение
React может изменить ваше представление о разработке приложений. Когда вы создаете пользовательский интерфейс с помощью React, вы сначала разбиваете его на части, называемые компонентами. Затем вы описываете различные визуальные состояния для каждого из ваших компонентов. Наконец, вы соединяете свои компоненты вместе, чтобы данные проходили через них. В этом руководстве мы проведем вас через мыслительный процесс создания таблицы с данными о продуктах с возможностью поиска с помощью React.
Содержание туториала по React
React может изменить ваше представление о разработке приложений. Когда вы создаете пользовательский интерфейс с помощью React, вы сначала разбиваете его на части, называемые компонентами. Затем вы описываете различные визуальные состояния для каждого из ваших компонентов. Наконец, вы соединяете свои компоненты вместе, чтобы данные проходили через них. В этом руководстве мы проведем вас через мыслительный процесс создания таблицы с данными о продуктах с возможностью поиска с помощью React.
На этом экране пять компонентов:
Вы можете строить «сверху вниз», начиная с компонентов, расположенных выше в иерархии (например,
Теперь давайте рассмотрим нашу стратегию для этого состояния:
Вы можете начать видеть, как будет вести себя ваше приложение. Измените начальное значение
Обратите внимание, что редактирование формы пока не работает. В приведенном выше коде есть ошибка консоли, объясняющая, почему:
Начните с макета
Представьте, что у вас уже есть JSON API и мокап от дизайнера. JSON API возвращает некоторые данные, которые выглядят следующим образом:Чтобы реализовать пользовательский интерфейс в React, обычно выполняется одни и те же пять шагов.[ { category: 'Fruits', price: '$1', stocked: true, name: 'Apple' }, { category: 'Fruits', price: '$1', stocked: true, name: 'Dragonfruit' }, { category: 'Fruits', price: '$2', stocked: false, name: 'Passionfruit' }, { category: 'Vegetables', price: '$2', stocked: true, name: 'Spinach' }, { category: 'Vegetables', price: '$4', stocked: false, name: 'Pumpkin' }, { category: 'Vegetables', price: '$1', stocked: true, name: 'Peas' }, ];
Шаг 1. Разбейте пользовательский интерфейс на иерархию компонентов
Начните с рисования рамок вокруг каждого компонента и подкомпонента в макете и присваивайте им имена. Если вы работаете с дизайнером, возможно, они уже назвали эти компоненты в своем инструменте дизайна. В зависимости от вашего опыта вы можете думать о разделении дизайна на компоненты по-разному:- Программирование — используйте те же методы для принятия решения о создании новой функции или объекта. Одним из таких методов является принцип единой ответственности, то есть в идеале компонент должен делать только одну вещь. Если он в конечном итоге растет, его следует разбить на более мелкие подкомпоненты.
- CSS — подумайте, для чего бы вы сделали селекторы классов.
- Дизайн — подумайте, как бы вы организовали слои дизайна.
FilterableProductTable
(серый) содержит все приложение.SearchBar
(синий) получает пользовательский ввод.ProductTable
(фиолетовый) отображает и фильтрует список в соответствии с пользовательским вводом.ProductCategoryRow
(зеленый) отображает заголовок для каждой категории.ProductRow
(желтый) отображает строку для каждого продукта.
ProductTable
(фиолетовый), вы увидите, что заголовок таблицы (содержащий метки "Name" и "Price") не является отдельным компонентом. Это вопрос предпочтений, и вы можете пойти любым путем. В этом примере это часть ProductTable
, поскольку она появляется внутри списка ProductTable
. Однако, если этот заголовок станет сложным (например, если вы добавите сортировку), имеет смысл сделать его отдельным компонентом ProductTableHeader
.
Теперь, когда вы идентифицировали компоненты макета, расположите их в иерархическом порядке. Компоненты, которые появляются внутри другого компонента в макете, должны отображаться как дочерние элементы в иерархии:
- FilterableProductTable
- SearchBar
- ProductTable
- ProductCategoryRow
- ProductRow
Шаг 2: Создайте статичную версию в React
Теперь, когда у вас есть иерархия компонентов, пришло время реализовать ваше приложение. Самый простой подход — создать версию, которая отображает пользовательский интерфейс из вашей модели данных без добавления какой-либо интерактивности… пока! Часто проще сначала создать статичную версию, а затем добавить интерактивность отдельно. Чтобы создать статичную версию приложения, которое отображает вашу модель данных, вам нужно создать компоненты, которые повторно используют другие компоненты и передают данные с помощью пропсов. Пропсы — это способ передачи данных от родителя к дочернему элементу. (Если вы знакомы с концепцией состояния, вообще не используйте состояние для создания этой статичной версии. Состояние зарезервировано только для интерактивности, то есть данных, которые меняются со временем. Поскольку это статичная версия приложения, вам это не нужно.)FilterableProductTable
), или «снизу вверх», работая с компонентами, расположенными ниже (например, ProductRow
). В более простых примерах обычно проще идти сверху вниз, а в более крупных проектах легче идти снизу вверх.
(Если этот код выглядит пугающе, сначала пройдите Быстрый старт.) После создания компонентов у вас будет библиотека повторно используемых компонентов, которые отображают вашу модель данных. Поскольку это статичное приложение, компоненты будут возвращать только JSX. Компонент наверху иерархии (function ProductCategoryRow({ category }) { return ( <tr> <th colSpan="2">{category}</th> </tr> ); } function ProductRow({ product }) { const name = product.stocked ? ( product.name ) : ( <span style={{ color: 'red' }}>{product.name}</span> ); return ( <tr> <td>{name}</td> <td>{product.price}</td> </tr> ); } function ProductTable({ products }) { const rows = []; let lastCategory = null; products.forEach((product) => { if (product.category !== lastCategory) { rows.push( <ProductCategoryRow category={product.category} key={product.category} /> ); } rows.push(<ProductRow product={product} key={product.name} />); lastCategory = product.category; }); return ( <table> <thead> <tr> <th>Name</th> <th>Price</th> </tr> </thead> <tbody>{rows}</tbody> </table> ); } function SearchBar() { return ( <form> <input type="text" placeholder="Search..." /> <label> <input type="checkbox" /> Only show products in stock </label> </form> ); } function FilterableProductTable({ products }) { return ( <div> <SearchBar /> <ProductTable products={products} /> </div> ); } const PRODUCTS = [ { category: 'Fruits', price: '$1', stocked: true, name: 'Apple' }, { category: 'Fruits', price: '$1', stocked: true, name: 'Dragonfruit' }, { category: 'Fruits', price: '$2', stocked: false, name: 'Passionfruit' }, { category: 'Vegetables', price: '$2', stocked: true, name: 'Spinach' }, { category: 'Vegetables', price: '$4', stocked: false, name: 'Pumpkin' }, { category: 'Vegetables', price: '$1', stocked: true, name: 'Peas' }, ]; export default function App() { return <FilterableProductTable products={PRODUCTS} />; }
FilterableProductTable
) будет использовать вашу модель данных в качестве опоры. Это называется односторонним потоком данных, потому что данные передаются от компонента верхнего уровня к компонентам в нижней части дерева.
Шаг 3. Найдите минимальное, но полное представление состояния пользовательского интерфейса.
Чтобы сделать пользовательский интерфейс интерактивным, вам нужно разрешить пользователям изменять базовую модель данных. Для этого вы будете использовать состояние. Думайте о состоянии как о минимальном наборе изменяющихся данных, которые должно запомнить ваше приложение. Самый важный принцип структурирования состояния — следовать принципу DRY (Don’t Repeat Yourself, не повторяться). Выясните абсолютно минимальное представление состояния, в котором нуждается ваше приложение, и вычислите все остальное по требованию. Например, если вы создаете список покупок, вы можете хранить элементы в виде массива в состоянии. Если вы хотите также отобразить количество элементов в списке, не сохраняйте количество элементов в качестве другого значения состояния — вместо этого считывайте длину вашего массива. Теперь подумайте обо всех фрагментах данных в этом примере приложения:- Первоначальный список продуктов
- Текст для поиска, который ввел пользователь
- Значение флажка
- Отфильтрованный список товаров
- Остается ли он неизменным с течением времени? Если да, то это не состояние.
- Он передается от родителя через проп? Если да, то это не состояние.
- Можете ли вы вычислить его на основе существующего состояния или пропса в вашем компоненте? Если да, то это точно не состояние!
- Исходный список продуктов передается в качестве пропса, поэтому он не является состоянием.
- Текст поиска кажется состоянием, поскольку он меняется со временем и не может быть вычислен из чего-либо.
- Значение флажка кажется состоянием, поскольку оно меняется со временем и не может быть вычислено из чего-либо.
- Отфильтрованный список продуктов не является состоянием, поскольку его можно вычислить, взяв исходный список продуктов и отфильтровав его в соответствии с текстом поиска и значением флажка.
Пропсы и Состояние
В React есть два типа данных: пропсы и состояние. Они очень разные:- Пропсы похожи на аргументы, которые вы передаете в функции. Они позволяют родительскому компоненту передавать данные дочернему компоненту и настраивать его внешний вид. Например,
Form
может передать пропcolor
в кнопкуButton
. - Состояние похоже на память компонента. Это позволяет компоненту отслеживать некоторую информацию и изменять ее в ответ на взаимодействие. Например,
Button
может отслеживать состояниеisHovered
.
Шаг 4: Определите, где должно находится ваше состояние
После определения минимальных данных о состоянии вашего приложения вам необходимо определить, какой компонент отвечает за изменение этого состояния или владеет этим состоянием. Помните: React использует односторонний поток данных, передавая данные вниз по иерархии компонентов от родительского к дочернему компоненту. Сразу может быть неясно, какой компонент каким состоянием должен владеть. Это может быть сложно, если вы новичок в этой концепции, но вы можете понять это, выполнив следующие шаги. Для каждой части состояния в вашем приложении:- Определите каждый компонент, который отображает что-то на основе этого состояния.
- Найдите их ближайший общий родительский компонент — компонент выше всех в иерархии.
- Решите, где должно находится состояние:
- Часто вы можете поместить состояние непосредственно в их общего родителя.
- Вы также можете поместить состояние в какой-либо компонент над их общим родителем.
- Если вы не можете найти компонент, где имеет смысл владеть состоянием, создайте новый компонент исключительно для хранения состояния и добавьте его где-нибудь в иерархии над общим родительским компонентом.
- Определите компоненты, которые используют состояние:
ProductTable
необходимо отфильтровать список продуктов на основе этого состояния (текст поиска и значение флажка).SearchBar
должен отображать это состояние (текст поиска и значение флажка). - Найдите их общего родителя: первый родительский компонент, который используется обоими компонентами, — это
FilterableProductTable
. - Решите, где находится состояние: мы сохраним текст фильтра и проверенные значения состояния в
FilterableProductTable
.
FilterableProductTable
.
Добавьте состояние к компоненту с помощью хука useState()
. Хуки позволяют «подключиться» к циклу рендеринга компонента. Добавьте две переменные состояния вверху FilterableProductTable
и укажите начальное состояние вашего приложения:
Затем передайтеfunction FilterableProductTable({ products }) { const [filterText, setFilterText] = useState(''); const [inStockOnly, setInStockOnly] = useState(false);
filterText
и inStockOnly
в ProductTable
и SearchBar
в качестве проса:
<div> <SearchBar filterText="{filterText}" inStockOnly="{inStockOnly}" /> <ProductTable products="{products}" filterText="{filterText}" inStockOnly="{inStockOnly}" /> </div>
filterText
с useState('')
на useState('fruit')
в приведенном ниже коде песочницы. Вы увидите как текст ввода поиска, так и обновление таблицы:
import { useState } from 'react'; function FilterableProductTable({ products }) { const [filterText, setFilterText] = useState(''); const [inStockOnly, setInStockOnly] = useState(false); return ( <div> <SearchBar filterText={filterText} inStockOnly={inStockOnly} /> <ProductTable products={products} filterText={filterText} inStockOnly={inStockOnly} /> </div> ); } function ProductCategoryRow({ category }) { return ( <tr> <th colSpan="2">{category}</th> </tr> ); } function ProductRow({ product }) { const name = product.stocked ? ( product.name ) : ( <span style={{ color: 'red' }}>{product.name}</span> ); return ( <tr> <td>{name}</td> <td>{product.price}</td> </tr> ); } function ProductTable({ products, filterText, inStockOnly }) { const rows = []; let lastCategory = null; products.forEach((product) => { if (product.name.toLowerCase().indexOf(filterText.toLowerCase()) === -1) { return; } if (inStockOnly && !product.stocked) { return; } if (product.category !== lastCategory) { rows.push( <ProductCategoryRow category={product.category} key={product.category} /> ); } rows.push(<ProductRow product={product} key={product.name} />); lastCategory = product.category; }); return ( <table> <thead> <tr> <th>Name</th> <th>Price</th> </tr> </thead> <tbody>{rows}</tbody> </table> ); } function SearchBar({ filterText, inStockOnly }) { return ( <form> <input type="text" value={filterText} placeholder="Search..." /> <label> <input type="checkbox" checked={inStockOnly} /> Only show products in stock </label> </form> ); } const PRODUCTS = [ { category: 'Fruits', price: '$1', stocked: true, name: 'Apple' }, { category: 'Fruits', price: '$1', stocked: true, name: 'Dragonfruit' }, { category: 'Fruits', price: '$2', stocked: false, name: 'Passionfruit' }, { category: 'Vegetables', price: '$2', stocked: true, name: 'Spinach' }, { category: 'Vegetables', price: '$4', stocked: false, name: 'Pumpkin' }, { category: 'Vegetables', price: '$1', stocked: true, name: 'Peas' }, ]; export default function App() { return <FilterableProductTable products={PRODUCTS} />; }
В приведенном выше кодеYou provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. Вы предоставили проп `value` для поля формы без обработчика `onChange`. Это отобразит поле только для чтения.
ProductTable
и SearchBar
считывают пропсы filterText
и inStockOnly
для отображения таблицы, ввода и флажка. Например, вот как SearchBar
заполняет входное значение:
Однако вы еще не добавили никакого кода для реагирования на действия пользователя, такие как ввод текста. Сделаем это в следующем шаге.function SearchBar({ filterText, inStockOnly }) { return ( <form> <input type="text" value={filterText} placeholder="Search..."/>
Шаг 5. Добавьте обратный поток данных
В настоящее время ваше приложение корректно отображается с пропсами и состоянием, спускающимися по иерархии. Но чтобы изменить состояние в соответствии с пользовательским вводом, вам нужно будет поддерживать поток данных в обратном направлении: компоненты формы глубоко в иерархии должны обновить состояние вFilterableProductTable
.
React делает этот поток данных явным, но требует немного большего набора текста, чем двусторонняя привязка данных. Если вы попытаетесь ввести или установить флажок в приведенном выше примере, вы увидите, что React игнорирует ваш ввод. Это сделано намеренно. Написав <input value={filterText} />
, вы установили проп value
для input
, чтобы оно всегда было равно состоянию filterText
, переданному из FilterableProductTable
. Поскольку состояние filterText
никогда не устанавливается, ввод никогда не изменяется.
Вы хотите сделать так, чтобы всякий раз, когда пользователь меняет ввод формы, состояние обновлялось, чтобы отражать эти изменения. Состояние принадлежит FilterableProductTable
, поэтому только он может вызывать setFilterText
и setInStockOnly
. Чтобы позволить SearchBar
обновлять состояние FilterableProductTable
, вам нужно передать эти функции в SearchBar
:
Внутриfunction FilterableProductTable({ products }) { const [filterText, setFilterText] = useState(''); const [inStockOnly, setInStockOnly] = useState(false); return ( <div> <SearchBar filterText={filterText} inStockOnly={inStockOnly} onFilterTextChange={setFilterText} onInStockOnlyChange={setInStockOnly} />
SearchBar
вы добавите обработчики событий onChange
, который установит родительское состояние:
Теперь приложение работает!<input type="text" value={filterText} placeholder="Search..." onChange={(e) => onFilterTextChange(e.target.value)} />
Вы можете узнать все об обработке событий и обновлении состояния в разделе "Добавление интерактивности".import { useState } from 'react'; function FilterableProductTable({ products }) { const [filterText, setFilterText] = useState(''); const [inStockOnly, setInStockOnly] = useState(false); return ( <div> <SearchBar filterText={filterText} inStockOnly={inStockOnly} onFilterTextChange={setFilterText} onInStockOnlyChange={setInStockOnly} /> <ProductTable products={products} filterText={filterText} inStockOnly={inStockOnly} /> </div> ); } function ProductCategoryRow({ category }) { return ( <tr> <th colSpan="2">{category}</th> </tr> ); } function ProductRow({ product }) { const name = product.stocked ? ( product.name ) : ( <span style={{ color: 'red' }}>{product.name}</span> ); return ( <tr> <td>{name}</td> <td>{product.price}</td> </tr> ); } function ProductTable({ products, filterText, inStockOnly }) { const rows = []; let lastCategory = null; products.forEach((product) => { if (product.name.toLowerCase().indexOf(filterText.toLowerCase()) === -1) { return; } if (inStockOnly && !product.stocked) { return; } if (product.category !== lastCategory) { rows.push( <ProductCategoryRow category={product.category} key={product.category} /> ); } rows.push(<ProductRow product={product} key={product.name} />); lastCategory = product.category; }); return ( <table> <thead> <tr> <th>Name</th> <th>Price</th> </tr> </thead> <tbody>{rows}</tbody> </table> ); } function SearchBar({ filterText, inStockOnly, onFilterTextChange, onInStockOnlyChange, }) { return ( <form> <input type="text" value={filterText} placeholder="Search..." onChange={(e) => onFilterTextChange(e.target.value)} /> <label> <input type="checkbox" checked={inStockOnly} onChange={(e) => onInStockOnlyChange(e.target.checked)} />{' '} Only show products in stock </label> </form> ); } const PRODUCTS = [ { category: 'Fruits', price: '$1', stocked: true, name: 'Apple' }, { category: 'Fruits', price: '$1', stocked: true, name: 'Dragonfruit' }, { category: 'Fruits', price: '$2', stocked: false, name: 'Passionfruit' }, { category: 'Vegetables', price: '$2', stocked: true, name: 'Spinach' }, { category: 'Vegetables', price: '$4', stocked: false, name: 'Pumpkin' }, { category: 'Vegetables', price: '$1', stocked: true, name: 'Peas' }, ]; export default function App() { return <FilterableProductTable products={PRODUCTS} />; }
Реакция на события в React компонентах
год назад·8 мин. на чтение
React позволяет добавлять обработчики событий в JSX. Обработчики событий — это ваши собственные функции, которые будут запускаться в ответ на такие действия, как клик, наведение курсора, фокусировка на поле ввода формы и т.д.
Содержание туториала по React
React позволяет добавлять обработчики событий в JSX. Обработчики событий — это ваши собственные функции, которые будут запускаться в ответ на такие действия, как клик, наведение курсора, фокусировка на поле ввода формы и т.д.
Вы определили функцию
Разница тонкая. В первом примере функция
Когда вы пишете код инлайном (определение в той же строке), та же ловушка проявляется по-другому:
Такой инлайн код не срабатывает при клике — он срабатывает каждый раз, когда компонент отрисовывается:
В этом примере
При нажатии на кнопку:
Добавление обработчиков событий
Чтобы добавить обработчик событий, сначала нужно определить функцию, а затем передать ее в качестве пропса соответствующему тегу JSX. Например, вот кнопка, которая пока ничего не делает:Вы можете заставить компонент показывать сообщение, когда пользователь нажимает на кнопку. Для этого нужно выполнить три следующих шага:export default function Button() { return <button>I don't do anything</button>; }
- Объявите функцию с именем
handleClick
внутри компонентаButton
. - Реализуйте логику внутри этой функции (используйте
alert
для отображения сообщения). - Добавьте
onClick={handleClick}
в<button>
.
export default function Button() { function handleClick() { alert('You clicked me!'); } return <button onClick={handleClick}>Click me</button>; }
handleClick
, а затем передали ее как проп в <button>
. handleClick
— это обработчик событий. Обработчик событий:
- Обычно определяется внутри ваших компонентов.
- Имеет имена, которые начинаются с
handle
, за которым следует имя события.
handle
, за которым следует имя события. Вы часто будете видеть onClick={handleClick}
, onMouseEnter={handleMouseEnter}
и т.д.
По-другому вы можете определить встроенный обработчик событий в JSX:
Или, более кратко, используя функцию стрелки:<button onClick={function handleClick() { alert('You clicked me!'); }}>
Все эти стили эквивалентны. Инлайновые обработчики событий удобны для коротких функций.<button onClick={() => { alert('You clicked me!'); }}>
Особенности передачи обработчиков событий
Функции, передаваемые обработчикам событий, должны отправляться, а не вызываться. Например:отправка функции (верно) | вызов функции (неверно) |
---|---|
<button onClick={handleClick}> | <button onClick={handleClick()}> |
handleClick
передается как обработчик события onClick
. Это говорит React запомнить ее и вызывать функцию только тогда, когда пользователь нажимает кнопку.
Во втором примере ()
в конце handleClick()
запускает функцию сразу же во время рендеринга, без каких-либо кликов. Это связано с тем, что JavaScript внутри JSX {
и }
выполняется сразу.
отправка функции (верно) | вызов функции (неверно) |
---|---|
<button onClick={() => alert('...')}> | <button onClick={alert('...')}> |
Если вы хотите определить инлайн (встроенный) обработчик событий, оберните его в анонимную функцию следующим образом:// Это оповещение срабатывает при рендеринге компонента, а не при нажатии! <button onClick={alert('You clicked me!')}>
Вместо выполнения кода внутри при каждом рендеринге создается функция, которая будет вызываться позже. В обоих случаях мы хотим передать функцию:<button onClick={() => alert('You clicked me!')}>
<button onClick={handleClick}>
передает функциюhandleClick
.<button onClick={() => alert('...')}>
передает функцию() => alert('...')
.
Чтение пропсов в обработчиках событий
Поскольку обработчики событий объявляются внутри компонента, они имеют доступ к пропсам компонента. Вот кнопка, при нажатии на которую отображается предупреждение с сообщениемmessage
:
Это позволяет этим двум кнопкам отображать разные сообщения.function AlertButton({ message, children }) { return <button onClick={() => alert(message)}>{children}</button>; } export default function Toolbar() { return ( <div> <AlertButton message="Playing!">Play Movie</AlertButton> <AlertButton message="Uploading!">Upload Image</AlertButton> </div> ); }
Передача обработчиков событий в качестве пропса
Часто требуется, чтобы родительский компонент указывал обработчик событий дочернего элемента. Рассмотрим кнопки: в зависимости от того, где вы используете компонентButton
, вы можете захотеть выполнить другую функцию — возможно, одна воспроизводит фильм, а другая загружает изображение.
Для этого передайте проп, который компонент получает от своего родителя, в качестве обработчика событий, например:
Здесь компонентfunction Button({ onClick, children }) { return <button onClick={onClick}>{children}</button>; } function PlayButton({ movieName }) { function handlePlayClick() { alert(`Playing ${movieName}!`); } return <Button onClick={handlePlayClick}>Play "{movieName}"</Button>; } function UploadButton() { return <Button onClick={() => alert('Uploading!')}>Upload Image</Button>; } export default function Toolbar() { return ( <div> <PlayButton movieName="Kiki's Delivery Service" /> <UploadButton /> </div> ); }
Toolbar
отображает PlayButton
и UploadButton
:
PlayButton
передаетhandlePlayClick
в качестве пропсаonClick
внутренней кнопке.UploadButton
передает() => alert('Uploading!')
в качестве пропсаonClick
дляButton
, который находится внутри.
Button
принимает проп onClick
. Он передает этот проп непосредственно встроенной в браузер кнопке <button>
с onClick={onClick}
. Это говорит React вызывать переданную функцию по клику.
Если вы используете дизайн-систему, такие компоненты, как кнопки, обычно содержат стили, но не определяют поведение. Вместо этого такие компоненты, как PlayButton
и UploadButton
, будут передавать обработчики событий вниз.
Именование пропсов обработчика событий
Встроенные компоненты, такие как<button>
и <div>
, поддерживают только имена событий браузера, такие как onClick
. Однако, когда вы создаете свои собственные компоненты, вы можете называть пропсы их обработчиков событий как угодно.
По соглашению пропсы обработчиков событий должны начинаться с on
, за которым следует заглавная буква.
Например, проп onClick
компонента Button
можно было бы назвать onSmash
:
function Button({ onSmash, children }) { return <button onClick={onSmash}>{children}</button>; } export default function App() { return ( <div> <Button onSmash={() => alert('Playing!')}>Play Movie</Button> <Button onSmash={() => alert('Uploading!')}>Upload Image</Button> </div> ); }
<button onClick={onSmash}>
показывает, что браузерному <button>
(нижний регистр) по-прежнему требуется проп onClick
, но имя пропса, полученное вашим пользовательским компонентом Button
, зависит от вас.
Когда ваш компонент поддерживает несколько взаимодействий, вы можете назвать пропсы обработчика событий по именам конкретных действий. Например, компонент Toolbar
получает обработчики событий onPlayMovie
и onUploadImage
:
Обратите внимание, что компонентуexport default function App() { return ( <Toolbar onPlayMovie={() => alert('Playing!')} onUploadImage={() => alert('Uploading!')} /> ); } function Toolbar({ onPlayMovie, onUploadImage }) { return ( <div> <Button onClick={onPlayMovie}>Play Movie</Button> <Button onClick={onUploadImage}>Upload Image</Button> </div> ); } function Button({ onClick, children }) { return <button onClick={onClick}>{children}</button>; }
App
не нужно знать, что Toolbar
будет делать с onPlayMovie
или onUploadImage
. Это деталь реализации компонента Toolbar
. Здесь Toolbar
передает их как обработчики onClick
своим компонентам Button
, но позже он также может запускать их с помощью сочетания клавиш. Именование пропсов в честь специфичных в приложении действий, таких как onPlayMovie
, дает вам возможность изменить способ их использования позже.
Распространение события (Event Propagation)
Обработчики событий также будут перехватывать события от любых дочерних элементов вашего компонента. Мы говорим, что событие «пузырится» или «распространяется» вверх по дереву: оно начинается там, где произошло событие, а затем идет вверх по дереву. Этот<div>
содержит две кнопки. И <div>
, и каждая кнопка имеют свои собственные обработчики onClick
. Как вы думаете, какие обработчики сработают, когда вы нажмете кнопку?
Если вы нажмете на любую кнопку, ееexport default function () { return ( <div className="Toolbar" onClick={() => { alert('You clicked on the toolbar!'); }} > <button onClick={() => alert('Playing!')}>Play Movie</button> <button onClick={() => alert('Uploading!')}>Upload Image</button> </div> ); }
onClick
будет запущен первым, а затем onClick
родителя <div>
. Таким образом, появятся два сообщения. Если вы щелкнете по самому Toolbar
, запустится onClick
только родительского элемента <div>
.
Все события в React распространяются, кроме onScroll
, который работает только с тегом JSX, к которому вы его прикрепляете.
Остановка распространения события
Обработчики событий получают объект события в качестве единственного аргумента. По соглашению его обычно называютe
, что означает "event" ("событие"). Вы можете использовать этот объект для чтения информации о событии.
Этот объект события также позволяет остановить распространение. Если вы хотите, чтобы событие не достигало родительских компонентов, вам нужно вызвать e.stopPropagation()
, как это делает этот компонент Button
:
function Button({ onClick, children }) { return ( <button onClick={(e) => { e.stopPropagation(); onClick(); }} > {children} </button> ); } export default function Toolbar() { return ( <div className="Toolbar" onClick={() => { alert('You clicked on the toolbar!'); }} > <Button onClick={() => alert('Playing!')}>Play Movie</Button> <Button onClick={() => alert('Uploading!')}>Upload Image</Button> </div> ); }
- React вызывает обработчик
onClick
, переданный<button>
. - Этот обработчик, определенный в
Button
, делает следующее:- Вызывает
e.stopPropagation()
, предотвращая дальнейшее всплытие события. - Вызывает функцию
onClick
, которая является пропсом, переданным из компонентаToolbar
.
- Вызывает
- Эта функция, определенная в компоненте
Toolbar
, отображает собственное оповещение кнопки. - Поскольку распространение было остановлено, обработчик
onClick
родительского элемента<div>
не запускается.
e.stopPropagation()
при нажатии на кнопки теперь отображается только одно предупреждение (от <button>
), а не два из них (от <button>
и родительской Toolbar
<div>
). Клик по кнопке — это не то же самое, что клик по окружающему Toolbar
, поэтому остановка распространения имеет смысл для этого пользовательского интерфейса.
Захват событий
В редких случаях вам может понадобиться перехватывать все события дочерних элементов, даже если они остановили распространение. Например, может быть, вы хотите регистрировать каждый клик в аналитике, независимо от логики распространения. Вы можете сделать это, добавивCapture
в конце имени события:
Каждое событие распространяется в три этапа:<div onClickCapture={() => { /* запускается первым */ }} > <button onClick={(e) => e.stopPropagation()} /> <button onClick={(e) => e.stopPropagation()} /> </div>
- Он перемещается вниз, вызывая все обработчики
onClickCapture
. - Он запускает обработчик
onClick
выбранного элемента. - Он перемещается вверх, вызывая все обработчики
onClick
.
Передача обработчиков как альтернатива распространению
Обратите внимание, как этот обработчик кликов запускает код, а затем вызывает пропonClick
, переданное родителем:
Вы также можете добавить дополнительный код в этот обработчик перед вызовом родительского обработчика событияfunction Button({ onClick, children }) { return ( <button onClick={(e) => { e.stopPropagation(); onClick(); }} > {children} </button> ); }
onClick
. Этот шаблон обеспечивает альтернативу распространению. Это позволяет дочернему компоненту обрабатывать событие, а также позволяет родительскому компоненту указывать дополнительное поведение. В отличие от распространения, оно не происходит автоматически. Но преимущество этого паттерна в том, что вы можете четко проследить всю цепочку кода, которая выполняется в результате какого-то события.
Если вы полагаетесь на распространение и сложно отследить, какие обработчики выполняются и почему, попробуйте вместо этого этот подход.
Предотвращение поведения по умолчанию
С некоторыми событиями браузера связано поведение по умолчанию. Например, событие отправки<form>
, которое происходит при нажатии кнопки внутри него, по умолчанию перезагружает всю страницу:
Вы можете вызватьexport default function Signup() { return ( <form onSubmit={() => alert('Submitting!')}> <input /> <button>Send</button> </form> ); }
e.preventDefault()
для объекта события, чтобы этого не произошло:
Не путайтеexport default function Signup() { return ( <form onSubmit={(e) => { e.preventDefault(); alert('Submitting!'); }} > <input /> <button>Send</button> </form> ); }
e.stopPropagation()
и e.preventDefault()
. Они оба полезны, но не связаны между собой:
e.stopPropagation()
останавливает срабатывание обработчиков событий, прикрепленных к указанным выше тегам.e.preventDefault()
предотвращает поведение браузера по умолчанию для нескольких событий, которые его содержат.
Могут ли обработчики событий иметь побочные эффекты?
Да, могут. Обработчики событий — лучшее место для побочных эффектов. В отличие от функций рендеринга, обработчики событий не обязательно должны быть чистыми, поэтому это отличное место для того, чтобы что-то изменить — например, изменить значение инпута в ответ на ввод или изменить список в ответ на нажатие кнопки. Однако для того, чтобы изменить некоторую информацию, вам сначала нужно каким-то образом ее сохранить. В React это делается с помощью состояния - памяти компонента. Обо всем этом вы узнаете в следующей части.Резюме
- Вы можете обрабатывать события, передавая функцию в качестве пропса элементу, такому как
<button>
. - Обработчики событий должны передаваться, а не вызываться.
onClick={handleClick}
, а неonClick={handleClick()}
. - Вы можете определить функцию обработчика событий отдельно или встроенную (инлайн).
- Обработчики событий определяются внутри компонента, поэтому они могут получить доступ к пропсам.
- Вы можете объявить обработчик событий в родительском элементе и передать его в качестве пропса дочернему элементу.
- Вы можете определить свои собственные пропсы обработчика событий с именами, специфичными для приложения.
- События распространяются вверх. Вызовите
e.stopPropagation()
для первого аргумента, чтобы это предотвратить. - События могут иметь нежелательное поведение браузера по умолчанию. Вызовите
e.preventDefault()
, чтобы это предотвратить. - Явный вызов пропса обработчика событий из дочернего обработчика является хорошей альтернативой распространению события.