AUISoft
AUIGrid 3.0.14 Documentation
CheckBoxEditRenderer

체크박스 렌더러는 특정 칼럼의 셀에 체크박스가 출력되는 칼럼 렌더러입니다.

체크박스 렌더러는 칼럼 레이아웃을 정의할 때 개별 칼럼의 renderer 속성 값인 Object 형태로 선언되어야 합니다.

칼럼의 renderer 속성의 type 으로만 설정 가능합니다.

아래는 설정 예제 입니다.
var columnLayout = [ {
     dataField : "name",
     headerText : "Name",
     width : 140
}, {
     dataField : "isAvailable",
     headerText : "Avaliable",
     width : 80,
     renderer : {
            type : "CheckBoxEditRenderer",
            showLabel : true
      }
}];
NameDescription
checkableFunction
Type : Function

사용자가 체크박스를 클릭하여 체크 상태를 변경하고자 할 때 변경을 허락할지 여부를 지정할 수 있는 함수 입니다.

예를 들어 특정 값은 수정 불가 상태를 만들고자 할 수 있습니다. 이런 경우 유용한 함수입니다.

파라메터 설명

  • rowIndex : (Number) 행 인덱스
  • columnIndex : (Number) 칼럼 인덱스
  • value : (Object) 원본 데이터
  • isChecked : (Boolean) 현재 체크박스 체크 여부
  • item : (Object) 행 아이템
  • dataField : (String) 현재 칼럼의 데이터 필드명

Return : (Boolean) true 를 반환하면 사용자가 자유롭게 체크 변경이 가능하며, false 반환 시 수정 불가 상태로 만듭니다.

함수 전체 작성 예는 다음과 같습니다.

checkableFunction :  function(rowIndex, columnIndex, value, isChecked, item, dataField ) {
       // 행 아이템의 name 이 Anna 라면 수정 불가로 지정.
       if(item.name == "Anna") {
              return false;
        }
        return true;
 }
기본값(default) : null.
checkValue
Type : String

데이터의 value 값 중 체크박스를 선택되도록 결정 짓는 값을 지정합니다.

기본적으로 데이터의 value 가 true 라면 이 속성은 의미가 없지만, 데이터의 값이 "Active", "Inactive" 로 체크 선택/해제가 결정된다면 checkValue 를 "Active" 로 설정하십시오.

기본값(default) : true.
disabledFunction
Type : Function

체크박스를 조건에 따라 비활성화(disabled) 할지 여부를 결정 할 수 있는 함수입니다.

예를 들어 특정 값(name=Anna)은 체크박스를 비활성화 할 때 유용한 함수입니다.

파라메터 설명

  • rowIndex : (Number) 행 인덱스
  • columnIndex : (Number) 칼럼 인덱스
  • value : (Object) 원본 데이터
  • isChecked : (Boolean) 현재 체크박스 체크 여부
  • item : (Object) 행 아이템
  • dataField : (String) 현재 칼럼의 데이터 필드명

Return : (Boolean) true 를 반환하면 체크박스가 비활성화(disabled) 됩니다.

함수 전체 작성 예는 다음과 같습니다.

disabledFunction :  function(rowIndex, columnIndex, value, isChecked, item, dataField ) {
       // 행 아이템의 name 이 Anna 라면 체크박스 비활성화(disabled) 처리
       if(item.name == "Anna") {
              return true;
        }
        return fale;
 }
기본값(default) : null.
editable
Type : Boolean

체크박스 클릭 시 체크 선택/해제가 되도록 할지 여부를 지정합니다.

기본값(default) : false.
showLabel
Type : Boolean

체크박스 옆에 텍스트를 출력할 지 여부를 지정합니다.

기본값(default) : false.
unCheckValue
Type : String

데이터의 value 값 중 체크박스를 해제하도록 결정 짓는 값을 지정합니다.

기본적으로 데이터의 value 가 false 라면 이 속성은 의미가 없지만, 데이터의 값이 "Active", "Inactive" 로 체크 선택/해제가 결정된다면 unCheckValue 를 "Inactive" 로 설정하십시오.

기본값(default) : false.
visibleFunction
Type : Function

체크박스를 조건에 따라 표시 할지 여부를 결정 할 수 있는 함수입니다.

예를 들어 특정 값(name=Anna)은 체크박스를 표시하지 않고자 할 때 유용한 함수입니다.

파라메터 설명

  • rowIndex : (Number) 행 인덱스
  • columnIndex : (Number) 칼럼 인덱스
  • value : (Object) 원본 데이터
  • isChecked : (Boolean) 현재 체크박스 체크 여부
  • item : (Object) 행 아이템
  • dataField : (String) 현재 칼럼의 데이터 필드명

Return : (Boolean) true 를 반환하면 체크박스가 셀에 표시됩니다.

함수 전체 작성 예는 다음과 같습니다.

visibleFunction :  function(rowIndex, columnIndex, value, isChecked, item, dataField ) {
       // 행 아이템의 name 이 Anna 라면 체크박스 표시 하지 않음
       if(item.name == "Anna") {
              return false;
        }
        return true;
 }
기본값(default) : null.