v6.0.0

[ArthurSonzogni]

6.0.0 (2025-03-23)

Component

• Feature: Add support for raw input. Allowing more keys to be detected.
• Feature: Add ScreenInteractive::ForceHandleCtrlC(false) to allow component
  to fully override the default Ctrl+C handler.
• Feature: Add ScreenInteractive::ForceHandleCtrlZ(false) to allow component
  to fully override the default Ctrl+Z handler.
• Feature: Add Mouse::WeelLeft and Mouse::WeelRight events on supported
  terminals.
• Feature: Add Event::DebugString().
• Feature: Add support for Input's insert mode. Add InputOption::insert
  option. Added by @mingsheng13.
• Feature: Add DropdownOption to configure the dropdown. See Feature: Dropdown options with callback #826.
• Feature: Add support for Selection. Thanks @clement-roblot. See Selection2 the come back #926.
  • See ScreenInteractive::GetSelection().
  • See ScreenInteractive::SelectionChange(...) listener.
• Bugfix/Breaking change: Mouse transition:
  • Detect when the mouse move, as opposed to being pressed.
    The Mouse::Moved motion was added.
  • Dragging the mouse with the left button pressed now avoids activating
    multiple checkboxes.
  • A couple of components are now activated when the mouse is pressed,
    as opposed to being released.
    This fixes: Click and drag tiggers buttons and checkboxes repeatedly #773
    This fixes: Cursor state (blinking, block, underline, ...) is not reset after exiting a program #792
• Bugfix: mouse.control is now reported correctly.
• Feature: Add ScreenInteractive::FullscreenPrimaryScreen(). This allows
  displaying a fullscreen component on the primary screen, as opposed to the
  alternate screen.
• Bugfix: Input onchange was not called on backspace or delete key.
  Fixed by @chrysante in chrysante in PR Input onchange not called #776.
• Bugfix: Propertly restore cursor shape on exit. See Cursor state (blinking, block, underline, ...) is not reset after exiting a program #792.
• Bugfix: Fix cursor position in when in the last column. See Problem with setting the cursor position on the right screen edge when drawing. #831.
• Bugfix: Fix ResizeableSplit keyboard navigation. Fixed by Fix ResizableSplit handling keyboard navigation incorrectly #842.
• Bugfix: Fix Menu focus. See [HELP] - Menu inside frame goes to the top when unfocused #841
• Feature: Add ComponentBase::Index(). This allows to get the index of a
  component in its parent. See Menu item selection not drawn the whole way #932
• Feature: Add EntryState::index. This allows to get the index of a menu entry.
  See Menu item selection not drawn the whole way #932
• Feature: Add SliderOption::on_change. This allows to set a callback when the
  slider value changes. See Add SliderWithCallback component #938.
• Bugfix: Handle Dropdown with no entries.
• Bugfix: Fix crash in LinearGradient due to float precision and an off-by-one
  mistake. See Vector out of bounds error in linear_gradient.cpp #998.

Dom

• Feature: Add italic decorator. For instance:

  auto italic_text = text("Italic text") | italic;

  auto italic_text = italic(text("Italic text"));

  Proposed by @KenReneris in Add support for italics #1009.
• Feature: Add hscroll_indicator. It display an horizontal indicator
  reflecting the current scroll position. Proposed by @ibrahimnasson in
  issue 752
• Feature: Add extend_beyond_screen option to Dimension::Fit(..), allowing
  the element to be larger than the screen. Proposed by @LordWhiro. See Display problem #572 and
  Print a non-dynamic element higher than the terminal #949.
• Feature: Add support for Selection. Thanks @clement-roblot. See Selection2 the come back #926.
  • See selectionColor decorator.
  • See selectionBackgroundColor decorator.
  • See selectionForegroundColor decorator.
  • See selectionStyle(style) decorator.
  • See selectionStyleReset decorator.
• Breaking change: Change how "focus"/"select" are handled. This fixes the
  behavior.

Screen

• Feature: Add Box::IsEmpty().
• Feature: Color transparency
  • Add Color::RGBA(r,g,b,a).
  • Add Color::HSVA(r,g,b,a).
  • Add Color::Blend(Color).
  • Add Color::IsOpaque()

Util

• Feature: Support arbitrary Adapter for ConstStringListRef. See Problems with Menu? #843.

Build

• Support for cmake's "unity/jumbo" builds. Fixed by @ClausKlein.

---

This discussion was created from the release v6.0.0.

[KerstinKeller]

@ArthurSonzogni
Thanks for your work on ftxui!

One question regarding the 6.0.0, can you explain the rationale for making the Render function non-virtual and instead introducing a OnRender function? (Which is not at all mentioned in the release notes)
And then what the implications are for the user?

We do have quite a few components which inherit from ftxui components, and were overriding the Render method, however after the upgrade, we do have some problems with the rendering / selection of elements (eclipse-ecal/ecal#2095).

[ArthurSonzogni]

@KerstinKeller,

You can replace all the implementation of Render by an implementation of OnRender instead.

Context I had to split this function in two:

• Render controlled by FTXUI.
• OnRender controlled by the users.

Render() allows me to tag element as "active" or "inactive" depending on the Component state. This allows to select the focused element in a hiearchical manner. This replaces the previous focus/select decorator where only a 2-level global focus was previously applied.

See Render implementation