2024년 4분기 신규기능(Ver 8.2.0.3~ )




Ver 8.2.0.3-20241010-14


- (Method)doSave, getSaveJson, getSaveString 등의 저장 함수를 호출할 때, 사용자가 저장함수에서 설정한 인자(saveMode, col, validRequired)에 따라 유효성 검사를 진행하는 (Cfg)ValidCheck 추가

Cfg:{
     ValidCheck: true // 저장 함수 호출 시 유효성 검사 실행
}


- 유효성 검사 통과 실패 시 띄울 메세지를 설정하는 (Cfg)ValidateMessage 추가

Cfg:{
ValidateMessage : "유효성 검사 실패!" // 유효성 검사 통과 실패 시 설정한 문구를 출력
}

[실행 결과]



- (Method)getRowValue 에 saveAttr 인자 추가

Row 내부에 기존에 선언한 컬럼값이 아닌 다른 데이터가 있는 경우 saveAttr:"추출할데이터key값" 을 선언하면 해당 데이터도 getRowValue 에서 리턴됩니다.

여러 개를 추출하고자 하는 경우 "," 를 구분자로 작성하면 됩니다.


// 현재 포커스 하고 있는 row의 값들을 가져오는데, 
// 선언한 컬럼은 아니지만 Test, abc 라는 이름의 데이터도 들고오겠다.
sheet.getRowValue({row: sheet.getFocusedRow(), saveAttr:"Test,abc"})

Ver 8.2.0.3-20241010-14


- 동적으로 Foot 과 Head를 생성하는 (Method)showFixedRows 추가

메소드의 인자로 Head,Foot 의 object 객체가 들어갑니다.


[사용 예시]

// 1. Foot 행 1개 생성

var obj1 = {Kind : 'Foot', ... };

sheet.showFixedRows(obj1);


// 2. Foot 행 2개, Head 행 1개 생성

sheet.showFixedRows([

    {

        Kind:'Foot', 

      TextData: {

          'Value' : '커스텀 Foot행1', 'TextColor': 'green', 'Span': 4

      }

    },

    {

        Kind:'Head',

      TextData: {

          'Value' : '커스텀 Head행', 'TextColor': 'red', 'Span': 3, 'Color': 'yellow'

      }

    },

    {

        Kind:'Foot',

      Color: 'blue'

    }

  ]);


[예시 2번 실행 결과]



- 동적으로 Formula를 추가하는 (Method)addFormula 추가

기존에는 동적으로 Formula를 추가하는 동작(컬럼을 추가하거나 등)을 설정하는 것이 복잡하고, 가끔은 불가능했습니다.

addFormula 를 사용 시 CanFormula 가 자동으로 true 로 설정되고, CalcOrder에 설정한 Formula 가 순차적으로 추가됩니다.


[사용 예시]

// 1. Row에 colorFormula 추가

var colorFormula = function (param) {

    if (param.Row && param.Row["IntData"] === 0) {

        return "#FFD9FA"

    }

}

// 데이터 행의 배경색을 조건에 따라 변경

sheet.addFormula(colorFormula, "", "", "Color");


// 2. Col 에 Formula 추가

var Formula = function (param) {

    if (param.Row["IntData"] > 100) {

        return true

    } else {

        return false

    }

}

// IntData의 값에 따라 체크박스 열의 체크 변경

sheet.addFormula(Formula, "", "CheckData", "", true);


[예시 1 실행 결과]