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
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.
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
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.
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.
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 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 Transtion), 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 the display. This mode also allows the length of time by
Durationproperty sets the color - changing process, realization of color gradient effect.
SPRITE(Slide change)，After choosing this mode, a
SpriteFrameimages 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
Normalpicture of the state of resources,
SpriteFramein the background of the button Sprite properties will be overwritten.
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 checkProgressBar component reference。
HORIZONTAL & VERTICAL Model
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. n both modes
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 checkSprite Filled ModelReference.
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
Fill Range property, so that it remains consistent. The following figure shows the progress bar filling mode when
Fill Type set to
Total Length different effect on the display.
Comparison of ways of using the input box directly, please refer directly to EditBox Component reference Description of each attribute in the document settings.
Continue on to read about Auto Layout.