SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 앱에 태블릿 터치 UI 스프레드시트 구현하기

웹 프론트엔드 개발자라면 "이 화면, 태블릿에서도 잘 되나요?"라는 요구사항을 받아본 적이 있을 겁니다. 반응형 레이아웃이야 CSS 미디어 쿼리로 처리할 수 있지만, 스프레드시트 형태의 UI는 셀 선택, 핀치줌, 소프트 키보드 충돌 같은 터치 환경 고유의 문제가 따라옵니다. SpreadJS(스프레드JS)는 MESCIUS가 개발한 고성능 JavaScript 스프레드시트 라이브러리로, 별도 모바일 빌드 없이 단일 코드베이스에서 데스크톱과 태블릿 UI를 동시에 구현할 수 있습니다.

PC용으로 만든 스프레드시트 화면을 태블릿에서 그대로 열면 여러 문제가 생깁니다. 셀 크기가 작아 손가락 탭이 빗나가기 쉽고, 두 손가락으로 핀치해도 아무 반응이 없으며, 가상 키보드가 하단에서 올라오는 순간 콘텐츠 영역이 밀려 레이아웃이 깨집니다. 이를 해결하기 위해 모바일 전용 페이지를 별도로 만들면 코드베이스가 두 개로 나뉘어 유지보수 부담이 커집니다.

SpreadJS는 useTouchLayout 옵션 하나로 터치 친화적인 UI로 즉시 전환되며, 핀치줌·스와이프 스크롤·터치 컨텍스트 툴바(TouchToolStrip)가 기본 내장되어 있습니다. 소프트 키보드 대응을 위한 visualViewport + spread.refresh() 패턴과 CSS 한 줄로 조정 가능한 셀 핸들 크기 API까지 갖추고 있어, React·Vue·Angular·Vanilla JS 어떤 환경에서도 추가 라이브러리 없이 완성도 높은 태블릿 앱을 구현할 수 있습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 spread.options.useTouchLayout = true 한 줄 설정만으로 셀 핸들·탭스트립 등 모든 UI 요소가 터치 조작에 최적화된 크기로 전환됩니다
02 핀치줌·스와이프 스크롤·터치 툴바(TouchToolStrip)가 기본 내장되어 있어 외부 라이브러리를 추가할 필요가 없습니다
03 CSS 한 줄로 셀 선택 핸들 크기를 손가락 조작에 맞게 자유롭게 조정할 수 있습니다
04 visualViewport + spread.refresh() 패턴으로 소프트 키보드 표시와 화면 회전을 간단하게 대응합니다
SpreadJS로 웹 앱에 태블릿 터치 UI 스프레드시트 구현하기 — 대표 이미지

useTouchLayout 옵션으로 터치 레이아웃을 활성화하는 방법

SpreadJS는 터치 입력이 감지되는 환경에서 탭·더블탭·드래그·스와이프·핀치 제스처를 자동으로 인식합니다. 여기에 useTouchLayout 옵션을 추가하면 셀 선택 핸들, 탭 스트립, 툴바 등의 시각 요소가 손가락 조작에 최적화된 크기로 전환됩니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
💡 TIP
useTouchLayout 은 터치 환경을 자동 감지하지 않습니다. 태블릿 전용 페이지라면 조건 없이 true 로 고정하고, 데스크톱과 공용이라면 'ontouchstart' in window 분기로 선택적으로 적용하세요.
↗
5가지
내장 터치 제스처
탭·더블탭·드래그·스와이프·핀치
↗
옵션 1줄
터치 레이아웃 전환
별도 모바일 빌드 불필요
↗
8~32px
핸들 크기 범위
CSS 한 줄로 조정

핀치줌과 TouchToolStrip을 내 앱에 맞게 설정하는 방법

SpreadJS의 터치 툴바는 셀을 탭으로 선택한 뒤 한 번 더 탭하면 나타납니다. 잘라내기·복사·붙여넣기가 기본 항목으로 제공되며, TouchToolStripItem 으로 비즈니스 로직에 맞는 커스텀 액션을 추가할 수 있습니다. 핀치줌은 두 손가락을 오므리거나 벌리기만 하면 별도 설정 없이 동작합니다.

핀치줌과 TouchToolStrip을 내 앱에 맞게 설정하는 방법 — SpreadJS 개념도

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
ⓘ NOTE
TouchToolStripItem 생성자는 (name, displayText, image, callback) 형태입니다. image 는 아이콘 경로(또는 data URI) 문자열이며 생략할 수 없습니다 — 콜백 함수는 4번째 인자로 전달해야 합니다. spread.touchToolStrip.itemHeight(60) / .itemWidth(70) 으로 버튼 크기도 조정 가능합니다.

손가락으로 셀을 더 쉽게 선택하도록 핸들 크기 조정하기

