HTMLInputElement.setRangeText() method replaces a range of text in an <input> or <textarea> element with a new string.

句法

element.setRangeText(replacement);
element.setRangeText(replacement, start, end [, selectMode]);
					

参数

replacement

The string to insert.

start 可选
The 0-based index of the first character to replace. Defaults to the current selectionStart value (the start of the user's current selection).
end 可选
The 0-based index of the character after the last character to replace. Defaults to the current selectionEnd value (the end of the user's current selection).
selectMode 可选
A string defining how the selection should be set after the text has been replaced. Possible values:
  • "select" selects the newly inserted text.
  • "start" moves the selection to just before the inserted text.
  • "end" moves the selection to just after the inserted text.
  • "preserve" attempts to preserve the selection. This is the default.

范例

Click the button in this example to replace part of the text in the text box. The newly inserted text will be highlighted (selected) afterwards.

HTML

<input type="text" id="text-box" size="30" value="This text has NOT been updated.">
<button onclick="selectText()">Update text</button>
					

JavaScript

function selectText() {
  const input = document.getElementById('text-box');
  input.focus();
  input.setRangeText('ALREADY', 14, 17, 'select');
}
					

结果

规范

规范 状态 注释
HTML 实时标准
The definition of 'HTMLInputElement.setSelectionRange()' in that specification.
实时标准 无变化
HTML5
The definition of 'HTMLInputElement.setSelectionRange()' in that specification.
推荐 初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
setRangeText Chrome 24 Edge 不支持 No Firefox 27 IE 不支持 No Opera Yes Safari 6.1 WebView Android Yes Chrome Android 25 Firefox Android Yes Opera Android Yes Safari iOS 7 Samsung Internet Android Yes

图例

完整支持

完整支持

不支持

不支持

另请参阅

元数据

  • 最后修改:
  1. HTMLInputElement
  2. 特性
    1. labels
    2. multiple
    3. webkitdirectory
    4. webkitEntries
  3. 方法
    1. mozGetFileNameArray()
    2. mozSetFileNameArray()
    3. select()
    4. setRangeText()
    5. setSelectionRange()
    6. stepDown()
    7. stepUp()
  4. 事件
    1. 无效
    2. search
  5. 继承:
    1. HTMLElement
    2. 元素
    3. 节点
    4. EventTarget
  6. HTML DOM 相关页面
    1. BeforeUnloadEvent
    2. DOMStringMap
    3. ErrorEvent
    4. GlobalEventHandlers
    5. HTMLAnchorElement
    6. HTMLAreaElement
    7. HTMLAudioElement
    8. HTMLBRElement
    9. HTMLBaseElement
    10. HTMLBaseFontElement
    11. HTMLBodyElement
    12. HTMLButtonElement
    13. HTMLCanvasElement
    14. HTMLContentElement
    15. HTMLDListElement
    16. HTMLDataElement
    17. HTMLDataListElement
    18. HTMLDialogElement
    19. HTMLDivElement
    20. HTMLDocument
    21. HTMLElement
    22. HTMLEmbedElement
    23. HTMLFieldSetElement
    24. HTMLFormControlsCollection
    25. HTMLFormElement
    26. HTMLFrameSetElement
    27. HTMLHRElement
    28. HTMLHeadElement
    29. HTMLHeadingElement
    30. HTMLHtmlElement
    31. HTMLIFrameElement
    32. HTMLImageElement
    33. HTMLIsIndexElement
    34. HTMLKeygenElement
    35. HTMLLIElement
    36. HTMLLabelElement
    37. HTMLLegendElement
    38. HTMLLinkElement
    39. HTMLMapElement
    40. HTMLMediaElement
    41. HTMLMetaElement
    42. HTMLMeterElement
    43. HTMLModElement
    44. HTMLOListElement
    45. HTMLObjectElement
    46. HTMLOptGroupElement
    47. HTMLOptionElement
    48. HTMLOptionsCollection
    49. HTMLOutputElement
    50. HTMLParagraphElement
    51. HTMLParamElement
    52. HTMLPictureElement
    53. HTMLPreElement
    54. HTMLProgressElement
    55. HTMLQuoteElement
    56. HTMLScriptElement
    57. HTMLSelectElement
    58. HTMLShadowElement
    59. HTMLSourceElement
    60. HTMLSpanElement
    61. HTMLStyleElement
    62. HTMLTableCaptionElement
    63. HTMLTableCellElement
    64. HTMLTableColElement
    65. HTMLTableDataCellElement
    66. HTMLTableElement
    67. HTMLTableHeaderCellElement
    68. HTMLTableRowElement
    69. HTMLTableSectionElement
    70. HTMLTemplateElement
    71. HTMLTextAreaElement
    72. HTMLTimeElement
    73. HTMLTitleElement
    74. HTMLTrackElement
    75. HTMLUListElement
    76. HTMLUnknownElement
    77. HTMLVideoElement
    78. HashChangeEvent
    79. 历史
    80. ImageData
    81. 定位
    82. MessageChannel
    83. MessageEvent
    84. MessagePort
    85. Navigator
    86. NavigatorGeolocation
    87. NavigatorID
    88. NavigatorLanguage
    89. NavigatorOnLine
    90. NavigatorPlugins
    91. PageTransitionEvent
    92. Plugin
    93. PluginArray
    94. PopStateEvent
    95. PortCollection
    96. PromiseRejectionEvent
    97. RadioNodeList
    98. Transferable
    99. ValidityState
    100. Window
    101. WindowBase64
    102. WindowEventHandlers
    103. WindowTimers