diff --git a/README.md b/README.md index d3ba89c..cc2f071 100644 --- a/README.md +++ b/README.md @@ -22,11 +22,12 @@ Or point to the ZIP file of a [specific release](https://github.com/Insality/dr For **Druid** to work requires next input bindings: -- Mouse trigger - `Button 1` -> `touch` _For basic input components_ -- Key trigger - `Backspace` -> `key_backspace` _For back_handler component, input component_ -- Key trigger - `Back` -> `key_back` _For back_handler component, Android back button, input component_ +- Mouse trigger - `Button 1` -> `touch` _For basic input components_ +- Key trigger - `Backspace` -> `key_backspace` _For back_handler component, input component_ +- Key trigger - `Back` -> `key_back` _For back_handler component, Android back button, input component_ - Key trigger - `Enter` -> `key_enter` _For input component, optional_ - Key trigger - `Esc` -> `key_esc` _For input component, optional_ +- Touch triggers - `Touch multi` -> `multitouch` _For scroll component_ ![](media/input_binding_2.png) ![](media/input_binding_1.png) @@ -61,7 +62,7 @@ druid.set_default_style(your_style) -- Call this function on language changing in the game, -- to retranslate all lang_text components: -druid.on_languge_change() +druid.on_language_change() -- Call this function on layout changing in the game, -- to reapply layouts @@ -109,6 +110,8 @@ druid.on_window_callback(event) - **[Swipe](https://github.com/Insality/druid/blob/master/docs_md/01-components.md#swipe)** - System Druid component, handle swipe gestures on node +- **[Drag](https://github.com/Insality/druid/blob/master/docs_md/01-components.md#drag)** - System Druid component, handle drag input on node + Full info see on _[components.md](https://github.com/Insality/druid/blob/master/docs_md/01-components.md)_ @@ -183,7 +186,7 @@ end - *on_input* used for almost all basic druid components - *update* used for progress bar, scroll and timer base components -- *on_message* used for specific druid events, like language change or layout change (TODO: in future) +- *on_message* used for specific druid events, like language change or layout change - *final* used for custom components, what have to do several action before destroy Recommended is fully integrate al druid lifecycles functions @@ -223,13 +226,11 @@ _Will fill later_ ## License -Original created by [AGulev](https://github.com/AGulev) +- Original created by [AGulev](https://github.com/AGulev) +- Developed and supporting by [Insality](https://github.com/Insality) +- Assets from [Kenney](http://www.kenney.nl/) -Developed and supporting by [Insality](https://github.com/Insality) - -Assets from [Kenney](http://www.kenney.nl/) - -MIT License +**MIT** License ## Issues and suggestions diff --git a/docs/index.html b/docs/index.html index c7116f4..e4788f4 100644 --- a/docs/index.html +++ b/docs/index.html @@ -200,7 +200,7 @@
generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
diff --git a/docs/modules/component.html b/docs/modules/component.html index aae8da2..99b8ff4 100644 --- a/docs/modules/component.html +++ b/docs/modules/component.html @@ -83,13 +83,9 @@

Functions

- - - - - + @@ -136,11 +132,19 @@ - + + + + + + + + + - +
get_style()Get current component style table
set_style(style)Set current component style tableSet current component style table.
get_template()Return druid with context of calling component.
setup_component(table, table)is_child_of()Return true, if current component is child of another component
get_name()Return component name
setup_component(table, table, table) Setup component context and his style table
Component.create(name, interest)Component.create(name[, interest={}]) Create new component.
@@ -152,32 +156,14 @@

Functions

-
- - get_style() -
-
- Get current component style table - - - -

Returns:

-
    - - table - Component style table -
- - - - -
set_style(style)
- Set current component style table + Set current component style table. + Invoke on_style_change on component, if exist. Component should handle + their style changing and store all style params

Parameters:

@@ -414,10 +400,50 @@ +
+
+ + is_child_of() +
+
+ Return true, if current component is child of another component + + + +

Returns:

+
    + + bool + True, if current component is child of another +
+ + + + +
+
+ + get_name() +
+
+ Return component name + + + +

Returns:

+
    + + string + The component name +
+ + + +
- setup_component(table, table) + setup_component(table, table, table)
Setup component context and his style table @@ -433,6 +459,10 @@ style Druid style module +
  • table + style + Druid style module +

    • Returns:

    @@ -448,7 +478,7 @@
    - Component.create(name, interest) + Component.create(name[, interest={}])
    Create new component. It will inheritance from basic @@ -464,6 +494,7 @@
  • interest table List of component's interest + (default {})
    • @@ -479,7 +510,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.back_handler.html b/docs/modules/druid.back_handler.html index 7e95a33..7f6e1b0 100644 --- a/docs/modules/druid.back_handler.html +++ b/docs/modules/druid.back_handler.html @@ -218,7 +218,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.blocker.html b/docs/modules/druid.blocker.html index 721f904..236317c 100644 --- a/docs/modules/druid.blocker.html +++ b/docs/modules/druid.blocker.html @@ -237,7 +237,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.button.html b/docs/modules/druid.button.html index 883e585..0c807bf 100644 --- a/docs/modules/druid.button.html +++ b/docs/modules/druid.button.html @@ -123,7 +123,7 @@ Style - Component style params + Component style params. @@ -382,11 +382,28 @@ Style
    - Component style params + Component style params. + You can override this component styles params in druid styles table + or create your own style

    Fields:

    @@ -279,7 +282,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.grid.html b/docs/modules/druid.grid.html index a487fda..730bc39 100644 --- a/docs/modules/druid.grid.html +++ b/docs/modules/druid.grid.html @@ -110,7 +110,7 @@ clear() - Clear all items from the grid + Clear grid nodes array.

    Tables

    @@ -275,7 +275,8 @@ clear()
    - Clear all items from the grid + Clear grid nodes array. GUI nodes will be not deleted! + If you want to delete GUI nodes, use grid.nodes array before grid:clear @@ -373,7 +374,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.helper.html b/docs/modules/druid.helper.html index e05799f..64a239d 100644 --- a/docs/modules/druid.helper.html +++ b/docs/modules/druid.helper.html @@ -298,7 +298,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.hover.html b/docs/modules/druid.hover.html index 7d36b64..25a72f9 100644 --- a/docs/modules/druid.hover.html +++ b/docs/modules/druid.hover.html @@ -95,6 +95,10 @@ Set hover state + set_mouse_hover(state) + Set mouse hover state + + set_click_zone(zone) Strict hover click area. @@ -159,6 +163,27 @@ +
    +
    + + set_mouse_hover(state) +
    +
    + Set mouse hover state + + +

    Parameters:

    + + + + + +
    @@ -198,7 +223,11 @@ @@ -214,7 +243,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.html b/docs/modules/druid.html index ea8c216..ac40eb7 100644 --- a/docs/modules/druid.html +++ b/docs/modules/druid.html @@ -329,7 +329,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.input.html b/docs/modules/druid.input.html index 737bc3d..d5a0952 100644 --- a/docs/modules/druid.input.html +++ b/docs/modules/druid.input.html @@ -121,7 +121,7 @@ Style - Component style params + Component style params. @@ -341,7 +341,9 @@ Style
    - Component style params + Component style params. + You can override this component styles params in druid styles table + or create your own style

    Fields:

    @@ -349,14 +351,12 @@
  • IS_LONGTAP_ERASE bool Is long tap will erase current input data -
    • -
  • BUTTON_SELECT_INCREASE - number - Button scale multiplier on selecting input field + (default false)
  • MASK_DEFAULT_CHAR string Default character mask for password input + (default *)
  • on_select function @@ -370,7 +370,7 @@ function (self, button_node) Callback on wrong user input
    • -
  • button +
  • button_style table Custom button style for input node
    • @@ -388,7 +388,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.lang_text.html b/docs/modules/druid.lang_text.html index 8345b88..84c9334 100644 --- a/docs/modules/druid.lang_text.html +++ b/docs/modules/druid.lang_text.html @@ -243,7 +243,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.progress.html b/docs/modules/druid.progress.html index 60b3a72..ec3270b 100644 --- a/docs/modules/druid.progress.html +++ b/docs/modules/druid.progress.html @@ -125,7 +125,7 @@ Style - Component style params + Component style params. @@ -355,7 +355,9 @@ Style
    - Component style params + Component style params. + You can override this component styles params in druid styles table + or create your own style

    Fields:

    @@ -363,10 +365,12 @@
  • SPEED number Progress bas fill rate. More -> faster + (default 5)
  • MIN_DELTA number Minimum step to fill progress bar + (default 0.005)
    • @@ -382,7 +386,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.radio_group.html b/docs/modules/druid.radio_group.html index 65b2d6f..f87e4ad 100644 --- a/docs/modules/druid.radio_group.html +++ b/docs/modules/druid.radio_group.html @@ -242,7 +242,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.scroll.html b/docs/modules/druid.scroll.html index e9aae94..da5ff6e 100644 --- a/docs/modules/druid.scroll.html +++ b/docs/modules/druid.scroll.html @@ -122,7 +122,7 @@ Return if scroll have inertion. - set_extra_strech_size(stretch_size) + set_extra_strech_size([stretch_size=0]) Set extra size for scroll stretching. @@ -146,7 +146,7 @@ Style - Component style params + Component style params. @@ -369,7 +369,7 @@
    - set_extra_strech_size(stretch_size) + set_extra_strech_size([stretch_size=0])
    Set extra size for scroll stretching. @@ -381,6 +381,7 @@
  • stretch_size number Size in pixels of additional scroll area + (default 0)
    • @@ -543,46 +544,57 @@ Style
    - Component style params + Component style params. + You can override this component styles params in druid styles table + or create your own style

    Fields:

    @@ -598,7 +610,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.slider.html b/docs/modules/druid.slider.html index c81ac6e..1303128 100644 --- a/docs/modules/druid.slider.html +++ b/docs/modules/druid.slider.html @@ -281,7 +281,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.swipe.html b/docs/modules/druid.swipe.html index 6589bc4..60464fd 100644 --- a/docs/modules/druid.swipe.html +++ b/docs/modules/druid.swipe.html @@ -106,7 +106,7 @@ Style - Component style params + Component style params. @@ -220,7 +220,9 @@ Style
    - Component style params + Component style params. + You can override this component styles params in druid styles table + or create your own style

    Fields:

    @@ -228,14 +230,17 @@
  • SWIPE_TIME number Maximum time for swipe trigger + (default 0.4)
  • SWIPE_THRESHOLD number Minimum distance for swipe trigger + (default 50)
  • SWIPE_TRIGGER_ON_MOVE bool If true, trigger on swipe moving, not only release action + (default false)
    • @@ -251,7 +256,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.text.html b/docs/modules/druid.text.html index a081325..b75b29b 100644 --- a/docs/modules/druid.text.html +++ b/docs/modules/druid.text.html @@ -407,7 +407,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid.timer.html b/docs/modules/druid.timer.html index c1ad7b9..517ff76 100644 --- a/docs/modules/druid.timer.html +++ b/docs/modules/druid.timer.html @@ -296,7 +296,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid_event.html b/docs/modules/druid_event.html index 877e8bc..261e260 100644 --- a/docs/modules/druid_event.html +++ b/docs/modules/druid_event.html @@ -242,7 +242,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/modules/druid_instance.html b/docs/modules/druid_instance.html index ad27765..c0f164b 100644 --- a/docs/modules/druid_instance.html +++ b/docs/modules/druid_instance.html @@ -211,6 +211,10 @@ druid:new_swipe(...) Create swipe basic component + + druid:new_drag(...) + Create drag basic component +
    @@ -874,6 +878,33 @@ +
    +
    + + druid:new_drag(...) +
    +
    + Create drag basic component + + +

    Parameters:

    + + +

    Returns:

    +
      + + Componetn + drag component +
    + + + +
    @@ -882,7 +913,7 @@
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/topics/01-components.md.html b/docs/topics/01-components.md.html index 7f48b5e..21478e4 100644 --- a/docs/topics/01-components.md.html +++ b/docs/topics/01-components.md.html @@ -48,6 +48,7 @@
  • Grid
  • Hover
  • Swipe
    • +
  • Drag
    • @@ -158,7 +159,7 @@ Where node name is name of node from GUI scene. You can use node_name

    Blocker

    -

    Blocker API here

    +

    Blocker API here

    Overview

    Druid component for block input. Use it to block input in special zone.

    @@ -211,32 +212,35 @@ Where node name is name of node from GUI scene. You can use node_nameBasic Druid scroll component. Handle all scrolling stuff in druid GUI

    Setup

    -

    Create scroll component with druid: scroll = druid:new_scroll(scroll_parent, scroll_input).

    +

    Create scroll component with druid: scroll = druid:new_scroll(view_node, content_node).

    -

    Scroll parent - is dynamic part. This node will change position by scroll system

    +

    Viewnode_ - is static part. It capturing user input and recognize scrolling touches

    -

    Scroll input - is static part. It capturing user input and recognize scrolling touches

    +

    Contentnode_ - is dynamic part. This node will change position by scroll system

    -

    Initial scroll size will be equal to scroll parent node size. The initial view box will be equal to scroll input node size

    +

    Initial scroll size will be equal to contentnode_ node size. The initial view box will be equal to viewnode_ node size

    -

    Usually, Place static input zone part, and as children add scroll parent part: +

    Usually, Place viewnode_ and as children add contentnode_:

    -

    *Here scrollcontentzone below input zone, in game content zone be able to scroll left until end*

    +

    *Here contentnode below viewnode, in game content_node be able to scroll left until end*

    Notes

    -

    - Scroll by default style have inertion and "back moving". It can be adjust via scroll style settings +

    - Scroll by default style have inertion and extra size for strecthing effect. It can be adjust via scroll style settings - You can setup "points of interest". Scroll always will be centered on closes point of interest. It is able to create slider without inertion and points of interest on each scroll element. - Scroll have next events:

    -- *on_scroll* On scroll move callback
-- *on_scroll_to* On scroll_to function callback
-- *on_point_scroll* On scroll_to_index function callback
+- *on_scroll* (self, position) On scroll move callback
+- *on_scroll_to* (self, position, is_instant) On scroll_to function callback
+- *on_point_scroll* (self, item_index, position) On scroll_to_index function callback
    -

    - You can adjust scroll content size by scroll:set_border(node_size). It will setup new size to content node.

    +

    - You can adjust scroll content size by scroll:set_size(node_size). It will setup new size to content node +- You can enabled or disable inertion mode via scroll:set_intert(state) +- You can adjust extra stretch size via scroll:set_extra_stretch_size +- Multitouch is required for scroll. Scroll is correctly handling touch_id swap while dragging scroll

    @@ -361,7 +365,7 @@ Key is value from druid const: const.SIDE.X (or just "x") or const.SIDE.Y (or ju

    Component for manage node positions. Very simple implementation for nodes with equal size

    Setup

    -

    Create grid component with druid: grid = druid:new_grid(parent_node, prefab_node, max_in_row_elements)

    +

    Create component with druid: grid = druid:new_grid(parent_node, prefab_node, max_in_row_elements)

    Notes

    - Grid on adding elements will setup parent to parentnode_ @@ -381,6 +385,8 @@ Key is value from druid const: const.SIDE.X (or just "x") or const.SIDE.Y (or ju

    Create hover component with druid: hover = druid:new_hover(node, callback)

    Notes

    +

    - By default, hover handles hover event with pressed touch action_id. So it's mean, what mouse or touch have to be pressed +- On desktop platforms there is onmousehover event. It's event on mouse hover without any action id

    @@ -391,7 +397,7 @@ Key is value from druid const: const.SIDE.X (or just "x") or const.SIDE.Y (or ju

    System Druid component, handle swipe actions on node

    Setup

    -

    Create hover component with druid: hover = druid:new_swipe(node, swipe_callback)

    +

    Create swipe component with druid: hover = druid:new_swipe(node, swipe_callback)

    Notes

    - Swipe callback have next params: (self, swipe_side, distance, time)

    @@ -404,16 +410,60 @@ Key is value from druid const: const.SIDE.X (or just "x") or const.SIDE.Y (or ju

    - Swipe trigger only, if all input actions was on swipe node. If action will be outside of node, swipe status will be reseted -- In swipe style table you can adjust minimal distance and maximum time to trigger swipe +- In swipe style table you can adjust minimal distance and maximum time to trigg- Hover state trigger only with touch on mobile devices or button mouse holding. Just mouse over swipe - In swipe style table you can toggle type of swipe triggering. if SWIPETRIGGERON_MOVE setup to true - swipe will trigger as swipe can be triggered. If setup to false - swipe will trigger only on released action -- If you have stencil on swipe node and you don't want trigger it outside of stencil node, you can use swipe:set_click_zone to restrict swipe zone

    +- If you have stencil on swipe node and you don't want trigger it outside of stencil node, you can use swipe:set_click_zone to restrict swipe zonethout buttons is now not allowed.

    + + +

    +

    Drag

    +

    Drag API here

    + +

    Overview

    +

    System Druid component, handle drag actions on node

    + +

    Setup

    +

    Create drag component with druid: hover = druid:new_drag(node, drag_callback)

    + +

    Notes

    +

    - Drag callback have next params: (self, swipe_side, distance, time)

    + +
    +- **self**: Druid self context
+- **dx**: *number* - delta x position
+- **dy**: *number* - delta y position
+
    + +

    - In styles, you can point the drag start deadzone. Default value is 10 pixels +- Drag correctly process multitouch. You can switch touch_id, while dragging on node with correct dx and dy values (made for correct scrolling) +- You can restrict horizontal or vertical dragging by setting drag.can_x or drag.can_y to false value +- You can get info about current drag state:

    + +
    +- _is_touch_ - Is currently node touching
+- _is_drag_ - Is currently node is dragging
+- _x_ and _y_ - Current touch position
+- _touch_start_pos_ - Touch stat positions
+
    + +

    - Drag have next events:

    + +
    +- _on_touch_start_ (self) - Event on touch start
+- _on_touch_end_ (self) - Event on touch end
+- _on_drag_start_ (self) - Event on drag start
+- _on_drag_ (self, dx, dy) - Event on drag process
+- _on_drag_end_ (self) - Event on drag end
+
    + +

    - Drag node zone can be restricted via drag:set_click_zone(node)

    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/topics/02-creating_custom_components.md.html b/docs/topics/02-creating_custom_components.md.html index 67a5e37..086bc4f 100644 --- a/docs/topics/02-creating_custom_components.md.html +++ b/docs/topics/02-creating_custom_components.md.html @@ -113,6 +113,10 @@ function M.on_input(self, action_id, action) end +-- Call on component creation and on component:set_style() function +function M.on_style_change(self, style) +end + -- Call only if exist interest: const.ON_MESSAGE function M.on_message(self, message_id, message, sender) end @@ -226,10 +230,6 @@ There is next interests in druid: -- Button self on callback is self of _this_ component local button = druid:new_button(...) - - -- helper can return you the component style for current component - -- It return by component name from - local my_style = self:get_style() end @@ -245,7 +245,7 @@ There is next interests in druid:
    generated by LDoc 1.4.6 -Last updated 2020-05-04 00:51:46 +Last updated 2020-05-09 16:07:15
    diff --git a/docs/topics/03-styles.md.html b/docs/topics/03-styles.md.html index 8bdb3b1..b51a6c6 100644 --- a/docs/topics/03-styles.md.html +++ b/docs/topics/03-styles.md.html @@ -34,6 +34,7 @@ @@ -90,7 +91,8 @@

    Usage

    -

    Setup default druid style for all druid instances via druid.set_default_style

    +

    Setup default druid style for all druid instances via druid.set_default_style +You can pass nil or emptytable_ to use default values for all components (no styles)

     local druid = require("druid.druid")
@@ -131,11 +133,29 @@
 
 
 
+
    
+
    Create your own styles
    
+
+
    The most components have their styles. You can explore it on Druid API in table style section (button example). Or you can see, what fields component uses in code in function on_style_change
    
+
+
    To create you style, create lua module, what return <componentname_, componentstyle_> table
    
+
+
    Example: default druid style
    
+
+
    Override all fields you want and set your style with one of next ways:
    
+
+
      
+    
    • Set your style as global via druid.set_default_style
      • 
+    
    • Set style for concrete druid instance via druid = druid.new(self, style)
      • 
+    
    • Set style for concrete instance via component:set_style(style)
      • 
+
    
+
+
  
  
 
    
 generated by LDoc 1.4.6
-Last updated 2020-05-04 00:51:46 
+Last updated 2020-05-09 16:07:15 
 
     
  
 
diff --git a/docs/topics/04-druid_assets.md.html b/docs/topics/04-druid_assets.md.html
index 738e4fb..8df0a70 100644
--- a/docs/topics/04-druid_assets.md.html
+++ b/docs/topics/04-druid_assets.md.html
@@ -92,7 +92,7 @@
  
 
    
 generated by LDoc 1.4.6
-Last updated 2020-05-04 00:51:46 
+Last updated 2020-05-09 16:07:15 
 
     
  
 
diff --git a/docs/topics/05-examples.md.html b/docs/topics/05-examples.md.html
index 187c016..c124314 100644
--- a/docs/topics/05-examples.md.html
+++ b/docs/topics/05-examples.md.html
@@ -90,7 +90,7 @@
  
 
    
 generated by LDoc 1.4.6
-Last updated 2020-05-04 00:51:46 
+Last updated 2020-05-09 16:07:15 
 
     
  
 
diff --git a/docs/topics/README.md.html b/docs/topics/README.md.html
index 2205ddb..07dcf24 100644
--- a/docs/topics/README.md.html
+++ b/docs/topics/README.md.html
@@ -116,6 +116,7 @@
     
  • Key trigger - Back -> key_back  For backhandler component, Android back button, input component_
    • 
     
  • Key trigger - Enter -> key_enter For input component, optional
    • 
     
  • Key trigger - Esc -> key_esc For input component, optional
    • 
+    
  • Touch triggers - Touch multi -> multitouch For scroll component
    • 
 
 
 
    
@@ -152,7 +153,7 @@
 
 -- Call this function on language changing in the game,
 -- to retranslate all lang_text components:
-druid.on_languge_change()
+druid.on_language_change()
 
 -- Call this function on layout changing in the game,
 -- to reapply layouts
@@ -187,6 +188,7 @@
     
  • Grid - Component for manage node positions 
    • 
     
  • Hover - System Druid component, handle hover node state
    • 
     
  • Swipe - System Druid component, handle swipe gestures on node
    • 
+    
  • Drag - System Druid component, handle drag input on node 
    • 
 
 
 
    Full info see on components.md
    
@@ -271,7 +273,7 @@
 
      
     
    • *on_input* used for almost all basic druid components
      • 
     
    • update used for progress bar, scroll and timer base components
      • 
-    
    • *on_message* used for specific druid events, like language change or layout change (TODO: in future)
      • 
+    
    • *on_message* used for specific druid events, like language change or layout change
      • 
     
    • final used for custom components, what have to do several action before destroy
      • 
 
    
 
@@ -319,13 +321,13 @@ https://insality.github.io/druid/
    
 
    
 
    License
    
 
-
    Original created by AGulev
    
+
 
-
    Developed and supporting by Insality
    
-
-
    Assets from Kenney
    
-
-
    MIT License
    
+
    MIT License
    
 
 
 
    
@@ -337,7 +339,7 @@ https://insality.github.io/druid/
    
  
 
    
 generated by LDoc 1.4.6
-Last updated 2020-05-04 00:51:46 
+Last updated 2020-05-09 16:07:15 
 
     
  
 
diff --git a/docs/topics/changelog.md.html b/docs/topics/changelog.md.html
index 2cfc3d9..4fe82e0 100644
--- a/docs/topics/changelog.md.html
+++ b/docs/topics/changelog.md.html
@@ -140,21 +140,52 @@
     
  • Druid Scroll component fully reworked. Input logic moved to Drag component
    
 
 
    -- Updated scroll documentation
-- Changed constructor order params
+- 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 scroll size via _.gui_ scene. Just setup correct node size
-- Different anchoring is supported (for easier layout)
+- 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_
+- **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
 
    
 
    • 
-    
  • Grid anchor by default equals to node pivot (so, more gui settings in .gui settings)
    • 
+    
  • 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
    • 
 
 
 
@@ -162,7 +193,7 @@
  
 
    
 generated by LDoc 1.4.6
-Last updated 2020-05-04 00:51:46 
+Last updated 2020-05-09 16:07:15 
 
     
  
 
diff --git a/docs_md/01-components.md b/docs_md/01-components.md
index fd94779..9b3ee6e 100644
--- a/docs_md/01-components.md
+++ b/docs_md/01-components.md
@@ -51,7 +51,7 @@ Create text node with druid: `text = druid:new_text(node_name, [initial_value],
 
 
 ## Blocker
-[Blocker API here](https://insality.github.io/druid/modules/druid.button.html)
+[Blocker API here](https://insality.github.io/druid/modules/druid.blocker.html)
 
 ### Overview
 Druid component for block input. Use it to block input in special zone.
@@ -101,28 +101,31 @@ Create lang text component with druid `text = druid:new_lang_text(node_name, loc
 Basic Druid scroll component. Handle all scrolling stuff in druid GUI
 
 ### Setup
-Create scroll component with druid: `scroll = druid:new_scroll(scroll_parent, scroll_input)`.
+Create scroll component with druid: `scroll = druid:new_scroll(view_node, content_node)`.
 
-_Scroll parent_ - is dynamic part. This node will change position by scroll system
+_View_node_ - is static part. It capturing user input and recognize scrolling touches
 
-_Scroll input_ - is static part. It capturing user input and recognize scrolling touches
+_Content_node_ - is dynamic part. This node will change position by scroll system
 
-Initial scroll size will be equal to _scroll parent_ node size. The initial view box will be equal to _scroll input_ node size
+Initial scroll size will be equal to _content_node_ node size. The initial view box will be equal to _view_node_ node size
 
-Usually, Place static input zone part, and as children add scroll parent part:
+Usually, Place _view_node_ and as children add _content_node_:
 ![](../media/scroll_scheme.png)
 ![](../media/scroll_outline.png)
 
-*Here scroll_content_zone below input zone, in game content zone be able to scroll left until end*
+*Here content_node below view_node, in game content_node be able to scroll left until end*
 
 ### Notes
-- Scroll by default style have inertion and "back moving". It can be adjust via scroll [style settings](https://insality.github.io/druid/modules/druid.scroll.html#Style)
+- Scroll by default style have inertion and extra size for strecthing effect. It can be adjust via scroll [style settings](https://insality.github.io/druid/modules/druid.scroll.html#Style)
 - You can setup "points of interest". Scroll always will be centered on closes point of interest. It is able to create slider without inertion and points of interest on each scroll element.
 - Scroll have next events:
-	- *on_scroll* On scroll move callback
-	- *on_scroll_to* On scroll_to function callback
-	- *on_point_scroll* On scroll_to_index function callback
-- You can adjust scroll content size by `scroll:set_border(node_size)`. It will setup new size to content node.
+	- *on_scroll* (self, position) On scroll move callback
+	- *on_scroll_to* (self, position, is_instant) On scroll_to function callback
+	- *on_point_scroll* (self, item_index, position) On scroll_to_index function callback
+- You can adjust scroll content size by `scroll:set_size(node_size)`. It will setup new size to _content node_
+- You can enabled or disable inertion mode via `scroll:set_intert(state)`
+- You can adjust extra stretch size via `scroll:set_extra_stretch_size`
+- Multitouch is required for scroll. Scroll is correctly handling touch_id swap while dragging scroll
 
 
 ## Progress
@@ -239,7 +242,7 @@ Create timer component with druid: `timer = druid:new_timer(text_node, from_seco
 Component for manage node positions. Very simple implementation for nodes with equal size
 
 ### Setup
-Create grid component with druid: `grid = druid:new_grid(parent_node, prefab_node, max_in_row_elements)`
+Create  component with druid: `grid = druid:new_grid(parent_node, prefab_node, max_in_row_elements)`
 
 ### Notes
 - Grid on _adding elements_ will setup parent to _parent_node_
@@ -258,6 +261,8 @@ System Druid component, handle hover node state.
 Create hover component with druid: `hover = druid:new_hover(node, callback)`
 
 ### Notes
+- By default, hover handles _hover event_ with pressed touch action_id. So it's mean, what mouse or touch have to be pressed
+- On desktop platforms there is _on_mouse_hover_ event. It's event on mouse hover without any action id
 
 
 ## Swipe
@@ -267,7 +272,7 @@ Create hover component with druid: `hover = druid:new_hover(node, callback)`
 System Druid component, handle swipe actions on node
 
 ### Setup
-Create hover component with druid: `hover = druid:new_swipe(node, swipe_callback)`
+Create swipe component with druid: `hover = druid:new_swipe(node, swipe_callback)`
 
 ### Notes
 - Swipe callback have next params: (self, swipe_side, distance, time)
@@ -276,6 +281,37 @@ Create hover component with druid: `hover = druid:new_swipe(node, swipe_callback
 	- **distance**: *number* - in pixels, distance of swipe
 	- **time**: *number* - in seconds, time of swiping
 - Swipe trigger only, if all input actions was on swipe node. If action will be outside of node, swipe status will be reseted
-- In swipe style table you can adjust minimal distance and maximum time to trigger swipe
+- In swipe style table you can adjust minimal distance and maximum time to trigg-  Hover state trigger only with touch on mobile devices or button mouse holding. Just mouse over swipe
 - In swipe style table you can toggle type of swipe triggering. if SWIPE_TRIGGER_ON_MOVE setup to true - swipe will trigger as swipe can be triggered. If setup to false - swipe will trigger only on released action
-- If you have stencil on swipe node and you don't want trigger it outside of stencil node, you can use `swipe:set_click_zone` to restrict swipe zone
\ No newline at end of file
+- If you have stencil on swipe node and you don't want trigger it outside of stencil node, you can use `swipe:set_click_zone` to restrict swipe zonethout buttons is now not allowed.
+
+
+## Drag
+[Drag API here](https://insality.github.io/druid/modules/druid.drag.html)
+
+### Overview
+System Druid component, handle drag actions on node
+
+### Setup
+Create drag component with druid: `hover = druid:new_drag(node, drag_callback)`
+
+### Notes
+- Drag callback have next params: (self, swipe_side, distance, time)
+	- **self**: Druid self context
+	- **dx**: *number* - delta x position
+	- **dy**: *number* - delta y position
+- In styles, you can point the drag start deadzone. Default value is 10 pixels
+- Drag correctly process multitouch. You can switch touch_id, while dragging on node with correct _dx_ and _dy_ values (made for correct scrolling)
+- You can restrict horizontal or vertical dragging by setting `drag.can_x` or `drag.can_y` to _false_ value
+- You can get info about current drag state:
+	- _is_touch_ - Is currently node touching
+	- _is_drag_ - Is currently node is dragging
+	- _x_ and _y_ - Current touch position
+	- _touch_start_pos_ - Touch stat positions
+- Drag have next events:
+	- _on_touch_start_ (self) - Event on touch start
+	- _on_touch_end_ (self) - Event on touch end
+	- _on_drag_start_ (self) - Event on drag start
+	- _on_drag_ (self, dx, dy) - Event on drag process
+	- _on_drag_end_ (self) - Event on drag end
+- Drag node zone can be restricted via `drag:set_click_zone(node)`
diff --git a/docs_md/02-creating_custom_components.md b/docs_md/02-creating_custom_components.md
index 38534e3..b6ed5ed 100644
--- a/docs_md/02-creating_custom_components.md
+++ b/docs_md/02-creating_custom_components.md
@@ -28,6 +28,10 @@ end
 function M.on_input(self, action_id, action)
 end
 
+-- Call on component creation and on component:set_style() function
+function M.on_style_change(self, style)
+end
+
 -- Call only if exist interest: const.ON_MESSAGE
 function M.on_message(self, message_id, message, sender)
 end
@@ -138,10 +142,6 @@ function M.init(self, template_name, node_table)
 
 	-- Button self on callback is self of _this_ component
 	local button = druid:new_button(...)
-
-	-- helper can return you the component style for current component
-	-- It return by component name from 
-	local my_style = self:get_style()
 end
 
 ```
diff --git a/docs_md/03-styles.md b/docs_md/03-styles.md
index d651333..426c3a7 100644
--- a/docs_md/03-styles.md
+++ b/docs_md/03-styles.md
@@ -9,6 +9,7 @@ In component API documentation, you can find the style API for this component. O
 
 ## Usage
 Setup default druid style for all druid instances via `druid.set_default_style`
+You can pass _nil_ or _empty_table_ to use default values for all components (no styles)
 ```lua
 local druid = require("druid.druid")
 local my_style = require("my.amazing.style")
@@ -41,3 +42,18 @@ local function init(self)
 	self.button:set_style(my_style)
 end
 ```
+
+
+## Create your own styles
+
+The most components have their styles. You can explore it on [Druid API](https://insality.github.io/druid/) in table style section ([button example](https://insality.github.io/druid/modules/druid.button.html#Style)). Or you can see, what fields component uses in code in function `on_style_change`
+
+To create you style, create lua module, what return <_component_name_, _component_style_> table
+
+Example: [default druid style](https://github.com/Insality/druid/blob/develop/druid/styles/default/style.lua)
+
+Override all fields you want and set your style with one of next ways:
+
+- Set your style as global via `druid.set_default_style`
+- Set style for concrete druid instance via `druid = druid.new(self, style)`
+- Set style for concrete instance via `component:set_style(style)`
\ No newline at end of file
diff --git a/docs_md/changelog.md b/docs_md/changelog.md
index ceb4a95..e809c88 100644
--- a/docs_md/changelog.md
+++ b/docs_md/changelog.md
@@ -58,16 +58,17 @@ Druid 0.4.0:
 	- 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
-	- Updated scroll documentation
-	- Changed constructor order params
+	- 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 scroll size via _.gui_ scene. Just setup correct node size
-	- Different anchoring is supported (for easier layout)
+	- 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_
+	- **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
@@ -75,7 +76,7 @@ Druid 0.4.0:
 	- 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 old hover event. Trigger only if touch pressed on node
+	- _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:
@@ -89,4 +90,4 @@ Druid 0.4.0:
 
 - **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
\ No newline at end of file
+- **Fix #53:** Bug with final _Druid instance_ without any components
diff --git a/game.project b/game.project
index 4fd3084..055a75d 100644
--- a/game.project
+++ b/game.project
@@ -10,7 +10,7 @@ height = 900
 
 [project]
 title = druid
-version = 0.3.0
+version = 0.4.0
 
 [library]
 include_dirs = druid
diff --git a/media/input_binding_1.png b/media/input_binding_1.png
index aac429b..aa0856a 100644
Binary files a/media/input_binding_1.png and b/media/input_binding_1.png differ