웹 앱에서 SpreadJS 셀 보호와 편집 권한 설정하는 방법
React·Vue·Angular 같은 프레임워크로 웹 앱을 개발하다 보면 "결재 양식에서 금액 셀만 수정 가능하게 해주세요" 같은 요구사항을 마주치는 경우가 있습니다. SpreadJS는 MESCIUS가 개발한 엔터프라이즈 JavaScript 스프레드시트 라이브러리로, sheet.protect()
와 style.locked
API를 통해 웹 브라우저에서 Excel 수준의 셀·시트 잠금과 역할별 편집 권한 제어를 순수 JavaScript로 구현할 수 있습니다.
Excel에서는 셀 서식 대화상자의 보호 탭에서 클릭 몇 번으로 셀을 잠글 수 있지만, 웹 앱에서 같은 동작을 직접 구현하려면 어디서 시작해야 할지 막막할 수 있습니다. SpreadJS는 이 과정을 setDefaultStyle(locked: true)
로 전체를 먼저 잠근 뒤 편집을 허용할 셀에만 .locked(false)
를 적용하는 두 단계 패턴으로 단순화합니다.
이 가이드에서는 결재 시스템·ERP처럼 역할(관리자/일반 사용자)에 따라 편집 가능한 셀이 달라지는 실무 시나리오를 중심으로, 셀·시트 잠금 기초부터 비밀번호 보호, 보호 상태의 이벤트 처리, 수식 숨김까지 VanillaJS 코드로 단계별로 살펴봅니다.
sheet.options.isProtected = true
로 시트 전체를 보호하고, style.locked = false
를 지정한 셀만 선택적으로 편집 허용하는 Excel 동일 방식
sheet.protect(password)
/ sheet.unprotect(password)
로 비밀번호 기반 잠금을 설정해 역할에 따라 코드로 보호를 해제·재설정
RangeChanged
이벤트가 발생하지 않는 문제는 CellChanged
+ propertyName === 'value'
+ suspendEvent()
패턴으로 해결
style.hidden = true
로 셀 수식을 보이지 않게 설정해 비즈니스 로직을 보호하는 수식 숨김(formula hidden) 실무 패턴

JavaScript 웹 앱에서 SpreadJS로 시트 보호를 구현하는 방법
SpreadJS는 sheet.options.isProtected = true
로 시트를 보호하면 모든 셀이 잠금 상태가 되어 사용자가 값을 수정할 수 없습니다. 핵심 패턴은 두 단계입니다: ① 시트 전체를 보호하고, ② 편집을 허용할 셀에만 locked = false
를 설정하는 것입니다.
이 방식은 Excel의 "셀 서식 → 보호 탭 → 잠금 해제 → 시트 보호" 흐름과 정확히 동일합니다. SpreadJS는 이를 프로그래밍 방식으로 제어해 동적인 권한 구성이 가능합니다.
STEP 1: 라이브러리 참조
STEP 2: HTML 구조 (결재 요청서)
STEP 3: JavaScript — 결재 요청서 선택적 셀 잠금
setDefaultStyle(locked: true)
로 전체를 먼저 잠근 뒤 허용 셀에만 .locked(false)
를 적용합니다. 반대로 setDefaultStyle(locked: false)
으로 전체를 해제한 뒤 잠글 셀에만 .locked(true)
를 적용하는 역방향 패턴도 동일하게 동작합니다.
allowSort
, allowFilter
등 protectionOptions
는 UI 컨텍스트 메뉴에만 적용됩니다. 코드에서 직접 API를 호출하면 보호 여부와 관계없이 동작합니다.

사용자 역할에 따라 편집 가능 셀을 다르게 제어하는 방법
SpreadJS는 별도의 범위 지정 API 없이, sheet.getRange().locked()
로 역할마다 다른 범위를 동적으로 잠그고 해제하는 방식으로 역할별 편집 권한을 구현합니다. 실무에서는 sheet.protect(password)
/ sheet.unprotect(password)
와 동적 잠금 제어를 조합해 로그인한 사용자의 역할에 따라 편집 가능 범위를 실시간으로 전환합니다.
STEP 2: HTML
STEP 3: JavaScript — 역할별 편집 권한 (예산 관리 시트)
sheet.protect(password)
로 클라이언트 보호를 설정하더라도, 브라우저 개발자 도구를 통해 코드를 실행하면 비밀번호를 우회할 수 있습니다. 서버 측 API에서도 반드시 권한을 검증해야 완전한 보안이 보장됩니다.

