> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 测验漏斗中的文件上传区块

> 了解如何在 LanderLab 测验漏斗中使用文件上传区块。设置允许的文件类型、最少/最多文件数量和校验规则，并在任意步骤中收集用户文件。

文件上传（File Upload）区块让你可以直接在测验漏斗的步骤中收集用户的文件。你可以将它放入任意步骤，配置允许的文件类型，设置用户可以上传的文件数量，并要求用户必须上传后才能继续。

## 什么是文件上传区块？

文件上传区块是一种可以添加到漏斗步骤中的测验区块。当用户进入该步骤时，会看到一个拖放上传区域，可以在其中提交一个或多个文件。

当你需要线索在筛选流程中提供证明文件、图片或媒体文件时，它非常有用。例如：身份证明、作品集文件、合同，或产品问题的照片。

## 如何将文件上传区块添加到步骤中

<Steps>
  <Step title="打开你的测验漏斗">
    在 LanderLab 中进入你要编辑的测验漏斗。
  </Step>

  <Step title="进入相应的步骤">
    打开你想收集文件的步骤，或新建一个步骤。
  </Step>

  <Step title="添加区块">
    在该步骤中点击 **Add Block**，然后从区块列表中选择 **Upload**。
  </Step>

  <Step title="进行配置">
    区块会被添加到你的步骤中。点击它即可打开设置面板并进行配置。
  </Step>
</Steps>

## 区块设置

将 Upload 区块添加到步骤后，点击它即可在左侧打开其设置面板。

### General

| 字段 | 作用 |
| - | - |
| **Name** | 区块的内部标识符，用于线索数据和测验逻辑引用。 |
| **Label** | 已发布步骤中显示在上传区域上方的小标签。 |
| **Title** | 上传区域内显示的主要提示（例如“将文件拖放到此处或点击上传”）。 |
| **Description** | 上传区域内标题下方显示的辅助文字（例如“支持 png、jpeg、pdf”）。 |

### Settings

| 字段 | 作用 |
| - | - |
| **Min Files** | 用户必须上传的最少文件数量。默认为 1。 |
| **Max Files** | 允许上传的最多文件数量。 |
| **Allow Types** | 允许的文件格式。你可以在下拉菜单中选择多种类型。 |

#### 支持的文件类型

你可以允许以下格式的任意组合：

<AccordionGroup>
  <Accordion title="图片">
    JPEG, PNG, WebP, GIF, SVG, HEIC
  </Accordion>

  <Accordion title="文档">
    PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, CSV, TXT
  </Accordion>

  <Accordion title="视频">
    MP4, MOV, WebM
  </Accordion>
</AccordionGroup>

<Warning>
  每次提交上传的文件总大小不得超过 30 MB。
</Warning>

## 校验

在 **Validations** 部分，你可以开启 **Required** 开关。启用后，用户必须至少上传最少数量的文件，才能进入下一步。

你还可以设置自定义的 **Error Message**，在用户未上传就尝试继续时显示。

## 其他配置选项

Upload 区块还支持其他测验区块通用的标准选项：

| 部分 | 控制内容 |
| - | - |
| **Spacing** | 调整内边距和外边距。 |
| **Appearance** | 控制区块的视觉外观。 |
| **Visibility** | 根据条件显示或隐藏区块。 |

## 用户看到的效果

当用户进入该步骤时，会看到一个标注清晰的上传区域，其中显示你配置的标题和描述。用户可以直接将文件拖放到该区域，也可以点击浏览并从设备中选择文件。

## 提示

<Tip>
  在 **Description** 字段中清楚说明支持的格式和大小。这可以减少用户的困惑和提交失败。
</Tip>

<Tip>
  如果只需要一个文件，请将 **Min Files** 和 **Max Files** 都设为 `1`，以简化体验。
</Tip>

<Tip>
  当文件对线索筛选至关重要时，请开启 **Required** 开关。如果上传是可选的，则保持关闭。
</Tip>

<Tip>
  **Name** 字段的值会成为线索数据中的键名。请为它取一个清晰的名称，例如 `portfolio_upload` 或 `id_document`，以便在线索控制台中轻松识别。
</Tip>

## 相关内容

<CardGroup cols={2}>
  <Card title="管理步骤" icon="list-ol" href="/zh/features/quizzes/managing-steps">
    了解如何在测验漏斗中添加、重新排序和管理步骤。
  </Card>

  <Card title="测验区块" icon="puzzle-piece" href="/zh/features/quizzes/get-started">
    浏览可以添加到测验步骤中的所有区块。
  </Card>

  <Card title="校验" icon="circle-check" href="/zh/features/quizzes/get-started">
    了解如何设置规则，控制用户何时可以继续。
  </Card>

  <Card title="条件" icon="code-branch" href="/zh/features/quizzes/get-started">
    使用条件逻辑，根据用户输入显示或隐藏区块。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.