File: input.html

package info (click to toggle)
wdg-html-reference 4.0-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 4,528 kB
  • ctags: 305
  • sloc: makefile: 39
file content (112 lines) | stat: -rw-r--r-- 6,544 bytes parent folder | download
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<!-- Thanks for reading the source of this document. Hope you enjoy -->
<!-- what you find here. Please let me know if you find any errors. -->
<HEAD>
<TITLE>INPUT - Input field</TITLE>
<META NAME="description" CONTENT="Wilbur is the name for the next HTML standard (3.2). Here you can find all the tags in this proposal, including tips on usage and limitations.">
<META NAME="keywords" CONTENT="html authoring, reference, wilbur, tag overview">
<META NAME="generator" CONTENT="Orb v1.3 for OS/2">
<META NAME="author" CONTENT="Arnoud Engelfriet">
<LINK REV="made" HREF="mailto:galactus@htmlhelp.com" TITLE="Wilbur feedback">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080"
ALINK="#000080">
<H1 ALIGN=CENTER>INPUT - Input field</H1>

<TABLE>
<TR>
<TH VALIGN=TOP ALIGN=LEFT><B>Appearance:</B></TH> 
<TD VALIGN=TOP>&lt;INPUT TYPE=x NAME=y&gt;<BR></TD>
</TR>
<TR>
<TH VALIGN=TOP ALIGN=LEFT><B>Attributes:</B></TH> 
<TD VALIGN=TOP>TYPE=text|password|checkbox|radio|submit|reset|file|hidden|image, NAME=<CODE>string</CODE>, VALUE=<CODE>string</CODE>, CHECKED, SIZE=<CODE>n</CODE>, MAXLENGTH=<CODE>n</CODE>, SRC=<CODE>URL</CODE>, ALIGN=top|middle|bottom|left|right<BR></TD>
</TR>
<TR>
<TH VALIGN=TOP ALIGN=LEFT><B>Contents:</B></TH> 
<TD VALIGN=TOP>None (<A HREF="../../../glossary/glossary.html#empty">Empty</A>).<BR></TD>
</TR>
<TR>
<TH VALIGN=TOP ALIGN=LEFT><B>May occur in:</B></TH> 
<TD VALIGN=TOP><A HREF="../body/body.html">BODY</A>, <A HREF="../block/div.html">DIV</A>, <A HREF="../block/center.html">CENTER</A>, <A HREF="../block/blockquote.html">BLOCKQUOTE</A>, <A HREF="../block/form.html">FORM</A>, <A HREF="../table/th.html">TH</A>, <A HREF="../table/td.html">TD</A>, <A HREF="../list/dt.html">DT</A>, <A HREF="../list/dd.html">DD</A>, <A HREF="../list/li.html">LI</A>, <A HREF="../block/p.html">P</A>, <A HREF="../block/h1.html">H1</A>, <A HREF="../block/h2.html">H2</A>, <A HREF="../block/h3.html">H3</A>, <A HREF="../block/h4.html">H4</A>, <A HREF="../block/h5.html">H5</A>, <A HREF="../block/h6.html">H6</A>, <A HREF="../block/pre.html">PRE</A>, <A HREF="../block/address.html">ADDRESS</A>, <A HREF="../font/tt.html">TT</A>, <A HREF="../font/i.html">I</A>, <A HREF="../font/b.html">B</A>, <A HREF="../font/u.html">U</A>, <A HREF="../font/strike.html">STRIKE</A>, <A HREF="../font/big.html">BIG</A>, <A HREF="../font/small.html">SMALL</A>, <A HREF="../font/sub.html">SUB</A>, <A HREF="../font/sup.html">SUP</A>, <A HREF="../phrase/em.html">EM</A>, <A HREF="../phrase/strong.html">STRONG</A>, <A HREF="../phrase/dfn.html">DFN</A>, <A HREF="../phrase/code.html">CODE</A>, <A HREF="../phrase/samp.html">SAMP</A>, <A HREF="../phrase/kbd.html">KBD</A>, <A HREF="../phrase/var.html">VAR</A>, <A HREF="../phrase/cite.html">CITE</A>, <A HREF="../special/font.html">FONT</A>, <A HREF="../special/a.html">A</A>, <A HREF="../special/applet.html">APPLET</A>, <A HREF="../table/caption.html">CAPTION</A>, but must be inside a <A HREF="../block/form.html">FORM</A>.<BR></TD>
</TR>
</TABLE>

