Thuộc tính toàn cục

Thuộc tính toàn cục là các thuộc tính chung cho tất cả các phần tử HTML; chúng có thể được dùng trên tất cả các phần tử, mặc dù chúng có thể không có hiệu lực trên một số phần tử.

Thuộc tính toàn cục có thể được chỉ định trên tất cả các phần tử HTML, ngay cả những phần tử không được chỉ định trong tiêu chuẩn. Điều đó có nghĩa là bất kỳ phần tử không chuẩn nào cũng phải cho phép các thuộc tính này, mặc dù việc dùng các phần tử đó có nghĩa là tài liệu không còn tuân thủ HTML5. Ví dụ, các trình duyệt tuân thủ HTML5 ẩn nội dung được đánh dấu là <foo hidden>…</foo>, mặc dù <foo> không phải là phần tử HTML hợp lệ.

Ngoài các thuộc tính toàn cục HTML cơ bản, các thuộc tính toàn cục sau cũng tồn tại:

  • xml:langxml:base — được kế thừa từ các đặc tả XHTML và không được dùng nữa, nhưng vẫn được giữ cho mục đích tương thích.
  • Thuộc tính ARIA role và nhiều trạng thái và thuộc tính aria-*, được dùng để đảm bảo khả năng tiếp cận.
  • Các thuộc tính xử lý sự kiện được liệt kê bên dưới.

Danh sách thuộc tính toàn cục

accesskey

Cung cấp gợi ý để tạo phím tắt bàn phím cho phần tử hiện tại. Thuộc tính này bao gồm danh sách các ký tự được phân tách bằng dấu cách. Trình duyệt nên dùng ký tự đầu tiên tồn tại trong bố cục bàn phím của máy tính.

anchor Non-standard

Liên kết một phần tử được định vị với một phần tử neo. Giá trị của thuộc tính là giá trị id của phần tử bạn muốn neo phần tử được định vị vào. Phần tử sau đó có thể được định vị bằng cách dùng định vị neo CSS.

autocapitalize

Kiểm soát liệu văn bản được nhập có tự động viết hoa hay không và nếu có thì theo cách nào.

autocorrect

Kiểm soát liệu văn bản đầu vào có tự động được sửa lỗi chính tả hay không. Điều này có thể được áp dụng cho các phần tử có văn bản có thể chỉnh sửa ngoại trừ các phần tử <input> với thuộc tính: type="password", type="email", hoặc type="url".

autofocus

Cho biết rằng một phần tử sẽ được lấy tiêu điểm khi tải trang, hoặc ngay khi <dialog> mà nó thuộc về được hiển thị. Thuộc tính này là boolean, ban đầu là false.

class

Danh sách các lớp của phần tử, được phân tách bằng dấu cách. Các lớp cho phép CSS và JavaScript chọn và truy cập các phần tử cụ thể qua bộ chọn lớp hoặc các hàm như phương thức Document.getElementsByClassName().

contenteditable

Thuộc tính enumerated cho biết nếu phần tử có thể được chỉnh sửa bởi người dùng. Nếu có, trình duyệt sẽ sửa đổi widget của nó để cho phép chỉnh sửa. Thuộc tính phải nhận một trong các giá trị sau:

  • true hoặc chuỗi rỗng, cho biết rằng phần tử phải có thể chỉnh sửa;
  • false, cho biết rằng phần tử không được chỉnh sửa.
  • plaintext-only, cho biết văn bản thô của phần tử có thể chỉnh sửa, nhưng định dạng văn bản phong phú bị tắt.
data-*

Tạo thành một lớp thuộc tính, được gọi là thuộc tính dữ liệu tùy chỉnh, cho phép trao đổi thông tin độc quyền giữa HTML và biểu diễn DOM của nó mà có thể được dùng bởi các script. Tất cả dữ liệu tùy chỉnh như vậy có thể truy cập qua giao diện HTMLElement của phần tử mà thuộc tính được đặt trên. Thuộc tính HTMLElement.dataset cung cấp quyền truy cập vào chúng.

