files/ja/web/html/attributes/minlength/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

---
title: 'HTML 属性: minlength'
slug: Web/HTML/Attributes/minlength
tags:
  - Attribute
  - Input
  - Reference
  - minlength
  - textarea
translation_of: Web/HTML/Attributes/minlength
---
<p>{{HTMLSidebar}}</p>

<p class="summary"><strong><code>minlength</code></strong> 属性は、ユーザーが {{htmlelement('input')}} または {{htmlelement('textarea')}} に入力できる最小文字数を (UTF-16 コード単位で) 定義します。 0 以上の整数値である必要があります。 minlength が指定されなかった場合、または無効な値が指定された場合は、 input や textarea には最小文字数が設定されません。この値は <a href="/ja/docs/Web/HTML/Attributes/maxlength">maxlength</a> の値以下である必要があります。そうでなければどちらの条件にも合わせることができないので、この値が有効になることはありません。</p>

<p>フィールドのテキスト値の長さが minlength を UTF-16 コード単位の長さで下回った場合、入力欄は制約検証に失敗し、 {{domxref('validityState.tooShort')}} が <code>true</code> を返します。制約検証は、ユーザーが値を変更した場合にのみ適用されます。送信に失敗すると、ブラウザーによっては必要な最小文字列と現在の長さを示してエラーメッセージを表示します。</p>

<h2 id="Examples" name="Examples">例</h2>

<p><code>minlength="5"</code> を追加すると、値は空か5文字以上でないと有効にはならなくなります。</p>

<pre class="brush: html notranslate">&lt;label for="fruit"&gt;Enter a fruit name that is at least 5 letters long&lt;/label&gt; &lt;input type="text" minlength="5" id="fruit"&gt;</pre>

<p>擬似クラスを使用すると、要素を値が有効かどうかによってスタイル付けすることができます。この値は null (空欄) または5文字以上であれば有効になります。<em>ライム色</em>は無効であり、<em>レモン色は有効です</em>。</p>

<pre class="brush: css notranslate">input {
  border: 2px solid currentcolor;
}
input:invalid {
  border: 2px dashed red;
}
input:invalid:focus {
  background-image: linear-gradient(pink, lightgreen);
}</pre>

<p>{{EmbedLiveSample('Examples', '100%', 200)}}</p>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'input.html#attr-input-minlength', 'minlength attribute')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5.1', 'input.html#attr-minlength-accept', 'minlength attribute')}}</td>
   <td>{{Spec2('HTML5.1')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>

<p>{{Compat("html.elements.attribute.minlength")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li><a href="/ja/docs/Web/HTML/Attributes/maxlength">maxlength</a></li>
 <li><a href="/ja/docs/Web/HTML/Attributes/size">size</a></li>
 <li><a href="/ja/docs/Web/HTML/Attributes/pattern">pattern</a></li>
 <li><a href="/ja/docs/Web/Guide/HTML/HTML5/Constraint_validation">制約検証</a></li>
</ul>