# @univerjs-pro/slicer

> Language fallback: requested `ja-JP`; content is `en-US`.

- Human documentation: [https://docs.univer.ai/ja-JP/reference/packages/plugins/univerjs-pro/slicer](https://docs.univer.ai/ja-JP/reference/packages/plugins/univerjs-pro/slicer)

- Agent Markdown: [https://docs.univer.ai/ja-JP/reference/packages/plugins/univerjs-pro/slicer.md](https://docs.univer.ai/ja-JP/reference/packages/plugins/univerjs-pro/slicer.md)

- Requested language: `ja-JP`

- Content language: `en-US`

- Documentation version: `1.4.0`

- Source: [packages/plugins/univerjs-pro/slicer.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs-pro/slicer.mdx)

---

Shared slicer and timeline models, styles, and canvas controls.

```typescript
import { UniverSlicerPlugin } from '@univerjs-pro/slicer'

univer.registerPlugin(UniverSlicerPlugin)
```

The plugin has no configuration options. In Sheets, use [`@univerjs-pro/sheets-slicer`](https://docs.univer.ai/ja-JP/reference/packages/plugins/univerjs-pro/sheets-slicer.md), which depends on this plugin.

## Public exports

- `ISlicerDefinition`, `ITimelineDefinition`, and `ISlicerResource` describe slicers, timelines, and their saved data.
- `SlicerSourceKind`, `SlicerTargetKind`, `SlicerControlKind`, and `TimelineLevel` identify sources, targets, controls, and timeline levels.
- `SlicerCacheCrossFilter` and `SlicerCacheSortOrder` configure filtering and sorting.
- `SlicerThemeService`, `SlicerCanvasControl`, and `SlicerShape` provide shared rendering support.
- `BUILT_IN_SLICER_STYLE_NAMES` and `BUILT_IN_TIMELINE_STYLE_NAMES` list the built-in styles.
- `ITimelineDateCondition` and `TimelineDateFilterOperator` describe fixed date conditions. `compileTimelineCondition(condition)` returns a predicate over `RecordValue`, matching only date values. Conditions use numeric date serials; `useWholeDay: true` ignores fractional time, and between conditions include both bounds. Invalid conditions throw.

`compileTimelineRange(range)` uses half-open `[startDate, endDate)` bounds. Its `useWholeDay: true` rounds the start down and the end up; an equal start and end remains empty. A timeline cache holds either a range selection or a date condition, not both. See [date conditions](https://docs.univer.ai/ja-JP/guides/sheets/features/slicer.md#date-conditions).

See the [slicer guide](https://docs.univer.ai/ja-JP/guides/sheets/features/slicer.md) for Sheets setup and usage.