Defold Druid UI Library

Druid 0.3.0:

Druid:final() now is important function for correct working

Add swipe basic component

- Swipe component handle simple swipe gestures on node. It has single callback with direction on swipe. You can adjust a several parameters of swipe in druid style.
- Swipe can be triggered on action.released or while user is make swiping (in process)
- Add swipe example at main Druid example. Try swipe left/right to switch example pages.

Add input basic component

- Input component handle user text input. Input contains from button and text components. Button needed for selecting/unselecting input field
- Long click on input field for clear and select input field (clearing can be disable via styles)
- Click outside of button to unselect input field
- On focus lost (game minimized) input field will be unselected
- You can setup max length of the text
- You can setup allowed characters. On add not allowed characters on_input_wrong will be called. By default it cause simple shake animation
- The keyboard for input will not show on mobile HTML5. So input field in mobile HTML5 is not working now
- To make work different keyboard type, make sure value in game.project Android:InputMethod set to HiddenInputField (https://defold.com/manuals/project-settings/#input-method)

Add two functions to basic component: increase_input_priority and reset_input_priority. It used to process component input first in current input stack (there is two input stacks now: INPUT and INPUT_HIGH). Example: on selecting input field, it increase input self priority until it be unselected
Add two new component interests: on_focus_gain and on_focus_lost

Add global druid events:

- on_window_callback: call druid.on_window_callback(event) for on_focus_gain/lost correct work
- on_language_change: call druid.on_language_change() (#38) for update all druid instances lang components
- on_layout_change: call druid.on_layout_change() (#37) for update all gui layouts (unimplemented now)

Add button on_click_outside event. You can subscribe on this event in button. Was needed for Input component (click outside to deselect input field)
Add startpos_ field to button component
Changed input binding settings. Add esc, enter, text and marked_text. Backspace now is different from android back button event. Check the README setup section
Renamed onchangelanguage -> onlanguagechange component interest
Add several examples to druid-assets respository (see live example here): https://insality.github.io/druid-assets/)

Known issues:

- Adjusting text size by height works wrong. Adjusting single line texting works fine
- Space is not working in HTML5

Druid 0.4.0:

Add Drag basic component

- Drag component allow you detect dragging on GUI node
- Drag will be processed even the cursor is outside of node, if drag is already started
- Drag provides correct handle of several touches. Drag can switch between them (no more scroll gliches with position)
- Drag have next events:
    - on_touch_start (self)
    - on_touch_end (self)
    - on_drag_start (self)
    - on_drag (self, dx, dy)
    - on_drag_end (self)
- You can restriction side of draggin by changing _drag.can_x_ and _drag.can_y_ fields
- You can setup drag deadzone to detect, when dragging is started (by default 10 pixels)

Druid Scroll component fully reworked. Input logic moved to Drag component

- Update scroll documentation
- Change constructor order params
- Change _scroll:set_border_ to _scroll:set_size_
- Scroll now contains from view and content node
    - _View node_ - static node, which size determine the "camera" zone
    - _Content node_ - dynamic node, moving by _Scroll_ component
- Scroll will be disabled only if content size equals to view size (by width or height separatly)
- You can adjust start scroll size via _.gui_ scene. Just setup correct node size
- Different anchoring is supported (for easier layouting)
- Function _scroll_to_ now accept position relative to _content node_. It's more easier for handling. _Example:_ if you have children node of _content_node_, you can pass this node position to scroll to this.
- **Resolve #52**: _Content node size_ now can be less than _view node size_. In this case, content will be scrolled only inside _view size_ (can be disabled via style field: _SMALL_CONTENT_SCROLL_)
- **Fix #50**: If style:SOFT_ZONE_SIZE equals to [0..1], scroll can be disappeared

Druid Grid Update

- Anchor by default equals to node pivot (so, more component settings in _.gui_ settings) (#51)
- Function grid:clear now don't delete any GUI nodes. Druid will not care about gui.delete_node logic anymore (#56)

Druid Hover component now have two hover events (#49):

- _on_hover_ is usual hover event. Trigger only if touch or mouse action_id pressed on node
- _on_mouse_hover_ action on node without action_id (desktop mouse over). Works only on desktop platform

Styles update:

- Styles table now can be empty, every component have their default style values
- Remove component:get_style function. Now style can be only set
- To get style values in component, add component:on_style_change function. It's invoked on component:set_style function
- You can look up default values inside component:on_style_change function or style component API on Druid API

Druid update:

- Now function druid:remove remove instance and all instance children components. No more manual deleting child components (#41)

Fix: Blocker component bug (blocker had very high priority, so it's block even button components, created after bloker)
Fix #58: Bug, when druid instance should be always named druid (ex: self.druid = druid.new(self))
Fix #53: Bug with final Druid instance without any components

Druid

Topics

Modules