SpreadJS의 터치 선택 핸들(파란 동그라미)은 CSS 한 줄로 크기를 변경할 수 있습니다. 기본값 16px는 정밀 드래그에 불편할 수 있으므로, 태블릿 환경에서는 20~24px로 키우는 것을 권장합니다.

⭐ BEST PRACTICE
iOS Human Interface Guidelines는 탭 가능한 최소 영역을 44×44pt로 권장합니다. 핸들을 24px로 설정하면 오차 범위 내에서 이 기준을 충족하며, 범위 선택 시 시작·끝 핸들을 정확하게 잡을 수 있습니다.

소프트 키보드가 올라왔을 때 스프레드시트 레이아웃을 유지하는 방법

태블릿에서 셀을 더블탭해 편집 모드에 진입하면 소프트 키보드가 올라와 visualViewport 높이가 줄어듭니다. 스프레드시트 컨테이너가 이를 감지하지 못하면 셀 위치와 스크롤이 틀어질 수 있습니다. visualViewport.resize 이벤트와 spread.refresh() 를 조합하면 키보드 등장·소멸 시 레이아웃을 즉시 복원할 수 있습니다. 화면 회전이나 분할화면 전환 같은 컨테이너 크기 변화는 ResizeObserver 로 대응합니다.

소프트 키보드가 올라왔을 때 스프레드시트 레이아웃을 유지하는 방법 — SpreadJS 개념도

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
⚠ WARNING
window.resize 는 iOS Safari에서 소프트 키보드 팝업을 항상 감지하지 못합니다. window.visualViewport.resize 를 사용해야 iOS와 Android Chrome 모두에서 안정적으로 동작합니다.

현장 데이터 입력 폼을 보호 시트와 CellChanged 이벤트로 구현하기

태블릿 현장 앱의 핵심 요건은 "입력 가능한 셀은 터치로 편집, 나머지 셀은 보호"입니다. isProtected + 셀 잠금 해제 + CellChanged 이벤트를 조합하면 재고 입력, 점검 리포트, ERP 현장 조회 화면을 깔끔하게 구현할 수 있습니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
⭐ IMPORTANT
isProtected=true 상태에서는 RangeChanged 이벤트가 작동하지 않을 수 있습니다. CellChanged + propertyName === 'value' 패턴이 보호된 시트에서 값 변경을 감지하는 안정적인 방법입니다.

개발자들이 자주 묻는 질문

Q01

JavaScript로 웹 스프레드시트에 터치 스크롤과 핀치줌을 구현하려면 어떻게 해야 하나요?

SpreadJS를 사용하면 spread.options.useTouchLayout = true 한 줄만 추가하는 것으로 터치 스크롤과 핀치줌이 즉시 활성화됩니다. 별도의 이벤트 핸들러를 작성하거나 외부 터치 라이브러리를 설치할 필요가 없습니다.

Q02

웹 앱에서 태블릿 친화적인 엑셀 같은 UI를 만들 때 사용할 수 있는 JavaScript 라이브러리는 무엇인가요?

SpreadJS(by MESCIUS)는 핀치줌·소프트 키보드 대응·셀 핸들 크기 조정 기능을 기본으로 내장합니다. 별도의 모바일 버전 없이 하나의 코드베이스로 데스크톱과 태블릿을 동시에 지원합니다.

Q03

SpreadJS에서 모바일 터치 이벤트를 켜려면 어떻게 하나요?

SpreadJS는 터치 환경을 자동으로 인식해 탭·핀치·스와이프 제스처를 처리합니다. 여기에 spread.options.useTouchLayout = true 를 설정하면 셀 핸들·탭스트립 등 UI 요소가 터치에 최적화된 크기로 변경되어 손가락 조작이 훨씬 편리해집니다.

Q04

모바일 화면에서 스프레드시트 셀 선택이 잘 안 될 때 어떻게 해결하나요?

CSS에서 .sjs-touch-selection-indicator { width: 22px; } 를 추가하면 셀 선택 핸들 크기를 늘릴 수 있습니다. 기본값인 16px는 소형 화면에서 정밀 탭이 어려울 수 있으며, 8~32px 범위 내에서 원하는 값으로 자유롭게 조정할 수 있습니다.

Q05

Handsontable과 SpreadJS를 모바일·터치 지원 측면에서 비교하면 어떤 차이가 있나요?

Handsontable은 기본 터치 지원이 제한적이며 핀치줌과 터치 컨텍스트 툴바(TouchToolStrip)를 공식 지원하지 않습니다. SpreadJS는 핀치줌·스와이프 스크롤·TouchToolStrip·소프트 키보드 대응을 모두 기본으로 내장하여, 추가 의존성 없이 엔터프라이즈 수준의 터치 UI를 제공합니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드