<dvt:timeSelector>

timeSelector time selector


Use the timeSelector tag to select a certain time range on a time axis. Typically used in a master-detail graphs. The selected time range in the master graph is displayed in the detail graph.

Relationship with other tags

The timeSelector tag is a child tag of the graph tag.

The timeSelector tag can have the following child tag: specialEffects.

Example

The following example shows the XML for a timeSelector tag.

        <dvt:graph>
            <dvt:timeSelector explicitStart="#{sampleGraph.startDate}"
                explicitEnd="#{sampleGraph.endDate}" 
            borderColor="#cccccc" 
            borderTransparent="false" 
            mode="EXPLICIT"
            fillColor="#ffffff" 
            fillTransparent="false"/>
        </dvt:graph>

Attributes

Name Type Supports EL? Description
id java.lang.String no Specifies the unique identifier for the component.
fillColor java.lang.String no Specifies the color of the fill for the time selector. Enter values in RGB hexadecimal. The example color="#000000" specifies black color. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.
borderColor java.lang.String no Specifies the color of the border for the time selector. Enter values in RGB hexadecimal. The example color="#000000" specifies black color. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.
borderTransparent boolean no Indicates whether the border of the time selector is transparent. To make the time selector transparent, set both the borderTransparent and fillTransparent attributes to "true". Valid values are:
  • true - (Default) If the border of the time selector is transparent.
  • false - If the border of the time selector is visible.
Note: When an attribute or an object is transparent, it is not visible, but you can select it.
fillTransparent boolean no Indicates whether the fill of the time selector is transparent. To make the time selector transparent, set both the borderTransparent and fillTransparent attributes to "true". Valid values are:
  • true - If the time selector is transparent.
  • false - (Default) If the time selector is visible.
Note: When an attribute or an object is transparent, it is not visible, but you can select it.
explicitStart java.util.Date no Specifies the explicit start date for the time selector. Mode must be set to EXPLICIT. Only value-binding is supported for this property.
explicitEnd java.util.Date no Specifies the explicit end date for the time selector. Mode must be set to EXPLICIT. Only value-binding is supported for this property.
mode java.lang.String no Indicates the mode of the time selector. Valid values are:
  • TSM_OFF - (Default) which means do not show the time selector.
  • TSM_EXPLICIT - is used for setting explicit time range. On a time axis, you can specify an explicit time range to show up on the time selector.