Wijmo 블로그 MESCIUS 기술 블로그 ·

Wijmo FlexGrid 인라인 편집 구현: isReadOnly·cellEditEnding 유효성 검사

별도의 팝업 폼 없이 표 셀을 바로 클릭해 데이터를 수정하는 인라인 편집(in-place editing)은 엔터프라이즈 웹 애플리케이션에서 업무 효율을 높이는 핵심 UX 패턴입니다. Wijmo FlexGrid는 isReadOnly 속성 기본값이 false 여서 별도 설정 없이 인라인 편집이 즉시 활성화되고, beginningEdit · cellEditEnding 등 풍부한 이벤트로 편집 권한과 유효성 검사를 세밀하게 제어할 수 있어, 복잡한 업무 화면도 직관적으로 구현할 수 있습니다.

⭐
Key Points
이 글에서 다루는 핵심 내용
01
isReadOnly 속성의 기본값이 false 라서 별도 설정 없이도 그리드 전체에서 인라인 편집을 바로 사용할 수 있습니다. 편집을 막으려면 isReadOnly: true 를 지정합니다.
02
isReadOnly 는 그리드·컬럼·행 세 단계에서 각각 독립적으로 편집 권한을 제어합니다.
03
beginningEdit 이벤트에서 e.cancel = true 를 설정하면 조건에 맞는 셀만 동적으로 읽기 전용으로 만들 수 있습니다.
04
cellEditEnding 이벤트에서 args.previousData (이전 값)와 grid.activeEditor.value (새 값)를 비교해 유효하지 않은 입력을 바로 차단합니다.
05
args.stayInEditMode = true 를 함께 설정하면 잘못 입력한 뒤에도 편집 모드가 유지되어 사용자가 곧바로 값을 고칠 수 있습니다.

셀 편집이 시작되고 끝나는 흐름 한눈에 보기

FlexGrid의 셀 편집은 Excel과 유사한 두 가지 모드로 동작합니다. **전체 편집 모드(Full-edit)**는 F2 키 또는 더블클릭으로 진입하며, 방향 키를 눌러도 편집 모드를 유지합니다. **빠른 편집 모드(Quick-edit)**는 셀에 바로 타이핑을 시작할 때 진입하며, 방향 키를 누르면 편집이 종료됩니다.

셀 편집의 전체 흐름은 다음과 같은 이벤트 체인으로 구성됩니다:

  1. beginningEdit — 셀이 편집 모드로 진입하기 직전 발생. e.cancel = true 로 편집 자체를 차단할 수 있습니다.
  2. prepareCellForEdit — 편집기 DOM이 준비된 직후 발생. grid.activeEditor 로 편집 입력 요소에 접근해 커스텀 처리를 추가할 수 있습니다.
  3. cellEditEnding — 편집 완료 직전 발생. args.previousData 와 grid.activeEditor.value 로 이전·신규 값을 비교해 유효성 검사를 수행합니다.
  4. cellEditEnded — 편집이 커밋되거나 취소된 후 발생. 변경 후 후처리 로직(로그, UI 갱신 등)에 사용합니다.

FlexGrid 셀 편집 라이프사이클 다이어그램: beginningEdit → activeEditor → cellEditEnding → cellEditEnded

💡 SUMMARY
Wijmo FlexGrid는 isReadOnly 기본값이 false여서 인라인 편집이 즉시 활성화되며, cellEditEnding 이벤트로 유효성 검사를 즉시 적용할 수 있습니다.

isReadOnly로 그리드·컬럼·행 단위 편집 권한 나누기

FlexGrid의 편집 권한은 세 가지 레벨에서 독립적으로 제어됩니다.

1. 그리드 레벨: isReadOnly 속성으로 그리드 전체를 제어합니다. 기본값은 false (편집 가능)이므로, 그리드를 완전히 읽기 전용으로 만들고 싶을 때는 isReadOnly: true 를 설정합니다.

2. 컬럼 레벨: 각 컬럼 정의에 isReadOnly: true 를 설정해 해당 컬럼만 편집 불가로 지정합니다. ID처럼 수정해서는 안 되는 고정 필드에 적용합니다.

3. 행/셀 레벨(동적): beginningEdit 이벤트에서 행 데이터를 확인하고 e.cancel = true 로 특정 행의 편집을 동적으로 차단합니다. 예를 들어 "완료" 상태인 행은 수정을 막는 패턴이 대표적입니다.

isReadOnly 제어 레벨 다이어그램: 그리드·컬럼·행·셀 단위 토글 구조

컬럼의 isRequired 속성도 활용할 수 있습니다. 기본값은 null 로, 숫자·날짜·불리언은 필수이고 문자열은 빈 값을 허용합니다. isRequired: true 로 설정하면 빈 값 입력 자체를 막습니다.

