Wijmo FlexGrid 인라인 편집 구현: isReadOnly·cellEditEnding 유효성 검사
별도의 팝업 폼 없이 표 셀을 바로 클릭해 데이터를 수정하는 인라인 편집(in-place editing)은 엔터프라이즈 웹 애플리케이션에서 업무 효율을 높이는 핵심 UX 패턴입니다. Wijmo FlexGrid는 isReadOnly
속성 기본값이 false
여서 별도 설정 없이 인라인 편집이 즉시 활성화되고, beginningEdit
· cellEditEnding
등 풍부한 이벤트로 편집 권한과 유효성 검사를 세밀하게 제어할 수 있어, 복잡한 업무 화면도 직관적으로 구현할 수 있습니다.
isReadOnly
속성의 기본값이 false
라서 별도 설정 없이도 그리드 전체에서 인라인 편집을 바로 사용할 수 있습니다. 편집을 막으려면 isReadOnly: true
를 지정합니다.isReadOnly
는 그리드·컬럼·행 세 단계에서 각각 독립적으로 편집 권한을 제어합니다.beginningEdit
이벤트에서 e.cancel = true
를 설정하면 조건에 맞는 셀만 동적으로 읽기 전용으로 만들 수 있습니다.cellEditEnding
이벤트에서 args.previousData
(이전 값)와 grid.activeEditor.value
(새 값)를 비교해 유효하지 않은 입력을 바로 차단합니다.args.stayInEditMode = true
를 함께 설정하면 잘못 입력한 뒤에도 편집 모드가 유지되어 사용자가 곧바로 값을 고칠 수 있습니다.셀 편집이 시작되고 끝나는 흐름 한눈에 보기
FlexGrid의 셀 편집은 Excel과 유사한 두 가지 모드로 동작합니다. **전체 편집 모드(Full-edit)**는 F2 키 또는 더블클릭으로 진입하며, 방향 키를 눌러도 편집 모드를 유지합니다. **빠른 편집 모드(Quick-edit)**는 셀에 바로 타이핑을 시작할 때 진입하며, 방향 키를 누르면 편집이 종료됩니다.
셀 편집의 전체 흐름은 다음과 같은 이벤트 체인으로 구성됩니다:
-
beginningEdit— 셀이 편집 모드로 진입하기 직전 발생.e.cancel = true로 편집 자체를 차단할 수 있습니다. -
prepareCellForEdit— 편집기 DOM이 준비된 직후 발생.grid.activeEditor로 편집 입력 요소에 접근해 커스텀 처리를 추가할 수 있습니다. -
cellEditEnding— 편집 완료 직전 발생.args.previousData와grid.activeEditor.value로 이전·신규 값을 비교해 유효성 검사를 수행합니다. -
cellEditEnded— 편집이 커밋되거나 취소된 후 발생. 변경 후 후처리 로직(로그, UI 갱신 등)에 사용합니다.

isReadOnly로 그리드·컬럼·행 단위 편집 권한 나누기
FlexGrid의 편집 권한은 세 가지 레벨에서 독립적으로 제어됩니다.
1. 그리드 레벨: isReadOnly
속성으로 그리드 전체를 제어합니다. 기본값은 false
(편집 가능)이므로, 그리드를 완전히 읽기 전용으로 만들고 싶을 때는 isReadOnly: true
를 설정합니다.
2. 컬럼 레벨: 각 컬럼 정의에 isReadOnly: true
를 설정해 해당 컬럼만 편집 불가로 지정합니다. ID처럼 수정해서는 안 되는 고정 필드에 적용합니다.
3. 행/셀 레벨(동적): beginningEdit
이벤트에서 행 데이터를 확인하고 e.cancel = true
로 특정 행의 편집을 동적으로 차단합니다. 예를 들어 "완료" 상태인 행은 수정을 막는 패턴이 대표적입니다.

