Update docs

This commit is contained in:
Janne Valkealahti
2023-10-20 08:07:17 +01:00
parent 1b4170845f
commit d77bcac59c
8 changed files with 282 additions and 44 deletions

View File

@@ -8,7 +8,21 @@ _BoxView_ is a base implementation providing functionality to draw into a
bounded _Rectancle_. Only direct use of it is its `drawFunction` which
allows to do simple things without implementing a full custom `View`.
[source, java, indent=0]
----
include::{snippets}/BoxViewSnippets.java[tag=sample]
----
== Customisation
_BoxView_ as mostly being a base class contains some useful features
like if it should draw a border and what what are its paddings.
Border can have a title and its color and focused color can be
defined. It's also possible to explicitely set background color
which will override one from styling.
== Default Bindings
Does not have any default bindings.
== Events
Does not have any events.

View File

@@ -6,3 +6,52 @@ ifndef::snippets[:snippets: ../../../../../src/test/java/org/springframework/she
_ButtonView_ is a base implementation providing functionality to draw a button.
Inherits xref:tui/views/box.adoc[].
[source, text]
----
┌──────┐
│ text │
└──────┘
----
You can set a text for a button and action to do when button is selected.
[source, java, indent=0]
----
include::{snippets}/ButtonViewSnippets.java[tag=sample]
----
== Default Bindings
Default _key bindigs_ are:
.Key
|===
|Command |Description
|Enter
|Selects a button
|===
Default _mouse bindigs_ are:
.Mouse
|===
|Command |Description
|Released \| Button1
|Selects a button
|===
== Events
[[tui-views-list-events]]
.ListView Events
|===
|Event |Description
|ButtonViewSelectEvent
|Button is selected.
|===

View File

@@ -6,3 +6,29 @@ ifndef::snippets[:snippets: ../../../../../src/test/java/org/springframework/she
_DialogView_ is a base implementation providing functionality to draw a dialog.
Inherits xref:tui/views/box.adoc[].
[source, text]
----
┌──────────────────┐
│ │
│ <Main content> │
│ │
├──────────────────┤
│ <Buttons> │
└──────────────────┘
----
== Default Bindings
Does not have any default bindings.
== Events
Events are sent depending on a used list type.
.DialogView Events
|===
|Event |Description
|DialogViewCloseEvent
|Dialog requested to get closed.
|===

View File

@@ -13,15 +13,15 @@ include::{snippets}/GridViewSnippets.java[tag=snippet1]
Will result layout of:
[source, text, indent=0]
[source, text]
----
---┬---
| | |
| | |
---┼---
| | |
| | |
---┴---
───┬───
───┼───
───┴───
----
== Default Bindings

View File

@@ -28,42 +28,6 @@ Supports `NOCHECK``, `CHECK`` and `RADIO``
include::{snippets}/ListViewSnippets.java[tag=snippet2]
----
== Default Bindings
Default _view commands_ are:
[[tui-views-list-viewcommands]]
.ViewCommands
|===
|Command |Description
|LINE_UP
|Selection moves up. Bound to _CursorUp_ and _WheelUp_.
|LINE_DOWN
|Selection moves down. Bound to _CursorDown_ and _WheelDown_.
|===
_Enter_ is choosing an active item. _Space_ is changing selection state.
== Events
Events are sent depending on a used list type.
[[tui-views-list-events]]
.ListView Events
|===
|Event |Description
|ListViewOpenSelectedItemEvent
|Active item is requested to get opened.
|ListViewSelectedItemChangedEvent
|Active item is changed.
|===
== Customisation
How individual cells are shown depends on a _CellFactory_. Default implementation
@@ -82,3 +46,73 @@ And set it as a factory:
----
include::{snippets}/ListViewSnippets.java[tag=uselistcell]
----
== Default Bindings
Default _view commands_ are:
[[tui-views-list-viewcommands]]
.ViewCommands
|===
|Command |Description
|LINE_UP
|Selection moves up.
|LINE_DOWN
|Selection moves down.
|===
Default _key bindigs_ are:
.Key
|===
|Command |Description
|CursorUp
|Bound ViewCommand LINE_UP
|CursorDown
|Bound ViewCommand LINE_DOWN
|Enter
|Choose active item.
|Space
|Change active item selection state.
|===
Default _mouse bindigs_ are:
.Mouse
|===
|Command |Description
|Wheel \| WheelUp
|Bound ViewCommand LINE_UP
|Wheel \| WheelDown
|Bound ViewCommand LINE_DOWN
|Released \| Button1
|Choose item
|===
== Events
Events are sent depending on a used list type.
[[tui-views-list-events]]
.ListView Events
|===
|Event |Description
|ListViewOpenSelectedItemEvent
|Active item is requested to get opened.
|ListViewSelectedItemChangedEvent
|Active item is changed.
|===

View File

@@ -6,3 +6,54 @@ ifndef::snippets[:snippets: ../../../../../src/test/java/org/springframework/she
_MenuView_ is a base implementation providing functionality to draw a menu.
Inherits xref:tui/views/box.adoc[].
== Default Bindings
Default _key bindigs_ are:
.Key
|===
|Command |Description
|CursorUp
|Move selection up
|CursorDown
|Move selection down
|Enter
|Choose active item.
|===
Default _mouse bindigs_ are:
.Mouse
|===
|Command |Description
|Wheel \| WheelUp
|Move selection up
|Wheel \| WheelDown
|Move selection down
|Released \| Button1
|Choose item
|===
== Events
Events are sent depending on a used list type.
.ListView Events
|===
|Event |Description
|MenuViewOpenSelectedItemEvent
|Active item is requested to get opened.
|MenuViewSelectedItemChangedEvent
|Active item is changed.
|===

View File

@@ -6,3 +6,32 @@ ifndef::snippets[:snippets: ../../../../../src/test/java/org/springframework/she
_MenuBarView_ is a base implementation providing functionality to draw a menu bar.
Inherits xref:tui/views/box.adoc[].
== Default Bindings
Default _key bindigs_ are:
.Key
|===
|Command |Description
|CursorLeft
|Move selection left
|CursorRight
|Move selection right
|===
Default _mouse bindigs_ are:
.Mouse
|===
|Command |Description
|Released \| Button1
|Choose item
|===
== Events
Does not have any events.