Selection: phương thức collapse()
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.
Phương thức Selection.collapse() thu gọn vùng chọn hiện tại về một điểm duy nhất. Tài liệu không bị sửa đổi. Nếu nội dung đang được focus và có thể chỉnh sửa, caret sẽ nhấp nháy tại đó.
Note:
Phương thức này là bí danh của phương thức Selection.setPosition().
Cú pháp
collapse(node)
collapse(node, offset)
Tham số
node-
Vị trí caret sẽ nằm trong nút này. Giá trị này cũng có thể được đặt thành
null- nếu chỉ địnhnull, phương thức sẽ hoạt động nhưSelection.removeAllRanges(), tức là tất cả các range sẽ bị xóa khỏi vùng chọn. offsetOptional-
Độ lệch trong
nodemà vùng chọn sẽ được thu gọn tới. Nếu không chỉ định, giá trị mặc định0sẽ được dùng.
Giá trị trả về
Không có (undefined).
Ví dụ
// Đặt caret ở đầu phần body của tài liệu HTML.
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);
Thông số kỹ thuật
| Specification |
|---|
| Selection API # dom-selection-collapse |