컬럼의 isRequired
속성도 활용할 수 있습니다. 기본값은 null
로, 숫자·날짜·불리언은 필수이고 문자열은 빈 값을 허용합니다. isRequired: true
로 설정하면 빈 값 입력 자체를 막습니다.
예제 1: 컬럼별로 편집 가능 여부를 다르게 설정하기
판매 데이터를 표시하는 그리드에서 ID·상태 컬럼은 읽기 전용으로 고정하고, "완료" 상태의 행은 beginningEdit
이벤트로 동적으로 편집을 막는 예제입니다.
STEP 1: 라이브러리 참조 (CDN)
FlexGrid 그리드만 사용하므로 wijmo.min.js
(코어)와 wijmo.grid.min.js
만 로드합니다. 한국어 로캘 적용을 위해 wijmo.culture.ko.min.js
도 함께 포함합니다.
STEP 2: HTML 컨테이너 준비
STEP 3: 데이터와 그리드 초기화
STEP 4: 완성 — beginningEdit으로 조건부 셀 잠금
위 라이브 데모에서 직접 확인해보세요. "진행중" 행은 담당자·카테고리·매출액을 자유롭게 편집할 수 있고, "완료" 행을 클릭하면 편집이 차단되면서 안내 메시지가 표시됩니다. isReadOnly
기본값( false
)으로 그리드 전체 편집이 허용된 상태에서, ID·상태 컬럼은 isReadOnly: true
로 고정하고, beginningEdit
핸들러에서 행 상태를 확인해 "완료" 행 전체를 잠그는 방식입니다.
예제 2: 입력값을 즉시 검증하는 cellEditEnding 유효성 검사
cellEditEnding
이벤트는 편집이 완료되기 직전에 발생합니다. 이 시점에 args.previousData
(편집 전 값)와 grid.activeEditor.value
(사용자가 입력한 새 값)를 비교해, 유효하지 않은 값이면 args.cancel = true
+ args.stayInEditMode = true
로 편집 모드를 유지하며 오류를 즉시 알릴 수 있습니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 컨테이너 준비
STEP 3: 데이터와 그리드 초기화
STEP 4: 완성 — 잘못된 입력 차단하고 편집 유지
위 라이브 데모에서 수량·단가·할인율 셀을 편집해보세요. 수량에 0이나 소수를 입력하거나, 단가에 음수를, 할인율에 100을 초과하는 값을 입력하면 cellEditEnding
이벤트가 발동해 편집 모드를 유지한 채 오류 메시지를 표시합니다. args.previousData
는 이전 값(커밋 전 원본 데이터)이고, sender.activeEditor.value
는 현재 편집기의 문자열 값이므로, 두 값을 비교하거나 새 값만 독립적으로 검증할 수 있습니다.
AG Grid와 비교: FlexGrid 편집 방식의 차이점
AG Grid Community 버전도 기본 셀 편집을 지원하지만, 컬럼별로 cellEditor
컴포넌트를 별도 정의해야 하고, 유효성 검사도 valueSetter
+ valueParser
콜백 조합이 필요합니다. Wijmo FlexGrid는 데이터 타입을 자동 감지해 숫자·날짜·불리언 에디터를 즉시 활성화하므로, 별도의 에디터 컴포넌트 없이도 대부분의 업무 시나리오를 처리할 수 있습니다.
또한 국내에서 많이 사용되는 RealGrid, IBSheet 등과 비교해도, FlexGrid의 beginningEdit
/ cellEditEnding
이벤트 기반 유효성 검사 패턴은 콜백 설계가 일관되어 팀 내 표준 코드 패턴으로 정착시키기 용이합니다.
startEditing(fullEdit, r, c)
메서드로 프로그래밍 방식의 편집 진입도 지원합니다. 예를 들어 버튼 클릭 시 특정 셀을 자동으로 편집 모드로 전환할 수 있습니다:
자주 묻는 질문 (FAQ)
FlexGrid에서 인라인 편집을 켜려면 어떻게 하나요?
isReadOnly
속성의 기본값이 false
이므로 별도 설정 없이 바로 셀 편집이 가능합니다. 편집을 막으려면 grid.isReadOnly = true
를, 다시 허용하려면 grid.isReadOnly = false
를 설정하세요. 그리드를 만들 때 옵션으로 지정할 수도 있습니다: new wijmo.grid.FlexGrid('#grid', { isReadOnly: true })
.FlexGrid에서 특정 컬럼만 편집하지 못하게 하려면 어떻게 하나요?
isReadOnly: true
를 추가하면 해당 컬럼의 모든 셀이 읽기 전용이 됩니다. 예: { binding: 'id', header: 'ID', isReadOnly: true }
. 반대로 그리드 전체를 isReadOnly: true
로 설정한 뒤 특정 컬럼만 isReadOnly: false
로 열어 두는 패턴도 사용할 수 있습니다.cellEditEnding 이벤트로 잘못된 입력을 막으려면 어떻게 하나요?
cellEditEnding
핸들러 안에서 sender.activeEditor.value
로 새 입력값을 가져와 검증하고, 유효하지 않으면 args.cancel = true
(변경 무효화)와 args.stayInEditMode = true
(편집 모드 유지)를 설정합니다. 이전 값은 args.previousData
로 확인할 수 있습니다.
자바스크립트 그리드에서 편집 전후 값을 비교하려면 어떻게 하나요?
cellEditEnding
이벤트에서 args.previousData
는 편집 전 원본 값이고, sender.activeEditor.value
는 편집기에 입력된 현재 문자열 값입니다. 숫자 컬럼은 parseFloat(sender.activeEditor.value.replace(/,/g, ''))
처럼 서식 문자를 제거한 뒤 파싱해서 비교합니다.엔터프라이즈 웹 앱에서 그리드 편집 기능이 잘 구현된 UI 라이브러리는?
isReadOnly
제어, beginningEdit
/ cellEditEnding
이벤트 기반 유효성 검사, 프로그래밍 방식의 startEditing()
메서드를 모두 내장합니다. Angular, React, Vue 세 프레임워크를 공식 지원해 엔터프라이즈 환경에서 안정적인 선택지입니다.
