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
setRangeText(replacement)
setRangeText(replacement, start)
setRangeText(replacement, start, end)
setRangeText(replacement, start, end, selectMode)
Tham số
replacement-
Chuỗi để chèn vào.
startOptional-
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ị
selectionStarthiện tại (đầu của lựa chọn hiện tại của người dùng). endOptional-
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ị
selectionEndhiện tại (cuối của lựa chọn hiện tại của người dùng). selectModeOptional-
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
<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
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> |