SpreadJS 블로그 MESCIUS 기술 블로그 ·

웹 앱에서 SpreadJS 셀 보호와 편집 권한 설정하는 방법

React·Vue·Angular 같은 프레임워크로 웹 앱을 개발하다 보면 "결재 양식에서 금액 셀만 수정 가능하게 해주세요" 같은 요구사항을 마주치는 경우가 있습니다. SpreadJS는 MESCIUS가 개발한 엔터프라이즈 JavaScript 스프레드시트 라이브러리로, sheet.protect() 와 style.locked API를 통해 웹 브라우저에서 Excel 수준의 셀·시트 잠금과 역할별 편집 권한 제어를 순수 JavaScript로 구현할 수 있습니다.

Excel에서는 셀 서식 대화상자의 보호 탭에서 클릭 몇 번으로 셀을 잠글 수 있지만, 웹 앱에서 같은 동작을 직접 구현하려면 어디서 시작해야 할지 막막할 수 있습니다. SpreadJS는 이 과정을 setDefaultStyle(locked: true) 로 전체를 먼저 잠근 뒤 편집을 허용할 셀에만 .locked(false) 를 적용하는 두 단계 패턴으로 단순화합니다.

이 가이드에서는 결재 시스템·ERP처럼 역할(관리자/일반 사용자)에 따라 편집 가능한 셀이 달라지는 실무 시나리오를 중심으로, 셀·시트 잠금 기초부터 비밀번호 보호, 보호 상태의 이벤트 처리, 수식 숨김까지 VanillaJS 코드로 단계별로 살펴봅니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 시트 잠금 패턴: sheet.options.isProtected = true 로 시트 전체를 보호하고, style.locked = false 를 지정한 셀만 선택적으로 편집 허용하는 Excel 동일 방식
02 비밀번호 보호: sheet.protect(password) / sheet.unprotect(password) 로 비밀번호 기반 잠금을 설정해 역할에 따라 코드로 보호를 해제·재설정
03 이벤트 대안: 보호된 시트에서 RangeChanged 이벤트가 발생하지 않는 문제는 CellChanged + propertyName === 'value' + suspendEvent() 패턴으로 해결
04 수식 숨김: style.hidden = true 로 셀 수식을 보이지 않게 설정해 비즈니스 로직을 보호하는 수식 숨김(formula hidden) 실무 패턴
웹 앱에서 SpreadJS 셀 보호와 편집 권한 설정하는 방법 — 대표 이미지

JavaScript 웹 앱에서 SpreadJS로 시트 보호를 구현하는 방법

SpreadJS는 sheet.options.isProtected = true 로 시트를 보호하면 모든 셀이 잠금 상태가 되어 사용자가 값을 수정할 수 없습니다. 핵심 패턴은 두 단계입니다: ① 시트 전체를 보호하고, ② 편집을 허용할 셀에만 locked = false 를 설정하는 것입니다.

이 방식은 Excel의 "셀 서식 → 보호 탭 → 잠금 해제 → 시트 보호" 흐름과 정확히 동일합니다. SpreadJS는 이를 프로그래밍 방식으로 제어해 동적인 권한 구성이 가능합니다.

STEP 1: 라이브러리 참조

STEP 2: HTML 구조 (결재 요청서)

STEP 3: JavaScript — 결재 요청서 선택적 셀 잠금

실행 결과
💡 TIP
핵심 패턴: setDefaultStyle(locked: true) 로 전체를 먼저 잠근 뒤 허용 셀에만 .locked(false) 를 적용합니다. 반대로 setDefaultStyle(locked: false) 으로 전체를 해제한 뒤 잠글 셀에만 .locked(true) 를 적용하는 역방향 패턴도 동일하게 동작합니다.
ⓘ NOTE
allowSort , allowFilter 등 protectionOptions 는 UI 컨텍스트 메뉴에만 적용됩니다. 코드에서 직접 API를 호출하면 보호 여부와 관계없이 동작합니다.
JavaScript 웹 앱에서 SpreadJS로 시트 보호를 구현하는 방법 — SpreadJS 개념도

사용자 역할에 따라 편집 가능 셀을 다르게 제어하는 방법

SpreadJS는 별도의 범위 지정 API 없이, sheet.getRange().locked() 로 역할마다 다른 범위를 동적으로 잠그고 해제하는 방식으로 역할별 편집 권한을 구현합니다. 실무에서는 sheet.protect(password) / sheet.unprotect(password) 와 동적 잠금 제어를 조합해 로그인한 사용자의 역할에 따라 편집 가능 범위를 실시간으로 전환합니다.

STEP 2: HTML

STEP 3: JavaScript — 역할별 편집 권한 (예산 관리 시트)

실행 결과
⭐ IMPORTANT
sheet.protect(password) 로 클라이언트 보호를 설정하더라도, 브라우저 개발자 도구를 통해 코드를 실행하면 비밀번호를 우회할 수 있습니다. 서버 측 API에서도 반드시 권한을 검증해야 완전한 보안이 보장됩니다.
사용자 역할에 따라 편집 가능 셀을 다르게 제어하는 방법 — SpreadJS 개념도

셀 보호 활성화 후 값 변경 이벤트가 작동하지 않을 때 해결하는 방법