<P>
The INPUT tag is probably the most useful tag inside forms. It can
generate buttons, input fields and checkboxes. In all cases, the NAME
attribute must be set. 
<DL>
<DT>TYPE=text
<DD>This generates a input field, where the user can enter up to
MAXLENGTH characters. The SIZE attribute lists the length of the input
field (if the user enters more characters, the text will scroll). The
VALUE attribute specifies the initial value for the input field.
<DT>TYPE=password
<DD>Same as TYPE=text, but the text will be hidden by "*" or similar
characters. It is still sent in the clear to the server, though.
<DT>TYPE=checkbox
<DD>Produces a checkbox. It has two states, on and off. When it is on
when the form is submitted, it will be sent as "name=on", otherwise
it is ignored altogether. If you use CHECKED, it will come up checked
(selected) initially.
<DT>TYPE=radio
<DD>Produces a radio button. A radio button always exists in a group.
All members of this group should have the same NAME attribute, and
different VALUEs. The VALUE of the selected radio button will be sent
to the server. You must specify CHECKED on exactly one radio button,
which then will come up selected initially.
<DT>TYPE=submit
<DD>Produces a button, which when pressed sends the contents of the
form to the server. You can have more than one submit button in the form.
Each should have a different NAME. The name and value of the pressed
button will be sent to the server as well. The value of the VALUE attribute 
is typically used as text on the submit button.
<DT>TYPE=reset
<DD>Also produces a button, which will restore the form to its original
state if pressed. The value of the VALUE attribute is typically used as 
text on the reset button.
<DT>TYPE=file
<DD>Allows the user to upload a file. It is still very new, so it is
not very widely supported. It is typically presented as an input box
with a button to start browsing the local hard disk. This way, a user
can specify one or more filename(s) to upload. 
<DT>TYPE=hidden
<DD>Allows you to embed information in the form which you do not want
changed. This can be useful if the document is generated by a script
and you need to store state information. NAME and VALUE of this input
field will be sent to the server without modifications.
<DT>TYPE=image
<DD>Functions similar to a submit button, but uses an image instead.
The ALIGN attribute controls the alignment of the image. The coordinates
of the selected region will also be sent to the server, in the form
of "NAME.x=<CODE>n</CODE>&amp;NAME.y=<CODE>n</CODE>". A text browser will treat it as
identical to a normal submit button.
</DL>

  <H2>Notes:</H2>
<UL>

<LI>Do not expect that if you set MAXLENGTH, you will get no more than
so many characters. Anyone can modify his local copy of your form to
enter as many characters as he wants.
</UL>
<HR>
<CENTER>
<P>
<B><IMG SRC="../icon/wdglogo-small.gif" WIDTH=105 HEIGHT=40 ALT="Web Design Group" ALIGN=RIGHT></B><BR>
<A HREF="../index.html" TITLE="Index for Wilbur">Wilbur index</A>&nbsp;~
<A HREF="../overview.html" TITLE="Overview of HTML 3.2 tags">Tag overview</A>&nbsp;~
<A HREF="mailto:galactus@htmlhelp.com" TITLE="Wilbur reference feedback">Feedback</A>
<P>
<SMALL>
Copyright &copy; 1997 <A HREF="http://www.stack.nl/%7Egalactus/">Arnoud "Galactus" Engelfriet</A>.
</SMALL>
</CENTER>
</BODY>
</HTML>