Difference between revisions of "Development/Functional testing/Treeview hierarchy tests"

From AtoM wiki
(Dragging and dropping objects)
(Dragging and dropping objects: Update docs link)
 
(7 intermediate revisions by 2 users not shown)
Line 13: Line 13:
 
== Navigating large aggregations ==
 
== Navigating large aggregations ==
  
* In show screens for information objects or taxonomy terms with more than 10 siblings or children, the hierarchy treeview shows only the first 6 siblings or children
+
* In show screens for information objects or taxonomy terms with more than 10 siblings or children, the hierarchy treeview shows only the first 5 siblings or children
 
* A button with ellipses [...] appears as a node at the bottom of the treeview
 
* A button with ellipses [...] appears as a node at the bottom of the treeview
 
** Clicking on the button shows 4 more objects
 
** Clicking on the button shows 4 more objects
Line 25: Line 25:
  
 
== Dragging and dropping objects ==
 
== Dragging and dropping objects ==
*User should be able to drag an object with the mouse and drop it into another position under the same parent.
+
*User should be able to drag an object with the mouse and drop it into another position under the same parent to re-order siblings.
** Note that the "Move" button should be used to move objects to a new parent in the descriptive hierarchy. See [https://projects.artefactual.com/issues/4358 issue 4358]
+
** Note that the "[https://www.accesstomemory.org/docs/latest/user-manual/add-edit-content/archival-descriptions/#move-archival-description Move]" button should be used to move objects to a new parent in the descriptive hierarchy.
*If an object has child levels, dragging and dropping the object into another part under the same parent also moves all of the child levels
+
*If an object has child levels, dragging and dropping the object also moves all of the child levels.
*Users should not be able to drag and drop if they are not logged in or do not have update permissions
+
*Users should not be able to drag and drop if they are not logged in or do not have update permissions.
 +
 
 +
== Hierarchy browse ==
 +
* If an administrator has enabled "Settings > Treeview > Show browse hierarchy page > Yes" then "Hierarchy" appears as an option on the Browse results screen.
 +
* Clicking this "Hierarchy" button should take users to a full-page, full-width treeview containing all top-level descriptions in AtoM.
 +
* All top level description titles should appear in alphabetical order.
 +
* Each description in the hierarchy browse page that has children should display an “expand/collapse” icon that can be clicked to display all the children of that description. Any child descriptions that in turn have children will also be expandable.
 +
* A number in the top right corner of the page will indicate how many more descriptions can be seen in the hierarchy. Click on that number to bring up the next page of results.
 +
* When a user clicks a description title in the hierarchy browse page, they will be redirected to the related archival description view page with the standard treeview
 +
** When the user presses the back button, they should return to the hierarchy browse page where they left off (i.e. with the same nodes expanded or contracted as before).
 +
 
  
 
[[Category:Development documentation]]
 
[[Category:Development documentation]]

Latest revision as of 15:30, 8 May 2020

Main Page > Development > Functional testing > Treeview hierarchy tests

User should be able to navigate hierarchies by expanding and collapsing objects, clicking on objects to open their show screens, and dragging and dropping objects to change their position within the hierarchy.

Expanding and collapsing objects

  • Opening a show screen with multiple levels should show the immediate lower levels with > signs next to them in the context menu box
  • Clicking on a > sign should expand the lower level to show its lower levels
  • The > sign should turn into a V sign when the object is expanded
  • Clicking on the V sign should collapse the object

Navigating large aggregations

  • In show screens for information objects or taxonomy terms with more than 10 siblings or children, the hierarchy treeview shows only the first 5 siblings or children
  • A button with ellipses [...] appears as a node at the bottom of the treeview
    • Clicking on the button shows 4 more objects
    • If the aggregation has more than 10 siblings, the [...] button will reappear beneath the 10th object.
      • Clicking the ellipses button again will create a slider to the right of the treeview, and will display 4 more objects at a time.
      • As the user scrolls down the slider, the treeview will automatically keep populating the hierarchy in 4-object increments until the user selects the desired object or all sibling information objects are displayed
  • When selecting an information object for display in the show screen that is lower than 6th in the hierarchy, the object is shown in the hierarchy treeview along with 4 siblings in either direction (up and down). As such, a maximum total of 9 information objects are displayed in the treeview when the showscreen displays an object that is lower than the 6th in the hierarchy - the object currently selected and up to 8 other siblings.
    • An ellipses button [...] will be displayed on either side of the treeview hierarchy. Clicking on the button will expand the treeview to display further siblings, in increments of 4.
    • If the user has expanded the treeview down the hierarchy, the slider bar will reappear, and the treeview will automatically populate the hierarchy in 4 object increments as the user scrolls down.

Dragging and dropping objects

  • User should be able to drag an object with the mouse and drop it into another position under the same parent to re-order siblings.
    • Note that the "Move" button should be used to move objects to a new parent in the descriptive hierarchy.
  • If an object has child levels, dragging and dropping the object also moves all of the child levels.
  • Users should not be able to drag and drop if they are not logged in or do not have update permissions.

Hierarchy browse

  • If an administrator has enabled "Settings > Treeview > Show browse hierarchy page > Yes" then "Hierarchy" appears as an option on the Browse results screen.
  • Clicking this "Hierarchy" button should take users to a full-page, full-width treeview containing all top-level descriptions in AtoM.
  • All top level description titles should appear in alphabetical order.
  • Each description in the hierarchy browse page that has children should display an “expand/collapse” icon that can be clicked to display all the children of that description. Any child descriptions that in turn have children will also be expandable.
  • A number in the top right corner of the page will indicate how many more descriptions can be seen in the hierarchy. Click on that number to bring up the next page of results.
  • When a user clicks a description title in the hierarchy browse page, they will be redirected to the related archival description view page with the standard treeview
    • When the user presses the back button, they should return to the hierarchy browse page where they left off (i.e. with the same nodes expanded or contracted as before).