슬라이서 (Slicers)

슬라이서는 사용자가 테이블 데이터를 시각적으로 필터링할 수 있는 컨트롤입니다. SheetKit은 테이블 기반 슬라이서의 추가, 조회, 삭제를 지원합니다 (Excel 2010에서 도입되었습니다).

add_slicer(sheet, config) / addSlicer(sheet, config)

워크시트에 테이블 열을 대상으로 하는 슬라이서를 추가합니다.

Rust:

use sheetkit::SlicerConfig;

let config = SlicerConfig {
    name: "StatusFilter".to_string(),
    cell: "F1".to_string(),
    table_name: "Table1".to_string(),
    column_name: "Status".to_string(),
    caption: Some("Status".to_string()),
    style: Some("SlicerStyleLight1".to_string()),
    width: Some(200),
    height: Some(200),
    show_caption: Some(true),
    column_count: None,
};
wb.add_slicer("Sheet1", &config)?;

TypeScript:

wb.addSlicer("Sheet1", {
    name: "StatusFilter",
    cell: "F1",
    tableName: "Table1",
    columnName: "Status",
    caption: "Status",
    style: "SlicerStyleLight1",
    width: 200,
    height: 200,
    showCaption: true,
});

SlicerConfig

필드	Rust 타입	TS 타입	설명
name	String	string	슬라이서 고유 이름입니다
cell	String	string	앵커 셀 (왼쪽 상단, 예: "F1")입니다
table_name	String	string	소스 테이블 이름입니다
column_name	String	string	필터링할 테이블 열 이름입니다
caption	Option<String>	string?	캡션 헤더 텍스트입니다. 기본값은 열 이름입니다
style	Option<String>	string?	시각적 스타일 (예: "SlicerStyleLight1")입니다
width	Option<u32>	number?	너비(픽셀)입니다. 기본값은 200입니다
height	Option<u32>	number?	높이(픽셀)입니다. 기본값은 200입니다
show_caption	Option<bool>	boolean?	캡션 헤더 표시 여부입니다
column_count	Option<u32>	number?	슬라이서 표시 열 수입니다

get_slicers(sheet) / getSlicers(sheet)

워크시트의 모든 슬라이서 정보를 반환합니다.

Rust:

let slicers = wb.get_slicers("Sheet1")?;
for s in &slicers {
    println!("{}: filtering column '{}'", s.name, s.column_name);
}

TypeScript:

const slicers = wb.getSlicers("Sheet1");
for (const s of slicers) {
    console.log(`${s.name}: filtering column '${s.columnName}'`);
}

SlicerInfo

필드	Rust 타입	TS 타입	설명
name	String	string	슬라이서 이름입니다
caption	String	string	표시 캡션입니다
table_name	String	string	소스 테이블 이름입니다
column_name	String	string	필터링 중인 열 이름입니다
style	Option<String>	string | null	시각적 스타일입니다 (설정된 경우)

delete_slicer(sheet, name) / deleteSlicer(sheet, name)

워크시트에서 이름으로 슬라이서를 삭제합니다. 슬라이서 정의, 캐시, content type, 관계가 모두 제거됩니다.

Rust:

wb.delete_slicer("Sheet1", "StatusFilter")?;

TypeScript:

wb.deleteSlicer("Sheet1", "StatusFilter");

슬라이서 스타일

Excel은 기본 슬라이서 스타일을 제공합니다. style 필드에 다음 중 하나를 전달하세요:

• SlicerStyleLight1 ~ SlicerStyleLight6
• SlicerStyleDark1 ~ SlicerStyleDark6
• SlicerStyleOther1 ~ SlicerStyleOther2

참고 사항

• 슬라이서는 Excel 2010 이상의 기능입니다. 슬라이서가 포함된 파일은 이전 버전의 스프레드시트 애플리케이션에서 올바르게 표시되지 않을 수 있습니다.
• 슬라이서는 OOXML 파트(xl/slicers/, xl/slicerCaches/)로 저장되며 적절한 content type과 관계가 설정됩니다.
• 동일한 워크시트에 여러 슬라이서를 추가할 수 있으며, 각각 다른 테이블 열을 필터링합니다.
• 슬라이서는 저장/열기 라운드트립을 지원합니다.

---