HTMLInputElement: phương thức setRangeText()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Phương thức HTMLInputElement.setRangeText() thay thế một phạm vi văn bản trong phần tử <input> hoặc <textarea> bằng một chuỗi mới.

Cú pháp

js
setRangeText(replacement)
setRangeText(replacement, start)
setRangeText(replacement, start, end)
setRangeText(replacement, start, end, selectMode)

Tham số

replacement

Chuỗi để chèn vào.

start Optional

Chỉ mục dựa trên 0 của ký tự đầu tiên cần thay thế. Mặc định là giá trị selectionStart hiện tại (đầu của lựa chọn hiện tại của người dùng).

end Optional

Chỉ mục dựa trên 0 của ký tự sau ký tự cuối cùng cần thay thế. Mặc định là giá trị selectionEnd hiện tại (cuối của lựa chọn hiện tại của người dùng).

selectMode Optional

Một chuỗi định nghĩa cách lựa chọn sẽ được đặt sau khi văn bản được thay thế. Các giá trị có thể:

  • "select" chọn văn bản mới chèn.
  • "start" di chuyển lựa chọn đến ngay trước văn bản đã chèn.
  • "end" di chuyển lựa chọn đến ngay sau văn bản đã chèn.
  • "preserve" cố gắng bảo tồn lựa chọn. Đây là giá trị mặc định.

Giá trị trả về

Không có (undefined).

Ví dụ

Nhấp vào nút trong ví dụ này để thay thế một phần văn bản trong hộp văn bản. Văn bản mới chèn sẽ được đánh dấu (chọn) sau đó.

HTML

html
<input
  type="text"
  id="text-box"
  size="30"
  value="Văn bản này CHƯA được cập nhật." />
<button>Cập nhật văn bản</button>

JavaScript

js
function selectText() {
  const input = document.getElementById("text-box");
  input.focus();
  input.setRangeText("ĐÃ", 14, 17, "select");
}

document.querySelector("button").addEventListener("click", selectText);

Kết quả

Đặc tả kỹ thuật

Specification
HTML
# dom-textarea/input-setrangetext-dev

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

Xem thêm