Extend (col)

시트 생성 시 Cols에 들어가는 열 설정(Type (col), Format (col) 등)을 다른 변수에서 가져와 적용합니다.
예를 들어 "$ 표시 + 천 단위 콤마 + 너비 120px 고정" 같은 공통 규격을 변수에 미리 정의해 두면, 그 규격이 필요한 모든 열에서 변수를 Extend로 불러와 똑같이 적용할 수 있습니다.
변수의 정의 위치는 자유이며, 배포 파일 ibsheet-common.js에는 날짜 형식 등 자주 쓰는 설정이 IB_Preset으로 기본 제공됩니다. 프로젝트에 필요한 설정도 여기에 추가해 사용할 수 있습니다.
Extend는 시트 생성(create) 시에만 적용되며, 이미 생성된 시트에는 반영되지 않습니다.

Type

object

Options

Example

//프로젝트 공통으로 사용할 열 설정 정보를 변수에 정의해 둡니다.(ibsheet-common.js파일 참고)
var IB_Preset = {
    USD:{Type: "Float", Format: "$ #,##0.#", Width: 120, CanResize: 0,Color: "#FFFF88"},  //미화 표시
    YMD:{Type: "Date", Format: "yyyy-MM-dd", EditFormat: "yyyyMMdd", Width: 110}, //년월일 기본 표시
    REGD:{Type: "Date", Format: "yyyy-MM-dd HH:mm", DataFormat: "yyyyMMddHHmm",CanEdit: 0, Width: 150}, //작성일시
    ... 여러가지 열 형식을 미리 정의해 둔다 ...
};

//시트 생성시 Extend를 이용하여 열 생성
//(Name속성만 설정하고 나머지 설정은 Extend로 반영받는다.)
options.Cols = [
    //Type,Format 등이 모두 한꺼번에 적용된다.
    {Name: "exportIncom", Extend: IB_Preset.USD},
    {Name: "birthDate", Extend: IB_Preset.YMD, CanEdit: 1},
    {Name: "ModiDate", Extend: IB_Preset.REGD},
    ...
];

같은 속성을 직접 설정과 Extend에 모두 지정하면 Cols 항목에서 뒤에 쓴 값이 적용됩니다. (헤더 Header는 순서와 무관하게 직접 지정한 값이 우선)

var defaultWidth = {Width: 100, MinWidth: 70};
var options = {
    Cols:[
        {Width: 300, Extend: defaultWidth},  //너비가 100px로 설정됨
        {Extend: defaultWidth, Width: 300}   //너비가 300px로 설정됨
    ]
}

기본 제공 프리셋 (IB_Preset)

ibsheet-common.js에 정의되어 있어 별도 정의 없이 Extend로 바로 사용할 수 있습니다.

날짜/시간

숫자

기능

STATUS, Popup은 내부적으로 Formula를 사용하므로 Def.Row에 CanFormula (row)와 CalcOrder (row)를 둘 다 반드시 설정해야 합니다. CalcOrder에는 계산할 대상을 지정하며, 값을 계산하는 STATUS는 열이름, 셀 속성을 계산하는 attribute+Formula (col)(예: Popup의 ButtonFormula)는 열이름+속성명 형식으로 적습니다. (DelCheck는 이벤트로 동작해 둘 다 필요 없습니다.)

options.Def = { Row: { CanFormula: 1, CalcOrder: "status,deptButton" } };
//CanFormula와 CalcOrder를 함께 설정 (CalcOrder 항목 사이에는 공백을 넣지 않음)
options.Cols = [
    {Header: "상태", Name: "status", Extend: IB_Preset.STATUS},   //값 Formula → 열이름 "status"
    {Header: "부서", Name: "dept",   Extend: IB_Preset.Popup},    //ButtonFormula → 열이름+속성명 "deptButton"
    {Header: "삭제", Name: "del",    Extend: IB_Preset.DelCheck}  //이벤트 → CalcOrder 불필요
];

자세한 사용법은 STATUS, Popup, DelCheck 문서를 참고하세요.

Try it

• Demo of Extend

Read More

• Type col
• Format col
• DataFormat col
• EditFormat col
• Width col

Since