Skip to content

Data Item Move On Navigation

DataItemMoveOnNavigation sends MoveUp and MoveDown row commands from Unity EventSystem navigation input.

Use it when Up/Down navigation should reorder rows in a Data Table Widget.

What It Does

  • Handles OnMove events on the row object.
  • Sends MoveUp for Up input and MoveDown for Down input.
  • Can consume handled moves so EventSystem focus does not continue to other controls.
  • Can also consume movement at table bounds to keep focus in the table.
  • Respects DataTableWidget Navigation Action Mode and only runs when that mode is Move On Navigation.

Setup

  1. Add this component to the row object that receives navigation move events.
  2. In DataTableWidget, set Navigation Action Mode to Move On Navigation.
  3. Keep Handle Up and Handle Down enabled unless you need one-way behavior.
  4. Set consume options based on whether focus should stay in the table at bounds.
  5. Test with keyboard/gamepad to verify move and focus behavior.

Inspector Fields

Field Description
Handle Up Sends MoveUp for Up navigation input.
Handle Down Sends MoveDown for Down navigation input.
Consume Handled Move Calls eventData.Use() after a successful handled move.
Consume At Bounds Also consumes Up/Down when move cannot occur at bounds, preventing focus from leaving the table.

Runtime Notes

  • Row moves are handled by the parent data widget host.
  • With paging enabled, move behavior follows the widget's reorder settings for visible page scope.
  • Disable consume options if you want normal EventSystem edge navigation to continue outside the table.

See Also