dir

Thuộc tính enumerated cho biết hướng của văn bản trong phần tử. Nó có thể có các giá trị sau:

  • ltr, có nghĩa là từ trái sang phải và được dùng cho các ngôn ngữ được viết từ trái sang phải (như tiếng Anh);
  • rtl, có nghĩa là từ phải sang trái và được dùng cho các ngôn ngữ được viết từ phải sang trái (như tiếng Ả Rập);
  • auto, để user agent tự quyết định. Nó dùng thuật toán cơ bản khi phân tích cú pháp các ký tự bên trong phần tử cho đến khi tìm thấy ký tự có hướng mạnh, sau đó áp dụng hướng đó cho toàn bộ phần tử.
draggable

Thuộc tính enumerated cho biết liệu phần tử có thể được kéo hay không, bằng cách dùng Drag and Drop API. Nó có thể có các giá trị sau:

  • true, cho biết phần tử có thể được kéo
  • false, cho biết phần tử không thể được kéo.
enterkeyhint

Gợi ý nhãn hành động (hoặc biểu tượng) nào sẽ hiển thị cho phím enter trên bàn phím ảo.

exportparts

Được dùng để xuất các phần shadow theo cách chuyển tiếp từ cây shadow lồng nhau vào cây light chứa.

hidden

Thuộc tính enumerated cho biết rằng phần tử chưa, hoặc không còn, có liên quan. Ví dụ, nó có thể được dùng để ẩn các phần tử của trang không thể dùng cho đến khi quá trình đăng nhập được hoàn thành. Trình duyệt sẽ không hiển thị các phần tử như vậy. Thuộc tính này không được dùng để ẩn nội dung có thể hợp lệ được hiển thị.

id

Xác định một định danh duy nhất (ID) phải là duy nhất trong toàn bộ tài liệu. Mục đích của nó là xác định phần tử khi liên kết (bằng cách dùng định danh đoạn), scripting, hoặc tạo kiểu (với CSS).

inert

Giá trị boolean khiến trình duyệt bỏ qua các sự kiện đầu vào người dùng cho phần tử. Hữu ích khi có các sự kiện click.

inputmode

Cung cấp gợi ý cho các trình duyệt về loại cấu hình bàn phím ảo để dùng khi chỉnh sửa phần tử này hoặc nội dung của nó. Được dùng chủ yếu trên các phần tử <input>, nhưng có thể dùng trên bất kỳ phần tử nào ở chế độ contenteditable.

is

Cho phép bạn chỉ định rằng một phần tử HTML tiêu chuẩn nên hành xử như một phần tử tích hợp tùy chỉnh đã đăng ký (xem Using custom elements để biết thêm chi tiết).

Note: Các thuộc tính item* là một phần của tính năng WHATWG HTML Microdata.

itemid

Định danh toàn cục duy nhất của một mục.

itemprop

Được dùng để thêm thuộc tính vào một mục. Mọi phần tử HTML có thể có thuộc tính itemprop được chỉ định, trong đó itemprop bao gồm cặp tên và giá trị.

itemref

Các thuộc tính không phải là hậu duệ của phần tử có thuộc tính itemscope có thể được liên kết với mục bằng cách dùng itemref. Nó cung cấp danh sách các id phần tử (không phải itemid) với các thuộc tính bổ sung ở nơi khác trong tài liệu.

itemscope

itemscope (thường) hoạt động cùng với itemtype để chỉ định rằng HTML trong một khối là về một mục cụ thể. itemscope tạo Mục và xác định phạm vi của itemtype liên kết với nó. itemtype là URL hợp lệ của từ vựng (như schema.org) mô tả mục và ngữ cảnh thuộc tính của nó.

itemtype

