워크플로 · 2026년 7월 15일
URL에 로컬라이제이션 탐색 상태 유지하기
로캘, 검색, 필터, 페이지네이션은 작업 맥락입니다. 이를 URL에 유지하면 번역 검토가 더 빨라지고 다시 복구할 수 있습니다.

편집자는 Contentful 항목을 하나의 콘텐츠 유형으로 필터링하고, 소스 로캘을 선택하고, 캠페인을 검색한 뒤, 검토가 필요한 페이지를 엽니다.
번역을 확인한 후 뒤로 가기를 누르면 기본 콘텐츠 목록이 나타납니다.
데이터는 그대로 있습니다. 작업 맥락만 사라졌습니다.
탐색 상태는 작업의 일부입니다
로컬라이제이션 화면에는 보통 여러 차원이 있습니다:
- 프로젝트
- 소스 및 대상 로캘
- 콘텐츠 유형
- 번역 상태
- 검색어
- 정렬 순서
- 페이지
이 값들은 편집자가 어떤 작업을 하고 있는지 결정합니다. 이를 일시적인 컴포넌트 상태로 취급하면 탐색, 새로고침, 공유 링크 전반에서 워크플로가 취약해집니다.
URL은 복구 가능한 탐색 상태를 담기에 가장 자연스러운 위치입니다.
뒤로 가기는 정말 뒤로 가기여야 합니다
편집자들은 목록 보기와 상세 보기 사이를 반복해서 이동합니다. 항목을 확인하고, 요청을 검토하고, 대기열로 돌아간 뒤, 다음 항목을 엽니다.
필터와 페이지네이션이 쿼리 문자열에 있으면 브라우저 기록이 그 반복 흐름을 보존합니다. 사용자는 매번 상세 보기 후 다시 구성하는 대신 같은 작업 구간으로 돌아갑니다.
이것은 단순한 편의성만의 문제가 아닙니다. 맥락을 잃은 뒤 검토자가 실수로 로캘이나 배치를 바꿀 가능성도 줄여줍니다.
공유 가능한 보기는 협업을 개선합니다
안정적인 필터가 포함된 URL은 팀원과 공유할 수 있습니다:
?locale=fr&content_type=landingPage&state=failed
받는 사람은 이를 재현하기 위한 글 설명을 따르는 대신 동일한 운영 보기를 바로 엽니다.
지원과 디버깅도 더 빨라집니다. 페이지에서 기술 식별자는 그대로 확인할 수 있으면서, 링크는 관련 검색 및 상태 맥락을 보존할 수 있습니다.
민감한 데이터는 URL에 두면 안 되지만, 일반적인 콘텐츠 필터는 바로 쿼리 매개변수가 잘 처리하는 종류의 상태입니다.
쿼리를 정규화하세요
지속적인 URL에는 규율이 필요합니다. 여러 매개변수 순서, 빈 값, 중복된 기본값, 오래된 페이지 번호는 혼란스러운 기록을 만들 수 있습니다.
깔끔한 구현은 다음을 해야 합니다:
- 서버에서 쿼리 값을 검증한다
- 가능하면 기본값은 생략한다
- 필터가 바뀌면 페이지네이션을 재설정한다
- 관련 없는 유효한 필터는 보존한다
- 빠른 검색 변경에는 history를 replace하고 의도적인 탐색에는 history를 push한다
그 결과, URL은 모든 UI 상호작용의 누적 기록이 되는 대신 현재 보기를 표현하게 됩니다.
공유 컨트롤을 동기화하세요
로캘 선택기는 콘텐츠 목록, 항목 상세, 번역 검토, 배치 화면 전반에 걸쳐 나타납니다. 각 컨트롤은 동일한 탐색 모델에서 읽고 써야 합니다.
한 선택기는 로컬 상태만 바꾸고 다른 선택기는 라우트를 업데이트하면, 사용자는 일관되지 않은 라벨을 보게 되고 잘못된 로캘로 요청이 생성될 수 있습니다.
서버에서 검증된 URL 상태는 현재 탐색 맥락을 위한 하나의 명확한 기준점이 됩니다.
핵심 요점
필터가 편집자 앞의 작업을 정의한다면, 그것은 버려도 되는 인터페이스 설정이 아닙니다.
로캘, 검색, 콘텐츠 유형, 상태, 페이지네이션을 정규화된 URL에 유지하세요. 뒤로 가기 탐색은 신뢰할 수 있게 되고, 보기는 공유 가능해지며, 번역 작업은 목록과 상세 사이의 일상적인 이동 속에서도 유지됩니다.