2025년 3분기 신규기능(Ver 8.3.0.18~)



Ver 8.3.0.18-20250703-13

1. (Cfg)StyleRowConfig 에 스타일행의 input을 표시하거나 숨길 수 있는 Extend 옵션 추가 

(Method)down2Excel 에 제공되는 numberFormatMode 인자를 ExportData 에도 제공하도록 추가하였습니다.

down2Excel 과 동일하게 엑셀 다운 시 실수 형태의 데이터 타입에 대한 셀 서식 설정 방식을 지정할 수 있습니다.

ValueTypeDescription
Extendboolean처음 랜더링 시 '헤더행', '데이터행' 버튼의 펼쳐짐 여부 (default: true)


[사용 예시]

options.Cfg = {

  StyleRowConfig: {

    Visible: true,

    StorageType: 2,

    ServerUrl: "./ibsheet/styleInfo.jsp",

    AutoLoad: true,

    Themes: {

      Mono: "./assets/ibsheet/css/mono/main.css", // css 파일 내의 클래스를 key와 일치되도록 수정 필요

      IBGY: "./assets/ibsheet/css/gray/main.css"

    },

    Extend : true // 처음 렌더링 시 '헤더행','데이터행' 버튼을 펼침

  }

};


[Extend: false 스타일 행 렌더링 예시]


[Extend: true 스타일 행 렌더링 예시]


2. Def의 Header, Row에 스타일 관련 설정을 할 수 있는 (Method)setCurrentStyle, getCurrentStyle, clearCurrentStyle 추가 

localStorage 등에 문자열로 저장하는 등의 작업을 위해, 현재 Def에 설정된 테마, 배경색, 글자색 및 Alternate 색상, 글자크기 정보를 문자열로 꺼내거나 컨트롤 하는 setCurrentStyle, getCurrentStyle 이 추가되었습니다.

getCurrentStyle 로 리턴되는 문자열은 현재 시트의 Def에 설정된 배경색, 글자색 및 Alternate 색상, 글자크기 정보 값을 가지고 있습니다.


localStorage, sessionStorage 에 저장한 현재 스타일 정보를 제거할 때는 clearCurrentStyle 을 사용할 수 있습니다.

* (Cfg)StorageSession 값이 0 인 경우에는 clearCurrentStyle 로 스토리지에서 관련 정보를 삭제할 수 없습니다. 사용을 위해서는 StorageSession :1 을 설정해야 합니다.


[사용 예시]

// 현재 시트의 컬럼 정보를 담고 있는 문자열을 반환

sheet.getCurrentStyle();

/-----------------------------------------------------------------/

var info = '{"HeaderColor":"#1d1d1b","HeaderTextSize":"14","HeaderTextColor":"#efe6e6","AlternateColor":"#dfdfe2","RowColor":"#f6f6ee","RowTextSize":"12","RowTextColor":"#211c1c","Theme":"IB"}' // getCurrentStyle에서 얻은 결과와 같은 형식


sheet.setCurrentStyle( info );

/-----------------------------------------------------------------/

options.Cfg = {

    StorageSession: 1        // 로컬 스토리지에 현재 시트 정보를 저장할 수 있고 가져올 수 있도록 설정

};

// 로컬 스토리지 혹은 세션 스토리지에 저장된 스타일 정보를 제거한다.

sheet.clearCurrentStyle();






Ver 8.3.0.19-20250710-15 

1. Int, Float 타입에서 Format 설정 시 양수, 음수, 0에 대한 TextColor, TextFont, TextSize, TextStyle를 설정할 수 있는 (col, cell)SignFontStyle 속성 추가 

SignFontStyle을 이용하여 숫자형 컬럼에서 데이터가 각 양수, 음수, 0일 때 Text가 표시될 속성들을 설정하여 적용할 수 있습니다.

양수, 음수, 0 일 때 Format을 지정하는 것과 동일하게 ;를 구분자로 사용합니다.

"red;;yellow" 와 같이 어떤 값을 빈 값이나 '', null로 지정할 경우 기존의 text 속성을 유지합니다.


NameTypeRequiredDescription
TextColorstring선택숫자형의 지정한 열에서 데이터에 따라 양수, 음수, 0일 때 적용하고자 하는 글자색(TextColor)을 설정합니다.
ex) "SignFontStyle": {"TextColor": "red;blue;orange", …}
TextFontstring선택숫자형의 지정한 열에서 데이터에 따라 양수, 음수, 0일 때 적용하고자 하는 글자 폰트(TextFont)를 설정합니다.
ex) "SignFontStyle": {TextFont: "Gulim, Helvetica;Malgun Gothic;Times New Roman", …}
TextSizestring선택숫자형의 지정한 열에서 데이터에 따라 양수, 음수, 0일 때 적용하고자 하는 글자 크기(TextSize)를 설정합니다.
ex) "SignFontStyle": {TextSize: "12px;15px;5px", …}
TextStylestring선택숫자형의 지정한 열에서 데이터에 따라 양수, 음수, 0일 때 적용하고자 하는 글자 스타일(TextStyle)를 숫자로 설정합니다.
ex) "SignFontStyle": {TextStyle: "5;2;8", …}


[사용 예시]

{

    "Header": "정수(Int)",

    "Type": "Int",

    "Name": "IntData", 

    SignFontStyle: {

        TextColor: "blue; red; pink",  // 양수-blue, 음수-red, 0-pink

    }

},





Ver 8.3.0.20-20250717-16

1. (Method)hasChangedData, getChangedData에 데이터 행만 대상으로 동작할 수 있는 dataonly 인자 추가 