Chỉ định URL của từ vựng sẽ được dùng để xác định itemprop (thuộc tính mục) trong cấu trúc dữ liệu. itemscope được dùng để đặt phạm vi của nơi trong cấu trúc dữ liệu từ vựng được đặt bởi itemtype sẽ hoạt động.

lang

Giúp xác định ngôn ngữ của phần tử: ngôn ngữ mà các phần tử không thể chỉnh sửa đang ở trong, hoặc ngôn ngữ mà các phần tử có thể chỉnh sửa nên được viết bởi người dùng. Thuộc tính phải chứa BCP 47 language tag hợp lệ. xml:lang có ưu tiên cao hơn nó.

nonce

nonce (số được dùng một lần) mật mã học có thể được dùng bởi Content Security Policy để xác định liệu một yêu cầu fetch cụ thể có được phép tiến hành hay không.

part

Danh sách các tên phần của phần tử, được phân tách bằng dấu cách. Tên phần cho phép CSS chọn và tạo kiểu cho các phần tử cụ thể trong cây shadow qua phần tử giả ::part.

popover

Được dùng để chỉ định phần tử là phần tử popover (xem Popover API). Các phần tử popover bị ẩn qua display: none cho đến khi được mở qua phần tử gọi/kiểm soát (tức là <button> hoặc <input type="button"> với thuộc tính popovertarget) hoặc lời gọi HTMLElement.showPopover().

role

Các vai trò xác định ý nghĩa ngữ nghĩa của nội dung, cho phép trình đọc màn hình và các công cụ khác trình bày và hỗ trợ tương tác với một đối tượng theo cách nhất quán với kỳ vọng của người dùng về loại đối tượng đó. roles được thêm vào các phần tử HTML bằng role="role_type", trong đó role_type là tên của vai trò trong đặc tả ARIA.

slot

Gán một slot trong cây shadow shadow DOM cho một phần tử: Phần tử có thuộc tính slot được gán cho slot được tạo bởi phần tử <slot> có giá trị thuộc tính name khớp với giá trị thuộc tính slot đó.

spellcheck

Thuộc tính enumerated xác định liệu phần tử có thể được kiểm tra lỗi chính tả hay không. Nó có thể có các giá trị sau:

  • chuỗi rỗng hoặc true, cho biết phần tử nên được kiểm tra lỗi chính tả nếu có thể;
  • false, cho biết phần tử không nên được kiểm tra lỗi chính tả.
style

Chứa các khai báo tạo kiểu CSS được áp dụng cho phần tử. Lưu ý rằng khuyến nghị các kiểu nên được xác định trong một tệp hoặc các tệp riêng biệt. Thuộc tính này và phần tử <style> chủ yếu có mục đích cho phép tạo kiểu nhanh, ví dụ cho mục đích kiểm tra.

tabindex

Thuộc tính số nguyên cho biết nếu phần tử có thể nhận tiêu điểm đầu vào (có thể lấy tiêu điểm), nếu nó nên tham gia điều hướng bàn phím tuần tự, và nếu có thì ở vị trí nào. Nó có thể nhận nhiều giá trị:

  • giá trị âm có nghĩa là phần tử nên có thể lấy tiêu điểm, nhưng không nên có thể truy cập qua điều hướng bàn phím tuần tự;
  • 0 có nghĩa là phần tử nên có thể lấy tiêu điểm và có thể truy cập qua điều hướng bàn phím tuần tự, nhưng thứ tự tương đối của nó được xác định bởi quy ước nền tảng;
  • giá trị dương có nghĩa là phần tử nên có thể lấy tiêu điểm và có thể truy cập qua điều hướng bàn phím tuần tự; thứ tự mà các phần tử được lấy tiêu điểm là giá trị tăng dần của tabindex. Nếu nhiều phần tử có cùng tabindex, thứ tự tương đối của chúng theo vị trí tương đối trong tài liệu.
title

