簡介

Content-Disposition 頭字段用于指示瀏覽器如何處理響應主體，通常用于文件下載或在線預覽。

語法

Content-Disposition 頭字段具有以下語法：

Content-Disposition: inline | attachment; filename="filename"; [disposition-type-params]

• inline ：指示瀏覽器在響應正文中內聯顯示文件。
• attachment ：指示瀏覽器將文件下載到本地。
• filename ：指定下載的文件名。如果省略，瀏覽器將使用默認文件名。
• disposition-type-params ：其他可選參數，用于指定文件的附加屬性，如文件名編碼或文件大小。

使用 Content-Disposition 頭字段

文件下載

要強制瀏覽器下載文件，請使用以下 Content-Disposition 頭：

Content-Disposition: attachment; filename="filename"

例如：

HTTP/1.1 200 OK
Content-Disposition: attachment; filename="myfile.txt"
Content-Type: text/plain文件內容...

在線預覽

要指示瀏覽器在響應正文中內聯顯示文件，請使用以下 Content-Disposition 頭：

Content-Disposition: inline; filename="filename"

例如：

HTTP/1.1 200 OK
Content-Disposition: inline; filename="myfile.pdf"
Content-Type: application/pdf文件內容...

其他屬性

Content-Disposition 頭字段還支持以下可選參數：

• filename= ：指定下載的文件名的編碼方式，如 UTF-8 或 base64。
• size= ：指定下載的文件大小，以字節為單位。
• creation-date= ：指定文件的創建日期和時間。
• modification-date= ：指定文件的修改日期和時間。

使用 Content-Disposition 頭字段設置文件下載和預覽選項

可以使用各種編程語言和 Web 框架在 HTTP 響應中設置 Content-Disposition 頭字段。以下是幾個示例：

Node.js (Express)

const express = require('express');const app = express();app.get('/download', (req, res) => {res.download('myfile.txt');
});app.get('/preview', (req, res) => {res.set('Content-Disposition', 'inline; filename="myfile.pdf"');res.sendFile('myfile.pdf');
});

Python (Flask)

from flask import Flask, send_fileapp = Flask(__name__)@app.route('/download')
def download():return send_file('myfile.txt', as_attachment=True)@app.route('/preview')
def preview():return send_file('myfile.pdf', as_attachment=False)

Java (spring Boot)

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;@SpringBootApplication
public class App {public static void main(string[] args) {SpringApplication.run(App.class, args);}@GetMapping("/download")public @ResponseBody byte[] download() {return Files.readAllBytes(Paths.get("myfile.txt"));}@GetMapping("/preview")public @ResponseBody byte[] preview() {return Files.readAllBytes(Paths.get("myfile.pdf"));}
}

結論

Content-Disposition 頭字段是用于指示瀏覽器如何處理 HTTP 響應主體的重要工具。通過正確使用此頭字段，您可以控制文件下載和在線預覽行為，從而改善用戶體驗。

---

---

相關標簽： 使用、 HTTP、 響應中設置文件下載和預覽選項、 使用co2滅火器時應手握紅色金屬管嗎、 頭字段在、 Disposition、 Content、

上一篇：深入研究ContentDisposition頭字段在HTTP響

下一篇：ContentDisposition頭字段服務器對HTTP響應