print Printer View e-mail E-mail this page Bookmark Bookmark
Oracle ADF Faces - <dvt:barGraph>

Summary

Tag name: <dvt:barGraph>
UIComponent class: oracle.adf.view.faces.bi.component.graph.UIGraph
Component type: oracle.dss.adf.graph.Graph (barGraph)

Use the barGraph tag to create an ADF bar graph. This tag has a minimal set of properties to support common functionality for this graph type. The following child tags can be specified on this tag.

Relationship with other tags

This component can have the following children: activeDataProperties, alertSet, annotationSet, background, graphFootnote, graphPlotArea, graphSubtitle, graphTitle, legendArea, legendText, legendTitle, markerText, o1Axis, o1MajorTick, o1TickLabel, o1Title, referenceObjectSet, seriesSet , shapeAttributesSet, timeAxisDateFormat, timeSelector, y1Axis, y1BaseLine, y1MajorTick, y1Title, y1TickLabel.

Example

The following example shows XML for a barGraph tag.
<dvt:barGraph imageWidth="300" imageHeight="300" imageFormat="FLASH" title="Graph"
o1AxisTitle="Employees" y1AxisTitle="Salary" partialTriggers="b2" partialSubmit="true"
value ="#{sampleGraph.graphDataModel}"/>

Events

Type Phases Description
org.apache.myfaces.trinidad.event.AttributeChangeEvent Invoke Application,
Apply Request Values		 Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.

Attributes

Name Type Supports EL? Description
advancedPropertiesXML String Yes

Specifies path to an XML file that contains settings for graph properties that are not exposed in the barGraph tag.
For example, /myfiles/graph.xml
Path from web application root must be provided.

attributeChangeListener javax.el.MethodExpression Only EL a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.
binding String Only EL

Specifies a binding reference to store a specific instance of UIGraph from a backing bean. Set this attribute only to access code in a backing bean. For example, to reference a graph component in the SampleGraph class, use the following code: binding="#{sampleGraph.graph}"
clickAction String Yes Refers to a backing bean method that performs navigation processing for the graph and returns an outcome String. Or a static outcome String can be specified. The JSF NavigationHandler selects the page to display next by matching the outcome String against the navigation rules in the application configuration resource file. The application writes the Navigation rules.
clickListener String Yes
contentDelivery String Yes Specifies whether to fetch content with page load or after page load. Valid values are lazy (default) and immediate.
customizationId String Yes The id used to locate this component when applying persistent customizations. Components without a customizationId set can not save customizations to the persistent store. Instead, any customizations will at most only apply to the current Session. Each customizationId must be unique in the document.
dynamicResize String Yes Specifies whether to resize the component based on its container size. Valid values are FIXED_SIZE (default) and DYNAMIC_RESIZE.
id String No the identifier for the component. The identifier must follow a subset of the syntax allowed in HTML:
  • Must not be a zero-length String.
  • First character must be an ASCII letter (A-Za-z) or an underscore ('_').
  • Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').
imageFormat String Yes

Format of graph image. Valid values are:

  • PNG - (Default) PNG image format.
  • SVG - SVG image format.
  • FLASH - FLASH image format.
  • PNG_STAMPED - PNG image with no javascript. This must be used when using graph in adf table cells via stamping.
  • AUTO - Generates Flash if a supported Flash player is found on the client.
imageHeight int Yes Specifies the height of the graph image in pixels.
imageWidth int Yes Specifies the width of the graph image in pixels.
inlineStyle String Yes Style of the outer element(enclosing div) of the component
o1AxisTitle String Yes Use to specify the text of the horizontal axis title.
partialSubmit boolean Yes

Indicates whether an action can be performed through a partial page submit. Valid values are:

  • "true" - (Default) Partial page submit is allowed.
  • "false" - No partial page submit.
partialTriggers String Yes the IDs of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too.
rendered boolean Yes Specifies whether the component is rendered.
shortDesc String Yes Specifies the short description of the graph. This is particularly useful in the screen reader mode.
style String Yes

Applies a style to the graph based on the specified XML file. Valid values are the name of a standard graph style or the path of a custom XML file that you want to set as a style for this graph.

Predefined graph styles are:

  • April
  • Autumn
  • Black and White
  • Comet
  • Confetti
  • Default
  • Earth
  • Executive
  • Financial
  • Glass
  • Nautical
  • Projection
  • Regatta
  • Southwest
  • Transparent

To specify a custom style, enter the entire path to the xml file. For example: /text/myStyle.xml.
styleClass String Yes Sets a CSS style class to use for this component. Note that width and height should be set using the inlineStyle property.
threeDEffect boolean Yes

Indicates whether a graph appears to have depth. Valid values are "true" and "false". Default value is "false".
title String Yes Specifies the text of the title.
value String Yes Specifies the graph's data model. This must be an instance of oracle.adf.view.faces.bi.model.DataModel or oracle.adf.view.faces.bi.model.GraphDataModel
y1AxisTitle String Yes Use to specify the text of the vertical axis title.
E-mail this page
Printer View Printer View
Oracle Is The Information Company About Oracle | Oracle RSS Feeds | Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Privacy