TextBox.doc.md

TextBox

Element that represents box with text. It's text can be edited in UI.

public sealed class TextBox : UIElement, IFocusable

You can find its source code in TextBox.cs

Building

To build TextBox you should use TextBoxBuilder. (Its source code is in TextBoxBuilder.cs)

public sealed class TextBoxBuilder : IUIElementBuilder<TextBox>

Here is the first example:

using Sunnyyssh.ConsoleUI;

var appBuilder = new ApplicationBuilder(new ApplicationSettings()); // app builder init.

// TextBox will have 100% width and 20% height.
var urlBoxBuilder = new TextBoxBuilder(1.0, 0.2)
{
    FocusedBackground = Color.DarkBlue, // When it's focused its background is dark blue.
    StartingText = "https://google.com",
    BorderKind = BorderKind.SingleLine, 
    ShowPressedChars = true, // Pressed characters are shown.
    WordWrap = false, // Words shouldn't be wrapped.
    UserEditable = true, // Its text may be edited in UI.
    TextHorizontalAligning = HorizontalAligning.Left,
    TextVerticalAligning = VerticalAligning.Top
};

// TextBox will have 100% width and 80% height.
var responseBoxBuilder = new TextBoxBuilder(1.0, 0.8)
{
    BorderKind = BorderKind.DoubleLine,
    WordWrap = false, // Words shouldn't be wrapped.
    UserEditable = false, // Its text may not be edited in UI.
    TextHorizontalAligning = HorizontalAligning.Left,
    TextVerticalAligning = VerticalAligning.Top
};

var app = appBuilder
    .Add(urlBoxBuilder, Position.LeftTop, out var builtUrlBox) // Add textBoxBuilder at left top position.
    .Add(responseBoxBuilder, 0, 0.2, out var builtResponseBox) // Add textBoxBuilder at left top position.
    .Build(); // Application builds.
    
builtUrlBox.WaitInitialization(); // Wait when they are initialized. (Actually, they are initialized because application is built).
builtResponseBox.WaitInitialization();
var urlBox = builtUrlBox.Element; // Get built TextBox instances.
var responseBox = builtResponseBox.Element;

urlBox.TextEntered += async (_, args) => 
    // reponseBox's text is updated by response on address that is urlBox's text.
    responseBox.Text = await new HttpClient().GetStringAsync(args.Text);
    
app.Run();
app.Wait();

It runs to this:

Here is the second example with using binding:

using Sunnyyssh.ConsoleUI;
using Sunnyyssh.ConsoleUI.Binding;

var appBuilder = new ApplicationBuilder(
    new ApplicationSettings() { DefaultForeground = Color.Gray }); // app builder init.

var textBox1Builder = new TextBoxBuilder(0.5, 1.0);
var textBox2Builder = new TextBoxBuilder(0.5, 1.0);

var stackBuilder = new StackPanelBuilder(0.7, 0.7, Orientation.Horizontal)
    .Add(textBox1Builder, out var builtTextBox1)
    .Add(textBox2Builder, out var builtTextBox2);
    
var app = appBuilder
    .Add(stackBuilder, Position.LeftTop)
    .Build();
    
var textBox1 = builtTextBox1.Element!; // It won't be null because application is built.
var textBox2 = builtTextBox2.Element!;

// It just assigns newValue to the changing.
void TextChanger(ValueChangedEventArgs<string?> eventArgs, ref string? changing) 
    => changing = eventArgs.NewValue;
// Two-side bindable object.
var bindableText = new InvertibleBindable<string?, ValueChangedEventArgs<string?>>(null, TextChanger);

textBox1.Bind(bindableText.FirstSide);
textBox2.Bind(bindableText.SecondSide);

app.Run();
app.Wait();

It runs to this: