당겨서 새로고침 및 오버플로 효과를 맞춤설정하여 스크롤을 관리하세요

요약

CSS overscroll-behavior 속성을 사용하면 개발자가 콘텐츠의 상단/하단에 도달할 때 브라우저의 기본 오버플로 스크롤 동작을 재정의할 수 있습니다. 사용 사례로는 모바일에서 풀-투-리프레시 기능을 사용 중지하고, 오버스크롤 글로우 및 러버밴딩 효과를 삭제하고, 페이지 콘텐츠가 모달/오버레이 아래에 있을 때 스크롤되지 않도록 하는 것이 있습니다.

배경

스크롤 경계 및 스크롤 체이닝

Chrome Android에서 스크롤 체이닝

스크롤은 페이지와 상호작용하는 가장 기본적인 방법 중 하나이지만 브라우저의 독특한 기본 동작으로 인해 특정 UX 패턴을 처리하기가 까다로울 수 있습니다. 예를 들어 사용자가 스크롤해야 할 수 있는 항목이 많은 앱 드로어를 생각해 보세요. 맨 아래에 도달하면 더 이상 사용할 콘텐츠가 없으므로 오버플로 컨테이너의 스크롤이 중지됩니다. 즉, 사용자가 '스크롤 경계'에 도달합니다. 하지만 사용자가 계속 스크롤하면 어떻게 되는지 확인해 보세요. 뒤에 있는 콘텐츠가 스크롤되기 시작합니다. 스크롤은 상위 컨테이너가 인계받습니다(위 예에서는 기본 페이지 자체).

이 동작을 스크롤 체이닝이라고 합니다. 콘텐츠를 스크롤할 때 브라우저의 기본 동작입니다. 기본값이 꽤 좋은 경우가 많지만 바람직하지 않거나 예상치 못한 경우도 있습니다. 특정 앱에서는 사용자가 스크롤 경계를 칠 때 다른 사용자 환경을 제공할 수 있습니다.

풀-투-리프레시 효과

스크롤하여 새로고침은 Facebook 및 트위터와 같은 모바일 앱에서 대중화된 직관적인 동작입니다. 소셜 피드를 내리고 손을 떼면 최신 게시물을 로드할 공간이 새로 만들어집니다. 실제로 이 특정 UX가 많이 사용되어 Android의 Chrome과 같은 모바일 브라우저도 동일한 효과를 도입했습니다. 페이지 상단에서 아래로 스와이프하면 전체 페이지가 새로고침됩니다.

트위터의 PWA에서 피드를 새로고침할 때
트위터의 커스텀 당겨서 새로고침
Chrome Android의 기본 풀-투-리프레시 작업은
전체 페이지를 새로고침합니다.

트위터 PWA와 같은 경우에는 기본 풀-투-리프레시 작업을 사용 중지하는 것이 좋습니다. 왜냐하면 이 앱에서는 사용자가 실수로 페이지를 새로고침하는 것을 원하지 않을 수 있습니다. 새로고침 애니메이션이 두 번 표시될 수도 있습니다. 또는 브라우저의 작업을 맞춤설정하여 사이트의 브랜딩에 더 적합하게 조정하는 것이 좋습니다. 안타깝게도 이러한 유형의 맞춤설정은 실행하기가 쉽지 않습니다. 개발자는 불필요한 JavaScript를 작성하거나, 스크롤을 차단하는 비패시브 터치 리스너를 추가하거나, 페이지가 오버플로되지 않도록 전체 페이지를 100vw/vh <div>에 고정합니다. 이러한 해결 방법은 스크롤 성능에 관한 부정적인 영향을 잘 문서화되어 있습니다.

더 나은 서비스를 제공할 수 있습니다.

overscroll-behavior 소개

overscroll-behavior 속성은 컨테이너 (페이지 자체 포함)를 오버스크롤할 때 발생하는 동작을 제어하는 새로운 CSS 기능입니다. 이를 사용하여 스크롤 체이닝을 취소하고, 당겨 새로고침 작업을 사용 중지/맞춤설정하고, iOS에서 러버밴딩 효과를 사용 중지할 수 있습니다 (Safari에서 overscroll-behavior를 구현하는 경우). 가장 좋은 점은 overscroll-behavior를 사용해도 인트로에 언급된 해킹과 달리 페이지 성능에 악영향을 미치지 않는다는 것입니다.

이 속성은 다음 세 가지 값을 사용할 수 있습니다.

  1. auto: 기본값입니다. 요소에서 발생한 스크롤은 상위 요소로 전파될 수 있습니다.
  2. contain: 스크롤 체이닝을 방지합니다. 스크롤은 상위 요소로 전파되지 않지만 노드 내의 로컬 효과는 표시됩니다. 예를 들어 Android의 오버스크롤 글로우 효과나 iOS의 러버밴딩 효과는 사용자가 스크롤 경계에 도달했을 때 사용자에게 알립니다. 참고: html 요소에서 overscroll-behavior: contain를 사용하면 오버스크롤 탐색 작업이 방지됩니다.
  3. none - contain과 동일하지만 노드 자체 내의 오버스크롤 효과 (예: Android 오버스크롤 발광 또는 iOS 고무밴딩)도 방지합니다.

overscroll-behavior 사용 방법을 알아보기 위해 몇 가지 예를 살펴보겠습니다.

스크롤이 고정된 위치 요소를 벗어나지 않도록 방지

채팅 상자 시나리오

채팅 창 아래의 콘텐츠도 스크롤됨 :(

페이지 하단에 고정된 채팅창을 예로 들 수 있습니다. 채팅창이 독립형 구성요소이며 뒤에 있는 콘텐츠와 별도로 스크롤되도록 하기 위함입니다. 그러나 스크롤 체인으로 인해 사용자가 채팅 기록에서 마지막 메시지를 조회하자마자 문서가 스크롤되기 시작합니다.

이 앱의 경우 채팅창 내에서 시작된 스크롤이 채팅 내에서 유지되는 것이 더 적절합니다. 채팅 메시지를 보유한 요소에 overscroll-behavior: contain를 추가하면 됩니다.

#chat .msgs {
  overflow: auto;
  overscroll-behavior: contain;
  height: 300px;
}

기본적으로 채팅창의 스크롤 컨텍스트와 기본 페이지를 논리적으로 분리합니다. 결과적으로 사용자가 채팅 기록의 상단/하단에 도달해도 기본 페이지가 유지됩니다. 채팅창에서 시작된 스크롤은 외부로 전파되지 않습니다.

페이지 오버레이 시나리오

'아래 스크롤' 시나리오의 또 다른 변형은 고정된 위치 오버레이 뒤에서 스크롤되는 콘텐츠가 표시되는 경우입니다. 확실한 증거가 있으니 overscroll-behavior를 받으세요. 브라우저가 도움을 주려고 하지만 결국 사이트가 버그가 있는 것처럼 보입니다.

- overscroll-behavior: contain 유무와 관계없는 모달

이전: 페이지 콘텐츠가 오버레이 아래로 스크롤됩니다.
이후: 페이지 콘텐츠가 오버레이 아래로 스크롤되지 않습니다.

당겨서 새로고침 사용 중지

스크롤하여 새로고침 작업을 사용 중지하는 것은 CSS 한 줄이면 됩니다. 전체 뷰포인트 정의 요소에서 스크롤 체이닝을 방지하기만 하면 됩니다. 대부분의 경우 <html> 또는 <body>입니다.

body {
  /* Disables pull-to-refresh but allows overscroll glow effects. */
  overscroll-behavior-y: contain;
}

이렇게 간단하게 추가하면 채팅창 데모에서 두 번의 당겨 새로고침 애니메이션을 수정하고 더 깔끔한 로드 애니메이션을 사용하는 맞춤 효과를 구현할 수 있습니다. 받은편지함이 새로고침될 때 전체 받은편지함도 흐리게 표시됩니다.

이전
이후

다음은 전체 코드의 스니펫입니다.

<style>
  body.refreshing #inbox {
    filter: blur(1px);
    touch-action: none; /* prevent scrolling */
  }
  body.refreshing .refresher {
    transform: translate3d(0,150%,0) scale(1);
    z-index: 1;
  }
  .refresher {
    --refresh-width: 55px;
    pointer-events: none;
    width: var(--refresh-width);
    height: var(--refresh-width);
    border-radius: 50%;
    position: absolute;
    transition: all 300ms cubic-bezier(0,0,0.2,1);
    will-change: transform, opacity;
    ...
  }
</style>

<div class="refresher">
  <div class="loading-bar"></div>
  <div class="loading-bar"></div>
  <div class="loading-bar"></div>
  <div class="loading-bar"></div>
</div>

<section id="inbox"><!-- msgs --></section>

<script>
  let _startY;
  const inbox = document.querySelector('#inbox');

  inbox.addEventListener('touchstart', e => {
    _startY = e.touches[0].pageY;
  }, {passive: true});

  inbox.addEventListener('touchmove', e => {
    const y = e.touches[0].pageY;
    // Activate custom pull-to-refresh effects when at the top of the container
    // and user is scrolling up.
    if (document.scrollingElement.scrollTop === 0 && y > _startY &&
        !document.body.classList.contains('refreshing')) {
      // refresh inbox.
    }
  }, {passive: true});
</script>

오버스크롤 발광 및 고무밴딩 효과 사용 중지

스크롤 경계에 도달할 때의 반동 효과를 사용 중지하려면 overscroll-behavior-y: none를 사용합니다.

body {
  /* Disables pull-to-refresh and overscroll glow effect.
     Still keeps swipe navigations. */
  overscroll-behavior-y: none;
}
이전: 스크롤 경계에 도달하면 글로우가 표시됩니다.
이후: 발광이 사용 중지됩니다.

전체 데모

종합해보면, 전체 채팅 상자 데모에서는 overscroll-behavior를 사용하여 맞춤 당겨서 새로고침 애니메이션을 만들고 스크롤이 채팅 상자 위젯을 이스케이프하지 않도록 합니다. 이렇게 하면 CSS overscroll-behavior 없이는 달성하기 어려운 최적의 사용자 환경을 제공할 수 있습니다.

데모 보기 | 소스