Documentation

Search 

Contents

  1. Introduction
  2. Getting Started
  3. Seam Concepts
  4. Component Types
  5. Design View Support
  6. Code View Support
  7. Tag Object Toolbars
  8. Property Inspectors
Selected 9. Seam Tag Reference

10. Seam Tag Reference

Contents > Seam Tag Reference > s:button

s:button

The s:button tag displays an HTML button element on the page. This Seam UI control does not submit an HTML form when included on the page. Similar to s:link , this tag supports Seam conversation propagation when clicked.

Example

<s:button value="Hello"></s:button>

HTML Output

<input type="button" id="_id2" onclick="location.href='/index.jsf'" value="Hello" />

Tag Attributes

accesskey Text
 
The accesskey attribute is a standard HTML attribute that sets the access key that transfers focus to this element when pressed.
action Text
 
The action attribute accepts a method-binding expression for a backing bean action method to invoke when this component is activated by the user. An action method must be a public method with no parameters that returns a String. The returned string represents the logical outcome of the action (eg. "success", "failure", etc.) and is used by the JavaServer Faces MVC framework to determine which view to display next.
alt Text
 
The alt attribute is a standard HTML attribute that sets the alternate textual description rendered by this component.
binding Expression
 
The value-binding expression linking this component tag to a backing bean property.
dir Enumerated
 
The dir attribute is a standard HTML attribute that overrides the default text directionality for this component. The values accepted for this component are "LTR" (left-to-right) and "RTL" (right-to-left).
disabled Boolean
 
The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.
fragment Text
 
id Text
 
The unique identifier value for this component. The value must be unique within the closest naming container.
image File
 
lang Text
 
The lang attribute is a standard HTML attribute that sets the code describing the language to be used in the markup generated by this component.
onblur Text
 
The onblur attribute sets the JavaScript code to execute when this element loses focus.
onchange Text
 
The onchange attribute sets the JavaScript code to execute when this element loses focus and its value changes after gaining focus.
onclick Text
 
The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.
ondblclick Text
 
The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.
onfocus Text
 
The onfocus attribute sets the JavaScript code to execute when the element receives focus.
onkeydown Text
 
The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.
onkeypress Text
 
The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.
onkeyup Text
 
The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.
onmousedown Text
 
The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.
onmousemove Text
 
The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.
onmouseout Text
 
The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.
onmouseover Text
 
The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.
onmouseup Text
 
The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.
onselect Text
 
The onselect attribute sets the JavaScript code to execute when the user selects the text contained by this element.
pageflow Text
 
The JBoss business process management (jBPM) pageflow or process definition to invoke. Requires a propagation attribute with the value "begin" or "join".
propagation Enumerated
 
This attribute determines which Seam context propagation mode to use. Possible values include: begin, join, none, or end.
readonly Boolean
 
The readonly attribute is a boolean flag that when set to true prohibits changes to this element by the user. The element will continue to receive focus unless you set the disabled attribute to true.
rendered Boolean
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
size Text
 
The size attribute sets the width in characters of this input field.
style CSS Style
 
The style attribute sets the CSS style definition to be applied to this component when it is rendered.
styleClass CSS Class
 
The styleClass attribute sets the CSS class to apply to this component when it is rendered.
tabindex Text
 
The tabindex attribute is a standard HTML attribute that sets the order in which this element receives focus when the user cycles through the elements using the TAB key. The value for this attribute must be an integer between 0 and 32767.
taskInstance Text
 
title Text
 
The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.
type Text
 
value Text
 
The value attribute sets the current value for this component.
view File