aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/htmlinputelement/setrangetext/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'files/ja/web/api/htmlinputelement/setrangetext/index.md')
-rw-r--r--files/ja/web/api/htmlinputelement/setrangetext/index.md101
1 files changed, 101 insertions, 0 deletions
diff --git a/files/ja/web/api/htmlinputelement/setrangetext/index.md b/files/ja/web/api/htmlinputelement/setrangetext/index.md
new file mode 100644
index 0000000000..06d23ddd27
--- /dev/null
+++ b/files/ja/web/api/htmlinputelement/setrangetext/index.md
@@ -0,0 +1,101 @@
+---
+title: HTMLInputElement.setRangeText()
+slug: Web/API/HTMLInputElement/setRangeText
+tags:
+ - API
+ - HTMLInputElement
+translation_of: Web/API/HTMLInputElement/setRangeText
+---
+<div>{{APIRef("HTML DOM")}}</div>
+
+<p><span class="seoSummary"><strong><code>HTMLInputElement.setRangeText()</code></strong> メソッドを用いて,{{HTMLElement("input")}}や{{HTMLElement("textarea")}}要素において,文章の指定した範囲を新たな文字列で置き換えられます。</span></p>
+
+<h2 id="構文">構文</h2>
+
+<pre class="syntaxbox"><em>element</em>.setRangeText(<em>置換対象</em>);
+<em>element</em>.setRangeText(<em>置換対象</em>, <em>開始</em>, <em>終了</em> [, <em>選択状態</em>]);
+</pre>
+
+<h3 id="引数">引数</h3>
+
+<dl>
+ <dt><code>置換対象</code></dt>
+ <dd>挿入する文字列。</dd>
+ <dt><code>開始</code>{{optional_inline}}</dt>
+ <dd>置き換える最初の文字の位置を0始まりで指定します。既定は現在の<code>selectionStart</code>の値(利用者が現在選択している範囲の始め)です。</dd>
+ <dt><code>終了</code>{{optional_inline}}</dt>
+ <dd>置き換える最初の文字の<em>一つ後の</em>位置を0始まりで指定します。既定は現在の<code>selectionEnd</code>の値(利用者が現在選択している範囲の終わり)です。</dd>
+ <dt><code>選択状態</code>{{optional_inline}}</dt>
+ <dd>文章が置換された後,選択範囲がどのように振る舞うべきかを指定します。<br>
+ 次の値が有効です:
+ <ul>
+ <li><code>select</code>: 新規挿入した文章を選択する。</li>
+ <li><code>start</code>: 挿入した文書の直前に選択範囲を移動する。</li>
+ <li><code>end</code>: 挿入した文書の直後に選択範囲を移動する。</li>
+ <li><code>preserve</code>: 選択範囲を保持しようとします。既定です。</li>
+ </ul>
+ </dd>
+</dl>
+
+<h2 id="事例">事例</h2>
+
+<p>例中のボタンを押して,欄内の文章の一部を置換してみてください。新規挿入された文章は,その後強調(選択)されるでしょう。</p>
+
+<h3 id="HTML">HTML</h3>
+
+<pre class="brush: html">&lt;input type="text" id="text-box" size="18" value="この文章は更新されていません。"/&gt;
+&lt;button onclick="selectText()"&gt;文章を更新する&lt;/button&gt;
+</pre>
+
+<h3 id="JavaScript">JavaScript</h3>
+
+<pre class="brush: js">function selectText() {
+ const input = document.getElementById('text-box');
+ input.focus();
+ input.setRangeText('ました', 9, 14, 'select');
+}</pre>
+
+<h3 id="結果">結果</h3>
+
+<p>{{EmbedLiveSample("Example")}}</p>
+
+<h2 id="仕様書">仕様書</h2>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">仕様書</th>
+ <th scope="col">状態</th>
+ <th scope="col">備考</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>{{SpecName("HTML WHATWG", "forms.html#dom-textarea/input-setrangetext", "HTMLInputElement.setSelectionRange()")}}</td>
+ <td>{{Spec2("HTML WHATWG")}}</td>
+ <td>変更なし</td>
+ </tr>
+ <tr>
+ <td>{{SpecName("HTML5 W3C", "forms.html#dom-textarea/input-setrangetext", "HTMLInputElement.setSelectionRange()")}}</td>
+ <td>{{Spec2("HTML5 W3C")}}</td>
+ <td>初回定義</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="ブラウザ互換性">ブラウザ互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.HTMLInputElement.setRangeText")}}</p>
+</div>
+
+<h2 id="関連項目">関連項目</h2>
+
+<ul>
+ <li>{{HTMLElement("input")}}</li>
+ <li>{{HTMLElement("textarea")}}</li>
+ <li>{{domxref("HTMLInputElement")}}</li>
+ <li>{{domxref("Selection")}}</li>
+</ul>