Struct TextBlockStep 

pub struct TextBlockStep { /* private fields */ }

A multi-line text input step.

Examples

use tty_form::{
    Form,
    step::{Step, TextBlockStep},
};

let mut form = Form::new();

let mut step = TextBlockStep::new("Enter your story:");
step.set_max_line_length(100);
step.add_to(&mut form);

Implementations

impl TextBlockStep

pub fn new(prompt: &str) -> Self

Create a new, default text block step.

Examples found in repository

examples/basic.rs (line 50)

fn execute() -> Result<String> {
    let mut form = Form::new();

    let mut commit_summary = CompoundStep::new();
    commit_summary.set_max_line_length(80);

    SelectInput::new(
        "Select the commit type.",
        vec![
            ("feat", "implemented a new feature"),
            ("bug", "fixed existing behavior"),
            ("docs", "added documentation"),
            ("chore", "non-source changes"),
        ],
    )
    .add_to(&mut commit_summary);

    let mut opening_paren = StaticText::new("(");
    let mut closing_paren = StaticText::new(")");

    let mut scope_input = TextInput::new("Enter the commit's scope.", true);

    let empty_scope = scope_input.set_evaluation(Evaluation::IsEmpty);
    opening_paren.set_dependency(empty_scope, Action::Hide);
    closing_paren.set_dependency(empty_scope, Action::Hide);

    let mut breaking_bang = StaticText::new("!");
    let colon = StaticText::new(": ");

    let description = TextInput::new("Enter the commit's description.", true);

    let mut long_description = TextBlockStep::new("Enter a long-form commit description.");
    long_description.set_margins(Some(1), Some(1));
    long_description.set_max_line_length(100);

    let mut breaking_step = YesNoStep::new(
        "Is this commit a breaking change?",
        "Enter a description of the breaking change.",
        "BREAKING CHANGE",
    );

    let trailers = KeyValueStep::new("Enter any key-value trailers, such as tickets.");

    let breaking_change = breaking_step.set_evaluation(Evaluation::Equal("Yes".to_string()));
    breaking_bang.set_dependency(breaking_change, Action::Show);

    opening_paren.add_to(&mut commit_summary);
    scope_input.add_to(&mut commit_summary);
    closing_paren.add_to(&mut commit_summary);
    breaking_bang.add_to(&mut commit_summary);
    colon.add_to(&mut commit_summary);
    description.add_to(&mut commit_summary);
    commit_summary.add_to(&mut form);
    long_description.add_to(&mut form);
    trailers.add_to(&mut form);
    breaking_step.add_to(&mut form);

    let mut stdout = stdout();
    let mut stdin = StdinDevice;

    let mut interface = Interface::new_relative(&mut stdout)?;

    let result = form.execute(&mut interface, &mut stdin);
    interface.exit()?;

    let mut output = String::new();
    match result {
        Ok(value) => output = value,
        Err(Error::Canceled) => println!("Form canceled."),
        Err(err) => eprintln!("Unexpected error occurred: {:?}", err),
    }

    Ok(output)
}

pub fn set_margins( &mut self, top_margin: Option<u16>, bottom_margin: Option<u16>, )

Set this text block’s top and bottom margins.

Examples found in repository

examples/basic.rs (line 51)

fn execute() -> Result<String> {
    let mut form = Form::new();

    let mut commit_summary = CompoundStep::new();
    commit_summary.set_max_line_length(80);

    SelectInput::new(
        "Select the commit type.",
        vec![
            ("feat", "implemented a new feature"),
            ("bug", "fixed existing behavior"),
            ("docs", "added documentation"),
            ("chore", "non-source changes"),
        ],
    )
    .add_to(&mut commit_summary);

    let mut opening_paren = StaticText::new("(");
    let mut closing_paren = StaticText::new(")");

    let mut scope_input = TextInput::new("Enter the commit's scope.", true);

    let empty_scope = scope_input.set_evaluation(Evaluation::IsEmpty);
    opening_paren.set_dependency(empty_scope, Action::Hide);
    closing_paren.set_dependency(empty_scope, Action::Hide);

    let mut breaking_bang = StaticText::new("!");
    let colon = StaticText::new(": ");

    let description = TextInput::new("Enter the commit's description.", true);

    let mut long_description = TextBlockStep::new("Enter a long-form commit description.");
    long_description.set_margins(Some(1), Some(1));
    long_description.set_max_line_length(100);

    let mut breaking_step = YesNoStep::new(
        "Is this commit a breaking change?",
        "Enter a description of the breaking change.",
        "BREAKING CHANGE",
    );

    let trailers = KeyValueStep::new("Enter any key-value trailers, such as tickets.");

    let breaking_change = breaking_step.set_evaluation(Evaluation::Equal("Yes".to_string()));
    breaking_bang.set_dependency(breaking_change, Action::Show);

    opening_paren.add_to(&mut commit_summary);
    scope_input.add_to(&mut commit_summary);
    closing_paren.add_to(&mut commit_summary);
    breaking_bang.add_to(&mut commit_summary);
    colon.add_to(&mut commit_summary);
    description.add_to(&mut commit_summary);
    commit_summary.add_to(&mut form);
    long_description.add_to(&mut form);
    trailers.add_to(&mut form);
    breaking_step.add_to(&mut form);

    let mut stdout = stdout();
    let mut stdin = StdinDevice;

    let mut interface = Interface::new_relative(&mut stdout)?;

    let result = form.execute(&mut interface, &mut stdin);
    interface.exit()?;

    let mut output = String::new();
    match result {
        Ok(value) => output = value,
        Err(Error::Canceled) => println!("Form canceled."),
        Err(err) => eprintln!("Unexpected error occurred: {:?}", err),
    }

    Ok(output)
}

