SpreadJS로 병원 EMR 검사 결과 화면 개발하기
SpreadJS는 MESCIUS가 개발한 JavaScript 스프레드시트 컴포넌트로, 웹 애플리케이션 안에 Excel 수준의 조건부 서식·셀 보호·스파크라인·데이터 검증을 추가 라이브러리 없이 구현할 수 있도록 설계된 UI 솔루션입니다.
의료 EMR 또는 HIS 시스템을 웹으로 새로 개발하거나 기존 시스템을 리빌드하는 프로젝트를 맡았다면, 검사 수치 이상값 강조·환자 정보 보호·처방 드롭다운 검증을 단일 그리드 컴포넌트 안에서 동시에 처리해야 하는 요건과 마주칩니다. 일반 HTML 테이블이나 단순 그리드 라이브러리로는 이 요건들을 충족하려면 별도 플러그인이나 직접 구현이 필요한 경우가 많습니다.
이 글에서는 SpreadJS API를 사용해 비정상 수치 자동 강조, 편집 권한 분리, 추이 스파크라인, 드롭다운 입력 검증 네 가지를 단계별로 구현하는 방법을 소개합니다. React·Vue·Angular·Vanilla JS 어느 환경에서든 동일한 API를 사용할 수 있으며, 각 섹션의 코드 예제는 독립적으로 적용 가능합니다.

