> For the complete documentation index, see [llms.txt](https://visualonecompany.gitbook.io/storyframeworkdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://visualonecompany.gitbook.io/storyframeworkdocs/user-interface/sfui-elements.md).

# SFUI Elements

SF6 introduced a new library of input agnostic widget elements that are used to assist gamepad navigation of any given widget. SF's gamepad widget solution derives from physically moving the players cursor using the left joystick, making designing and programming widgets that can be used by both keyboard/mouse & gamepad a lot less of a hassle.

***

Widgets specifically used for input agnostic navigation are generally labelled with the prefix `SFUI` . Below you'll find the current list of "SFUI" elements that are used throughout SF's menu's, and can be used within your own custom widgets as well;

* `SFUI Input Key`\
  This widget is the only exception within the current lineup of SFUI elements that aren't directly used for navigation, but instead acts as a "cosmetic" element. This widget is used to display input key prompts through its defined Keyboard & Gamepad input keys. Styling of this widget is entirely driven through the `PlatformInputMapping_DT` data table, as this data table is where all of your projects input key appearances should live.
* `SFUI Button Root`\
  A simple widget container that encapsulates all of its children elements within a clickable button, allowing for creation of buttons that can be used by any input method. This widget also exposes bindable events similarly to the generic button element such as "On Hovered", "On Unhovered", and "On Pressed (Multi-Input)".  <sup><sub><mark style="color:$info;">**(By default, the "click" input on gamepad is "Face Button Bottom")**<mark style="color:$info;"><sub></sup>
* `SFUI Scroll Box Root`\
  Another simple widget container that encapsulates all of its children elements within a scrollable box. Easily create scroll boxes that can be navigated with a gamepad using this widget. Also exposes common bindable events such as "On Hovered", "On Unhovered", and "On Scrolled (Multi-Input)".  <sup><sub><mark style="color:$info;">**(By default, the "scroll" input on gamepad is "Right Thumbstick")**<mark style="color:$info;"><sub></sup>
