lurq 0.2.6

A Rust UI toolkit with typed components, retained state, reactive signals, GPU rendering, and DevTools.
Documentation
use crate::{
  core::Guard,
  layout::{
    Alignment, StackAlignment,
    layout_kind::{FrameConstraints, ScrollDirection, ScrollState},
  },
  node::{
    dimension::Dimension,
    node::{EventHandlers, Node},
    node_kind::NodeKind,
    padding::Padding,
    spacing_value::SpacingValue,
  },
};

const DEFAULT_SCROLL_TEXT_WRAP: bool = true;
const DEFAULT_SCROLL_OPACITY: f32 = 1.0;

fn make_scroll(child: Node, direction: ScrollDirection) -> Node {
  let tag_name = child.tag_name.clone();
  Node {
    node_id: crate::core::NodeId::UNASSIGNED,
    tag_name,
    component_slot_id: None,
    component_key: None,
    #[cfg(feature = "devtools")]
    component_props_debug: None,
    #[cfg(feature = "devtools")]
    component_signals_debug: Vec::new(),
    #[cfg(feature = "devtools")]
    component_memos_debug: Vec::new(),
    #[cfg(feature = "devtools")]
    component_effects_debug: Vec::new(),
    #[cfg(feature = "devtools")]
    component_contexts_debug: Vec::new(),
    layout_kind: crate::layout::layout_kind::LayoutKind::ScrollModifier {
      state: ScrollState::new(),
      direction,
    },
    node_kind: NodeKind::Empty,
    text_content: Guard::new(None),
    text_wrap: DEFAULT_SCROLL_TEXT_WRAP,
    overflow: crate::layout::layout_kind::Overflow::Hidden,
    intrinsic_size: None,
    color: Guard::new(None),
    border_radius: Guard::new(None),
    border: Guard::new(None),
    caret_color: Guard::new(None),
    cursor: None,
    #[cfg(feature = "image")]
    background_image: Guard::new(None),
    #[cfg(feature = "image")]
    background_size: crate::node::node::BackgroundSize::default(),
    #[cfg(all(feature = "image", feature = "resources"))]
    background_resource_image: None,
    scrollbar_style: Guard::new(None),
    scrollbar_hovered_style: None,
    element_ref: None,
    interaction: None,
    style_state: crate::node::interaction_state::InteractionState::new(),
    state_styles: crate::node::style::StateStyles::default(),
    opacity: DEFAULT_SCROLL_OPACITY,
    transform: crate::node::transform::Transform2D::IDENTITY,
    animation_overrides: Vec::new(),
    transitions: Vec::new(),
    animation: None,
    layout_cache: Default::default(),
    children: vec![child],
    events: EventHandlers::default(),
  }
}

pub fn scroll_vertical(child: Node) -> Node {
  make_scroll(child, ScrollDirection::Vertical)
}

pub fn scroll_horizontal(child: Node) -> Node {
  make_scroll(child, ScrollDirection::Horizontal)
}

pub fn scroll_both(child: Node) -> Node {
  make_scroll(child, ScrollDirection::Both)
}

impl Node {
  pub fn child(mut self, child: Node) -> Self {
    self.push_child(child);
    self
  }

  pub fn with_children(mut self, children: impl IntoIterator<Item = Node>) -> Self {
    for child in children {
      self.push_child(child);
    }
    self
  }

  pub fn spacing(mut self, spacing: impl Into<SpacingValue>) -> Self {
    self.set_spacing(spacing);
    self
  }

  fn set_spacing(&mut self, spacing: impl Into<SpacingValue>) {
    let spacing = spacing.into();
    match &mut self.layout_kind {
      crate::layout::layout_kind::LayoutKind::Row { spacing: s, .. } => *s = spacing,
      crate::layout::layout_kind::LayoutKind::Column { spacing: s, .. } => *s = spacing,
      _ => {
        if let Some(child) = self.modifier_child_mut() {
          child.set_spacing(spacing);
        }
      }
    }
  }

  pub fn align_items(mut self, align: Alignment) -> Self {
    self.set_align_items(align);
    self
  }

  fn set_align_items(&mut self, align: Alignment) {
    match &mut self.layout_kind {
      crate::layout::layout_kind::LayoutKind::Row { align: a, .. } => *a = align,
      crate::layout::layout_kind::LayoutKind::Column { align: a, .. } => *a = align,
      _ => {
        if let Some(child) = self.modifier_child_mut() {
          child.set_align_items(align);
        }
      }
    }
  }

  pub fn justify(mut self, justify: crate::layout::layout_kind::Justify) -> Self {
    self.set_justify(justify);
    self
  }

