lurq 0.22.2

A Rust UI toolkit with typed components, retained state, reactive signals, GPU rendering, and DevTools.
Documentation
pub use crate::node::node_kind::{TextInputOverflow, TextInputOverflowAnchor};
use crate::{
  app::theme::CaretMode,
  core::Signal,
  impl_into_node,
  layout::text_style::{TextAlign, TextStyle},
};

impl_into_node!(TextInput);

impl TextInput {
  pub fn new(value: Signal<String>) -> Self {
    Self::from_node(crate::node::Node::text_input(value))
  }

  pub fn styled(value: Signal<String>, style: TextStyle) -> Self {
    Self::from_node(crate::node::Node::text_input_styled(value, style))
  }

  pub fn text_style(mut self, style: TextStyle) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_style(node, style));
    self
  }

  pub fn placeholder_style(mut self, style: TextStyle) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_placeholder_style(node, style));
    self
  }

  pub fn text_align(mut self, align: impl Into<TextAlign>) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_align(node, align));
    self
  }

  /// Extra space after every glyph of the value and placeholder, in logical
  /// pixels (negative tightens). Like `text_align`, a later `text_style` or
  /// `placeholder_style` replaces it.
  pub fn letter_spacing(mut self, letter_spacing: f32) -> Self {
    self.update_node(|node| node.set_text_input_letter_spacing(letter_spacing));
    self
  }

  pub fn placeholder(mut self, placeholder: &str) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::placeholder(node, placeholder));
    self
  }

  pub fn on_input(mut self, f: impl crate::node::IntoTextInputEventHandler) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::on_input(node, f));
    self
  }

  pub fn off_input(mut self, f: impl crate::node::IntoTextInputEventHandler) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::off_input(node, f));
    self
  }

  pub fn caret_color(mut self, color: impl Into<crate::node::TextColor>) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::caret_color(node, color));
    self
  }

  pub fn selection_color(mut self, color: impl Into<crate::node::TextColor>) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::selection_color(node, color));
    self
  }

  pub fn caret_mode(mut self, mode: CaretMode) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_caret_mode(node, mode));
    self
  }

  pub fn overflow(mut self, overflow: TextInputOverflow) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_overflow(node, overflow));
    self
  }

  /// Controls which edge of overflowing single-line text is visible while
  /// the input is not focused. Focused inputs always scroll to follow the
  /// caret.
  pub fn unfocused_overflow_anchor(mut self, anchor: TextInputOverflowAnchor) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_unfocused_overflow_anchor(node, anchor));
    self
  }

  /// Masks each value character with `•` (U+2022).
  pub fn mask(mut self) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_mask(node));
    self
  }

  /// Uses a custom mask, such as `'\u{25cf}'` for a WinUI-style heavy dot.
  pub fn mask_char(mut self, mask: char) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_mask_char(node, mask));
    self
  }

  pub fn unmask(mut self) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_unmask(node));
    self
  }

  pub fn single_line(mut self) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_overflow(node, TextInputOverflow::Scroll));
    self
  }

  pub fn multiline(mut self) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_overflow(node, TextInputOverflow::Multiline));
    self
  }

  pub fn textarea(mut self) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_rows(node, 2, 6));
    self
  }

  pub fn rows(mut self, min_rows: usize, max_rows: usize) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_rows(node, min_rows, max_rows));
    self
  }

  pub fn min_rows(mut self, min_rows: usize) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_min_rows(node, min_rows));
    self
  }

  pub fn max_rows(mut self, max_rows: usize) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_max_rows(node, max_rows));
    self
  }

  pub fn rows_exact(mut self, rows: usize) -> Self {
    self.update_node(|node| crate::node::NodeUpdate::text_input_rows_exact(node, rows));
    self
  }
}

impl Default for TextInput {
  fn default() -> Self {
    Self::new(Signal::new(String::new()))
  }
}