💡 SUMMARY
Wijmo FlexGrid의 isReadOnly 속성은 그리드·컬럼·행 세 단계에서 편집 권한을 세밀하게 제어합니다.

예제 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 핸들러에서 행 상태를 확인해 "완료" 행 전체를 잠그는 방식입니다.

💡 SUMMARY
FlexGrid의 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 는 현재 편집기의 문자열 값이므로, 두 값을 비교하거나 새 값만 독립적으로 검증할 수 있습니다.

💡 SUMMARY
cellEditEnding 이벤트에서 args.cancel과 args.stayInEditMode를 함께 사용하면 잘못된 입력 시 편집 모드를 유지하며 즉시 수정을 유도할 수 있습니다.

AG Grid와 비교: FlexGrid 편집 방식의 차이점

AG Grid Community 버전도 기본 셀 편집을 지원하지만, 컬럼별로 cellEditor 컴포넌트를 별도 정의해야 하고, 유효성 검사도 valueSetter + valueParser 콜백 조합이 필요합니다. Wijmo FlexGrid는 데이터 타입을 자동 감지해 숫자·날짜·불리언 에디터를 즉시 활성화하므로, 별도의 에디터 컴포넌트 없이도 대부분의 업무 시나리오를 처리할 수 있습니다.

또한 국내에서 많이 사용되는 RealGrid, IBSheet 등과 비교해도, FlexGrid의 beginningEdit / cellEditEnding 이벤트 기반 유효성 검사 패턴은 콜백 설계가 일관되어 팀 내 표준 코드 패턴으로 정착시키기 용이합니다.

startEditing(fullEdit, r, c) 메서드로 프로그래밍 방식의 편집 진입도 지원합니다. 예를 들어 버튼 클릭 시 특정 셀을 자동으로 편집 모드로 전환할 수 있습니다:

💡 SUMMARY
Wijmo FlexGrid는 데이터 타입 자동 감지와 일관된 이벤트 API로 AG Grid 대비 설정 코드를 줄이면서 동일한 편집 기능을 구현할 수 있습니다.

자주 묻는 질문 (FAQ)

Q01

FlexGrid에서 인라인 편집을 켜려면 어떻게 하나요?

FlexGrid는 isReadOnly 속성의 기본값이 false 이므로 별도 설정 없이 바로 셀 편집이 가능합니다. 편집을 막으려면 grid.isReadOnly = true 를, 다시 허용하려면 grid.isReadOnly = false 를 설정하세요. 그리드를 만들 때 옵션으로 지정할 수도 있습니다: new wijmo.grid.FlexGrid('#grid', { isReadOnly: true }) .
Q02

FlexGrid에서 특정 컬럼만 편집하지 못하게 하려면 어떻게 하나요?

컬럼 정의 객체에 isReadOnly: true 를 추가하면 해당 컬럼의 모든 셀이 읽기 전용이 됩니다. 예: { binding: 'id', header: 'ID', isReadOnly: true } . 반대로 그리드 전체를 isReadOnly: true 로 설정한 뒤 특정 컬럼만 isReadOnly: false 로 열어 두는 패턴도 사용할 수 있습니다.
Q03

cellEditEnding 이벤트로 잘못된 입력을 막으려면 어떻게 하나요?

cellEditEnding 핸들러 안에서 sender.activeEditor.value 로 새 입력값을 가져와 검증하고, 유효하지 않으면 args.cancel = true (변경 무효화)와 args.stayInEditMode = true (편집 모드 유지)를 설정합니다. 이전 값은 args.previousData 로 확인할 수 있습니다.
Q04

자바스크립트 그리드에서 편집 전후 값을 비교하려면 어떻게 하나요?

cellEditEnding 이벤트에서 args.previousData 는 편집 전 원본 값이고, sender.activeEditor.value 는 편집기에 입력된 현재 문자열 값입니다. 숫자 컬럼은 parseFloat(sender.activeEditor.value.replace(/,/g, '')) 처럼 서식 문자를 제거한 뒤 파싱해서 비교합니다.
Q05

엔터프라이즈 웹 앱에서 그리드 편집 기능이 잘 구현된 UI 라이브러리는?

Wijmo FlexGrid는 데이터 타입 자동 감지(숫자·날짜·불리언 에디터 즉시 활성화), 다단계 isReadOnly 제어, beginningEdit / cellEditEnding 이벤트 기반 유효성 검사, 프로그래밍 방식의 startEditing() 메서드를 모두 내장합니다. Angular, React, Vue 세 프레임워크를 공식 지원해 엔터프라이즈 환경에서 안정적인 선택지입니다.

MESCIUS Wijmo

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

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

Wijmo 무료 체험판 다운로드