Content-Language header
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Tiêu đề HTTP Content-Language biểu diễn được sử dụng để mô tả (các) ngôn ngữ dành cho đối tượng, để người dùng có thể phân biệt theo ngôn ngữ ưa thích của họ.
Ví dụ, Content-Language: de-DE chỉ ra rằng tài liệu dành cho người nói tiếng Đức. Tài liệu có thể được viết bằng tiếng Anh, không phải tiếng Đức, như một phần của khóa học ngôn ngữ dành cho người học tiếng Đức. Để chỉ ra ngôn ngữ tài liệu được viết bằng, hãy sử dụng thuộc tính lang thay thế.
Nếu không có Content-Language nào được chỉ định, mặc định là nội dung dành cho tất cả đối tượng ngôn ngữ. Nhiều thẻ ngôn ngữ cũng có thể được sử dụng, cũng như áp dụng tiêu đề Content-Language cho nhiều kiểu phương tiện khác nhau và không chỉ cho các tài liệu văn bản.
| Loại tiêu đề | Tiêu đề biểu diễn |
|---|---|
| Tiêu đề yêu cầu bị cấm | Không |
| CORS-safelisted response header | Có |
| CORS-safelisted request header | Có* |
* Giá trị chỉ có thể là 0-9, A-Z, a-z, dấu cách, hoặc các ký tự *,-.;=.
Cú pháp
Content-Language: de-DE
Content-Language: en-US
Content-Language: de-DE, en-CA
Chỉ thị
language-tag-
Nhiều thẻ ngôn ngữ được phân tách bằng dấu phẩy. Mỗi thẻ ngôn ngữ là một chuỗi một hoặc nhiều thẻ con không phân biệt chữ hoa/thường, mỗi thẻ được phân tách bằng ký tự gạch ngang (
-). Trong hầu hết các trường hợp, thẻ ngôn ngữ bao gồm thẻ con ngôn ngữ chính xác định một gia đình ngôn ngữ liên quan rộng lớn (ví dụ:en= tiếng Anh) và tùy chọn theo sau bởi một loạt các thẻ con thu hẹp phạm vi ngôn ngữ đó (ví dụ:en-CA= tiếng Anh như được sử dụng ở Canada).
Note: Các ngôn ngữ được chỉ định sử dụng thẻ ngôn ngữ BCP 47, dựa vào tiêu chuẩn ISO 639 (thường xuyên nhất là danh sách mã ISO 639-1) cho các mã ngôn ngữ được sử dụng.
Ví dụ
Chỉ ra ngôn ngữ một tài liệu được viết bằng
Thuộc tính toàn cục lang được sử dụng trên các phần tử HTML để chỉ ra ngôn ngữ của toàn bộ tài liệu HTML hoặc các phần của nó.
<html lang="de">
…
</html>
Không sử dụng phần tử meta này để khai báo ngôn ngữ tài liệu, như được hiển thị bên dưới:
<meta http-equiv="content-language" content="de" />
Chỉ ra đối tượng mục tiêu cho tài nguyên
Tiêu đề Content-Language được sử dụng để chỉ định đối tượng mục tiêu của trang và có thể chỉ ra rằng đây là nhiều hơn một ngôn ngữ.
Content-Language: de, en
Thông số kỹ thuật
| Specification |
|---|
| HTTP Semantics # field.content-language |