|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.cabo.ui.DeprecatedUINode | +--oracle.cabo.ui.BaseUINode | +--oracle.cabo.ui.BaseMutableUINode | +--oracle.cabo.ui.beans.BaseWebBean | +--oracle.cabo.ui.beans.MarlinBean | +--oracle.cabo.ui.beans.layout.HideShowBean
On mobile devices the hideShow renders nothing itself, but does renders its indexed children.
The hideShow can have a PROMPT child. This child is rendered next to the hide or show icon. This child defaults to a link. The link's destination is the same as the destination of the hide or show icon. The link's text defaults to "Hide" and "Show", but can be set with the UNDISCLOSED_TEXT and DISCLOSED_TEXT attributes.
The ID attribute is used to specify the name which is used to identify the HideShow in client-server events.
The DISCLOSED atrribute toggles the HideShow's children between being disclosed or undisclosed. This attribute may be set to Boolean.TRUE or Boolean.FALSE. By default, this attribute will be Boolean.FALSE.
The text of the HideShow comes from the DISCLOSED_TEXT and UNDISCLOSED_TEXT attributes. In almost all cases, the DISCLOSED_TEXT should consist of the word "Hide" plus a description of the HideShow's children, and the UNDISCLOSED_TEXT should consist of the word "Show" plus a description of the children. The default values for these attributes are "Hide" and "Show".
The FORM_SUBMITTED attribute indicates whether or not to submit data through form submission. The default value is Boolean.FALSE.
The name of the form to be submitted can be specified through the FORM_NAME attribute. If no name is specified, the form to which the HideShow belongs will be used.
If the FORM_SUBMITTED attribute is Boolean.FALSE, the links generated by the HideShow will be URLs based on the DESTINATION attribute. If no destination is specified, the default URL for the page will be used.
The SELECTED attribute indicates whether or not to display the hideShow icon and prompt as selected.
An interactive hideShow
<ctrl:content> <dataScope xmlns="http://xmlns.oracle.com/uix/ui"> <provider> <data name="hideShow"> <method class="oracle.cabo.doc.demo.HideShowData" method="getData"/> </data> </provider> <contents> <hideShow formSubmitted="true" id="hideShow" data:disclosed="show@hideShow"> <contents> <header text="Header"> <contents> <header text="SubHeader"/> </contents> </header> </contents> </hideShow> </contents> </dataScope> </ctrl:content> <handlers xmlns="http://xmlns.oracle.com/uix/controller"> <event name="hide"> <method class="oracle.cabo.doc.demo.HideShowData" method="hideEventHandler"/> </event> <event name="show"> <method class="oracle.cabo.doc.demo.HideShowData" method="showEventHandler"/> </event> </handlers>
Constructor Summary | |
|
HideShowBean()
Construct an instance of the HideShowBean. |
protected |
HideShowBean(boolean ignored,
java.lang.String localName)
Construct an instance of the HideShowBean. |
|
HideShowBean(java.lang.String id)
Construct an instance of the HideShowBean. |
|
HideShowBean(java.lang.String id,
java.lang.String destination)
Construct an instance of the HideShowBean. |
|
HideShowBean(java.lang.String id,
java.lang.String disclosedText,
java.lang.String undisclosedText)
Construct an instance of the HideShowBean. |
|
HideShowBean(java.lang.String id,
java.lang.String disclosedText,
java.lang.String undisclosedText,
java.lang.String destination)
Construct an instance of the HideShowBean. |
Method Summary | |
java.lang.String |
getDestination()
Gets base destination for the hide/show link. |
static java.lang.String |
getDestination(MutableUINode bean)
Gets base destination for the hide/show link. |
java.lang.String |
getDisclosedText()
Gets the text to display when the children are shown |
static java.lang.String |
getDisclosedText(MutableUINode bean)
Gets the text to display when the children are shown |
java.lang.String |
getFormName()
Gets form to which HideShow events should be submitted. |
static java.lang.String |
getFormName(MutableUINode bean)
Gets form to which HideShow events should be submitted. |
java.lang.String |
getPartialRenderMode()
Gets |
static java.lang.String |
getPartialRenderMode(MutableUINode bean)
Gets |
java.lang.String[] |
getPartialTargets()
Gets The IDs of the partial target nodes to render when the partialRenderMode is set to "multiple". |
static java.lang.String[] |
getPartialTargets(MutableUINode bean)
Gets The IDs of the partial target nodes to render when the partialRenderMode is set to "multiple". |
UINode |
getPrompt()
Child rendered next to the hide or show icon. |
static UINode |
getPrompt(MutableUINode bean)
Child rendered next to the hide or show icon. |
java.lang.String |
getUndisclosedText()
Gets the text to display when the children are hidden |
static java.lang.String |
getUndisclosedText(MutableUINode bean)
Gets the text to display when the children are hidden |
boolean |
isDisclosed()
Gets whether or not to disclose the children This attribute is not supported on the following agent types: pda. |
static boolean |
isDisclosed(MutableUINode bean)
Gets whether or not to disclose the children This attribute is not supported on the following agent types: pda. |
boolean |
isFormSubmitted()
Gets whether or not to use form sumission in the Hide/Show link. |
static boolean |
isFormSubmitted(MutableUINode bean)
Gets whether or not to use form sumission in the Hide/Show link. |
boolean |
isSelected()
Gets whether or not the hideShow is selected. |
static boolean |
isSelected(MutableUINode bean)
Gets whether or not the hideShow is selected. |
boolean |
isUnvalidated()
Gets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
static boolean |
isUnvalidated(MutableUINode bean)
Gets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
static void |
setDestination(MutableUINode bean,
java.lang.String destination)
Sets base destination for the hide/show link. |
void |
setDestination(java.lang.String destination)
Sets base destination for the hide/show link. |
void |
setDestinationBinding(BoundValue boundValue)
Binds the base destination for the hide/show link. |
static void |
setDestinationBinding(MutableUINode bean,
BoundValue boundValue)
Binds the base destination for the hide/show link. |
static void |
setDestinationBinding(MutableUINode bean,
java.lang.Object selectKey)
Binds the base destination for the hide/show link. |
static void |
setDestinationBinding(MutableUINode bean,
java.lang.String dataNamespace,
java.lang.String dataName,
java.lang.Object selectKey)
Binds the base destination for the hide/show link. |
void |
setDestinationBinding(java.lang.Object selectKey)
Binds the base destination for the hide/show link. |
void |
setDestinationBinding(java.lang.String dataNamespace,
java.lang.String dataName,
java.lang.Object selectKey)
Binds the base destination for the hide/show link. |
void |
setDisclosed(boolean disclosed)
Sets whether or not to disclose the children This attribute is not supported on the following agent types: pda. |
static void |
setDisclosed(MutableUINode bean,
boolean disclosed)
Sets whether or not to disclose the children This attribute is not supported on the following agent types: pda. |
static void |
setDisclosedText(MutableUINode bean,
java.lang.String disclosedText)
Sets the text to display when the children are shown |
void |
setDisclosedText(java.lang.String disclosedText)
Sets the text to display when the children are shown |
static void |
setFormName(MutableUINode bean,
java.lang.String formName)
Sets form to which HideShow events should be submitted. |
void |
setFormName(java.lang.String formName)
Sets form to which HideShow events should be submitted. |
void |
setFormSubmitted(boolean formSubmitted)
Sets whether or not to use form sumission in the Hide/Show link. |
static void |
setFormSubmitted(MutableUINode bean,
boolean formSubmitted)
Sets whether or not to use form sumission in the Hide/Show link. |
static void |
setPartialRenderMode(MutableUINode bean,
java.lang.String partialRenderMode)
Sets |
void |
setPartialRenderMode(java.lang.String partialRenderMode)
Sets |
static void |
setPartialTargets(MutableUINode bean,
java.lang.String[] partialTargets)
Sets The IDs of the partial target nodes to render when the partialRenderMode is set to "multiple". |
void |
setPartialTargets(java.lang.String[] partialTargets)
Sets The IDs of the partial target nodes to render when the partialRenderMode is set to "multiple". |
static void |
setPrompt(MutableUINode bean,
UINode promptNode)
Child rendered next to the hide or show icon. |
void |
setPrompt(UINode promptNode)
Child rendered next to the hide or show icon. |
void |
setSelected(boolean selected)
Sets whether or not the hideShow is selected. |
static void |
setSelected(MutableUINode bean,
boolean selected)
Sets whether or not the hideShow is selected. |
static void |
setTranslatableDisclosedText(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the text to display when the children are shown |
void |
setTranslatableDisclosedText(java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the text to display when the children are shown |
static void |
setTranslatableUndisclosedText(MutableUINode bean,
java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the text to display when the children are hidden |
void |
setTranslatableUndisclosedText(java.lang.String bundleName,
java.lang.String key)
Binds to a ResourceBundle the the text to display when the children are hidden |
static void |
setUndisclosedText(MutableUINode bean,
java.lang.String undisclosedText)
Sets the text to display when the children are hidden |
void |
setUndisclosedText(java.lang.String undisclosedText)
Sets the text to display when the children are hidden |
void |
setUnvalidated(boolean unvalidated)
Sets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
static void |
setUnvalidated(MutableUINode bean,
boolean unvalidated)
Sets If this element is used in formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. |
Methods inherited from class oracle.cabo.ui.beans.MarlinBean |
isEqualMarlinName |
Methods inherited from class oracle.cabo.ui.BaseUINode |
getAttributeNames, getAttributeValue, getAttributeValueImpl, getChildArray, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getPreorderDescendentAttributeValue, getRawAttributeValue, getRenderedUINode, getRenderer, getRenderer, render, render, toString |
Methods inherited from class oracle.cabo.ui.DeprecatedUINode |
getAttributeValue, getChildNames, getNamedChild |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface oracle.cabo.ui.UINode |
getAttributeNames, getAttributeValue, getAttributeValue, getChildNames, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getRawAttributeValue, render, render |
Constructor Detail |
public HideShowBean()
public HideShowBean(java.lang.String id)
id
- the page-wide unique client ID of this node.public HideShowBean(java.lang.String id, java.lang.String disclosedText, java.lang.String undisclosedText)
id
- the page-wide unique client ID of this node.disclosedText
- the text to display when the children are shownundisclosedText
- the text to display when the children are hiddenpublic HideShowBean(java.lang.String id, java.lang.String destination)
id
- the page-wide unique client ID of this node.destination
- base destination for the hide/show link.public HideShowBean(java.lang.String id, java.lang.String disclosedText, java.lang.String undisclosedText, java.lang.String destination)
id
- the page-wide unique client ID of this node.disclosedText
- the text to display when the children are shownundisclosedText
- the text to display when the children are hiddendestination
- base destination for the hide/show link.protected HideShowBean(boolean ignored, java.lang.String localName)
Method Detail |
public final UINode getPrompt()
public final void setPrompt(UINode promptNode)
public final boolean isSelected()
public final void setSelected(boolean selected)
public final boolean isDisclosed()
public final void setDisclosed(boolean disclosed)
public final java.lang.String getDisclosedText()
public final void setDisclosedText(java.lang.String disclosedText)
public final void setTranslatableDisclosedText(java.lang.String bundleName, java.lang.String key)
bundleName
- the name of the ResourceBundlekey
- the key of the string to retrieve from the ResourceBundlepublic final java.lang.String getUndisclosedText()
public final void setUndisclosedText(java.lang.String undisclosedText)
public final void setTranslatableUndisclosedText(java.lang.String bundleName, java.lang.String key)
bundleName
- the name of the ResourceBundlekey
- the key of the string to retrieve from the ResourceBundlepublic final java.lang.String getDestination()
public final void setDestination(java.lang.String destination)
public final void setDestinationBinding(BoundValue boundValue)
boundValue
- a BoundValue implementation to be used
to retrieve the value.public final void setDestinationBinding(java.lang.Object selectKey)
selectKey
- the key to be passed to selectValue()
on the
current DataObject
, e.g., the DataObject for the current
table row.public final void setDestinationBinding(java.lang.String dataNamespace, java.lang.String dataName, java.lang.Object selectKey)
dataNamespace
- the namespace to be passed to
RenderingContext.getDataObject()
dataName
- the name to be passed to
RenderingContext.getDataObject()
selectKey
- the key to be passed to selectValue()
on the
DataObject
.public final boolean isFormSubmitted()
public final void setFormSubmitted(boolean formSubmitted)
public final boolean isUnvalidated()
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public final void setUnvalidated(boolean unvalidated)
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public final java.lang.String getFormName()
public final void setFormName(java.lang.String formName)
public final java.lang.String getPartialRenderMode()
The partialRenderMode attribute is used to control the hideShow component's partial page rendering behavior. partialRenderMode defaults to "none", in which case full page rendering is used to hide/show the contents of the hideShow component. When partialRenderMode is set to "self" or "multiple", partial page rendering is used to re-render the hideShow component's contents as they are hidden/shown.
In order to enable partial page rendering, the hideShow component's id attribute must be set, the hideShow component must be contained in with an UIX body element, and the Configuration.ACCESSIBILITY_MODE must be set to AccessibilityMode.INACCESSIBLE_MODE. When these requirements are met, and partialRenderMode is set to "self" or "multiple", the hideShow component will use the paritial page rendering architecture to send events to the application. If any of these requirements are not met, or if the browser is not capable of supporting partial page rendering, full page rendering will be performed.
public final void setPartialRenderMode(java.lang.String partialRenderMode)
The partialRenderMode attribute is used to control the hideShow component's partial page rendering behavior. partialRenderMode defaults to "none", in which case full page rendering is used to hide/show the contents of the hideShow component. When partialRenderMode is set to "self" or "multiple", partial page rendering is used to re-render the hideShow component's contents as they are hidden/shown.
In order to enable partial page rendering, the hideShow component's id attribute must be set, the hideShow component must be contained in with an UIX body element, and the Configuration.ACCESSIBILITY_MODE must be set to AccessibilityMode.INACCESSIBLE_MODE. When these requirements are met, and partialRenderMode is set to "self" or "multiple", the hideShow component will use the paritial page rendering architecture to send events to the application. If any of these requirements are not met, or if the browser is not capable of supporting partial page rendering, full page rendering will be performed.
public final java.lang.String[] getPartialTargets()
public final void setPartialTargets(java.lang.String[] partialTargets)
public static UINode getPrompt(MutableUINode bean)
public static void setPrompt(MutableUINode bean, UINode promptNode)
public static boolean isSelected(MutableUINode bean)
public static void setSelected(MutableUINode bean, boolean selected)
public static boolean isDisclosed(MutableUINode bean)
public static void setDisclosed(MutableUINode bean, boolean disclosed)
public static java.lang.String getDisclosedText(MutableUINode bean)
public static void setDisclosedText(MutableUINode bean, java.lang.String disclosedText)
public static void setTranslatableDisclosedText(MutableUINode bean, java.lang.String bundleName, java.lang.String key)
bundleName
- the name of the ResourceBundlekey
- the key of the string to retrieve from the ResourceBundlepublic static java.lang.String getUndisclosedText(MutableUINode bean)
public static void setUndisclosedText(MutableUINode bean, java.lang.String undisclosedText)
public static void setTranslatableUndisclosedText(MutableUINode bean, java.lang.String bundleName, java.lang.String key)
bundleName
- the name of the ResourceBundlekey
- the key of the string to retrieve from the ResourceBundlepublic static java.lang.String getDestination(MutableUINode bean)
public static void setDestination(MutableUINode bean, java.lang.String destination)
public static void setDestinationBinding(MutableUINode bean, BoundValue boundValue)
boundValue
- a BoundValue implementation to be used
to retrieve the value.public static void setDestinationBinding(MutableUINode bean, java.lang.Object selectKey)
selectKey
- the key to be passed to selectValue()
on the
current DataObject
, e.g., the DataObject for the current
table row.public static void setDestinationBinding(MutableUINode bean, java.lang.String dataNamespace, java.lang.String dataName, java.lang.Object selectKey)
dataNamespace
- the namespace to be passed to
RenderingContext.getDataObject()
dataName
- the name to be passed to
RenderingContext.getDataObject()
selectKey
- the key to be passed to selectValue()
on the
DataObject
.public static boolean isFormSubmitted(MutableUINode bean)
public static void setFormSubmitted(MutableUINode bean, boolean formSubmitted)
public static boolean isUnvalidated(MutableUINode bean)
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public static void setUnvalidated(MutableUINode bean, boolean unvalidated)
formSubmitted
mode, then the default behaviour is to validate all form inputs,
before submitting to the server. This attribute allows
this validation to be disabled.public static java.lang.String getFormName(MutableUINode bean)
public static void setFormName(MutableUINode bean, java.lang.String formName)
public static java.lang.String getPartialRenderMode(MutableUINode bean)
The partialRenderMode attribute is used to control the hideShow component's partial page rendering behavior. partialRenderMode defaults to "none", in which case full page rendering is used to hide/show the contents of the hideShow component. When partialRenderMode is set to "self" or "multiple", partial page rendering is used to re-render the hideShow component's contents as they are hidden/shown.
In order to enable partial page rendering, the hideShow component's id attribute must be set, the hideShow component must be contained in with an UIX body element, and the Configuration.ACCESSIBILITY_MODE must be set to AccessibilityMode.INACCESSIBLE_MODE. When these requirements are met, and partialRenderMode is set to "self" or "multiple", the hideShow component will use the paritial page rendering architecture to send events to the application. If any of these requirements are not met, or if the browser is not capable of supporting partial page rendering, full page rendering will be performed.
public static void setPartialRenderMode(MutableUINode bean, java.lang.String partialRenderMode)
The partialRenderMode attribute is used to control the hideShow component's partial page rendering behavior. partialRenderMode defaults to "none", in which case full page rendering is used to hide/show the contents of the hideShow component. When partialRenderMode is set to "self" or "multiple", partial page rendering is used to re-render the hideShow component's contents as they are hidden/shown.
In order to enable partial page rendering, the hideShow component's id attribute must be set, the hideShow component must be contained in with an UIX body element, and the Configuration.ACCESSIBILITY_MODE must be set to AccessibilityMode.INACCESSIBLE_MODE. When these requirements are met, and partialRenderMode is set to "self" or "multiple", the hideShow component will use the paritial page rendering architecture to send events to the application. If any of these requirements are not met, or if the browser is not capable of supporting partial page rendering, full page rendering will be performed.
public static java.lang.String[] getPartialTargets(MutableUINode bean)
public static void setPartialTargets(MutableUINode bean, java.lang.String[] partialTargets)
|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |