시트 작업

v4.1부터 스프레드시트에서 여러 시트로 작업할 수 있습니다.

이 문서에서는 API 메서드를 사용하여 새 시트를 추가하고, 불필요한 시트를 제거하고, 모든 시트를 가져오고, 현재 활성 시트를 가져오는 방법을 설명합니다. 또한 스프레드시트에 여러 시트를 한 번에 로드하는 방법도 설명합니다.

노트

사용자 인터페이스를 통해 여러 시트와 상호 작용하는 방법을 알아보려면 사용자 가이드를 확인하세요.

v6.0부터 Sheet Manager 모듈이 spreadsheet.sheets 속성을 통해 시트 관리를 처리합니다. 전용 Sheet Manager API는 이전에 Spreadsheet 인스턴스에서 직접 사용할 수 있었던 시트 관련 메서드를 대체합니다.

여러 시트 로드

스프레드시트에 여러 시트를 로드하려면 원하는 수의 시트와 구성으로 데이터를 준비하고 parse() 메서드에 파라미터로 전달하세요. 데이터는 object여야 합니다. 객체에 포함할 수 있는 속성 목록 확인.

노트

multiSheets 구성 옵션이 false로 설정된 경우 시트가 하나만 생성됩니다.

새 시트 추가

스프레드시트에 새 시트를 추가하려면 sheets.add() 메서드를 사용하고 새 시트의 이름을 파라미터로 전달하세요:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

// 사용자 정의 이름으로 시트 추가
const newSheetId = spreadsheet.sheets.add("Q4 Report");
console.log(newSheetId); // 예: "sheet_2"

// 자동 생성된 이름으로 시트 추가
const anotherId = spreadsheet.sheets.add();

이 메서드는 생성된 시트의 id를 반환합니다.

시트 제거

sheets.remove() 메서드를 통해 시트 id로 스프레드시트에서 시트를 제거할 수 있습니다:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

// id로 시트 제거
spreadsheet.sheets.remove("sheet_2");

스프레드시트에 시트가 2개 미만인 경우 시트는 제거되지 않습니다.

활성 시트 설정

스프레드시트 초기화 후 활성 시트를 동적으로 변경하려면 sheets.setActive() 메서드를 사용하세요. 시트의 id를 파라미터로 받습니다:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

// 두 번째 시트로 전환
spreadsheet.sheets.setActive("sheet_2");

// 전환 확인
const active = spreadsheet.sheets.getActive();
console.log(active.name); // "Sheet 2"

관련 샘플: Spreadsheet. 활성 시트 설정

활성 시트 가져오기

sheets.getActive() 메서드를 적용하여 현재 활성 시트를 가져올 수 있습니다:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

const active = spreadsheet.sheets.getActive();
console.log(active.name); // "Sheet 1"
console.log(active.id);   // "sheet_1"

이 메서드는 현재 활성 시트의 name 및 id 속성을 가진 객체를 반환합니다.

모든 시트 가져오기

sheets.getAll() 메서드는 스프레드시트의 모든 시트를 시트 객체 배열로 반환합니다:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

const allSheets = spreadsheet.sheets.getAll();
console.log(allSheets);
// [
//   { id: "sheet_1", name: "Sheet 1" },
//   { id: "sheet_2", name: "Sheet 2" }
// ]

id로 시트 가져오기

id로 단일 시트 객체를 검색하려면 sheets.get() 메서드를 사용하세요:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

const sheet = spreadsheet.sheets.get("sheet_1");
console.log(sheet.name); // "Sheet 1"

시트 지우기

sheets.clear() 메서드를 사용하여 id로 지정된 시트의 데이터를 지울 수 있습니다:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    multiSheets: true
});
spreadsheet.parse(data);

// id로 특정 시트 지우기
spreadsheet.sheets.clear("sheet_1");

// 현재 활성 시트 지우기
spreadsheet.sheets.clear();

관련 샘플: Spreadsheet. 지우기

전체 스프레드시트를 한 번에 지워야 하는 경우 clear() 메서드를 사용하세요.