Skip to main content

​
개요

Upcart를 닫은 후 스토어 페이지가 스크롤되지 않는다면, 카트 드로어가 열려 있을 때 페이지 스크롤을 잠그는 테마 로직이 원인일 가능성이 높아요. 또한 Upcart는 이제 기존 스크롤 잠금 로직 재정의처럼 이런 문제를 해결하는 내장 설정을 제공해요. Upcart의 내장 설정을 사용하거나, 스크롤 잠금 동작을 제거하는 간단한 커스터마이징을 추가해 해결할 수 있어요.
해결 방법

​
내장 솔루션 사용하기

대부분의 경우 Upcart 설정의 내장 옵션만으로 커스텀 코드 없이 스크롤 문제를 해결할 수 있어요.
  1. “Override existing scroll locking logic” 활성화하기:
    • Upcart 설정에서 Cart Editor를 여세요.
    • Settings → Cart settings로 이동한 뒤 Advanced Settings를 펼치세요.
    • Override existing scroll locking logic을 활성화하세요. 이 옵션의 설명은 정확히 이 경우 — 장바구니가 닫힌 후에도 테마나 서드파티 앱이 페이지를 스크롤 잠금 상태로 남겨 두는 경우 — 를 다뤄요.
    모바일용이나 오버레이용 스크롤 설정이 따로 있는 것은 아니에요 — 이 체크박스 하나로 둘 다 처리돼요.
장바구니를 닫은 후 페이지 스크롤을 복원하는 커스터마이징을 적용하려면 다음 단계를 따르세요.

​
Custom HTML 설정 접근하기

  1. Shopify 대시보드에서 Upcart 앱을 여세요.
  2. Cart Editor로 이동하세요.
  3. Settings를 열고 Custom HTML 탭을 선택하세요. Settings는 탭이 한 줄로 나열되어 있어요 — Custom HTML이 보이지 않는다면 More settings 안에 있어요.

​
코드 추가하기

  1. 내장 솔루션으로 문제가 해결되지 않는 고급 사례나 특수한 경우에는 Upcart에서 커스텀 HTML 코드를 적용할 수 있어요. Upcart에서 HTML 코드를 적용할 위치를 선택하세요. 이 해결책에는 Above Announcements/Rewards 섹션을 선택하세요.
  2. 다음 코드 스니펫을 추가하세요:
레거시 안내: window.upcartOnCartOpened와 window.upcartOnCartClosed 콜백은 여전히 작동하지만 더 이상 사용되지 않으며 콘솔 경고를 출력해요. 새 스크립트에는 모두 upcartSubscribeCartOpened와 upcartSubscribeCartClosed를 사용하세요.
  1. 변경 사항을 저장하세요.
  2. 스토어프런트를 새로 고침하고 장바구니를 닫아 스크롤이 복원되는지 테스트하세요.

​
발생 원인

Upcart가 열리면 스토어의 기본 카트 드로어를 숨기고 그 시각적 공간을 차지해요. 하지만 일부 테마에는 드로어가 활성화될 때마다 페이지 스크롤을 잠그는 코드가 있어요. Upcart가 닫힌 후에도 그 잠금이 남아 페이지 스크롤이 되지 않을 수 있어요. 모바일 기기에서는 오버레이가 남아 있거나 페이지가 클릭되지 않는 등의 추가적인 문제가 발생할 수 있어요. 이런 문제는 모바일 전용 스크롤 잠금 동작이나 초기화되지 않은 오버레이와 관련된 경우가 많아요. 위 스크립트는 장바구니가 열리거나 닫힐 때 페이지의 overflow 속성을 수동으로 재설정해 정상적인 스크롤 동작을 복원해요.
도움이 필요하거나 추가 문제 해결이 필요한 경우

​
지원팀에 문의하기 전 추가 단계

  1. Override existing scroll locking logic이 활성화되어 있는지 확인하세요.
  2. 커스텀 코드나 서드파티 스크립트가 간섭할 가능성이 있는지 다시 확인하세요.
수정 사항을 적용한 후에도 스크롤 문제가 계속된다면, 테마가 다른 선택자나 사용자 지정 스크롤 로직을 사용하고 있을 수 있어요. 올바른 선택자를 찾는 데 도움이 필요하면 Upcart 지원팀에 문의하시고, 테마의 스크롤 설정 조정에 대한 도움이 필요하면 테마 개발자에게 연락하세요.