<ISINDEX>

Description

This element will show an text input field. After pressing the <Enter> key the browser will construct a new URL, with the current address, a question mark and the text the user entered in the text field, and send it to the server.

You can put the element in the HEAD or the BODY section.

When used with Netscape Navigator and put it in the HEAD section of the document, the attributes ALINK, BACKGROUND, BGCOLOR, LINK, TEXT, and VLINK of the BODY element will not be used.

The semantics for ISINDEX are currently well defined only when the base URL for the enclosing document is an HTTP URL. Typically, when the user presses the enter (return) key, the query string is sent to the server identified by the base URL for this document. For example, if the query string entered is "ten green apples" and the base URL is:

http://www.acme.com/

then the query generated is: http://www.acme.com/?ten+green+apples

Note that space characters are mapped to "+" characters and that normal URL character escaping mechanisms apply. For further details see the HTTP specification.

Note in practice, the query string is restricted to Latin-1 as there is no current mechanism for the URL to specify a character set for the query.

DTD

Note: This element is deprecated, and this DTD fragment is taken from the
      Transitional DTD.

<!ELEMENT ISINDEX - O EMPTY            -- single line prompt -->
<!ATTLIST ISINDEX
  %coreattrs;                          -- id, class, style, title --
  %i18n;                               -- lang, dir --
  prompt      %Text;         #IMPLIED  -- prompt message --
  >

Attributes

Core attributes: class id style title
Internationalization attributes: dir lang

ACTION
Specify the address to which the input must be send.

PROMPT
This attribute lets you specify what message you want to appear before the text input field of the index. The default is: "This is a searchable index. Enter search keywords:"

TARGET
The TARGET attribute forces the load of the result of the query into the targeted window. The value supplied with the attribute must be the same as the name of the window, and is case-sensitive. You can give a window a name with the FRAME element. If a window with the supplied target name does not exists then a new window will be created with that name.
If you do not specify a target window the current window will be used, or the target specified with the BASE element.

Magic TARGET names
These names all begin with the underscore character. Any targeted window name beginning with underscore which is not one of these names, will be ignored.

Value Description

_blank This target will cause the link to always be loaded in a new blank window. This window is not named.

_self This target causes the link to always load in the same window the anchor was clicked in. This is useful for overriding a globally assigned BASE target.

_parent This target makes the link load in the immediate FRAMESET parent of this document. This defaults to acting like _self if the document has no parent.

_top This target makes the link load in the full body of the window. This defaults to acting like _self if the document is already at the top. It is useful for breaking out of an arbitrarily deep FRAME nesting.

Value	Description
_blank	This target will cause the link to always be loaded in a new blank window. This window is not named.
_self	This target causes the link to always load in the same window the anchor was clicked in. This is useful for overriding a globally assigned BASE target.
_parent	This target makes the link load in the immediate FRAMESET parent of this document. This defaults to acting like `_self` if the document has no parent.
_top	This target makes the link load in the full body of the window. This defaults to acting like `_self` if the document is already at the top. It is useful for breaking out of an arbitrarily deep FRAME nesting.

Examples

<ISINDEX action="ISINDEX1.html" prompt="Enter your query" target="_top"> and

press enter.

and press enter.