Uppy 从 URL 导入

@uppy/url 插件允许用户从互联网导入文件。粘贴任何 URL，它就会被添加！

我何时应该使用这个？

当你想让用户从任何 URL 导入文件时。

要使 URL 插件工作，需要一个 Companion 实例。这为用户节省了带宽，特别是当他们使用移动连接时更为有用。

你可以自托管 Companion 或通过任何 Transloadit 计划获取托管版本。

注意

Companion 内置了服务器端请求伪造（SSRF）保护，因此你不必担心任意 URL 的安全影响。

npm
```
npm install @uppy/url
```
Shell
yarn
```
yarn add @uppy/url
```
Shell

CDN

警告

此捆绑包包含了大部分Uppy插件，因此不建议在生产环境中使用此方法，因为尽管您可能仅仅用到其中一小部分插件，但用户却需要下载全部插件。
然而，这对于加速您的开发环境非常有帮助，所以在起步阶段，请放心使用它来提升开发速度。


<!-- 1. Add CSS to `<head>` -->
<link href="https://releases.transloadit.com/uppy/v3.27.3/uppy.min.css" rel="stylesheet">

<!-- 2. Initialize -->
<div id="uppy"></div>

<script type="module">
    import { Uppy, Url } from "https://releases.transloadit.com/uppy/v3.27.3/uppy.min.mjs"
    const uppy = new Uppy()
    uppy.use(Url, {
      // Options
    })
</script>

使用

使用@uppy/url仅需在 Uppy 中进行设置。

在 Uppy 中使用


import Uppy from "@uppy/core";
import Dashboard from "@uppy/dashboard";
import Url from "@uppy/url";

import "@uppy/core/dist/style.min.css";
import "@uppy/dashboard/dist/style.min.css";

new Uppy()
  .use(Dashboard, { inline: true, target: "#dashboard" })
  .use(Url, { companionUrl: "https://your-companion.com" });

在 Companion 中使用

Companion 开箱即支持此插件，因此这一侧不需要集成。

API

选项

`id`

此插件的唯一标识符（ string，默认：'Url' ）。

`title`

在 UI 中显示的标题/名称，如 Dashboard 标签（ string，默认：'Url' ）。

`target`

放置拖放区域的 DOM 元素、CSS 选择器或插件（ string，Element，Function，或UIPlugin，默认：Dashboard ）。

`companionUrl`

指向 Companion 实例的 URL（ string，默认：null ）。

`companionHeaders`

应随每次请求一起发送到 Companion 的自定义头部（ Object，默认：{} ）。

`companionAllowedHosts`

应接受 OAuth 响应的有效且授权的 URL（ string，RegExp，或 Array ，默认：companionUrl ）。

此值可以是 string，RegExp 模式，或两者的 Array 。如果你的 Companion 运行在多个主机上，这将非常有用。否则，默认值应该足够。

`companionCookiesRule`

此选项对应于 RequestCredentials 值（ string，默认：'same-origin' ）。

这告诉插件是否向 Companion 发送 cookies。

`locale`


export default {
  strings: {
    pluginNameUrl: "Url",
  },
};

Uppy 从 URL 导入

我何时应该使用这个？

使用

在 Uppy 中使用

在 Companion 中使用

API

选项

id

title

target

companionUrl

companionHeaders

companionAllowedHosts

companionCookiesRule

locale

在本文档中