• Home
    • View
    • Login
    This page
    • Normal
    • Export PDF
    • Page Information

    Loading...
  1. Dashboard
  2. Undefined Space
  3. OpenJFX
  4. TreeView User Experience Documentation

Page History

Versions Compared

Old Version 2

changes.mady.by.user Jindrich Dinga

Saved on Aug 26, 2013

compared with

New Version 3

changes.mady.by.user Jindrich Dinga

Saved on Sep 20, 2013

  • Previous Change: Difference between versions 1 and 2
  • Next Change: Difference between versions 3 and 4
  • View Page History

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

1.1 CHARACTERISTICS of a TREE CONTROL

 treePartsImage Removed

Image Added Image RemovedImage Added

 

  • A tree control is a visual representation mechanism for a data set with a tree structure.

...

1.2 Input Actions Associated with Parts of the Tree Cell

Image RemovedImage Added

 

  • It should be possible for the application developer to override the actions mapped to one of the areas
  • It should be possible for the application developer to easily specify what a mouse action (say click) should do across the entire cell.
  • Some platforms that have dedicated gestures for scrolling (such as the flick gesture in touch platforms). In such cases, these specific gestures should be supported.
  • Note: There is some ambiguity in terms of how the white space is treated. As seen in the above diagram, we propose that by default clicking on the white space should select the node. Clicking on the whitespace and dragging should start a panning action (in addition to selecting the node).

...

2.1 Nodes should Open and Close

opencloseBeh1Image RemovedImage Added

  • The control should be able to support smooth animation during open and close. 
    [Parameters : Speed with which the animation for the open and close of the node, type of animation]
  • Tree component does not need to support the case where only one node is open at a time
  • Applications may want to auto-open nodes with only one child node. The tree control itself should make this feasible. Implementation team may consider an attribute that the application developer can set to easily trigger this behavior if needed.
  • By default the tree should remember expanded nodes and reopen in its prior state. Applications may want to:
    • always reopen the tree with all the nodes closed & scrolled to the top,
    • always reopen the tree in another state specified by the application developer or
    • always reopen the tree in its previous state. Application developer should be able to specify one of these settings

...

2.2 The list component should be able to support horizontal and vertical scrolling

opencloseBeh1Image RemovedImage Added

  • If a scroll bar is present, then the item with focus should be in the visible window, unless the the user explicitly scrolls off the view.

  • Scrolling should cause entire lines to appear or disappear from the viewable area (we should not see partially displayed row of text)

  • In case the node name does not fit in the viewable area and has been truncates (and a horizontal scroll bar is presented), hovering over the node should bring up a tool tip with the entire node name
  • When tree nodes are being opened the tree should scroll horizontally to ensure that the first few (7- 9 ?) characters of the newly visible child-nodes are in the view screen
  • If a tree node is selected and then the tree is resized, the selected item should stay visible during and after the resize.


2.3 Should be able to select one or more items

opencloseBeh1Image RemovedImage Added

  • Should be able to select items by clicking
  • Should be able to select multiple items
  • Should be able to select multiple discontiguous items
    (keyboard and selection conventions should be the same as those for the list spec.)
  • Should be able to have checkboxes in front of the node name, in order to facilitate selection
    • UX rational: Sometimes need to incrementally "mark" nodes for other operations - more convenient than normal selection for later batch operations. This makes multi select via keyboard much simpler for users.

...

2.4 The tree control should support customized context menus when right clicking on a node

opencloseBeh1Image RemovedImage Added

Sometimes, in addition to the right click menu (or instead of it) these actions are invoked via a pull down menu placed in the Title bar of the tree control. Actions may also be shown as buttons, icons or links in the cell that are revealed on hover (or mouseover). 
UX Rationale for contextual menu: Common UX usage that needs to be supported

2.5 Should support Drag and Drop of nodes

opencloseBeh1Image RemovedImage Added

  • Nodes or elements can be dropped into other locations in the tree
  • Nodes or elements can be dropped on to other locations in the UI outside the tree (where the drop action is appropriate, if the drop action is not appropriate for a certain area, the cursor should change into a stop cursor).
  • The tree should provide drop feedback. By default it should disambiguate exactly which node the content will drop into. Application developers should be able to further customize this into cases where they want to convey that a certain node does not work as a drop-site or cases where they want to allow content to be dropped between two nodes (so that a new node is added at that location).

...

The tree component may need to convey to the user that the data in the tree is still loading. This can be at the level for the child node, parent node, several nodes, or globally. Spinners are animated icons shown when parts of the tree is still loading. Several cases are illustrated in the mock ups here:

Image RemovedImage Added

Note: The child nodes need to be shown as spinners only if there is a lag in determining the exact icon to display. The appropriate icon should be shown as soon as it is available.

...

The diagram and table below discuss how these actions can be performed using the keyboard and tab traversal. After that we look at the mobile and TV platforms.

