Extension-Druid/docs_md/changelog.md

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 start_pos 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 on_change_language -> on_language_change 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 dragging 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)

• [Breaking changes] 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 you can only set styles
  • 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 blocker)

• 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