셀 보호 활성화 후 값 변경 이벤트가 작동하지 않을 때 해결하는 방법
보호된 시트에서 값 변경을 감지하는 방법을 알아봅니다. 잠금 해제 셀에 값을 입력하면 CellChanged
이벤트는 정상 발생하지만, RangeChanged
는 보호된 시트에서 발생하지 않습니다.
올바른 패턴: CellChanged
+ args.propertyName === 'value'
필터 + 핸들러 내부 setValue 시 spread.suspendEvent()
/ spread.resumeEvent()
사용.
STEP 2: HTML
STEP 3: JavaScript — CellChanged 이벤트 + suspendEvent 패턴
spread.suspendEvent()
없이 이벤트 핸들러 내부에서 sheet.setValue()
를 호출하면 CellChanged가 재귀적으로 무한 발생합니다. suspendEvent()
→ 처리 → resumeEvent()
순서를 반드시 지키세요.
args.propertyName
에는 'value'
외에도 'style'
, 'formula'
, 'comment'
등이 올 수 있습니다. 값 변경만 처리하려면 반드시 === 'value'
필터를 추가해야 합니다.웹 스프레드시트에서 수식을 숨겨 비즈니스 로직을 보호하는 방법
인사 평가·인센티브 계산처럼 계산 공식 자체가 영업 비밀인 경우, style.hidden = true
로 수식을 숨길 수 있습니다. isProtected = true
상태에서만 효과가 있으며, 수식 입력줄에 아무것도 표시되지 않습니다.
STEP 2: HTML
STEP 3: JavaScript — style.hidden으로 수식 숨김
style.hidden = true
는 sheet.options.isProtected = true
상태에서만 효과가 있습니다. 보호를 해제하면 수식이 다시 표시됩니다. 수식을 완전히 보호하려면 hidden: true
와 locked: true
를 함께 사용하세요.protectionOptions로 열·행 단위 잠금을 세밀하게 제어하는 방법
행/열 단위로 잠금을 적용하거나 세부 보호 옵션을 조합하면 실무 요건을 정밀하게 충족할 수 있습니다.
allowSort: true, allowFilter: true
를 유지하면서 데이터 편집만 차단하는 것이 사용성과 보안의 균형점입니다. 결재 완료 시 sheet.protect(adminPassword)
로 잠근 뒤 공람자가 데이터를 정렬/필터링할 수 있도록 허용하는 패턴이 실무에 적합합니다.SpreadJS 셀 보호 개발자 FAQ
JavaScript 스프레드시트에서 특정 셀만 사용자가 입력할 수 있게 제한하려면 어떻게 하나요?
SpreadJS에서는 sheet.protect()
로 시트를 잠근 뒤 편집을 허용할 셀에만 style.locked=false
를 설정하면 됩니다. 가장 일반적인 방법은 setDefaultStyle()
로 전체 셀을 먼저 잠금 처리한 뒤 허용 셀에만 .locked(false)
를 적용하는 패턴으로, Excel의 선택적 편집 보호와 동일하게 동작합니다.
로그인한 사용자의 역할(관리자/일반 사용자)에 따라 편집 가능한 셀 범위를 다르게 적용할 수 있나요?
SpreadJS는 별도의 권한 범위 API 없이 sheet.getRange().locked()
로 역할마다 다른 셀 범위의 잠금 상태를 동적으로 전환합니다. 로그인 역할( role
)에 따라 sheet.protect()
와 동적 locked()
설정을 조합하면 관리자와 일반 사용자가 접근할 수 있는 편집 영역을 실시간으로 전환할 수 있습니다.
SpreadJS에서 `sheet.protect()`와 `isProtected`는 어떻게 다른가요? 비밀번호 없이도 시트를 보호할 수 있나요?
sheet.options.isProtected = true
는 비밀번호 없이 시트를 즉시 보호하며, sheet.options.isProtected = false
로 간단히 해제할 수 있습니다. 반면 sheet.protect(password)
는 비밀번호를 등록해 sheet.unprotect(password)
없이는 보호를 풀 수 없게 합니다. 비밀번호 설정 여부는 sheet.hasPassword()
로 확인할 수 있습니다.
셀 보호를 활성화했더니 값이 바뀌어도 이벤트가 발생하지 않아요. 어떻게 해결하나요?
보호된 시트에서는 RangeChanged
이벤트가 발생하지 않습니다. 대신 CellChanged
이벤트에서 args.propertyName === 'value'
조건으로 필터링하면 값 변경을 정상적으로 감지할 수 있습니다. 이벤트 핸들러 안에서 setValue()
를 호출할 때는 반드시 spread.suspendEvent()
/ spread.resumeEvent()
로 재귀 이벤트를 차단해야 합니다.
웹 개발에서 Excel처럼 시트 보호와 비밀번호 잠금을 지원하는 JavaScript 라이브러리가 있나요?
SpreadJS(스프레드JS) by MESCIUS는 Excel과 동일한 셀·시트 보호, 비밀번호 잠금, 역할별 편집 권한을 VanillaJS로 구현할 수 있는 엔터프라이즈 JavaScript 스프레드시트 라이브러리입니다. sheet.protect()
, style.locked
, protectionOptions
의 조합으로 ERP·결재 시스템 수준의 셀 보호를 코드로 완전히 제어할 수 있습니다.
