Document

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.

* Some parts of this feature may have varying levels of support.

Giao diện Document đại diện cho bất kỳ trang web nào được tải trong trình duyệt và đóng vai trò là điểm truy cập vào nội dung của trang web, cụ thể là cây DOM.

Cây DOM bao gồm các phần tử như <body> và <table>, cùng nhiều phần tử khác. Nó cung cấp các chức năng toàn cục cho tài liệu, chẳng hạn như cách lấy URL của trang và tạo các phần tử mới trong tài liệu.

Giao diện Document mô tả các thuộc tính và phương thức chung cho bất kỳ loại tài liệu nào. Tùy thuộc vào loại tài liệu (ví dụ: HTML, XML, SVG, ...), một API lớn hơn sẽ khả dụng: các tài liệu HTML, được phục vụ với kiểu nội dung "text/html", cũng triển khai giao diện HTMLDocument, trong khi các tài liệu XML và SVG triển khai giao diện XMLDocument.

Constructor

Document(): Tạo một đối tượng Document mới.

Thuộc tính instance

Giao diện này cũng kế thừa từ các giao diện Node và EventTarget.

Document.activeElement Read only: Trả về Element hiện đang có tiêu điểm.
Document.activeViewTransition Read only: Trả về một instance ViewTransition đại diện cho view transition đang hoạt động trên tài liệu, hoặc null nếu không có view transition nào đang hoạt động.
Document.adoptedStyleSheets: Thêm một mảng các stylesheet đã được xây dựng để sử dụng cho tài liệu. Các stylesheet này cũng có thể được chia sẻ với các subtree shadow DOM của cùng một tài liệu.
Document.body: Trả về node <body> hoặc <frameset> của tài liệu hiện tại.
Document.characterSet Read only: Trả về bộ ký tự đang được tài liệu sử dụng.
Document.childElementCount Read only: Trả về số lượng phần tử con của tài liệu hiện tại.
Document.children Read only: Trả về các phần tử con của tài liệu hiện tại.
Document.compatMode Read only: Cho biết liệu tài liệu có được hiển thị ở chế độ quirks hay strict.
Document.contentType Read only: Trả về Content-Type từ MIME Header của tài liệu hiện tại.
Document.currentScript Read only: Trả về phần tử <script> có script đang được xử lý và không phải là JavaScript module.
Document.customElementRegistry Read only: Đối tượng CustomElementRegistry được liên kết với tài liệu này, hoặc null nếu chưa được thiết lập.
Document.doctype Read only: Trả về Document Type Definition (DTD) của tài liệu hiện tại.
Document.documentElement Read only: Trả về Element là phần tử con trực tiếp của tài liệu. Đối với các tài liệu HTML, đây thường là đối tượng HTMLHtmlElement đại diện cho phần tử <html> của tài liệu.
Document.documentURI Read only: Trả về vị trí của tài liệu dưới dạng chuỗi.
Document.embeds Read only: Trả về một HTMLCollection các phần tử <embed> được nhúng trong tài liệu.
Document.featurePolicy Experimental Read only: Trả về giao diện FeaturePolicy với các chính sách tính năng được áp dụng cho tài liệu.
Document.firstElementChild Read only: Trả về phần tử con đầu tiên của tài liệu hiện tại.
Document.fonts: Trả về giao diện FontFaceSet của tài liệu hiện tại.
Document.forms Read only: Trả về một HTMLCollection các phần tử <form> trong tài liệu.
Document.fragmentDirective Read only: Trả về FragmentDirective cho tài liệu hiện tại.
Document.fullscreenElement Read only: Phần tử hiện đang ở chế độ toàn màn hình cho tài liệu này.
Document.head Read only: Trả về phần tử <head> của tài liệu hiện tại.
Document.hidden Read only: Trả về giá trị Boolean cho biết trang có được coi là ẩn hay không.
Document.images Read only: Trả về một HTMLCollection các hình ảnh trong tài liệu.
Document.implementation Read only: Trả về DOM implementation được liên kết với tài liệu hiện tại.
Document.lastElementChild Read only: Trả về phần tử con cuối cùng của tài liệu hiện tại.
Document.links Read only: Trả về một HTMLCollection các siêu liên kết trong tài liệu.
Document.pictureInPictureElement Read only: Trả về Element hiện đang được trình bày ở chế độ picture-in-picture trong tài liệu này.
Document.pictureInPictureEnabled Read only: Trả về true nếu tính năng picture-in-picture được kích hoạt.
Document.plugins Read only: Trả về một HTMLCollection các plugin khả dụng.
Document.pointerLockElement Read only: Trả về phần tử được đặt làm mục tiêu cho các sự kiện chuột khi con trỏ bị khóa. null nếu khóa đang chờ, con trỏ không bị khóa, hoặc mục tiêu nằm trong tài liệu khác.
Document.prerendering Read only Experimental: Trả về giá trị boolean cho biết tài liệu có đang trong quá trình prerendering hay không, được khởi tạo thông qua Speculation Rules API.
Document.scripts Read only: Trả về một HTMLCollection các phần tử <script> trong tài liệu.
Document.scrollingElement Read only: Trả về tham chiếu đến Element cuộn tài liệu.
Document.styleSheets Read only: Trả về một ~~unsupported templ: domxref('stylesheetlist')} các đối tượng {{~~ cho các stylesheet được liên kết rõ ràng hoặc được nhúng trong tài liệu.
Document.timeline Read only: Trả về timeline như một instance đặc biệt của DocumentTimeline được tự động tạo khi tải trang.
Document.visibilityState Read only: Trả về một string biểu thị trạng thái hiển thị của tài liệu. Các giá trị có thể là visible, hidden và unloaded.

Các mở rộng cho HTMLDocument

Giao diện Document cho các tài liệu HTML kế thừa từ giao diện HTMLDocument hoặc được mở rộng cho các tài liệu đó.

Document.cookie

Trả về danh sách các cookie được phân tách bằng dấu chấm phẩy cho tài liệu đó hoặc thiết lập một cookie duy nhất.

Document.defaultView Read only

Trả về tham chiếu đến đối tượng window.

Document.designMode

Lấy/thiết lập khả năng chỉnh sửa toàn bộ tài liệu.

Document.dir

Lấy/thiết lập hướng văn bản (rtl/ltr) của tài liệu.

Document.fullscreenEnabled Read only

Cho biết chế độ toàn màn hình có khả dụng hay không.

Document.lastModified Read only

Trả về ngày mà tài liệu được sửa đổi lần cuối.

Document.location Read only

Trả về URI của tài liệu hiện tại.

Document.readyState Read only

Trả về trạng thái tải của tài liệu.

Document.referrer Read only

Trả về URI của trang đã liên kết đến trang này.

Document.title

Thiết lập hoặc lấy tiêu đề của tài liệu hiện tại.

Document.URL Read only

Trả về vị trí của tài liệu dưới dạng chuỗi.

Thuộc tính được đặt tên

Một số phần tử trong tài liệu cũng được hiển thị dưới dạng thuộc tính:

Đối với mỗi phần tử <embed>, <form>, <iframe>, <img> và <object>, name của nó (nếu không rỗng) sẽ được hiển thị. Ví dụ: nếu tài liệu chứa <form name="my_form">, thì document["my_form"] (và tương đương document.my_form) trả về tham chiếu đến phần tử đó.
Đối với mỗi phần tử <object>, id của nó (nếu không rỗng) sẽ được hiển thị.
Đối với mỗi phần tử <img> có name không rỗng, id của nó (nếu không rỗng) sẽ được hiển thị.

Nếu một thuộc tính tương ứng với một phần tử duy nhất, phần tử đó sẽ được trả về trực tiếp. Nếu phần tử duy nhất đó là một iframe, thì contentWindow của nó sẽ được trả về thay thế. Nếu thuộc tính tương ứng với nhiều phần tử, thì một HTMLCollection sẽ được trả về chứa tất cả các phần tử đó.

Các thuộc tính đã lỗi thời

Document.alinkColor Deprecated: Trả về hoặc thiết lập màu của các liên kết đang hoạt động trong phần thân tài liệu.
Document.all Deprecated: Cung cấp quyền truy cập vào tất cả các phần tử trong tài liệu — nó trả về một HTMLAllCollection có gốc tại node tài liệu. Đây là thuộc tính không chuẩn, kế thừa và không nên sử dụng.
Document.anchors Deprecated Read only: Trả về danh sách tất cả các neo trong tài liệu.
Document.applets Deprecated Read only: Trả về một HTMLCollection rỗng. Thuộc tính kế thừa, trước đây trả về danh sách các applet trong tài liệu.
Document.bgColor Deprecated: Lấy/thiết lập màu nền của tài liệu hiện tại.
Document.charset Deprecated Read only: Bí danh của Document.characterSet. Sử dụng thuộc tính này thay thế.
Document.domain Deprecated: Lấy/thiết lập miền của tài liệu hiện tại.
Document.fgColor Deprecated: Lấy/thiết lập màu nền trước, hoặc màu văn bản, của tài liệu hiện tại.
Document.fullscreen Deprecated: Trả về true khi tài liệu đang ở chế độ toàn màn hình.
Document.inputEncoding Deprecated Read only: Bí danh của Document.characterSet. Sử dụng thuộc tính này thay thế.
Document.lastStyleSheetSet Deprecated Read only Non-standard: Trả về tên của bộ stylesheet được kích hoạt lần cuối. Có giá trị null cho đến khi bộ stylesheet được thay đổi bằng cách thiết lập giá trị của selectedStyleSheetSet.
Document.linkColor Deprecated: Lấy/thiết lập màu của các siêu liên kết trong tài liệu.
Document.preferredStyleSheetSet Deprecated Read only Non-standard: Trả về bộ stylesheet ưa thích như được chỉ định bởi tác giả trang.
Document.rootElement Deprecated: Giống như Document.documentElement, nhưng chỉ dành cho các phần tử gốc <svg>. Sử dụng thuộc tính này thay thế.
Document.selectedStyleSheetSet Deprecated Non-standard: Trả về bộ stylesheet nào đang được sử dụng.
Document.styleSheetSets Deprecated Read only Non-standard: Trả về danh sách các bộ stylesheet khả dụng trên tài liệu.
Document.vlinkColor Deprecated: Lấy/thiết lập màu của các siêu liên kết đã truy cập.
Document.xmlEncoding Deprecated: Trả về mã hóa như được xác định bởi khai báo XML.
Document.xmlStandalone Deprecated: Trả về true nếu khai báo XML chỉ định tài liệu là standalone (ví dụ, một phần bên ngoài của DTD ảnh hưởng đến nội dung của tài liệu), ngược lại false.
Document.xmlVersion Deprecated: Trả về số phiên bản như được chỉ định trong khai báo XML hoặc "1.0" nếu khai báo vắng mặt.

Phương thức instance

Giao diện này cũng kế thừa từ các giao diện Node và EventTarget.

Document.adoptNode(): Nhận node từ tài liệu bên ngoài.
Document.append(): Chèn một tập hợp các đối tượng Node hoặc chuỗi sau phần tử con cuối cùng của tài liệu.
Document.ariaNotify() Experimental: Chỉ định rằng một chuỗi văn bản nhất định sẽ được trình đọc màn hình thông báo.
Document.browsingTopics() Non-standard Deprecated: Trả về một promise sẽ được đáp ứng với một mảng các đối tượng đại diện cho các chủ đề hàng đầu cho người dùng, một chủ đề từ mỗi ba epoch gần nhất. Theo mặc định, phương thức này cũng khiến trình duyệt ghi lại lượt truy cập trang hiện tại do người gọi quan sát, vì vậy tên máy chủ của trang có thể được sử dụng sau này trong tính toán chủ đề. Xem Topics API để biết thêm chi tiết.
Document.captureEvents() Deprecated: Xem Window.captureEvents.
Document.caretPositionFromPoint(): Trả về một đối tượng CaretPosition chứa node DOM chứa con trỏ và offset ký tự của con trỏ trong node đó.
Document.caretRangeFromPoint() Non-standard: Lấy một đối tượng Document.createAttribute(); Tạo một đối tượng Attr mới và trả về nó.
Document.createAttributeNS(): Tạo một node thuộc tính mới trong namespace đã cho và trả về nó.
Document.createCDATASection(): Tạo một node CDATA mới và trả về nó.
Document.createComment(): Tạo một node chú thích mới và trả về nó.
Document.createDocumentFragment(): Tạo một fragment tài liệu mới.
Document.createElement(): Tạo một phần tử mới với tên tag đã cho.
Document.createElementNS(): Tạo một phần tử mới với tên tag và URI namespace đã cho.
Document.createEvent() Deprecated: Tạo một đối tượng sự kiện.
Document.createNodeIterator(): Tạo một đối tượng NodeIterator.
Document.createProcessingInstruction(): Tạo một đối tượng ProcessingInstruction mới.
Document.createRange(): Tạo một đối tượng Range.
Document.createTextNode(): Tạo một node văn bản.
Document.createTouch() Deprecated Non-standard: Tạo một đối tượng Touch.
Document.createTouchList() Deprecated Non-standard: Tạo một đối tượng TouchList.
Document.createTreeWalker(): Tạo một đối tượng TreeWalker.
Document.elementFromPoint(): Trả về phần tử trên cùng tại các tọa độ đã chỉ định.
Document.elementsFromPoint(): Trả về một mảng tất cả các phần tử tại các tọa độ đã chỉ định.
Document.enableStyleSheetsForSet() Deprecated Non-standard: Kích hoạt các stylesheet cho bộ stylesheet đã chỉ định.
Document.exitFullscreen(): Ngừng hiển thị toàn màn hình của phần tử toàn màn hình của tài liệu.
Document.exitPictureInPicture(): Đưa video từ cửa sổ picture-in-picture nổi trở lại vùng chứa ban đầu của nó.
Document.exitPointerLock(): Giải tỏa khóa con trỏ.
Document.getAnimations(): Trả về một mảng tất cả các đối tượng Animation hiện đang có hiệu lực, có các phần tử mục tiêu là hậu duệ của document.
Document.getBoxQuads() Experimental: Trả về danh sách các đối tượng DOMQuad đại diện cho các fragment CSS của node.
Document.getElementById(): Trả về tham chiếu đối tượng đến phần tử được xác định.
Document.getElementsByClassName(): Trả về danh sách các phần tử có tên class đã cho.
Document.getElementsByTagName(): Trả về danh sách các phần tử có tên tag đã cho.
Document.getElementsByTagNameNS(): Trả về danh sách các phần tử có tên tag và namespace đã cho.
Document.getSelection(): Trả về một đối tượng Selection đại diện cho phạm vi văn bản được người dùng chọn, hoặc vị trí hiện tại của con trỏ.
Document.hasPrivateToken() Experimental: Trả về một promise sẽ được đáp ứng với giá trị boolean cho biết trình duyệt có lưu trữ private state token từ một issuer cụ thể hay không.
Document.hasRedemptionRecord() Experimental: Trả về một promise sẽ được đáp ứng với giá trị boolean cho biết trình duyệt có redemption record bắt nguồn từ một issuer cụ thể hay không.
Document.hasStorageAccess(): Trả về một Promise sẽ được phân giải với giá trị boolean cho biết tài liệu có quyền truy cập vào cookie không phân vùng hay không.
Document.hasUnpartitionedCookieAccess(): Tên mới cho Document.hasStorageAccess().
Document.importNode(): Trả về bản sao của node từ tài liệu bên ngoài.
Document.moveBefore(): Di chuyển một Node đã cho bên trong node DOM Document như một phần tử con trực tiếp, trước một node tham chiếu đã cho, mà không cần xóa và chèn lại node.
Document.mozSetImageElement() Non-standard: Cho phép bạn thay đổi phần tử đang được sử dụng làm hình nền cho một ID phần tử đã chỉ định.
Document.prepend(): Chèn một tập hợp các đối tượng Node hoặc chuỗi trước phần tử con đầu tiên của tài liệu.
Document.querySelector(): Trả về phần tử Element đầu tiên trong tài liệu, theo thứ tự tài liệu, khớp với các bộ chọn đã chỉ định.
Document.querySelectorAll(): Trả về danh sách tất cả các phần tử Element trong tài liệu khớp với các bộ chọn đã chỉ định.
Document.releaseCapture() Non-standard: Giải phóng capture chuột hiện tại nếu nó đang trên một phần tử trong tài liệu này.
Document.releaseEvents() Deprecated: Xem Window.releaseEvents().
Document.replaceChildren(): Thay thế các phần tử con hiện có của tài liệu bằng một tập hợp các phần tử con mới đã chỉ định.
Document.requestStorageAccess(): Cho phép tài liệu được tải trong ngữ cảnh của bên thứ ba (ví dụ: được nhúng trong một <iframe>) yêu cầu truy cập vào cookie không phân vùng, trong trường hợp các trình duyệt mặc định chặn truy cập vào cookie không phân vùng bởi các trang được tải trong ngữ cảnh của bên thứ ba để cải thiện quyền riêng tư.
Document.requestStorageAccessFor() Deprecated: Cho phép các trang cấp cao nhất yêu cầu truy cập cookie của bên thứ ba thay mặt cho nội dung nhúng có nguồn gốc từ trang khác trong cùng related website set.
Document.startViewTransition(): Bắt đầu một view transition mới và trả về một đối tượng ViewTransition để đại diện cho nó.

Giao diện Document được mở rộng với giao diện XPathEvaluator:

Document.createExpression(): Biên dịch một XPathExpression sau đó có thể được sử dụng cho các đánh giá (lặp lại).
Document.createNSResolver() Deprecated: Trả về node đầu vào như hiện có.
Document.evaluate(): Đánh giá một biểu thức XPath.

Mở rộng cho các tài liệu HTML

Giao diện Document cho các tài liệu HTML kế thừa từ giao diện HTMLDocument hoặc được mở rộng cho các tài liệu đó:

Document.clear() Deprecated: Phương thức này không làm gì cả.
Document.close(): Đóng stream tài liệu để ghi.
Document.execCommand() Deprecated: Trên tài liệu có thể chỉnh sửa, thực thi lệnh định dạng.
Document.getElementsByName(): Trả về danh sách các phần tử có tên đã cho.
Document.hasFocus(): Trả về true nếu tiêu điểm hiện đang nằm ở bất kỳ đâu bên trong tài liệu đã chỉ định.
Document.open(): Mở stream tài liệu để ghi.
Document.queryCommandEnabled() Deprecated Non-standard: Trả về true nếu lệnh định dạng có thể được thực thi trên phạm vi hiện tại.
Document.queryCommandIndeterm() Deprecated: Trả về true nếu lệnh định dạng đang ở trạng thái không xác định trên phạm vi hiện tại.
Document.queryCommandState() Deprecated Non-standard: Trả về true nếu lệnh định dạng đã được thực thi trên phạm vi hiện tại.
Document.queryCommandSupported() Deprecated Non-standard: Trả về true nếu lệnh định dạng được hỗ trợ trên phạm vi hiện tại.
Document.queryCommandValue() Deprecated: Trả về giá trị hiện tại của phạm vi hiện tại cho lệnh định dạng.
Document.write() Deprecated: Ghi văn bản vào tài liệu.
Document.writeln() Deprecated: Ghi một dòng văn bản vào tài liệu.

Phương thức static

Giao diện này cũng kế thừa từ các giao diện Node và EventTarget.

Document.parseHTML() Experimental: Tạo một đối tượng Document mới từ chuỗi HTML theo cách an toàn với XSS kèm theo sanitization.
Document.parseHTMLUnsafe(): Tạo một đối tượng Document mới từ chuỗi HTML mà không thực hiện sanitization. Chuỗi có thể chứa các shadow root khai báo.

Sự kiện

Lắng nghe các sự kiện này bằng cách sử dụng addEventListener() hoặc bằng cách gán một trình lắng nghe sự kiện cho thuộc tính oneventname của giao diện này. Ngoài các sự kiện được liệt kê dưới đây, nhiều sự kiện có thể nổi bọt từ nodes chứa trong cây tài liệu.

afterscriptexecute Non-standard Deprecated: Được kích hoạt khi phần tử <script> tĩnh hoàn thành thực thi script của nó
beforescriptexecute Non-standard Deprecated: Được kích hoạt khi một <script> tĩnh sắp bắt đầu thực thi.
prerenderingchange Experimental: Được kích hoạt trên tài liệu được prerender khi nó được kích hoạt (tức là người dùng xem trang).
securitypolicyviolation: Được kích hoạt khi chính sách bảo mật nội dung bị vi phạm.
visibilitychange: Được kích hoạt khi nội dung của một tab đã trở nên hiển thị hoặc đã bị ẩn.

Các sự kiện toàn màn hình

fullscreenchange: Được kích hoạt khi Document chuyển vào hoặc ra khỏi chế độ toàn màn hình.
fullscreenerror: Được kích hoạt nếu xảy ra lỗi khi cố gắng chuyển vào hoặc ra khỏi chế độ toàn màn hình.

Các sự kiện tải & dỡ tải

DOMContentLoaded: Được kích hoạt khi tài liệu đã được tải và phân tích cú pháp hoàn toàn, mà không chờ các stylesheet, hình ảnh và subframe tải xong.
readystatechange: Được kích hoạt khi thuộc tính readyState của tài liệu thay đổi.

Các sự kiện khóa con trỏ

pointerlockchange: Được kích hoạt khi con trỏ được khóa/mở khóa.
pointerlockerror: Được kích hoạt khi việc khóa con trỏ thất bại.

Các sự kiện cuộn

scroll: Được kích hoạt khi chế độ xem tài liệu hoặc một phần tử đã được cuộn.
scrollend: Được kích hoạt khi chế độ xem tài liệu hoặc một phần tử đã hoàn tất cuộn.
scrollsnapchange Experimental: Được kích hoạt trên vùng chứa cuộn khi kết thúc thao tác cuộn khi một mục snap cuộn mới đã được chọn.
scrollsnapchanging Experimental: Được kích hoạt trên vùng chứa cuộn khi trình duyệt xác định một mục snap cuộn mới đang chờ, tức là nó sẽ được chọn khi cử chỉ cuộn hiện tại kết thúc.

Các sự kiện chọn văn bản

selectionchange: Được kích hoạt khi lựa chọn văn bản hiện tại trên tài liệu thay đổi.

Các sự kiện nổi bọt

Không phải tất cả các sự kiện nổi bọt đều có thể đến được đối tượng Document. Chỉ những sự kiện sau mới có thể và có thể được lắng nghe trên đối tượng Document:

Các đặc tả kỹ thuật

Specification
DOM # interface-document
HTML # the-document-object
CSSOM View Module # extensions-to-the-document-interface
Pointer Lock 2.0 # extensions-to-the-document-interface
Selection API # extensions-to-document-interface

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

Help improve MDN

Learn how to contribute

This page was last modified on Jan 1, 1970 by MDN contributors.

View this page on GitHub • Report a problem with this content