OnClickSide (json event)

Button 또는 Icon이 속성을 사용하는 셀에 만들어지는 버튼을 클릭시 호출되는 Json 이벤트 입니다.
Json 이벤트는 셀, 행, 열에서 선언될 수 있으며 적용되는 우선 순위는 셀 > 행 > 열입니다.
예를 들어, 셀과 행 둘 다 선언했다면, 우선순위로 인해 행에 선언한 이벤트는 발생하지 않습니다.

Icon이나 Button 속성의 값이 Check 인 경우, 이 이벤트 내에서 값을 얻어보면 변경 전에 값이 추출됩니다.
이는 이 이벤트의 발생 시점이 실제로 체크가 변경되기 보다 앞서있기 때문입니다.
따라서 "Check"를 사용하실 때는 얻은 값의 반대 값을 입력해 주어야 합니다.

Syntax

function Handler(evtParam) {
  // ...
}

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

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

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

// 특정 행에 넣는 경우
var data = [{
    // ...
    OnClickSide: 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]
 * 열에 OnClickSide이벤트를 선언하는 경우
 * */

// 셀 내에 위치한 오른쪽 버튼을 클릭시 http://www.ibsheet.com 페이지를 새창에서 띄웁니다.
function Handler(evtParam) {
  window.open('http://www.ibsheet.com', '_blank');
}
var options = {
  Cols: [{
      Name: 'sCompany',
      Type: 'Text',
      Button: 'http://ibsheet.com/demo/images/11/s1.jpg',
      OnClickSide: Handler
    }
    // ...
  ]
};

/**
 * [예시 2]
 * 셀에 OnClickSide이벤트 선언하는 경우(시트에 사용될 데이터에 선언)
 * */
var data = [{
    sCompany: '시트',
    sCompanyOnClickSide: 'window.open("http://www.ibsheet.com", "_blank")',
  },
  // ...
];

Read More

Since

product version desc
core 8.0.0.0 기능 추가