Skip to content

Fixes #3996 Update docs with new features #3997

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: v2_develop
Choose a base branch
from
Open

Fixes #3996 Update docs with new features #3997

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1f125f3
Update docs with new features
tznind Mar 20, 2025
3a7296a
Fix typo
tznind Mar 20, 2025
2ed71e7
Fix another gramatical error
tznind Mar 20, 2025
ef5d413
Merge branch 'v2_develop' into new-in-v2
tig Mar 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions docfx/docs/newinv2.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ The entire library has been reviewed and simplified. As a result, the API is mor
* *New!* @Terminal.Gui.PosAlign - Aligns a set of views horizontally or vertically (left, right, center, etc...).
* *New!* @Terminal.Gui.View.Arrangement enables tiled and overlapped view arrangement and moving/resizing Views with the keyboard and mouse. See [Arrangement](arrangement.md).
* *Improved!* Keyboard [Navigation](navigation.md) has been revamped to be more reliability and ensure TUI apps built with Terminal.Gui are accessible.
* *New!* Sizable/Movable views - Any view can now be set to have resizeable borders and/or be dragged around.
* *Improved!* Consistent tabbing behavior - Tab navigation now behaves as expected, cleanly and consistently.

## New and Improved Built-in Views

Expand All @@ -41,12 +43,30 @@ The entire library has been reviewed and simplified. As a result, the API is mor
* *[MenuBar](~/api/Terminal.Gui.MenuBar.yml)* - COMING SOON! New implementation based on `Bar`
* *[ContextMenu](~/api/Terminal.Gui.ContextMenu.yml)* - COMING SOON! New implementation based on `Bar`
* *[FileDialog](~/api/Terminal.Gui.FileDialog.yml)* - The new, modern file dialog includes icons (in TUI!) for files/folders, search, and a `TreeView`.
* *[TableView](tableview.md)* - No longer just DataTable, now supports any collections, checkboxes and even expandable trees
* *@"Terminal.Gui.ColorPicker"* - Fully supports TrueColor with the ability to choose a color using HSV, RGB, or HSL as well as W3C standard color names.

## Beauty

Terminal.Gui has never been prettier

* *ShowBorders* - Get that 3D 'pop' for your buttons
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, ShadowStyle.

* *Gradient* - Render beautiful true color borders, titles etc with the new Gradient API


## Configuration Manager

Terminal.Gui now supports a configuration manager enabling library and app settings to be persisted and loaded from the file system. See [Configuration Manager](https://gui-cs.github.io/Terminal.GuiV2Docs/docs/overview.html#configuration-manager) for details.

## Logging & Metrics

Terminal.Gui now features multi level logging of engine internals and system performance metrics (redraws, invoke durations etc). Never again wonder why your frame rate is low, or a given terminal/distro does not behave as expected.
See [Logging](logging.md) for details.

## Sixel Image Support

Recently added to Windows Terminal and long supported in mainstream linux terminals, this graphics protcol allows images and even animations to be rendered directly into the console.

## Updated Keyboard API

The API for handling keyboard input is significantly improved. See [Keyboard API](keyboard.md).
Expand All @@ -63,3 +83,6 @@ The API for mouse input is now internally consistent and easiser to use.
* More granular APIs are provided to ease handling specific mouse actions. See [Mouse API](mouse.md).
* Views can use the `View.Highlight` event to have the view be visibly highlighted on various mouse events.
* Views can set `View.WantContinousButtonPresses = true` to ahve their `Command.Accept` command be invoked repeatedly as the user holds a mouse button down on the view.

## AOT support
*AOT/single file app support* now works out of the box.