JavaScript로 이상 수치를 자동 강조하는 조건부 서식 구현하기
SpreadJS를 사용하면 조건부 서식·셀 보호·스파크라인 등 Excel 기능을 그대로 웹 EMR 화면에 구현할 수 있습니다. conditionalFormats.addCellValueRule()
API 한 줄로 정상 범위를 벗어난 검사 수치에 색상을 자동 적용합니다.
아래 데모는 혈당·크레아티닌·WBC 등 주요 검사 항목을 표시하고, 값이 상한 초과 또는 하한 미만이면 빨간색으로 자동 강조하는 EMR 검사 결과 화면입니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: JavaScript
addCellValueRule(operator, value1, value2, style, ranges)
순서를 지키세요. greaterThan
· lessThan
같은 단일 비교 연산자는 value2 자리에 value1과 동일한 값을 넣어도 정상 동작합니다. 항목마다 정상 범위가 다른 경우 위처럼 각 행에 개별 규칙을 추가하는 것이 가장 유연합니다.
특정 셀만 편집 가능하게 만드는 isProtected + locked 패턴
SpreadJS에서 isProtected와 style.locked=false 패턴으로 처방 입력 셀만 편집 허용하고 나머지 환자 정보를 읽기 전용으로 보호합니다. 적용 순서는 세 단계입니다.
- 01
setDefaultStyle로 전체 셀 잠금 해제(style.locked = false) - 02
보호할 환자 정보 영역만
CellRange.locked(true)로 재잠금 - 03
sheet.options.isProtected = true로 시트 보호 활성화
아래 데모에서 환자 기본 정보 영역(파란 헤더)은 클릭해도 편집이 불가하며, 처방 입력 영역(초록 헤더)은 셀 선택·입력·드롭다운이 모두 가능합니다.
setDefaultStyle(unlockStyle)
로 전체를 먼저 열지 않으면 SpreadJS 기본 동작이 모든 셀을 잠긴 상태( locked=true
)로 처리합니다. 기본 해제 후 보호 범위만 재잠금하는 이 패턴이 EMR처럼 혼용 구간이 복잡한 화면에서 가장 안정적입니다.setSparkline()으로 셀 안에 미니 추이 차트 그리는 방법
SpreadJS 스파크라인은 Line, Column, WinLoss, Area, Bullet, Scatter 등 15종 이상의 인셀 미니 차트 타입을 지원하며 setSparkline()
API로 코드 몇 줄로 추가할 수 있습니다. 다음 데모는 최근 7일간 혈당과 수축기 혈압 데이터를 행 방향으로 입력하고, 각각 Line 스파크라인으로 추이를 시각화합니다.
DataOrientation.horizontal
을 사용합니다. 열 방향(행을 세로로)이면 DataOrientation.vertical
을 쓰세요. showHigh
와 showLow
를 true
로 설정하면 최고·최저 포인트가 별도 색으로 자동 강조되어 이상 추이를 한눈에 파악할 수 있습니다.
createListValidator로 드롭다운 입력 유효성 검사 적용하기
createListValidator()
는 쉼표 구분 문자열을 드롭다운 목록으로 만들어 유효하지 않은 약품코드나 용량 단위 입력을 즉시 차단합니다. highlightInvalidData
옵션을 함께 활성화하면 직접 타이핑으로 잘못된 값을 입력했을 때 셀에 빨간색 타원(oval)이 표시됩니다.
,
)를 포함한 값을 목록 항목으로 쓰려면 \\,
로 이스케이프해야 합니다. 예시: "123\\,456,789\\,012"
→ "123,456"과 "789,012" 두 개 항목으로 인식됩니다.기존 Excel 파일을 웹 앱에서 그대로 여는 방법: IO 플러그인
병원에서 오랫동안 사용해온 Excel 검사 양식을 SpreadJS IO 플러그인으로 불러오면 셀 서식, 수식, 드롭다운 목록, 인쇄 영역 설정을 그대로 유지한 채 웹 화면에 즉시 표시할 수 있습니다.
sheet.options.isProtected = true
와 conditionalFormats.addCellValueRule()
을 JavaScript로 추가하면, 기존 양식 레이아웃을 유지하면서 웹 EMR에 필요한 입력 제어와 수치 자동 강조를 한 번에 적용할 수 있습니다.개발자 FAQ: 자주 하는 질문과 답변
웹에서 엑셀처럼 동작하는 EMR 검사 결과 화면을 만들려면 어떤 라이브러리를 써야 하나요?
SpreadJS를 사용하면 조건부 서식·셀 보호·스파크라인 등 Excel 기능을 웹 EMR 화면에 그대로 구현할 수 있습니다. 조건부 서식, 셀 보호, 스파크라인, 데이터 검증이 모두 API로 제공되므로 별도 라이브러리를 추가하지 않아도 의료 UI에 필요한 핵심 기능을 하나의 컴포넌트로 충족할 수 있습니다.
웹 앱에서 정상 범위를 벗어난 검사 수치를 자동으로 색상으로 표시하려면 어떻게 구현하나요?
SpreadJS의 CellValueRule 조건부 서식을 사용하면 정상 범위 밖의 검사 수치에 색상을 자동으로 적용할 수 있습니다. sheet.conditionalFormats.addCellValueRule(ComparisonOperators.greaterThan, upperLimit, upperLimit, redStyle, ranges)
처럼 항목별로 규칙을 추가하면, 정상 범위가 서로 다른 여러 검사 항목을 하나의 시트에서 동시에 관리할 수 있습니다.
SpreadJS에서 일부 셀만 편집 가능하게 하고 나머지를 읽기 전용으로 설정하는 방법은 무엇인가요?
isProtected와 style.locked=false 패턴을 순서에 맞게 적용하면 처방 입력 셀만 편집 허용하고 나머지 환자 정보를 읽기 전용으로 보호할 수 있습니다. setDefaultStyle
로 전체 셀 잠금을 먼저 해제한 뒤, 보호할 영역만 CellRange.locked(true)
로 재잠금하고, 마지막으로 sheet.options.isProtected = true
를 설정하는 세 단계 순서를 반드시 지켜야 합니다.
JavaScript로 셀 안에 혈당·혈압 같은 수치 추이를 보여주는 미니 차트를 넣을 수 있나요?
sheet.setSparkline(row, col, dataRange, DataOrientation.horizontal, SparklineType.line, setting)
을 호출하면 셀 안에 Line 스파크라인을 추가할 수 있습니다. showHigh
· showLow
옵션으로 최고·최저 포인트를 색으로 강조할 수 있으며, Bullet 타입으로 전환하면 목표 혈당 대비 실측값 달성률도 셀 내부에 표현할 수 있습니다.
기존에 사용하던 Excel 검사 양식 파일을 웹 EMR 화면으로 그대로 불러올 수 있나요?
SpreadJS IO 플러그인의 spread.import()
API를 사용하면 Excel(xlsx) 파일을 브라우저에서 직접 로드할 수 있습니다. 기존 셀 서식, 수식, 드롭다운 목록이 모두 유지되므로 재작업 없이 웹 EMR 화면으로 전환할 수 있으며, 로드 후 JavaScript로 조건부 서식과 보호 설정을 추가해 웹 전용 기능을 덧붙일 수 있습니다.
