HTML/Elements/input/search

From W3C Wiki
< HTML‎ | Elements‎ | input
Revision as of 15:16, 15 March 2011 by Hiroki (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

<input type="search">

The search state represents a one line plain text edit control for the element's value.

Point

  • The difference between the Text state and the Search state is primarily stylistic: on platforms where search fields are distinguished from regular text fields, the Search state might result in an appearance consistent with the platform's search fields rather than appearing like a regular text field.


HTML Attributes

  • autocomplete = on/ off/ defult
    • on
      The on state indicates that the value is not particularly sensitive and the user can expect to be able to rely on his user agent to remember values he has entered for that control.
    • off
      The off state indicates either that the control's input data is particularly sensitive (for example the activation code for a nuclear weapon); or that it is a value that will never be reused (for example a one-time-key for a bank login) and the user will therefore have to explicitly enter the data each time, instead of being able to rely on the UA to prefill the value for him; or that the document provides its own autocomplete mechanism and does not want the user agent to provide autocompletion values.
    • defult
      The default state indicates that the user agent is to use the autocomplete attribute on the element's form owner instead. (By default, the autocomplete attribute of form elements is in the on state.)


  • list = ID reference
    Identify an element that lists predefined options suggested to the user.
    If present, its value must be the ID of a datalist element in the same document.


  • maxlength = positive integer
    Gives the maximum allowed value length of the element.


  • name = string
    Gives the name of the input element.


  • pattern =
    Specifies a regular expression against which the control's value is to be checked.
    If specified, the attribute's value must match the JavaScript Pattern production.
    When an input element has a pattern attribute specified, authors should include a title attribute to give a description of the pattern.


  • placeholder = string
    Represents a short hint (a word or short phrase) intended to aid the user with data entry.
    A hint could be a sample value or a brief description of the expected format. For a longer hint or other advisory text, the title attribute is more appropriate.


  • readonly = boolean
    Controls whether or not the user can edit the form control.


  • required = boolean
    When specified, the element is required.


  • size = valid non-negative integer
    The number of options meant to be shown by the control represented by its element.


  • value = string
    Gives the default value of the input element.


Examples

Example A

[try it]:

<input type="search" placeholder="Search">
<input type="submit" value="Search">

Input search01.png

HTML Reference

The HTML5 specification defines the Search state in 4.10.7.1.2 Text state and Search state.