pub fn set_max_line_length(&mut self, max_length: u16)

Set this text block step’s optional maximum line grapheme length.

Examples found in repository

examples/basic.rs (line 52)

fn execute() -> Result<String> {
    let mut form = Form::new();

    let mut commit_summary = CompoundStep::new();
    commit_summary.set_max_line_length(80);

    SelectInput::new(
        "Select the commit type.",
        vec![
            ("feat", "implemented a new feature"),
            ("bug", "fixed existing behavior"),
            ("docs", "added documentation"),
            ("chore", "non-source changes"),
        ],
    )
    .add_to(&mut commit_summary);

    let mut opening_paren = StaticText::new("(");
    let mut closing_paren = StaticText::new(")");

    let mut scope_input = TextInput::new("Enter the commit's scope.", true);

    let empty_scope = scope_input.set_evaluation(Evaluation::IsEmpty);
    opening_paren.set_dependency(empty_scope, Action::Hide);
    closing_paren.set_dependency(empty_scope, Action::Hide);

    let mut breaking_bang = StaticText::new("!");
    let colon = StaticText::new(": ");

    let description = TextInput::new("Enter the commit's description.", true);

    let mut long_description = TextBlockStep::new("Enter a long-form commit description.");
    long_description.set_margins(Some(1), Some(1));
    long_description.set_max_line_length(100);

    let mut breaking_step = YesNoStep::new(
        "Is this commit a breaking change?",
        "Enter a description of the breaking change.",
        "BREAKING CHANGE",
    );

    let trailers = KeyValueStep::new("Enter any key-value trailers, such as tickets.");

    let breaking_change = breaking_step.set_evaluation(Evaluation::Equal("Yes".to_string()));
    breaking_bang.set_dependency(breaking_change, Action::Show);

    opening_paren.add_to(&mut commit_summary);
    scope_input.add_to(&mut commit_summary);
    closing_paren.add_to(&mut commit_summary);
    breaking_bang.add_to(&mut commit_summary);
    colon.add_to(&mut commit_summary);
    description.add_to(&mut commit_summary);
    commit_summary.add_to(&mut form);
    long_description.add_to(&mut form);
    trailers.add_to(&mut form);
    breaking_step.add_to(&mut form);

    let mut stdout = stdout();
    let mut stdin = StdinDevice;

    let mut interface = Interface::new_relative(&mut stdout)?;

    let result = form.execute(&mut interface, &mut stdin);
    interface.exit()?;

    let mut output = String::new();
    match result {
        Ok(value) => output = value,
        Err(Error::Canceled) => println!("Form canceled."),
        Err(err) => eprintln!("Unexpected error occurred: {:?}", err),
    }

    Ok(output)
}

pub fn set_trim_trailing_whitespace(&mut self, trim: bool)

Set whether this text block should trim trailing whitespace.

Trait Implementations

impl Step for TextBlockStep

fn initialize(&mut self, _dependency_state: &mut DependencyState, _index: usize)

Perform any post-configuration initialization actions for this step.

fn render( &self, interface: &mut Interface<'_>, _dependency_state: &DependencyState, position: Position, is_focused: bool, ) -> u16

Render this step at the specified position and return the height of the rendered content.

fn update( &mut self, _dependency_state: &mut DependencyState, input: KeyEvent, ) -> Option<InputResult>

Handle the specified input event, optionally returning an instruction for the form.

fn help(&self) -> Segment

Retrieve this step’s current help text.

fn drawer(&self) -> Option<DrawerContents>

Retrieve this step’s current drawer contents, if applicable.

fn result(&self, _dependency_state: &DependencyState) -> String

Retrieves this step’s final WYSIWYG result.

fn add_to(self, form: &mut Form)

Complete configuration and add this step to the form.