Common UI Controls

This document describes commonly used non - core controls in the UI system. Use the core rendering component, and alignment strategy, These controls will constitute the most interactive part of our game UI. You will understand the usage of the following UI control:

  • ScrollView、ScrollBar and Mask
  • Button
  • ProgressBar
  • EditBox

UI controls are described below can be passed Node Tree top left to create a node in the menu "Create UI Node" to create a submenu.

create node ui


ScrollView Is a typical combination of controls, usually consists of the following nodes:

ScrollView Root Node

This node contains the ScrollView components, Detailed description of the component properties can refer to ScrollView component reference

content Node

Used to host content node will be displayed in the scroll view's contents, the Constraint box of the node is usually far greater than the ScrollView the root node of the Constraint box, only when content node is larger than the ScrollView node, view scrolling can be effective.

Content can include any number of child nodes of the node, with Layout component. Constraint box ensures that the content node is equal to the sum of all the child nodes of the Constraint box.

Mask Node

ScrollView in the mask is optional, but we always want to be able to hide content that are beyond the scope of the ScrollView Constraint box in content.

Mask componentAbility to hide itself outside the scope of the content of child nodes of the Constraint box, Note Mask a rendering component, other rendering component and therefore cannot(Sprite, Label..) coexist on the same node, we need an extra node is designed to place the Mask, Otherwise the ScrollView Sprite will not be able to set the background for the component.

ScrollBar Node

The scroll bar is optional, On a mouse device, we can quickly scroll through the mouse to drag the scroll bar functions. And on mobile devices, scroll bars are often used to indicate the amount and scope of the currently displayed content.

We can also set the horizontal and vertical scroll bar, scroll bars for each node contains a ScrollBar component. Nodes can also include a scrollbar child node to display both the foreground and the background of a scroll bar. Detailed property to set the check ScrollBar component reference.

Also of note is that handle part of the ScrollBar size is variable, recommended Sliced mode Sprite as the handle of the ScrollBar.


Button created by Node Tree menu node, by the parent with Button component and a child node with Label component composition.Button. Provide interactive features and buttons background image display parent nodes, child nodes provide the label on the button Label text rendering.

You can design according to the art style and needs, will Label the node removed or replaced with other icon Sprite needs.

Detailed property descriptions available on Button components Button component reference.

Transition Description

Transition property of the Button used to set up when the button is in normal (Normal), down (Pressed), the hover (Hover), disabled (Disabled) Target four state property to refer to the background. You can choose from three modes:

  • NONE (Nothing Translation): The mode button does not respond to interactive event to automatically change their appearance. But you can add a custom script on the button to precisely control the behavior of interactive performance.

  • COLOR (Color Change): After choosing this mode, you can see four states property and can set a color overlay for each state, When the button to switch to the corresponding state, Sets the color for button and the status color of the background image multiplying as the color of these display. This mode also allows the length of time by Duration property sets the color - changing process, realization of color gradient effect.

  • SPRITE(Slide change): After choosing this mode, a SpriteFrame images can be specified for each of the four - state resources, after the corresponding status is activated, Button background image will be replaced with the corresponding image resources. Note If you want to set Normal picture of the state of resources, SpriteFrame in the background of the button Sprite properties will be overwritten.

Click Events

Click Events property is an array type, Its length changed to 1 or more as button was pressed (mouse or touch) adds one or more response callback method. After you create new Click Events, you can drag the response component node to the 'Click callback method on the Target property of the Event, then select a component node, and select components from a list in a method as a callback method.

On Button Click event is designed to facilitate designers in making UI interface you can specify button function when setting, you want the button to customize the response to a greater diversity of events, you can refer to Internal-EventsDocument, on the button node listens to these interactive events and manually handled.


Progress is driven by the ProgressBar component of a Sprite node properties to achieve according to the set value displays the progress of different length or angle. ProgressBar there are three basic operating modes (by setting the mode property):


Other basic properties of check ProgressBar component reference.


Mode when HORIZONTAL or VERTICAL is selected, the progress bar by modifying Bar Sprite dimensions of the reference node (width or height property), to change the progress bar shows the length. In both modes Bar Sprite and Sliced display mode is recommended, in case of node size stretch can still maintain a high quality image rendering.

In both modes, Total Length property is in pixels, specifies the progress bar in a state of 100 (Progress property value is 1 ) Bar Sprite length. This attribute ensures that when we edit scenes can freely set Progress to a value less than 1, the Bar Sprite always be able to record the total length of our hope.


Different from the above two modes, Fill mode of the progress bar by a percentage cut Bar Sprite reference nodes to show progress, Therefore, we need a reference to Bar Sprite Sprite component - specific settings. The first Sprite Type property is set to FILLED, you can then select a fill direction (HORIZONTAL, and VERTICAL and the RADIAL), please check Sprite Filled Model reference.

Note that the progress bar in fill mode is selected, Total Length percentage into a decimal. Values range from 0 ~ 1, set Total Length number is synchronized to the Bar Sprite, Fill Range property, so that it remains consistent. The following figure shows the progress bar filling mode when Bar Sprite and Fill Type set to RADIAL, Total Length different effect on the display.

filled radial


Comparison of ways of using the input box directly, please refer directly to EditBox Component reference Description of each attribute in the document settings.

results matching ""

    No results matching ""