  fn set_justify(&mut self, justify: crate::layout::layout_kind::Justify) {
    match &mut self.layout_kind {
      crate::layout::layout_kind::LayoutKind::Row { justify: j, .. } => *j = justify,
      crate::layout::layout_kind::LayoutKind::Column { justify: j, .. } => *j = justify,
      _ => {
        if let Some(child) = self.modifier_child_mut() {
          child.set_justify(justify);
        }
      }
    }
  }

  pub fn wrap(mut self) -> Self {
    self.set_wrap();
    self
  }

  fn set_wrap(&mut self) {
    match &mut self.layout_kind {
      crate::layout::layout_kind::LayoutKind::Row { wrap: w, .. } => *w = crate::layout::layout_kind::FlexWrap::Wrap,
      crate::layout::layout_kind::LayoutKind::Column { wrap: w, .. } => *w = crate::layout::layout_kind::FlexWrap::Wrap,
      _ => {
        if let Some(child) = self.modifier_child_mut() {
          child.set_wrap();
        }
      }
    }
  }

  pub fn stack_align(mut self, align: StackAlignment) -> Self {
    self.set_stack_align(align);
    self
  }

  fn set_stack_align(&mut self, align: StackAlignment) {
    if let crate::layout::layout_kind::LayoutKind::Stack { align: a } = &mut self.layout_kind {
      *a = align;
    } else if let Some(child) = self.modifier_child_mut() {
      child.set_stack_align(align);
    }
  }

  fn push_child(&mut self, child: Node) {
    match self.layout_kind {
      crate::layout::layout_kind::LayoutKind::Row { .. }
      | crate::layout::layout_kind::LayoutKind::Column { .. }
      | crate::layout::layout_kind::LayoutKind::Stack { .. } => self.children.push(child),
      _ => {
        if let Some(inner) = self.modifier_child_mut() {
          inner.push_child(child);
        } else {
          self.children.push(child);
        }
      }
    }
  }

  pub(crate) fn modifier_child_mut(&mut self) -> Option<&mut Node> {
    if matches!(
      self.layout_kind,
      crate::layout::layout_kind::LayoutKind::PaddingModifier(_)
        | crate::layout::layout_kind::LayoutKind::FrameModifier(_)
        | crate::layout::layout_kind::LayoutKind::OffsetModifier { .. }
        | crate::layout::layout_kind::LayoutKind::AbsoluteModifier { .. }
        | crate::layout::layout_kind::LayoutKind::AlignModifier(_)
        | crate::layout::layout_kind::LayoutKind::FlexModifier(_)
    ) && self.children.len() == 1
    {
      Some(&mut self.children[0])
    } else {
      None
    }
  }

  pub fn size(self, width: impl Into<Dimension>, height: impl Into<Dimension>) -> Self {
    self.frame(FrameConstraints {
      width: Some(width.into()),
      height: Some(height.into()),
      ..Default::default()
    })
  }

  pub fn width(self, width: impl Into<Dimension>) -> Self {
    self.frame(FrameConstraints {
      width: Some(width.into()),
      ..Default::default()
    })
  }

  pub fn height(self, height: impl Into<Dimension>) -> Self {
    self.frame(FrameConstraints {
      height: Some(height.into()),
      ..Default::default()
    })
  }

  pub fn relative(self, x: f32, y: f32) -> Self {
    self.offset(x, y)
  }

  pub fn absolute(self, x: f32, y: f32, width: impl Into<Dimension>, height: impl Into<Dimension>) -> Self {
    self.absolute_modifier(x, y, Some(width.into()), Some(height.into()))
  }

  pub fn absolute_position(self, x: f32, y: f32) -> Self {
    self.absolute_modifier(x, y, None, None)
  }

  pub fn padding_horizontal(self, val: impl Into<SpacingValue>) -> Self {
    self.padding(Padding::horizontal(val.into()))
  }

  pub fn padding_vertical(self, val: impl Into<SpacingValue>) -> Self {
    self.padding(Padding::vertical(val.into()))
  }

  pub fn padding_left(self, val: impl Into<SpacingValue>) -> Self {
    self.padding(Padding::new().left(val.into()))
  }

  pub fn padding_right(self, val: impl Into<SpacingValue>) -> Self {
    self.padding(Padding::new().right(val.into()))
  }

  pub fn padding_top(self, val: impl Into<SpacingValue>) -> Self {
    self.padding(Padding::new().top(val.into()))
  }

  pub fn padding_bottom(self, val: impl Into<SpacingValue>) -> Self {
    self.padding(Padding::new().bottom(val.into()))
  }
}