文件库 File Library

文件库模块将 Directus 项目中的所有文件聚合到一个综合库中。 它是一个功能齐全的数字资产管理 (DAM) 系统,用于存储、组织、浏览和转换您的各种文件和资产。

文件库

有关文件夹和文件管理的更多文档
这是文件库模块的非技术性、无代码指南。 请注意,有关于通过 API 进行编程 FolderFile 管理的文档。

工作方式

所需知识
熟悉 集合页面 会有所帮助,但不是必需的。

文件库充当一个大 文件夹 来存储所有上传的 文件。 可以在文件库中创建子文件夹,以帮助文件保持井井有条。 文件夹和文件信息存储在常规集合中,这意味着 用户和角色访问权限 在文件夹和文件上是完全可配置和精细的。 可以通过应用程序一次上传多个文件,也可以通过 API 以编程方式上传。 可以上传任何类型的文件,不仅仅是图像。 从导航栏中选择文件夹时,将显示 文件列表页面。 此页面具有与 Collections Page 相同的所有特性和功能。

  1. 选择一个文件夹。 有两种选择:
    • 从导航栏中选择所需的文件夹。
    • 点击页眉中的create_new_folder,命名您的文件夹,然后点击 “保存”
  2. 单击页眉中的添加。 将出现一个弹出框。
  3. 上传您的文件。 您有 3 个选项:
    • 将文件从桌面拖到弹出窗口。
    • 单击弹出区域以从您的设备中手动选择文件。
    • 点击弹出窗口中的 more_vert 并选择 “从 URL 导入”
  4. 可选:单击文件显示以打开文件详细信息页面并根据需要填写信息。

文件

在“文件列表”页面中单击文件时,将出现“文件详细信息”页面。 这是用于查看资产和嵌入的自定义表单,包含开箱即用的核心字段(见下文),并且管理员能够添加其他自定义字段。 此页面具有与 项目页面 相同的特性和功能。

文件

操作按钮

请注意标题中的以下按钮:

  • check - 保存对文件所做的任何编辑。
  • tune - 请参阅 编辑图像 了解更多信息。
  • save_alt - 将文件下载到您当前的设备。
  • drive_file_move – 将选定的文件移动到另一个文件夹。
  • delete - 永久删除文件及其元数据。 此操作是永久性的,无法撤消。

删除链接到项目的文件
默认情况下,Directus 不允许您删除文件,除非您将其从任何和所有相关项目中删除。 但是,可以重新配置此行为,以便在删除文件时将文件字段的关系约束设置为“SET NULL”或“CASCADE”,从而在删除图像时自动更新文件。

文件详情

文件集合预先配置了以下开箱即用的字段。 可以根据需要在 Settings > Data Model 中创建和自定义新字段。 但是,无法更改或删除预配置的字段。

文件详情

  • 预览 - 图像或文件的预览。
  • 标题 – 文件的标题。
  • 描述 – 文件的描述。
  • 标签 - 用于搜索能力的关键字。
  • 位置 – 可选位置 (例如拍摄照片的地方)
  • 存储 – 使用哪个存储适配器来存储文件资产。
  • 文件名(磁盘) - 已锁定。 这是存储中文件的实际名称。
  • 文件名(下载) - 允许您在下载文件时设置文件名。

文件边栏

文件侧边栏还包括以下详细信息,这些详细信息不可编辑并用作元数据。

文件边栏

  • 类型 – 文件的 MIME 类型,在 App 中显示为格式化的媒体类型。
  • 尺寸 - 仅限图片。 图像的宽度和高度(以像素为单位)。
  • 大小 – 资产在存储适配器中占用的文件大小。
  • 创建日期 – 文件上传到项目的时间戳。
  • 拥有者 – 将文件上传到项目的用户。
  • 修改日期 – 上次修改文件的时间戳。
  • 编辑者 – 修改文件的用户。
  • 文件夹 – 包含文件的当前父文件夹。
  • 元数据 – 文件的 EXIF、IPTC 和 ICC 信息的元数据 JSON 转储。

编辑图像

旋转、裁剪、翻转或调整图像的纵横比。

  1. 文件库中,单击一个文件以打开其详细信息页面。
  2. 点击右上角的tune按钮打开图片编辑器。
  3. 进行更改并单击右上角的 check 以保存更新。

不可逆转的变化
编辑会覆盖磁盘上的原始文件。 这是无法逆转的。

上传一个文件

我们在 工作原理 中介绍了文件库的三种上传方法。 请记住,也可以通过不同的接口添加文件。 例如,用户可以在填写用户详细信息时上传头像图像。 同样,带有图片字段的商品在商品详情页面会有一个文件上传界面。 文件也可以通过 API 以编程方式上传

替换文件

替换文件时,将保留其现有信息和所有关系。

  1. 单击文件详细信息页面上的图像预览。 将出现一个弹出窗口。
  2. 上传您的文件。 您有 3 个选项:
    • 将文件从桌面拖到弹出窗口。
    • 单击弹出区域以从您的设备中手动选择文件。
    • 点击弹出窗口中的 more_vert 并选择 “从 URL 导入”

文件夹

文件夹为文件提供了组织系统。

文件夹

它们可以被命名、重命名和嵌套为文件夹层次结构中的任何位置的子文件夹。 从导航栏中选择文件夹后,将打开文件列表页面。 文件列表页面显示文件夹中的所有文件。 它还支持集合页面中的所有其他特性和功能,例如批量编辑、批量删除、排序、过滤、搜索等。文件夹也可以通过 API 以编程方式管理。

创建文件夹

  1. 文件库,单击位于标题中的 create_new_folder 按钮。
  2. 根据需要填写文件夹名称。
  3. 点击 “保存”

重命名文件夹

  1. 文件库中,右键单击要重命名的文件夹,然后选择“重命名文件夹”。
  2. 根据需要更新文件夹名称。
  3. 点击 “保存”

移动文件夹

  1. 文件库中,右键单击要移动的文件夹,然后选择 “移动到文件夹”。 将出现一个弹出窗口。
  2. 选择一个文件夹作为新的父文件夹。
  3. 点击 “保存”

删除文件夹

  1. 文件库中,右键单击要删除的文件夹,然后选择 “删除文件夹”
  2. 点击 “删除”

删除文件夹时,任何嵌套的文件和文件夹都将向上移动一级。

更多帮助

正在为您的非企业项目寻找技术支持? 与我们成长中的数千名工程师聊天 Discord 社区