use crate::core::alignment; use crate::core::event; use crate::core::layout; use crate::core::mouse; use crate::core::renderer; use crate::core::text::{Paragraph, Span}; use crate::core::widget::text::{ self, Catalog, LineHeight, Shaping, Style, StyleFn, Wrapping, }; use crate::core::widget::tree::{self, Tree}; use crate::core::{ self, Clipboard, Color, Element, Event, Layout, Length, Pixels, Point, Rectangle, Shell, Size, Vector, Widget, }; /// A bunch of [`Rich`] text. #[allow(missing_debug_implementations)] pub struct Rich<'a, Link, Theme = crate::Theme, Renderer = crate::Renderer> where Link: Clone + 'static, Theme: Catalog, Renderer: core::text::Renderer, { spans: Box]> + 'a>, size: Option, line_height: LineHeight, width: Length, height: Length, font: Option, align_x: alignment::Horizontal, align_y: alignment::Vertical, wrapping: Wrapping, class: Theme::Class<'a>, } impl<'a, Link, Theme, Renderer> Rich<'a, Link, Theme, Renderer> where Link: Clone + 'static, Theme: Catalog, Renderer: core::text::Renderer, Renderer::Font: 'a, { /// Creates a new empty [`Rich`] text. pub fn new() -> Self { Self { spans: Box::new([]), size: None, line_height: LineHeight::default(), width: Length::Shrink, height: Length::Shrink, font: None, align_x: alignment::Horizontal::Left, align_y: alignment::Vertical::Top, wrapping: Wrapping::default(), class: Theme::default(), } } /// Creates a new [`Rich`] text with the given text spans. pub fn with_spans( spans: impl AsRef<[Span<'a, Link, Renderer::Font>]> + 'a, ) -> Self { Self { spans: Box::new(spans), ..Self::new() } } /// Sets the default size of the [`Rich`] text. pub fn size(mut self, size: impl Into) -> Self { self.size = Some(size.into()); self } /// Sets the defualt [`LineHeight`] of the [`Rich`] text. pub fn line_height(mut self, line_height: impl Into) -> Self { self.line_height = line_height.into(); self } /// Sets the default font of the [`Rich`] text. pub fn font(mut self, font: impl Into) -> Self { self.font = Some(font.into()); self } /// Sets the width of the [`Rich`] text boundaries. pub fn width(mut self, width: impl Into) -> Self { self.width = width.into(); self } /// Sets the height of the [`Rich`] text boundaries. pub fn height(mut self, height: impl Into) -> Self { self.height = height.into(); self } /// Centers the [`Rich`] text, both horizontally and vertically. pub fn center(self) -> Self { self.align_x(alignment::Horizontal::Center) .align_y(alignment::Vertical::Center) } /// Sets the [`alignment::Horizontal`] of the [`Rich`] text. pub fn align_x( mut self, alignment: impl Into, ) -> Self { self.align_x = alignment.into(); self } /// Sets the [`alignment::Vertical`] of the [`Rich`] text. pub fn align_y( mut self, alignment: impl Into, ) -> Self { self.align_y = alignment.into(); self } /// Sets the [`Wrapping`] strategy of the [`Rich`] text. pub fn wrapping(mut self, wrapping: Wrapping) -> Self { self.wrapping = wrapping; self } /// Sets the default style of the [`Rich`] text. #[must_use] pub fn style(mut self, style: impl Fn(&Theme) -> Style + 'a) -> Self where Theme::Class<'a>: From>, { self.class = (Box::new(style) as StyleFn<'a, Theme>).into(); self } /// Sets the default [`Color`] of the [`Rich`] text. pub fn color(self, color: impl Into) -> Self where Theme::Class<'a>: From>, { self.color_maybe(Some(color)) } /// Sets the default [`Color`] of the [`Rich`] text, if `Some`. pub fn color_maybe(self, color: Option>) -> Self where Theme::Class<'a>: From>, { let color = color.map(Into::into); self.style(move |_theme| Style { color }) } /// Sets the default style class of the [`Rich`] text. #[cfg(feature = "advanced")] #[must_use] pub fn class(mut self, class: impl Into>) -> Self { self.class = class.into(); self } } impl<'a, Link, Theme, Renderer> Default for Rich<'a, Link, Theme, Renderer> where Link: Clone + 'a, Theme: Catalog, Renderer: core::text::Renderer, Renderer::Font: 'a, { fn default() -> Self { Self::new() } } struct State { spans: Vec>, span_pressed: Option, paragraph: P, } impl<'a, Link, Theme, Renderer> Widget for Rich<'a, Link, Theme, Renderer> where Link: Clone + 'static, Theme: Catalog, Renderer: core::text::Renderer, { fn tag(&self) -> tree::Tag { tree::Tag::of::>() } fn state(&self) -> tree::State { tree::State::new(State:: { spans: Vec::new(), span_pressed: None, paragraph: Renderer::Paragraph::default(), }) } fn size(&self) -> Size { Size { width: self.width, height: self.height, } } fn layout( &self, tree: &mut Tree, renderer: &Renderer, limits: &layout::Limits, ) -> layout::Node { layout( tree.state .downcast_mut::>(), renderer, limits, self.width, self.height, self.spans.as_ref().as_ref(), self.line_height, self.size, self.font, self.align_x, self.align_y, self.wrapping, ) } fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, defaults: &renderer::Style, layout: Layout<'_>, cursor: mouse::Cursor, viewport: &Rectangle, ) { let state = tree .state .downcast_ref::>(); let style = theme.style(&self.class); let hovered_span = cursor .position_in(layout.bounds()) .and_then(|position| state.paragraph.hit_span(position)); for (index, span) in self.spans.as_ref().as_ref().iter().enumerate() { let is_hovered_link = span.link.is_some() && Some(index) == hovered_span; if span.highlight.is_some() || span.underline || span.strikethrough || is_hovered_link { let translation = layout.position() - Point::ORIGIN; let regions = state.paragraph.span_bounds(index); if let Some(highlight) = span.highlight { for bounds in ®ions { let bounds = Rectangle::new( bounds.position() - Vector::new( span.padding.left, span.padding.top, ), bounds.size() + Size::new( span.padding.horizontal(), span.padding.vertical(), ), ); renderer.fill_quad( renderer::Quad { bounds: bounds + translation, border: highlight.border, ..Default::default() }, highlight.background, ); } } if span.underline || span.strikethrough || is_hovered_link { let size = span .size .or(self.size) .unwrap_or(renderer.default_size()); let line_height = span .line_height .unwrap_or(self.line_height) .to_absolute(size); let color = span .color .or(style.color) .unwrap_or(defaults.text_color); let baseline = translation + Vector::new( 0.0, size.0 + (line_height.0 - size.0) / 2.0, ); if span.underline || is_hovered_link { for bounds in ®ions { renderer.fill_quad( renderer::Quad { bounds: Rectangle::new( bounds.position() + baseline - Vector::new(0.0, size.0 * 0.08), Size::new(bounds.width, 1.0), ), ..Default::default() }, color, ); } } if span.strikethrough { for bounds in ®ions { renderer.fill_quad( renderer::Quad { bounds: Rectangle::new( bounds.position() + baseline - Vector::new(0.0, size.0 / 2.0), Size::new(bounds.width, 1.0), ), ..Default::default() }, color, ); } } } } } text::draw( renderer, defaults, layout, &state.paragraph, style, viewport, ); } fn on_event( &mut self, tree: &mut Tree, event: Event, layout: Layout<'_>, cursor: mouse::Cursor, _renderer: &Renderer, _clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Link>, _viewport: &Rectangle, ) -> event::Status { match event { Event::Mouse(mouse::Event::ButtonPressed(mouse::Button::Left)) => { if let Some(position) = cursor.position_in(layout.bounds()) { let state = tree .state .downcast_mut::>(); if let Some(span) = state.paragraph.hit_span(position) { state.span_pressed = Some(span); return event::Status::Captured; } } } Event::Mouse(mouse::Event::ButtonReleased(mouse::Button::Left)) => { let state = tree .state .downcast_mut::>(); if let Some(span_pressed) = state.span_pressed { state.span_pressed = None; if let Some(position) = cursor.position_in(layout.bounds()) { match state.paragraph.hit_span(position) { Some(span) if span == span_pressed => { if let Some(link) = self .spans .as_ref() .as_ref() .get(span) .and_then(|span| span.link.clone()) { shell.publish(link); } } _ => {} } } } } _ => {} } event::Status::Ignored } fn mouse_interaction( &self, tree: &Tree, layout: Layout<'_>, cursor: mouse::Cursor, _viewport: &Rectangle, _renderer: &Renderer, ) -> mouse::Interaction { if let Some(position) = cursor.position_in(layout.bounds()) { let state = tree .state .downcast_ref::>(); if let Some(span) = state .paragraph .hit_span(position) .and_then(|span| self.spans.as_ref().as_ref().get(span)) { if span.link.is_some() { return mouse::Interaction::Pointer; } } } mouse::Interaction::None } } fn layout( state: &mut State, renderer: &Renderer, limits: &layout::Limits, width: Length, height: Length, spans: &[Span<'_, Link, Renderer::Font>], line_height: LineHeight, size: Option, font: Option, horizontal_alignment: alignment::Horizontal, vertical_alignment: alignment::Vertical, wrapping: Wrapping, ) -> layout::Node where Link: Clone, Renderer: core::text::Renderer, { layout::sized(limits, width, height, |limits| { let bounds = limits.max(); let size = size.unwrap_or_else(|| renderer.default_size()); let font = font.unwrap_or_else(|| renderer.default_font()); let text_with_spans = || core::Text { content: spans, bounds, size, line_height, font, horizontal_alignment, vertical_alignment, shaping: Shaping::Advanced, wrapping, }; if state.spans != spans { state.paragraph = Renderer::Paragraph::with_spans(text_with_spans()); state.spans = spans.iter().cloned().map(Span::to_static).collect(); } else { match state.paragraph.compare(core::Text { content: (), bounds, size, line_height, font, horizontal_alignment, vertical_alignment, shaping: Shaping::Advanced, wrapping, }) { core::text::Difference::None => {} core::text::Difference::Bounds => { state.paragraph.resize(bounds); } core::text::Difference::Shape => { state.paragraph = Renderer::Paragraph::with_spans(text_with_spans()); } } } state.paragraph.min_bounds() }) } impl<'a, Link, Theme, Renderer> FromIterator> for Rich<'a, Link, Theme, Renderer> where Link: Clone + 'a, Theme: Catalog, Renderer: core::text::Renderer, Renderer::Font: 'a, { fn from_iter>>( spans: T, ) -> Self { Self::with_spans(spans.into_iter().collect::>()) } } impl<'a, Link, Theme, Renderer> From> for Element<'a, Link, Theme, Renderer> where Link: Clone + 'a, Theme: Catalog + 'a, Renderer: core::text::Renderer + 'a, { fn from( text: Rich<'a, Link, Theme, Renderer>, ) -> Element<'a, Link, Theme, Renderer> { Element::new(text) } }