HOWTO · JavaScript

JavaScript でテキスト領域の値を取得する

この記事では、さまざまな例を使用して、テキスト領域の値を取得し、任意の変数に格納して JavaScript コードでさらに使用する方法を学習します。

このページの内容

<textarea> に入力された値を読むには、要素を取得して .value プロパティを読み取ります。その文字列を変数に保存しておけば、表示、処理、または別の関数への受け渡しに使えます。以下の例では、まずネイティブ DOM API を使い、次に代替手段として jQuery を使います。

JavaScript で textarea の値を取得する

<textarea> には開始タグと終了タグがあり、初期テキストはその間に記述します。ブラウザーでは、.value を使うと、ユーザーが編集した内容を含むコントロールの現在の値を取得できます。マークアップ内の初期テキストは開始時の値であり、その後の編集内容を読む方法としては適していません。

このページ全体の例では、ボタンがクリックされるまで待ってから textarea の値を読み取ります。getElementById() は、ID に一致する要素がない場合に null を返すため、コードでは要素の有無を確認してから .value を読み取ります。結果は <pre> 要素にテキストとして設定されるので、入力内容が HTML として解釈されることはありません。

このセクションのコードと表示されるラベルや出力は英語のままです。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Read a textarea value</title>
</head>
<body>
  <label for="message">Message</label>
  <textarea id="message">Write a message here.</textarea>
  <button id="read-message" type="button">Read value</button>
  <pre id="result" aria-live="polite"></pre>

  <script>
    const button = document.getElementById("read-message");
    const result = document.getElementById("result");

    button.addEventListener("click", () => {
      const textarea = document.getElementById("message");
      if (textarea === null) {
        result.textContent = "Textarea not found.";
        return;
      }

      const textValue = textarea.value;
      result.textContent = textValue;
    });
  </script>
</body>
</html>

ブラウザーを使わずに実行できる小さな JavaScript の例では、この代替オブジェクトが同じプロパティアクセスを示します。これは textarea の値を模したもので、ブラウザーのページを作成したりテストしたりするものではありません。

const textarea = { value: "A note from the user." };
const textValue = textarea.value;
console.log(textValue);

jQuery で textarea の値を取得する

jQuery では、textarea に一致するセレクターに .val() を呼び出します。$ を使うコードより前に jQuery のスクリプトを読み込んでください。そうしないと、イベントハンドラーの登録時に $ が未定義になることがあります。このページではボタンのクリック時に現在の値を読み取るため、クリック前に行われた編集も反映されます。

このセクションのコードと表示されるラベルや出力は英語のままです。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Read a textarea value with jQuery</title>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
</head>
<body>
  <label for="message">Message</label>
  <textarea id="message">Write a message here.</textarea>
  <button id="read-message" type="button">Read value</button>
  <pre id="result" aria-live="polite"></pre>

  <script>
    $(function () {
      $("#read-message").on("click", function () {
        const textValue = $("#message").val();
        $("#result").text(textValue);
      });
    });
  </script>
</body>
</html>

セレクター $("#message") は textarea と同じ ID を使います。.val() は現在の値を読み取り、.text() は結果要素にテキストとして設定します。textarea の ID を変更する場合は、セレクターも合わせて変更してください。この例は jQuery をネットワーク経由で読み込む必要があります。ライブラリを読み込めない場合は $ 関数を使えないため、この jQuery の例は実行できません。

よくある間違いと確認事項

  • textarea ではなく input を選択している: 複数行テキストコントロールの値を取得するには、実際の <textarea> 要素を使います。input:text のようなセレクターでは textarea は選択されません。
  • ユーザーが操作する前に読み取っている: .value を読むか .val() を呼び出すのは、イベントハンドラーなど、関連する操作の後に実行される処理にします。ページの初期化時に一度だけ読み取ると、その時点の値が取得されます。
  • ID またはセレクターが間違っている: getElementById() や $("#...") に指定する ID が textarea と完全に一致していることを確認します。ネイティブ JavaScript では、要素が存在しない可能性がある場合、.value にアクセスする前に null かどうかを確認します。
  • 初期テキストと現在のテキストを混同している: <textarea> と </textarea> の間にあるテキストは初期値です。編集後は元のマークアップに頼らず、現在の .value プロパティを読み取ります。

ライブラリが不要なら、ネイティブ DOM の例を使います。jQuery の例は、ページですでに jQuery を読み込んでいる場合や、プロジェクトが別の理由でそれに依存している場合に選んでください。