셀 값을 변경했을 때 셀 값과 편집된 셀값이 같을 경우 호출되는
Json이벤트입니다.
Json이벤트는 셀, 행, 열에서 선언될 수 있으며 적용되는 우선 순위는 셀 > 행 > 열입니다.예를 들어, 셀과 행 둘 다 선언했다면, 우선순위로 인해 행에 선언한 이벤트는 발생하지 않습니다.
function Handler(evtParam) {
...
}
// 행에 넣는 경우
var options = {
...
Def: {
Row: {
...
OnSame: Handler, // 함수 호출이 아닌 문자열을 통한 간단한 로직 설정 가능
// ** 아래와 같은 예약어 사용 가능
// Sheet(현재 시트 객체),
// Row(현재 이벤트가 호출된 셀의 데이터 로우 객체),
// Value(현재 이벤트가 호출된 셀의 값),
// Col(현재 이벤트가 호출된 열이름),
// ex) "Value && alert('Same')"
...
}
}
...
};
// 열에 넣는 경우
var options = {
...
Cols: [
{
...
OnSame: Handler,
...
}
...
]
...
};
// 특정 셀에 넣는 경우
var data = [
{
...
열이름: "",
열이름OnSame: Handler,
...
},
...
];
// 특정 행에 넣는 경우
var data = [
{
...
OnSame: Handler,
...
},
...
];
// 위에서 설정한 options 또는 data 객체를 시트 생성자의 인자로 넣습니다.
IBSheet.create({
id: "sheet",
el: "Main",
options: options,
data: data
});
| Name | Type | Description |
|---|---|---|
| sheet | object |
시트 객체 |
| row | object |
편집 후에도 값이 이전과 같은 셀의 데이터 로우 객체 |
| col | string |
편집 후에도 값이 이전과 같은 셀의 열이름 |
| event | object |
이벤트에 대한 정보를 담고 있는 객체 |
/*
예시 1 열에 OnSame이벤트를 선언하는 경우
*/
// 값이 편집전과 같은 경우 alert를 띄우고 셀 배경을 빨간색으로 변경합니다.
function Handler(evtParam) {
alert("기존의 값과 결과가 같습니다.");
evtParam.sheet.setCellStyle({row: evtParam.row, col: evtParam.col, attr: {Color:'red'}, render:1});
}
var options = {
Cols: [
{
Name: "sCountry",
Type: "Text",
OnSame: Handler
}
...
]
};
/*
예시 2 셀에 OnSame이벤트 선언하는 경우(시트에 사용될 데이터에 선언)
*/
var data = [
{
"sCountry": "한국",
sCountryOnSame:"alert('기존의 값과 결과가 같습니다.') || Sheet.setCellStyle({row: Row, col: Col, attr: {Color:'red'}, render:1});",
},
...
];
| product | version | desc |
|---|---|---|
| core | 8.0.0.0 | 기능 추가 |