| |||||||
FRAMES NO FRAMES |
Use the webuijsf:bubble
tag to display a bubble
component in the rendered HTML page. Bubble component is a pop up window which appears on screen in response to certain mouse interactions.The purpose of the bubble component is to provide detailed information to the end user when a mouse hovers on a particular screen element.
To include a bubble component in the JSP page, the web application developer will include a tag as follows:
<webuijsf:bubble id="bubble" title="Bubble Help Title">
<webuijsf:staticText text="Add help Text" />
</webuijsf:bubble>
None.
JavaScript Function | Description |
open(event) |
Use this function to open the bubble component.
|
close() |
Use this function to close bubble component. |
getProps() |
Use this function to get widget properties. Please see setProps()
function for a list of supported properties. |
refresh(execute) |
Use this function to
asynchronously refresh the component.
|
setProps(props) |
Use this function to change any of the following supported
properties:
|
subscribe(topic, obj, func) |
Use this function to subscribe
to an event topic.
|
When the component is manipulated on the client side, some functions might
publish event topics for custom AJAX implementations to listen for.
For example, you can listen for the refresh event topic by using:
<webuijsf:script>
var processEvents =
{
update: function(props) {
//
Do something...
}
}
// Subscribe to refresh event.
var domNode = document.getElementById("form1:test1");
domNode.subscribe(domNode.event.refresh.endTopic,
processEvents, "update");
</webuijsf:script>
The following events are supported.
Event | Description |
<Node>.bubble.event.refresh.beginTopic | Event topic published before asynchronously refreshing the
component. Supported properties include:
|
<Node>.event.refresh.endTopic | Event topic published after asynchronously refreshing the
component. Supported properties include: setProps() function.
|
<webuijsf:bubble id="bubble" autoClose="true" helpTitle="Bubble Help Title">
<webuijsf:staticText text="Bubble positioning examples..." />
</webuijsf:bubble>
<webuijsf:hyperlink id="topleft" onMouseOver="document.getElementById('form1:bubble').open(event);"
onMouseOut="document.getElementById('form1:bubble').close();"
text="Bubble with Left top arrow"/>
<webuijsf:bubble id="bubble" helpTitle="#{BubbleBean.titleText}">
<webuijsf:staticText text="Bubble refresh example..." />
</webuijsf:bubble>
<webuijsf:textField id="field1" text="#{BubbleBean.titleText}"
onKeyUp="return refreshBubble();"
/>
<webuijsf:script>
// Refresh bubble.
function refreshBubble() {
var domNode = document.getElementById("form1:bubble");
return domNode.refresh("form1:field1_field");
}
</webuijsf:script>
Tag Information | |
Tag Class | com.sun.webui.jsf.component.BubbleTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | ||||
Name | Required | Request-time | Type | Description |
binding | false | false | java.lang.String | A ValueExpression that resolves to the UIComponent that corresponds to this tag. This attribute allows the Java bean that contains the UIComponent to manipulate the UIComponent, its properties, and its children. |
htmlTemplate | false | false | java.lang.String | Alternative HTML template to be used by bubble component. |
focusId | false | false | java.lang.String | focusId is use to set the focus to the one of the elements inside bubble. By default focus is set to bubble header. |
openDelay | false | false | java.lang.String | Use to put a delay in ms before opening the bubble. |
styleClass | false | false | java.lang.String | CSS style class or classes to be applied to the outermost HTML element when this component is rendered. |
width | false | false | java.lang.String | Number of pixels for the width of the bubble help window. The default is 200px. |
title | false | false | java.lang.String | Text for popup help title. |
autoClose | false | false | java.lang.String | Use to close the bubble help automatically |
visible | false | false | java.lang.String | Use to indicate whether the component should be viewable by the user in the rendered HTML page. If set to false, the HTML code for the component is present in the page, but the component is hidden with style attributes. By default, visible is set to false, so HTML for the component HTML is included and not visible to the user. If the component is not visible, it can still be processed on subsequent form submissions because the HTML is present. |
style | false | false | java.lang.String | CSS style or styles to be applied to the outermost HTML element when this component is rendered. |
closeButton | false | false | java.lang.String | Use to display close button for bubble. |
tabIndex | false | false | java.lang.String | This tabIndex value is used for making bubble component accessible. The value must be one higher than the last tabIndex value provided to the bubble body element. |
duration | false | false | java.lang.String | Number of milli-seconds after which pop-up help window should close. The default is 2000 milliseconds. |
value | false | false | java.lang.String | No Description |
converter | false | false | java.lang.String | The converter attribute is used to specify a method to translate native
property values to String and back for this component. The converter
attribute value must be one of the following:
|
rendered | false | false | java.lang.String | Use the rendered attribute to indicate whether the HTML code for the component should be included in the rendered HTML page. If set to false, the rendered HTML page does not include the HTML for the component. If the component is not rendered, it is also not processed on any subsequent form submission. |
id | false | true | java.lang.String | No Description |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |