Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

updated to align property names with HTTP header names

  • Loading branch information...
commit 697600f12b8ecd17462a2bb5328e804004e8fa93 1 parent 0151929
@CatChen CatChen authored
Showing with 15 additions and 3 deletions.
  1. +15 −3 Doraemon/Download Link.md
View
18 Doraemon/Download Link.md
@@ -20,6 +20,10 @@
豌豆荚可以通过 `href` 属性获取到下载地址,但无法获取到下载内容的相关信息(meta data),例如说是应用的图标。这些信息可以以键值对(key-value)的形式在 `#` 后面的锚点传递给豌豆荚,使用起来类似于查询字符串(query string)。
+其中有一些取值是跟 HTTP header 取值同名的,这些取值用于补充下载目标 HTTP header 不提供的信息。例如说,如果下载目标不提供 `content-disposition` header,且 URL 不包括文件名信息(如 `http://example.com/download?id=123`),浏览器就没办法获得文件名,这时候锚点后的 `content-disposition` 属性就可以用于提供此信息。
+
+需要注意的是,无论何时 HTTP header 的同名取值总会覆盖锚点后的属性。
+
豌豆荚对可以处理锚点里面的这些键值:
### name
@@ -34,8 +38,16 @@
如果下载链接所在的网页上使用了 micro-format,在锚点不提供 `image` 属性时,该属性从同一个 `itemscope` 内的 `*[itemprop=image]``*[itemprop=thumbnail] *[itemprop=image]``*[itemprop=thumbnailUrl]` 元素上获取。
-### size
+### content-type
+
+文件类型。取值应该为合法的 MIME-type。
+
+### content-length
+
+文件体积。文件在下载过程中如果提供了 HTTP header 的 `content-length` 属性,则以 HTTP header 属性为准。文件下载后,以实际存储的文件体积为准。会显示在资源管理界面和下载任务管理器。
+
+如果下载链接所在的网页上使用了 micro-format,在锚点不提供 `content-length` 属性时,该属性从同一个 `itemscope` 内的 `*[itemprop=fileSize]``*[itemprop=contentSize]` 元素上获取。
-文件体积。文件在下载过程中如果提供了 content-length 属性,则以 content-length 属性为准。文嘉下载后,以实际存储的文件体积为准。会显示在资源管理界面和下载任务管理器。
+### content-disposition
-如果下载链接所在的网页上使用了 micro-format,在锚点不提供 `size` 属性时,该属性从同一个 `itemscope` 内的 `*[itemprop=fileSize]``*[itemprop=contentSize]` 元素上获取
+文件名。必须以 HTTP header 的 `content-disposition` 取值格式提供,即 `attachment; filename=filename.txt`
Please sign in to comment.
Something went wrong with that request. Please try again.