본문으로 건너뛰기
STUDY LAB
FrontendLV.1

공용 컴포넌트 설계 방법 정리 (Frontend Fundamentals)

변경하기 쉬운 프론트엔드 코드를 만들기 위한 가독성, 예측 가능성, 응집도, 결합도 기준을 정리했습니다.

2분 읽기

공용 컴포넌트를 설계하기 위해 Frontend Fundamentals 내용을 참고했다. 읽어보면서 프론트엔드 코드 구조를 고민할 때 유용하다고 느껴 따로 정리해보았다.

변경하기 쉬운 코드#

좋은 프론트엔드 코드는 결국 변경하기 쉬운 코드라고 할 수 있다. 서비스는 계속 변화하기 때문에 새로운 요구사항이 추가되거나 기존 로직을 수정해야 하는 상황이 계속 발생한다.

Frontend Fundamentals에서는 코드 변경을 쉽게 하기 위한 기준으로 다음 네 가지 요소를 제시한다.

  • 가독성
  • 예측 가능성
  • 응집도
  • 결합도

1. 가독성#

가독성은 코드가 얼마나 읽기 쉬운지를 의미한다. 코드를 변경하기 위해서는 먼저 코드가 어떤 동작을 하는지 이해할 수 있어야 한다.

가독성을 높이기 위한 전략은 다음과 같다.

  • 중복 코드 지양하기
  • 맥락 줄이기
  • 복잡한 조건에 이름 붙이기
  • 매직 넘버 제거하기
  • Top-down 방식으로 읽히는 코드 구조 만들기

특히 매직 넘버는 코드의 의미를 파악하기 어렵게 만들기 때문에 상수로 선언해 의미를 명확히 하는 것이 좋다.

2. 예측 가능성#

예측 가능성은 다른 개발자가 함수나 컴포넌트의 동작을 얼마나 쉽게 예상할 수 있는지를 의미한다.

예측 가능성을 높이기 위한 전략은 다음과 같다.

  • 이름이 겹치지 않도록 관리하기
  • 같은 종류의 함수는 반환 타입을 통일하기
  • 숨은 로직을 드러내기

예를 들어 API 호출 관련 훅들이 서로 다른 반환 타입을 가지면 사용하는 입장에서 혼란이 발생할 수 있다.

3. 응집도#

응집도는 함께 수정되어야 할 코드가 실제로 함께 수정되는지를 의미한다.

특정 로직이 여러 컴포넌트에서 사용되더라도 함께 수정되어야 하는 코드라면 하나의 구조 안에서 관리하는 것이 좋다.

응집도를 높이기 위한 전략은 다음과 같다.

  • 함께 수정되는 파일을 같은 디렉토리에 배치하기
  • 매직 넘버 제거하기
  • 폼 단위 응집도 고려하기

폼의 경우 다음 두 가지 방식으로 응집도를 관리할 수 있다.

  • 필드 단위 응집도: 각 입력 요소가 독립적으로 관리되는 방식
  • 폼 전체 단위 응집도: 모든 검증 로직이 폼에 종속되는 방식

4. 결합도#

결합도는 코드를 수정했을 때 영향을 받는 범위를 의미한다. 영향 범위가 작을수록 코드의 예측 가능성이 높아진다.

결합도를 낮추기 위한 전략은 다음과 같다.

  • 책임을 하나씩 관리하기
  • 불필요한 공통화 피하기
  • Props Drilling 줄이기

여러 컴포넌트에서 사용하는 로직을 무조건 공통화하는 것이 항상 좋은 선택은 아니다. 공통화된 코드가 많아질수록 변경 시 영향 범위가 넓어질 수 있기 때문이다.

또한 Props Drilling은 컴포넌트 간 결합도가 높다는 신호이므로 Composition 패턴 등을 활용해 구조를 개선할 수 있다.

정리#

Frontend Fundamentals에서 말하는 좋은 프론트엔드 코드는 결국 다음 네 가지 기준의 균형을 맞추는 것이다.

  • 가독성
  • 예측 가능성
  • 응집도
  • 결합도

이 네 가지를 고려하며 컴포넌트와 구조를 설계한다면 장기적으로 유지보수하기 쉬운 프론트엔드 코드를 만들 수 있다.

End of article· 끝까지 읽으면+2 xp

Comments

질문이나 다른 의견이 있다면 남겨주세요. 함께 고민한 내용은 글에 반영합니다.

GitHub으로 의견 남기기