React에서는 JSX에 이벤트 핸들러를 추가할 수 있습니다. 이벤트 핸들러는 클릭, 마우스 호버, 폼 인풋 포커스 등 사용자 상호작용에 따라 유발되는 사용자 정의 함수입니다.
학습 내용
- 이벤트 핸들러를 작성하는 여러가지 방법
- 이벤트 처리 로직을 부모 컴포넌트에서 전달하는 방법
- 이벤트가 전파되는 방식와 이를 멈추는 방법
이벤트 핸들러 추가하기
이벤트 핸들러 추가를 위해서는 먼저 함수를 정의하고 이를 적절한 JSX 태그에 prop 형태로 전달해야 합니다. 아래 예시는 아직 아무런 동작도 수행하지 않는 버튼입니다.
Error
Extra 185 of 186 byte(s) found at buffer[1]
이제 다음 3단계 과정을 거쳐 사용자가 버튼을 클릭할 경우 메시지를 보여주도록 만들어 보겠습니다.
Button
컴포넌트 내부에handleClick
함수를 선언합니다.- 해당 함수 내부 로직을 구현합니다. 이번에는 메시지를 표시하기 위해
alert
를 사용합니다. <button>
JSX에onClick={handleClick}
을 추가합니다.
Error
Extra 185 of 186 byte(s) found at buffer[1]
handleClick
함수를 정의하였고 이를 <button>
에 prop 형태로 전달하였습니다. 여기서 handleClick
은 이벤트 핸들러입니다. 이벤트 핸들러 함수는 다음 특징을 가집니다.
- 주로 컴포넌트 내부에서 정의됩니다.
handle
로 시작하고 그 뒤에 이벤트명을 붙인 함수명을 가집니다.
관습적으로 handle
로 시작하며 이벤트명을 이어 붙인 이벤트 핸들러 명명법이 일반적입니다. onClick={handleClick}
, onMouseEnter={handleMouseEnter}
와 같은 경우를 자주 볼 수 있을 것입니다.
다른 방법으로 이벤트 핸들러를 JSX 내에서 인라인으로 정의할 수 있습니다.
<button onClick={function handleClick() {
alert('You clicked me!');
}}>
또는 화살표 함수를 사용하여 보다 간결하게 정의할 수도 있습니다.
<button onClick={() => {
alert('You clicked me!');
}}>
이러한 스타일은 모두 동일한 결과를 보여줍니다. 특히 인라인 이벤트 핸들러는 짧은 함수들을 정의할 때 편리합니다.
이벤트 핸들러 내에서 Prop 읽기
이벤트 핸들러는 컴포넌트 내부에서 선언되기에 이들은 해당 컴포넌트의 prop에 접근할 수 있습니다. 아래에서 클릭시 message
prop의 내용을 포함한 alert를 표시하는 버튼을 볼 수 있습니다.
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> ); }
위와 같이 두 개의 버튼이 서로 다른 메시지를 표시할 수 있습니다. 전달되는 메시지를 변경해보세요.
이벤트 핸들러를 Prop으로 전달하기
종종 부모 컴포넌트로 자식의 이벤트 핸들러를 지정하기를 원할 수 있습니다. 버튼의 경우를 고려해봅시다. Button
컴포넌트를 사용하는 위치에 따라 다른 기능을 수행하도록 만들고자 할 때가 있을 것입니다. 한 버튼은 영화를 재생하고 다른 버튼은 이미지를 업로드하도록 말이죠.
이러한 기능을 위해서 컴포넌트가 그 부모 컴포넌트로부터 받은 prop을 이벤트 핸들러로 다음과 같이 전달합니다.
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
을Button
내onClick
prop으로 전달합니다.UploadButton
은() => alert('Uploading!')
을Button
내onClick
prop으로 전달합니다.
최종적으로, Button
컴포넌트는 onClick
prop을 받습니다. 이후 받은 prop을 브라우저 빌트인 <button>
의 onClick={onClick}
으로 직접 전달합니다. 이를 통해 React가 전달받은 함수를 클릭 시점에 호출함을 알 수 있습니다.
만약 디자인 시스템을 적용한다면 버튼과 같은 컴포넌트는 동작을 지정하지 않고 스타일만 지정하는 것이 일반적입니다. 그 대신, PlayButton
과 UploadButton
같은 컴포넌트가 이벤트 핸들러를 전달하도록 합니다.
이벤트 핸들러 Prop 명명하기
<button>
과 <div>
같은 빌트인 컴포넌트는 onClick
과 같은 브라우저 이벤트 이름 만을 지원합니다. 그러나 사용자 정의 컴포넌트에서는 이벤트 핸들러 prop의 이름을 원하는 대로 명명할 수 있습니다.
관습적으로 이벤트 핸들러 prop의 이름은 on
으로 시작하여 대문자 영문으로 이어집니다.
그 예시로, Button
컴포넌트의 onClick
prop은 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
prop을 필요로 하고 있음을 보여줍니다. 그러나 여러분이 직접 정의한 Button
컴포넌트가 받게 될 prop의 이름은 여러분이 원하는 대로 명명할 수 있습니다.
컴포넌트가 여러 상호작용을 지원한다면 이벤트 핸들러 prop을 애플리케이션에 특화시켜 명명할 수 있습니다. 예시에서는 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
는 위 요소들을 Button
의 onClick
핸들러 요소로 내려보내지만, 추후에는 키보드 바로가기 키 입력을 통해 이들을 활성화할 수도 있을 것입니다. onPlayMovie
와 같이 prop 이름을 애플리케이션별 상호작용에 기반하여 명명한다면 나중에 어떻게 이를 이용하게 될지에 대한 유연성을 제공할 것입니다.
이벤트 전파
이벤트 핸들러는 해당 컴포넌트가 가진 어떤 자식 컴포넌트의 이벤트를 수신할 수도 있습니다. 이를 이벤트가 트리를 따라 “bubble” 되거나 “전파된다”고 표현합니다. 이때 이벤트는 발생한 지점에서 시작하여 트리를 따라 위로 전달됩니다.
아래 <div>
는 두 개의 버튼을 포함하고 있습니다. <div>
그리고 각각의 버튼은 각자의 onClick
핸들러를 가지고 있습니다. 버튼을 클릭한다면 어느 핸들러가 작동하게 될까요?
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> ); }
둘 중의 어느 버튼을 클릭하더라도 해당 버튼의 onClick
이 먼저 실행될 것이며 이후 부모인 <div>
의 onClick
이 뒤이어 실행될 것입니다. 따라서 두 개의 메시지가 표시될 것입니다. 만약 툴바 자체를 클릭한다면 오직 부모인 <div>
의 onClick
만이 실행될 것입니다.
전파 멈추기
이벤트 핸들러는 이벤트 오브젝트를 유일한 매개변수로 받습니다. 관습을 따르자면 “event”를 의미하는 e
로 호출되는 것이 일반적입니다. 이 오브젝트를 이벤트의 정보를 읽어들이는데 사용할 수 있습니다.
이러한 이벤트 오브젝트는 전파를 멈출 수 있게 해줍니다. 이벤트가 부모 컴포넌트에 닿지 못하도록 막으려면 아래 Button
컴포넌트와 같이 e.stopPropagation()
를 호출합니다.
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가
<button>
에 전달된onClick
핸들러를 호출합니다. Button
에 정의된 해당 핸들러는 다음을 수행합니다.e.stopPropagation()
을 호출하여 이벤트가 더 이상 bubbling 되지 않도록 방지합니다.Toolbar
컴포넌트가 전달해 준onClick
함수를 호출합니다.
Toolbar
컴포넌트에서 정의된 위 함수가 버튼의 alert를 표시합니다.- 전파가 중단되었으므로 부모인
<div>
의onClick
은 실행되지 않습니다.
e.stopPropagation()
의 결과, 버튼을 클릭하는 것은 이제 <button>
과 그 부모인 툴바의 <div>
가 보내는 두 개의 alert를 표시하지 않고 단 하나의 <button>
alert 만을 표시합니다. 버튼을 클릭하는 것은 그 주변의 툴바 부분을 클릭하는 것과 같지 않기에 이 UI 상에서는 전파를 멈추는 것이 합리적일 것입니다.
Deep Dive
드물게 전파가 중단된 상황일지라도 자식 컴포넌트의 모든 이벤트를 캡처해 확인해야 할 수 있습니다. 일례로, 분석을 위해 전파 로직에 상관 없이 모든 클릭 이벤트를 기록하고 싶을 수 있습니다. 이를 위해서는 이벤트명 마지막에 Capture
를 추가하면 됩니다.
<div onClickCapture={() => { /* this runs first */ }}>
<button onClick={e => e.stopPropagation()} />
<button onClick={e => e.stopPropagation()} />
</div>
각각의 이벤트는 세 단계를 거쳐 전파됩니다.
- 아래로 전달되면서 만나는 모든
onClickCapture
핸들러를 호출합니다. - 클릭된 요소의
onClick
핸들러를 실행합니다. - 위로 전달되면서 만나는 모든
onClick
핸들러를 호출합니다.
이벤트 캡처는 라우터나 분석을 위한 코드에 유용할 수 있지만 일반 애플리케이션 코드에서는 사용하지 않을 가능성이 높습니다.
전파의 대안으로 핸들러를 전달하기
아래 클릭 핸들러가 어떤 코드 라인을 실행시킨 이후에 부모로부터 전달받은 onClick
prop을 호출하는지 확인해보세요.
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에서는 컴포넌트의 기억 역할을 하는 state를 이용할 수 있습니다. 해당 기능의 모든 것에 대해 다음 페이지에서 배울 것입니다.
요약
<button>
과 같은 요소에 함수를 prop으로 전달하여 이벤트를 처리할 수 있습니다.- 이벤트 핸들러는 호출이 아니라 전달만 가능합니다!
onClick={handleClick()}
이 아니라onClick={handleClick}
입니다. - 이벤트 핸들러 함수는 별개의 함수 혹은 인라인 형태로 정의할 수 있습니다.
- 이벤트 핸들러는 컴포넌트 내부에서 정의되기에 다른 prop에 접근할 수 있습니다.
- 이벤트 핸들러는 부모에서 선언하여 자식에게 prop으로 전달할 수 있습니다.
- 사용자 정의 이벤트 핸들러의 이름을 애플리케이션에 특화된 이름으로 명명할 수 있습니다.
- 이벤트는 위쪽으로 전파됩니다. 첫 번째 매개변수로
e.stopPropagation()
를 호출하여 방지할 수 있습니다. - 이벤트는 의도치 않은 기본 브라우저 동작을 유발할 수 있습니다.
e.preventDefault()
를 호출하여 방지할 수 있습니다. - 명시적으로 이벤트 핸들러 prop을 자식 핸들러에서 호출하는 것은 전파에 대한 좋은 대안이 될 수 있습니다.
챌린지 1 of 2: 이벤트 핸들러 고치기
이 버튼을 클릭하면 페이지 배경이 흰색과 검은색으로 교체되도록 하려 합니다. 그러나 지금은 클릭 시 아무 일도 일어나지 않습니다. 문제를 해결해보세요. (handleClick
내의 로직에 대해선 걱정 마세요. 해당 부분은 정상입니다.)
export default function LightSwitch() { function handleClick() { let bodyStyle = document.body.style; if (bodyStyle.backgroundColor === 'black') { bodyStyle.backgroundColor = 'white'; } else { bodyStyle.backgroundColor = 'black'; } } return ( <button onClick={handleClick()}> Toggle the lights </button> ); }