최근 운영 중인 블로그 테마들을 전수 점검하다가 정말 당황스러운 버그를 하나 발견했습니다. 여러 테마 중 IT Story 테마의 목록 페이지에서 카테고리 태그 클릭을 했는데, 라벨 아카이브 페이지로 이동하지 않고 그냥 일반 게시글 상세 페이지가 열리는 현상이었습니다. 분명 눈으로 보기에는 다른 테마들과 완전히 똑같이 생긴 카드 UI인데, 유독 이 테마에서만 몇 달 동안 조용히 오작동하고 있었던 것입니다.
처음에는 단순한 링크 오류인 줄 알고 대수롭지 않게 여겼습니다. 하지만 코드를 뜯어보니 브라우저의 레이어 배치와 관련한 고질적인 css 문제였습니다. 오늘은 똑같이 디자인된 카드 UI에서 유독 한 곳에서만 카테고리 태그가 먹통이었던 삽질의 과정과 해결 방법을 기록해 보려 합니다.
똑같이 생겼는데 왜 얘만 카테고리가 안 눌릴까
문제가 발생한 원인을 찾기 위해 개발자 도구를 켜고 요소들을 하나씩 뜯어보았습니다. 저는 블로그 카드 내부의 어떤 공간을 클릭해도 상세 페이지로 이동할 수 있도록, 카드 전체 영역을 덮는 빈 링크를 배치하는 방식을 사용하고 있습니다. 일명 position absolute 오버레이 패턴입니다.
이 패턴은 .jb-card-link라는 빈 <a> 태그에 position: absolute; z-index: 1;을 부여하여 카드 전체를 덮어씌우는 구조로 작동합니다. 문제는 이렇게 하면 카드 안에 포함되어 있는 다른 클릭 요소, 즉 카테고리 태그 클릭 같은 개별 링크까지 이 투명한 오버레이막 뒤에 갇혀버린다는 점입니다.
따라서 카테고리 태그는 카드 오버레이보다 더 높은 레이어에 위치하도록 띄워주어야 정상적으로 작동합니다. 당연히 예전에 이 처리를 다 해두었다고 생각했는데, 특정 테마에서만 작동하지 않고 있었던 것입니다.
테마별 클래스 접두사가 불러온 어이없는 소외
원인은 허무하게도 테마별 클래스 접두사 차이에서 발생한 공백 때문이었습니다. 저는 이전에 블로그를 개편하면서 똑같은 카드 전체 클릭 오버레이 구조를 다른 테마들에도 적용한 적이 있었습니다. 그때 issuelog, kidstory, jins-lab 이렇게 3개 테마에는 오버레이 위로 태그를 띄우는 처리를 완벽하게 해두었습니다.
하지만 해당 테마들은 모두 jp-로 시작하는 클래스 접두사 계열을 공유하는 일관된 코드베이스를 가지고 있었습니다. 반면, 이번에 문제가 터진 IT Story 테마는 jb-라는 접두사를 사용하는 완전히 별개의 독립된 코드베이스로 만들어진 녀석이었습니다.
결국 예전에 작업할 때 jp- 계열 테마의 스타일만 일괄 수정하고, 다르게 코딩되어 있던 IT Story 테마는 작업 대상에서 완전히 빠뜨렸던 것입니다. 겉모습은 똑같이 아름답게 렌더링되고 있었기에, 소스코드가 다르다는 사실을 완전히 망각한 채 몇 달을 방치해 두고 있었습니다.
코드 수정과 깨달은 점
원인을 알았으니 해결은 아주 간단했습니다. IT Story 테마의 CSS 파일로 들어가서 카테고리 태그를 나타내는 클래스인 .jb-card-label을 찾아내었습니다. 그리고 이 클래스에 오버레이보다 높게 레이어를 올려주는 스타일을 새로 주입해 주었습니다.
구체적으로는 .jb-card-label에 position: relative; z-index: 2;를 명시적으로 추가했습니다. 이렇게 설정해주니 오버레이 영역인 z-index 1보다 높은 우선순위를 가지게 되면서, 투명한 막 위로 카테고리 태그가 안전하게 올라올 수 있게 되었습니다.
코드를 수정하고 저장한 뒤 블로그를 새로고침하여 테스트해 보았습니다. 이제는 카드 영역을 누르면 게시글이 잘 열리고, 카테고리 태그를 조준해서 누르면 원래 의도했던 대로 라벨 아카이브 페이지로 정확히 이동하는 것을 확인할 수 있었습니다.
겉보기만 믿지 말고 코드의 뿌리를 확인하자
이번에 카드 클릭 오버레이 z-index 버그를 해결하면서 뼈저리게 느낀 점이 있습니다. 바로 UI 디자인이 눈에 똑같이 보인다고 해서 내부 코드까지 같을 것이라 넘겨짚으면 안 된다는 사실입니다. 특히 여러 테마나 템플릿을 동시에 관리할 때, 클래스명 접두사가 다른 개별 테마는 겉보기에 완벽하더라도 내부 CSS 구조에서 언제든 소외될 수 있습니다.
앞으로는 공통적인 인터랙션 패턴을 이식하거나 수정할 때, 모든 테마의 코드베이스를 한 번 더 교차 검증하는 습관을 들여야겠습니다. 혹시 여러분도 카드 UI 내부에서 특정 링크가 클릭이 안 되거나 엉뚱한 곳으로 튀는 현상을 겪고 있다면, 혹시 absolute 오버레이와 z-index 관계가 꼬이지 않았는지 개발자 도구로 꼭 확인해 보시기 바랍니다.