<sas:Button>
Used to create a Button in a JSP page. Generates the appropriate HTML 4.0/XHTML 1.0 BUTTON tag attributes to represent a button.
Syntax
<sas:Button
[accessKey="java.lang.String"]
[active="true|false"]
[alternateText="java.lang.String"]
[bottomImage="java.lang.String"]
[bottomLeftImage="java.lang.String"]
[bottomRightImage="java.lang.String"]
[buttonType="BUTTON|ANCHOR"]
[customAttributes="java.lang.String"]
[disabledAlternateText="java.lang.String"]
[disabledImage="java.lang.String"]
[dynamicButtonArea="LEFT|RIGHT|TOP_LEFT|TOP_RIGHT|TOP|BOTTOM_LEFT|BOTTOM_RIGHT|BOTTOM|BOTTOM_ALL|TOP_ALL|CENTER_ALL"]
[dynamicRootName="java.lang.String"]
[enabled="true|false"]
[epilog="java.lang.String"]
[focus="true|false"]
[height="int"]
[heightPercentage="int"]
[id="value"]
[image="java.lang.String"]
[imageLocation="java.lang.String"]
[imagePosition="LEFT|RIGHT"]
[instantiate="true|false"]
[label="java.lang.String"]
[leftImage="java.lang.String"]
[locale="java.util.Locale"]
[name="java.lang.String"]
[objectDataProperty="java.lang.String"]
[onBlur="java.lang.String"]
[onClick="java.lang.String"]
[onFocus="java.lang.String"]
[onKeyDown="java.lang.String"]
[onKeyPress="java.lang.String"]
[onKeyUp="java.lang.String"]
[onMouseDown="java.lang.String"]
[onMouseOut="java.lang.String"]
[onMouseOver="java.lang.String"]
[onMouseUp="java.lang.String"]
[prolog="java.lang.String"]
[ref="java.lang.String"]
[render="true|false"]
[rightImage="java.lang.String"]
[rolloverImage="java.lang.String"]
[scope="page|request|session|application"]
[styleClassPrefix="java.lang.String"]
[tabIndex="int"]
[target="java.lang.String"]
[title="java.lang.String"]
[topImage="java.lang.String"]
[topLeftImage="java.lang.String"]
[topRightImage="java.lang.String"]
[url="java.lang.String"]
[verifyEnabled="true|false"]
[width="int"]
[widthPercentage="int"]
[wrap="true|false"]>
[<sas:StyleMapKey .../>]
[<sas:SetProperty ...>
The value to set on the parent tag
</sas:SetProperty>]
[Additional <sas:StyleMapKey>, <sas:SetProperty> tags...]
</sas:Button>
Attributes
accessKey | The accesskey |
|---|---|
active | true if button is active, false otherwise |
alternateText | The text that provides tooltip when hovering over the image. |
bottomImage | the name of the image |
bottomLeftImage | the name of the image |
bottomRightImage | the name of the image |
buttonType | |
customAttributes | a list of attributes in the form of attribute="value", space delimited |
disabledAlternateText | The text that provides tooltip when hovering over the image. |
disabledImage | image displayed in the button |
dynamicButtonArea | the area of the button to be change dynamically when rollover, disabled and enabled. |
dynamicRootName | The image root value |
enabled | state of the button |
epilog | Text that is output immediately after the last markup tag. |
focus | the focus state of the button |
height | The height in pixels |
heightPercentage | The height as a percentage |
id | Case-sensitive name used to identify the object instance. |
image | image displayed in the button |
imageLocation | The imageLocation value |
imagePosition | of the image |
instantiate | Flag that, if true, indicates that a new instance of the underlying class should be loaded if one cannot be found in PageContext. Must be used with an id attribute. |
label | the label of the button |
leftImage | the name of the image |
locale | Specifies the locale to use for this instance of the class. |
name | Value assigned to the markup tag's name attribute. |
objectDataProperty | Value assigned to the output tag's objectDataProperty attribute. |
onBlur | The onBlur value |
onClick | The onClick value |
onFocus | The onFocus value |
onKeyDown | The onKeyDown |
onKeyPress | The onKeyPressValue |
onKeyUp | The onKeyUp value |
onMouseDown | The onMouseDown value |
onMouseOut | The onMouseOut value |
onMouseOver | The onMouseOver value |
onMouseUp | The onMouseDown value |
prolog | Text that is output immediately preceeding the first markup tag. |
ref | The variable String value that represents an object created earlier in the same scope. |
render | Flag that, if true, indicates that the complete markup of the bean is output when the tag is closed. It also sets the the visible property on the underlying TransformationBean. |
rightImage | the name of the image |
rolloverImage | image displayed when mouseover this button |
scope | The scope (or page context) within which the reference is available. |
styleClassPrefix | The styleClassPrefix to use for the button. |
tabIndex | The FormElement tabindex |
target | The value of the TARGET= argument on the anchor tag |
title | The title of the href |
topImage | the name of the image |
topLeftImage | the name of the image |
topRightImage | the name of the image |
url | the url associated with the button |
verifyEnabled | true or false |
width | The width in pixels |
widthPercentage | The width as a percentage |
wrap | true if label is wrapped; false otherwise |
More Information
To view the documentation for the related TransformationBean, see com.sas.servlet.tbeans.html.Button.
If you need to subclass the tag handler class for the sas:Button tag, extend com.sas.taglib.servlet.tbeans.ButtonTag.