# OnChange (json event)

> 셀 값을 변경했을 때 셀 값과 편집된 셀값이 다를 경우 호출되는 `Json` 이벤트입니다.

> `Json` 이벤트는 셀, 행, 열에서 선언될 수 있으며 적용되는 우선 순위는 셀 > 행 > 열입니다.

> 예를 들어, 셀과 행 둘 다 선언했다면, 우선순위로 인해 행에 선언한 이벤트는 발생하지 않습니다.

### Syntax

    function Handler(evtParam) {
        ...
    }

    // 행에 넣는 경우
    var options = {
        ...
        Def: {
            Row: {
                ...
                OnChange: Handler,  // 함수 호출이 아닌 문자열을 통한 간단한 로직 설정 가능
                                    // ** 아래와 같은 예약어 사용 가능
                                    // sheet(현재 시트 객체),
                                    // row(현재 이벤트가 호출된 셀의 데이터 로우 객체),
                                    // col(현재 이벤트가 호출된 열이름)
                ...
            }
        }
        ...
    };

    // 열에 넣는 경우
    var options = {
        ...
        Cols: [
            {
                ...
                OnChange: Handler,
                ...
            }
            ...
        ]
        ...
    };

    // 특정 셀에 넣는 경우
    var data = [
        {
            ...
            열이름: "",
            열이름OnChange: Handler,
            ...
        },
        ...
    ];

    // 특정 행에 넣는 경우
    var data = [
        {
            ...
            OnChange: Handler,
            ...
        },
        ...
    ];

    // 위에서 설정한 options 또는 data 객체를 시트 생성자의 인자로 넣습니다.
    IBSheet.create({
        id: "sheet",
        el: "Main",
        options: options,
        data: data
    });

### Parameters

Name | Type | Description
--- | --- | ---
sheet | `object` | 시트 객체
row | `object` | 값이 변경된 셀의 데이터 로우 객체
col | `string` | 값이 변경된 셀의 열이름
event | `object` | 이벤트에 대한 정보를 담고 있는 객체

### Return

boolean

### Example

    /*
      예시 1 열에 OnChange이벤트를 선언하는 경우
    */

    // 값이 변경된 경우 alert를 띄웁니다.
    function Handler(evtParam) {
        alert("변경된 값은" + evtParam.sheet.getValue({row:evtParam.row,col:evtParam.col})+ "입니다");
    }
    var options = {
        Cols: [
            {
                Name: "sCountry",
                Type: "Text",
                OnChange: Handler
            }
            ...
        ]
    };

    /*
      예시 2 셀에 OnChange이벤트 선언하는 경우(시트에 사용될 데이터에 선언)
    */
    var data = [
        {
            "sCountry": "한국",
            sCountryOnChange: "alert('변경되었습니다')",
        },
        ...
    ];

### Read More

### Since

product | version | desc
--- | --- | ---
core | 8.0.0.0 | 기능 추가