inputSubmitObject.formEnctypeプロパティ

inputSubmitObject.formEnctypeは、送信ボタン(type属性がsubmitであるinput要素)のformEnctype属性の値を取得、もしくは、設定するプロパティ。

formEnctype属性には、送信データのエンコード方法を指定することができる。送信ボタンのformEnctype属性を指定した場合、送信ボタンが属するフォーム(form要素)のenctype属性よりも優先される。

構文

取得

var $formEnctype = $inputElementReference.formEnctype;

戻り値

送信ボタン(type属性がsubmitであるinput要素)のformEnctype属性の値。

設定

$inputElementReference.formEnctype = "encodeType";
encodeType
送信データのエンコード方法を指定する。
  • application/x-www-form-urlencoded:全ての文字をURLエンコードする。
  • multipart/form-data:フォームにファイルを送信する機能がある場合に指定する。
  • text/plain:スペースだけ「+」記号に変換する。その他の特殊文字はエンコードしない。

サンプル

送信ボタンのformEnctype属性の値:

【サンプルフォーム】
入力欄:

サンプルの動作について

  • 「送信」ボタンをクリックすると、【サンプルフォーム】の内容を送信する。
  • 「application/x-www-form-urlencoded」ボタンをクリックすると、「送信」ボタンのformEnctype属性値を「application/x-www-form-urlencoded」に設定する。「送信ボタンのformEnctype属性の値:」の右横に「application/x-www-form-urlencoded」と表示する。
  • 「multipart/form-data」ボタンをクリックすると、「送信」ボタンのformEnctype属性値を「multipart/form-data」に設定する。「送信ボタンのformEnctype属性の値:」の右横に「multipart/form-data」と表示する。
  • 「text/plain」ボタンをクリックすると、「送信」ボタンのformEnctype属性値を「text/plain」に設定する。「送信ボタンのformEnctype属性の値:」の右横に「text/plain」と表示する。

サンプルのソースコード

JavaScript

<script type="text/javascript">
function setFormEnctype( $formEnctype ) {
    var $elementReference = document.getElementById( "sample" );
    $elementReference.formEnctype = $formEnctype;
    var $formEnctype = $elementReference.formEnctype;
    document.getElementById( "sampleOutputA" ).innerHTML = $formEnctype;
}
</script>

HTML

<p>
    <button onclick="setFormEnctype('application/x-www-form-urlencoded');">application/x-www-form-urlencoded</button>
    <button onclick="setFormEnctype('multipart/form-data');">multipart/form-data</button>
    <button onclick="setFormEnctype('text/plain');">text/plain</button>
</p>
<p>送信ボタンのformEnctype属性の値:<span id="sampleOutputA"></span></p>
<form id="sampleForm" method="get" enctype="text/plain" action="http://alphasis.info/" target="_blank">
    【サンプルフォーム】
    <br />
    入力欄:<input type="text" name="s" value="JavaScript">
    <br />
    <input type="submit" value="送信" id="sample" formEnctype="application/x-www-form-urlencoded">
</form>

スポンサード リンク

カテゴリー: DOM, input type=submit オブジェクト, JavaScript, リファレンス パーマリンク