# pdf-preview LLMs.txt

> 供 LLM 快速理解 `@flatbiz/antd/pdf-preview` 的使用方式。

## 模块定位

pdf预览方式1

## 导入方式

```ts
import { PdfPreview } from '@flatbiz/antd/pdf-preview';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `* from ./preview.jsx`
- `Navigation`
- `PdfPreview` - pdf预览方式1
- `PdfPreviewProps`

## 依赖的 antd 能力

`Result`

## Props / 配置要点

### NavigationProps

- `numPages`（必填）：: number
- `activeNumber`（必填）：: number
- `onChangeActiveNumber`（必填）：: (active: number) => void
- `scale`（可选）：: number
- `navigationWidth`（可选）：: number
- `pdfPageListHeightScope`（必填）：: number[][]
- `pdfContentNodeId`（必填）：: string

### PdfPreviewProps

- `pdfUrl`（必填）：: string
- `scale`（可选）：: number；缩放比例，默认值：1
- `className`（可选）：: string
- `navigationScale`（可选）：: number；导航pdf，缩放比例，默认值：0.2
- `hiddenNavigation`（可选）：: boolean；隐藏导航栏
- `navigationWidth`（可选）：: number；导航栏宽度，默认值：200

## 使用规则与行为

- 缩放比例，默认值：1
- 导航pdf，缩放比例，默认值：0.2
- 隐藏导航栏
- 导航栏宽度，默认值：200
- pdf预览方式1
- 计算 page 在文档流中的高度范围，包含竖直方向间距

## 基础示例

```tsx
import { PdfPreview, type NavigationProps } from '@flatbiz/antd/pdf-preview';

const props: NavigationProps = {
  // 按业务传入必要参数
};

<PdfPreview {...props} />;
```

## 源码索引

- `src/pdf-preview/index.ts`
- `src/pdf-preview/navigation.tsx`
- `src/pdf-preview/preview.tsx`

## 给 LLM 的注意事项

- 优先使用 `@flatbiz/antd/pdf-preview` 或主入口 `@flatbiz/antd` 的公开导出，不要引用内部实现文件。
- 当 Props 与 antd 原组件同名能力冲突时，以本模块导出的 Props 类型为准。
- 若文档未覆盖某个边缘参数，请读取上方源码索引中的类型定义和 JSDoc。