보호된 시트에서 값 변경을 감지하는 방법을 알아봅니다. 잠금 해제 셀에 값을 입력하면 CellChanged 이벤트는 정상 발생하지만, RangeChanged 는 보호된 시트에서 발생하지 않습니다.

올바른 패턴: CellChanged + args.propertyName === 'value' 필터 + 핸들러 내부 setValue 시 spread.suspendEvent() / spread.resumeEvent() 사용.

STEP 2: HTML

STEP 3: JavaScript — CellChanged 이벤트 + suspendEvent 패턴

실행 결과
⚠ WARNING
spread.suspendEvent() 없이 이벤트 핸들러 내부에서 sheet.setValue() 를 호출하면 CellChanged가 재귀적으로 무한 발생합니다. suspendEvent() → 처리 → resumeEvent() 순서를 반드시 지키세요.
ⓘ NOTE
args.propertyName 에는 'value' 외에도 'style' , 'formula' , 'comment' 등이 올 수 있습니다. 값 변경만 처리하려면 반드시 === 'value' 필터를 추가해야 합니다.

웹 스프레드시트에서 수식을 숨겨 비즈니스 로직을 보호하는 방법

인사 평가·인센티브 계산처럼 계산 공식 자체가 영업 비밀인 경우, style.hidden = true 로 수식을 숨길 수 있습니다. isProtected = true 상태에서만 효과가 있으며, 수식 입력줄에 아무것도 표시되지 않습니다.

STEP 2: HTML

STEP 3: JavaScript — style.hidden으로 수식 숨김

실행 결과
💡 TIP
style.hidden = true 는 sheet.options.isProtected = true 상태에서만 효과가 있습니다. 보호를 해제하면 수식이 다시 표시됩니다. 수식을 완전히 보호하려면 hidden: true 와 locked: true 를 함께 사용하세요.

protectionOptions로 열·행 단위 잠금을 세밀하게 제어하는 방법

행/열 단위로 잠금을 적용하거나 세부 보호 옵션을 조합하면 실무 요건을 정밀하게 충족할 수 있습니다.

⭐ BEST PRACTICE
실무 결재 시스템에서는 allowSort: true, allowFilter: true 를 유지하면서 데이터 편집만 차단하는 것이 사용성과 보안의 균형점입니다. 결재 완료 시 sheet.protect(adminPassword) 로 잠근 뒤 공람자가 데이터를 정렬/필터링할 수 있도록 허용하는 패턴이 실무에 적합합니다.

SpreadJS 셀 보호 개발자 FAQ

Q01

JavaScript 스프레드시트에서 특정 셀만 사용자가 입력할 수 있게 제한하려면 어떻게 하나요?

SpreadJS에서는 sheet.protect() 로 시트를 잠근 뒤 편집을 허용할 셀에만 style.locked=false 를 설정하면 됩니다. 가장 일반적인 방법은 setDefaultStyle() 로 전체 셀을 먼저 잠금 처리한 뒤 허용 셀에만 .locked(false) 를 적용하는 패턴으로, Excel의 선택적 편집 보호와 동일하게 동작합니다.

Q02

로그인한 사용자의 역할(관리자/일반 사용자)에 따라 편집 가능한 셀 범위를 다르게 적용할 수 있나요?

SpreadJS는 별도의 권한 범위 API 없이 sheet.getRange().locked() 로 역할마다 다른 셀 범위의 잠금 상태를 동적으로 전환합니다. 로그인 역할( role )에 따라 sheet.protect() 와 동적 locked() 설정을 조합하면 관리자와 일반 사용자가 접근할 수 있는 편집 영역을 실시간으로 전환할 수 있습니다.

Q03

SpreadJS에서 `sheet.protect()`와 `isProtected`는 어떻게 다른가요? 비밀번호 없이도 시트를 보호할 수 있나요?

sheet.options.isProtected = true 는 비밀번호 없이 시트를 즉시 보호하며, sheet.options.isProtected = false 로 간단히 해제할 수 있습니다. 반면 sheet.protect(password) 는 비밀번호를 등록해 sheet.unprotect(password) 없이는 보호를 풀 수 없게 합니다. 비밀번호 설정 여부는 sheet.hasPassword() 로 확인할 수 있습니다.

Q04

셀 보호를 활성화했더니 값이 바뀌어도 이벤트가 발생하지 않아요. 어떻게 해결하나요?

보호된 시트에서는 RangeChanged 이벤트가 발생하지 않습니다. 대신 CellChanged 이벤트에서 args.propertyName === 'value' 조건으로 필터링하면 값 변경을 정상적으로 감지할 수 있습니다. 이벤트 핸들러 안에서 setValue() 를 호출할 때는 반드시 spread.suspendEvent() / spread.resumeEvent() 로 재귀 이벤트를 차단해야 합니다.

Q05

웹 개발에서 Excel처럼 시트 보호와 비밀번호 잠금을 지원하는 JavaScript 라이브러리가 있나요?

SpreadJS(스프레드JS) by MESCIUS는 Excel과 동일한 셀·시트 보호, 비밀번호 잠금, 역할별 편집 권한을 VanillaJS로 구현할 수 있는 엔터프라이즈 JavaScript 스프레드시트 라이브러리입니다. sheet.protect() , style.locked , protectionOptions 의 조합으로 ERP·결재 시스템 수준의 셀 보호를 코드로 완전히 제어할 수 있습니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드