DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

IMAGEBUTTON

Creates a graphical submit button. The value of the src attribute specifies the URI of the image that will decorate the button. For accessibility reasons, authors should provide alternate text for the image via the alt attribute.

When a pointing device is used to click on the image, the form is submitted and the click coordinates passed to the server. The x value is measured in pixels from the left of the image, and the y value in pixels from the top of the image. The submitted data includes name.x=x-value and name.y=y-value where "name" is the value of the name attribute, and x-value and y-value are the x and y coordinate values, respectively.

If the server takes different actions depending on the location clicked, users of non-graphical browsers will be disadvantaged. For this reason, authors should consider alternate approaches:

  • Use multiple submit buttons (each with its own image) in place of a single graphical submit button. Authors may use style sheets to control the positioning of these buttons.
  • Use a client-side image map together with scripting.

accesskey

Description:
See general information for accesskey.

alt

Description:
See general information for alt.

class

Description:
See general information for class.

dir

Description:
See general information for dir.

disabled

Description:
See general information for disabled.

id

Description:
See general information for id.

label

Description:
See general information for label.

lang

Description:
See general information for lang.

layout

Description:
See general information for Layout and the imagebutton specific information.

name

Description:
See general information for name.

src

Description:
See general information for src.

style

Description:
See general information for style.

tabindex

Description:
See general information for tabindex.

title

Description:
See general information for title.

type

Description:
See general information for type.
Default:
image

value

Description:
See general information for value.

[tsref:(cObject).FORM.FormObject.IMAGEBUTTON]