시트의 변경된 사항이 있는지 확인할 수 있는 Method 인 hasChangedData, getChangedData 는 데이터 영역 뿐 아니라 Foot, Header, Head, FormulaRow 등의 수정 사항도 인식하여 함께 return 이 됩니다.

사용의 편의성을 늘리고자, data 행만의 변경된 사항을 인식하여 리턴받을 수 있게 하는 dataonly 인자가 추가 되었습니다.

dataonly:1(true) 로 설정 시 데이터를 대상으로 변경된 사항을 리턴합니다.


[사용 예시]

sheet.hasChangedData({dataonly:true})



2. (Cfg)SelectingCells: 0인 경우 복사할 영역을 제어할 수 있는 (Cfg)CopyCols 옵션 추가

(Cfg)SelectingCells:0 을 설정한 경우 행단위로만 선택이 되어, 복사나 붙여넣기 동작 시 모든 행이 기준으로 복사/붙여넣기 되어 사용에 불편함이 있었습니다.

사용성 개선을 위하여 (Cfg)CopyCols 옵션을 추가하여 복사하여 붙여넣기에 사용할 열을 설정할 수 있습니다.

ValueDescription
0포커스된 열만 붙여넣기에 사용
1모든 표시열을 붙여넣기에 사용
2모든 열을 붙여넣기에 사용(숨겨진 컬럼도 포함)
3포커스된 행에 대해서만 포커스된 셀 범위 또는 모든 표시 열(default)



Ver 8.3.0.22-20250731-14

1. (Method)importData 시 엑셀 파일의 셀 위에 이미지를 불러올 지 결정하는 uploadImage 인자 추가  

업로드할 엑셀 파일에 아래처럼 이미지가 들어있을 경우, 해당 이미지를 데이터로 업로드 할지 무시할지 여부를 결정하는 uploadImage 인자가 추가되었습니다.

uploadImageboolean선택셀 위에 띄워진 이미지를 업로드할지 여부를 결정합니다.
0(false): 셀 위에 띄워진 이미지를 업로드하지 않음
1(true):셀 위에 띄워진 이미지를 업로드함 (default)


[사용 예시]

sheet.importData({

     uploadImage:false // 엑셀에 있는 이미지를 업로드 시 무시함

})


 


Ver 8.3.0.24-20250814-14

1. 시트에서 메뉴가 표시될 때, 마우스가 메뉴를 벗어나면 자동으로 메뉴가 닫히는 (cfg) AutoCloseDialog 기능 추가, AutoCloseDialog를 사용할 경우 마우스가 벗어날 때, 닫히기 전까지 시간을 설정할 수 있는 (cfg)AutoCloseDialogTimeout 옵션 추가

시트의 달력, Enum리스트, 컨텍스트 메뉴의 경우 사용자가 닫기 버튼을 누르거나 다른 영역을 클릭하기 전에는 시트에 플로팅되는 다이얼로그가 닫히지 않았습니다.

사용성을 높이기 위하여 사용자가 직접 닫지 않아도 다이얼로그 영역 바깥으로 마우스가 나가면 떠있는 다이얼로그를 닫을 수 있는 (Cfg)AutoCloseDialog 속성이 추가되었습니다.


AutoCloseDialog:true 사용 시 마우스가 나간 후 닫히는 지연 시간을 설정할 수 있는 AutoCloseDialogTimeout 기능도 함께 추가되었습니다. 이때 설정하는 시간의 단위는 ms 단위입니다.


[사용 예시]

options.Cfg = {

    AutoCloseDialog: 1, // 다이얼로그 자동닫기 설정

    AutoCloseDialogTimeout: 5000, // 자동닫기 지연시간 설정 

};



2. 포커스 된 셀의 오른쪽 하단을 드래그 하여 채우기 동작을 할 수 있는 (cfg) DragFill 추가 

포커스 된 셀 오른쪽 하단을 드래그 시 채우기 동작 활성화 여부를 지정할 수 있는 Cfg.DragFill 속성이 추가되었습니다. 

Cfg.DragFill: true 설정 시 아래 사진처럼 셀 우측 하단 모서리에 마우스 hover 시 + 표시가 생깁니다.


+ 표시가 생긴 상태로 클릭 후 원하는 영역을 드래그 하면 아래와 같이 채워질 영역이 표시됩니다.


영역 드래그 동작을 종료하면 아래처럼 기준 셀과 동일한 값으로 선택한 영역에 데이터가 채워 넣어집니다.


[사용 예시]

options.Cfg = {

   "DragFill": true // 채우기 동작 활성화

}



3. getSaveJson, getSaveString, doSave에서 Size, ResultMask, EditMask에 관한 유효성 검사를 진행 할 수 있는 옵션 추가 

각 함수의 인자로 validSize, validEditMask, validResultMask 인자가 추가되면서 Size, ResultMask, EditMask 에 관해 각각 유효성 검사를 진행할 지 말 지를 설정할 수 있습니다.


validSizeboolean선택사이즈 설정(Size col)에 대한 유효성 검사 여부 설정.
0(false):사이즈 유효성 검사 안함 (default)
1(true):사이즈 유효성 검사 실행
validEditMaskboolean선택EditMask 설정(EditMask col)에 대한 유효성 검사 여부 설정.
0(false):EditMask 유효성 검사 안함 (default)
1(true):EditMask 유효성 검사 실행
validResultMaskboolean선택ResultMask 설정(ResultMask col)에 대한 유효성 검사 여부 설정.
0(false):ResultMask 유효성 검사 안함 (default)
1(true):ResultMask 유효성 검사 실행

[사용 예시]

// ResultMask에 관한 유효성 검사 진행

sheet.getSaveJson({validResultMask: 1});


// Size, EditMask에 관한 유효성 검사 진행

sheet.doSave({url: "a.html", validSize: 1, validEditMask: 1});