DataV:time-selector

Chart style

A time picker is a widget that allows you to customize the background color of a calendar, the date and time style of a calendar, and the time format type. You can query and dynamically display the data of other widgets based on the time.

Style Panel

• Search Configuration: Click the Search configuration items icon in the upper-right corner of the Style panel. In the Search Configuration panel, enter the name of the configuration items that you want to search for and locate the configuration items. Fuzzy match is supported. For more information, see Search configuration items.

  • Size: the width and height of the widget. Unit: pixels.

  • Positioning: the x-axis and y-axis of the component. Unit: pixels. X-coordinate indicates the pixel distance between the upper-left corner of the widget and the left border of the canvas. Y-coordinate indicates the pixel distance between the upper-left corner of the widget and the upper border of the canvas.

  • Rotate: The widget is rotated around the center of the widget. Unit: degrees.

    • Directly enter the degrees in the Rotation Angle spin box or click the plus sign (+) or minus sign (-) to increase or decrease the value in the Rotation Angle spin box.

    • Click the icon to flip the widget style.

    • Click the icon to flip the widget style.

  • Opacity: Valid values: 0 to 1. If this parameter is set to 0, the widget is hidden. If this parameter is set to 1, the widget is completely displayed. Default value: 1.

• Basic Configuration: Set the basic configuration items of the time picker.

  • Locale: the locale of the time picker. Valid values: Chinese and English.

  • Time Format: Set the time format of the time picker. For more information, see Customize the style of the %Y-%m-%d %H:%M:%S.

  • Optional Range: Set the time range that can be selected in the selector. Set the Start Time and End Time configuration items. You can click the icon to enable or disable the optional time range configuration items.

  • Disable Range: If you select Disable Time Range, the data priority is higher than the specified time range. Please write in strict accordance with the time format.

  • Disable Time: If you select Disable Time, the data priority is higher than the value of Disable Time. Please write in strict accordance with the time format.

• Input Box: the input box of the time picker.

  • Background Color: the background color of the input box.

  • Border Style: Set the border line type, rounded border, line width, and color of the input box.

  • Text Style: Specify the font, weight, font size, and color of the text in the input box.

  • Clear Icon: Set the icon size, graphic color, and background color of the clear icon.

  • Hover Style: the border color of the input box.

• drop-down list: the drop-down list of the time picker.

  • drop-down box container: Set the width, height, rounded corners, and color of the time picker drop-down box.

  • Disable Style: Set the font size, background color, and font color of the calendar and time in the drop-down list.

  • Calendar Style: Set the calendar style of the drop-down list.

    • Top Style: Set the background color, text style, key style, and split style at the top of the calendar.

    • Week Style: Set the background color, border style, and text style of the calendar.

    • Sub-item Style: Set the background color, border style, and text style of the calendar sub-items in the selected and hovering states.

  • Time Style: Set the time style of the drop-down box in the Normal, Selected, and Hover states, including the Overall Background, Top Style, Split Style, Sub-item Fill, Sub-item Border, and Sub-item Text styles.

  • Bottom Style: Set the bottom style of the drop-down box, including the background color, split style, text style of the Left Now button in the default state and the left now button in the hover state, and background color, border style, and text style of the Right OK button in the default state and the right now button in the hover state.

Data Sources panel

Advanced Panel

Turn on the switch to enable the associated global variable feature. You can change the time data content in the selector, trigger data requests, throw temporary variables, and configure the use in other components. By default, the time value configured in the Data Source panel is thrown. For more information, see Component interaction configuration.

Blueprint Interaction

1. Click the icon in the upper-left corner to go to the Blueprint page.

2. On the Layer Nodes tab, add the widget to the main canvas.

3. View blueprint configuration parameters.

   • Event

     Event	Notes
     When the data interface request is completed	The event is triggered with the processed JSON data after a data interface request is responded and processed by a filter. For more information about specific data examples, see the Data Response Result section of the Data Source tab in the right-side configuration panel of the canvas editor.
     When the current time changes	The event that is thrown when the current time changes, and the corresponding data item at that time. For more information, see the data example. { "time": "2024-03-25 08:08:08" }

   • Action

     Action	Notes
     Import data	After data of a widget is processed in accordance with its drawing format, the widget is imported for redrawing. You do not need to request server data again. For more information, see the data example. [ { "time": "2024-03-08 08:08:08", "disabledTime": "2024-03-24 09:09:09", "selectRange": [ "2024-03-08 12:12:12", "2024-03-30 15:15:15" ], "disabledRange": [ "2024-03-14 18:18:18", "2024-03-18 19:19:19" ] } ]
     Request Data Interface	This action is performed to request the server data again. The data sent by an upstream data processing node or layer node is used as a parameter. For example, if the time picker is configured with the API data source as https://api.test and the data passed to the request data interface as { id: '1'}, the final request interface is https://api.test?id=1.
     Obtain the current timepieces	Gets the value of the current time picker. No parameters are required.
     Clear a component to its default value	Restores the time to the default value. No parameters are required.
     Move	Move a widget to a specified location. For more information, see the data example. { // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. "positionType": "to", // The location, which is indicated by the x and y coordinates. "attr": { "x": 0, "y": 0 }, // The animation type. "animation": { "enable": false, // The duration in which animation is displayed. "animationDuration": 1000, // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. "animationEasing": "linear" } }
     Toggle Show /Show	Toggles whether the widget is displayed or hidden. No parameters are required.
     Display	Display the widget. For more information, see Data example. { "animationType": "",// The animation method. Valid value: fade. If you do not set this parameter, no animation is available. "animationDuration": 1000,// The animation delay. Unit: ms. "animationEasing": ""// animation curve }
     Hide	Hide the component. For more information, see Data example. { "animationType": "",// The animation method. Valid value: fade. If you do not set this parameter, no animation is available. "animationDuration": 1000,// The animation delay. Unit: ms. "animationEasing": ""// animation curve }
     Update component configurations	Style configurations of widgets are dynamically updated. In the Style panel, click Copy Configuration to Clipboard to obtain the configuration data of the widget. After that, change the style field for the data processing node in Blueprint Editor.