Chứa văn bản biểu diễn thông tin tư vấn liên quan đến phần tử mà nó thuộc về. Thông tin như vậy thường, nhưng không nhất thiết, có thể được trình bày cho người dùng như tooltip.

translate

Thuộc tính enumerated được dùng để chỉ định liệu các giá trị thuộc tính của phần tử và các giá trị của các node con Text của nó có được dịch khi trang được bản địa hóa hay không, hoặc để lại không thay đổi. Nó có thể có các giá trị sau:

  • chuỗi rỗng hoặc yes, cho biết phần tử sẽ được dịch.
  • no, cho biết phần tử sẽ không được dịch.
virtualkeyboardpolicy Experimental

Thuộc tính enumerated được dùng để kiểm soát hành vi bàn phím ảo trên màn hình trên các thiết bị như máy tính bảng, điện thoại di động, hoặc các thiết bị khác mà bàn phím phần cứng có thể không có sẵn cho các phần tử có nội dung có thể chỉnh sửa (ví dụ, đây là phần tử <input> hoặc <textarea>, hoặc phần tử có thuộc tính contenteditable được đặt).

  • auto hoặc chuỗi rỗng, tự động hiển thị bàn phím ảo khi phần tử được lấy tiêu điểm hoặc chạm vào.
  • manual, tách tiêu điểm và chạm trên phần tử khỏi trạng thái của bàn phím ảo.
writingsuggestions

Thuộc tính enumerated cho biết liệu các gợi ý viết do trình duyệt cung cấp có nên được bật trong phạm vi của phần tử hay không.

  • false, tắt các gợi ý viết của trình duyệt.
  • true hoặc chuỗi rỗng, bật các gợi ý viết.

Danh sách thuộc tính xử lý sự kiện toàn cục

Các thuộc tính xử lý sự kiện HTML không được khuyến nghị; xem HTML attribute reference để biết cách chúng hoạt động.

Mặc dù các thuộc tính liệt kê bên dưới áp dụng cho tất cả các phần tử, chúng không hữu ích trên tất cả các phần tử. Ví dụ, thuộc tính HTML onvolumechange được chấp nhận bởi tất cả các phần tử và gắn trình lắng nghe sự kiện cho volumechange, nhưng chỉ các phần tử media mới nhận được sự kiện volumechange được trình duyệt kích hoạt. Đối với các phần tử khác, bạn chỉ có thể dùng EventTarget.dispatchEvent() để gửi thủ công một sự kiện. Một số thuộc tính có thể được chỉ định trên <body>, nhưng thay vào đó chúng sẽ lắng nghe các sự kiện trên window.

Đặc tả

Specification
CSS Shadow Module Level 1
# part-attr
CSS Shadow Module Level 1
# element-attrdef-html-global-exportparts
HTML
# attr-nonce
HTML
# attr-tabindex
HTML
# attr-lang
HTML
# attr-is
HTML
# attr-popover-hint
HTML
# the-inert-attribute
HTML
# the-popover-attribute
HTML
# attr-data-*
HTML
# the-accesskey-attribute
HTML
# attr-inputmode
HTML
# the-hidden-attribute
HTML
# the-title-attribute
HTML
# inert-subtrees
HTML
# the-style-attribute
HTML
# attr-autocorrect
HTML
# the-dir-attribute
HTML
# the-id-attribute
HTML
# attr-contenteditable
HTML
# classes
HTML
# attr-spellcheck
HTML
# attr-autocapitalize
HTML
# the-autofocus-attribute
HTML
# writing-suggestions
HTML
# attr-slot
HTML
# attr-translate
HTML
# attr-enterkeyhint
HTML
# the-draggable-attribute
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy
CSS Style Attributes
# style-attribute
DOM
# ref-for-dom-element-slot①

Tương thích trình duyệt

Xem thêm

  • Giao diện Element cho phép truy vấn hầu hết các thuộc tính toàn cục.