Image RemovedImage Added

Keyboard Operation (Win)Keyboard Operation (Mac)Action
Right ArrowRight ArrowExpand current selection (or go to first child node)
Left ArrowLeft ArrowCollapse current selection (or go to parent node)
Up ArrowUp ArrowMove selection up one node
Down ArrowDown ArrowMove selection down one node
HomeHomeMove selection to the first node in the tree
EndEndMove selection to the last node in the tree
Page UpPage UpMove the selection up on the first fully visible item on the current page. If the first fully visible item is selected, move the selection on the first fully visible item on the previous page.
Page DownPage DownMove selection down on the last fully visible item on the current page. If the last fully visible item is selected, move the selection on the last fully visible item on the next page.
Ctrl-PgDnCmd-PgDnMove focus down on the last fully visible item on the current page. If the last fully visible item is focused, move focus on the last fully visible item on the next page.
Ctrl-PgUpCmd-PgUpMove focus up on the first fully visible item on the current page. If the first fully visible item is focused, move focus on the first fully visible item on the previous page.
Ctrl-ACmd-ASelect all nodes in the tree. Focus remains on the same item.
Shift-Up ArrowShift-Up ArrowExtend selection up one node
Shift-Down ArrowShift-Down ArrowExtend selection down one node
Shift-HomeShift-HomeExtend selection to the top of the tree
Shift-EndShift-EndExtend selection to the bottom of the tree
Shift-PgUpShift-PgUpSelect all items between anchor and the first fully visible item on the current page. If the first fully visible item is already included in the selection, extend the selection to the first fully visible item on the previous page.

All previous selections, if applicable, are canceled. Available in multi-selection mode only.
Shift-PgDnShift-PgDnSelect all items between anchor and the last fully visible item on the current page. If the last fully visible item is already included in the selection, extend the selection to the last fully visible item on the next page.

All previous selections, if applicable, are canceled. Available in multi-selection mode only.
F2F2Rename selected node
EnterEnterSave changes made to the selected node
EscEscCancel changes made to the selected node
Ctrl-Up ArrowCmd-Up ArrowMove focus up one node
Ctrl-Down ArrowCmd-Down ArrowMove focus down one node
Ctrl-HomeCmd-HomeMove focus to the first node in the tree
Ctrl-EndCmd-EndMove selection to the last node in the tree
SpaceSpaceSelect a single node, create anchor.
Ctrl-SpaceCtrl-Cmd-SpaceSelect/Deselect a single node, create anchor.
Shift-SpaceShift-SpaceSelect a range of nodes
* (numlock)* (numlock)Expand everything
+ (numlock)+ (numlock)Expand current selection
- (numlock)- (numlock)Collapse current selection
Ctrl-Shift-UpCmd-Shift-UpExpands selection up by one item. Only in multi-selection modes.

If focus is on an unselected item, pressing Ctrl-Shift-Up selects all items between anchor and the item which is right above the focused item. The item which is right above the focused item is also included in the selection. Available in multi-selection mode only.
Ctrl-Shift-DownCmd-Shift-DownExpands selection down by one item. Only in multi-selection modes.

If focus is on an unselected item, pressing Ctrl-Shift-Down selects all items between anchor and the item which is right below the focused item. The item which is right below the focused item is also included in the selection. Available in multi-selection mode only.
Ctrl-Shift-SpaceCmd-Shift-SpaceSelects all items between anchor and focused item. Focused item is also included in the selection. Available in multi-selection mode only.
Ctrl-Shift-HomeCmd-Shift-HomeSelects all items between anchor and the first item. Available in multi-selection mode only.
Ctrl-Shift-EndCmd-Shift-EndSelects all items between anchor and the last item. Available in multi-selection mode only.
Ctrl-Shift-PageUpCmd-Shift-PageUpSelect all items between anchor and the first fully visible item on the current page. If the first fully visible item is already included in the selection, extend the selection to the first fully visible item on the previous page.

Available in multi-selection mode only.
Ctrl-Shift-PageDownCmd-Shift-PageDownSelect all items between anchor and the last fully visible item on the current page. If the last fully visible item is already included in the selection, extend the selection to the last fully visible item on the next page.

Available in multi-selection mode only.

...

Overview
Content Tools
ThemeBuilder

Terms of Use
• License: GPLv2
• Privacy • Trademarks • Contact Us

Powered by a free Atlassian Confluence Open Source Project License granted to https://www.atlassian.com/software/views/opensource-community-additional-license-offer. Evaluate Confluence today.

  • Kolekti ThemeBuilder Powered by Atlassian Confluence 8.5.23
  • Kolekti ThemeBuilder printed.by.atlassian.confluence
  • Report a bug
  • Atlassian News
Atlassian
Kolekti ThemeBuilder EngineAtlassian Confluence
{"serverDuration": 257, "requestCorrelationId": "db30757fae1eb23a"}