overlay.rs

  1use smallvec::SmallVec;
  2use taffy::style::{Display, Position};
  3
  4use crate::{
  5    point, AnyElement, BorrowWindow, Bounds, Element, IntoElement, LayoutId, ParentElement, Pixels,
  6    Point, Size, Style, WindowContext,
  7};
  8
  9pub struct OverlayState {
 10    child_layout_ids: SmallVec<[LayoutId; 4]>,
 11}
 12
 13pub struct Overlay {
 14    children: SmallVec<[AnyElement; 2]>,
 15    anchor_corner: AnchorCorner,
 16    fit_mode: OverlayFitMode,
 17    // todo!();
 18    anchor_position: Option<Point<Pixels>>,
 19    // position_mode: OverlayPositionMode,
 20}
 21
 22/// overlay gives you a floating element that will avoid overflowing the window bounds.
 23/// Its children should have no margin to avoid measurement issues.
 24pub fn overlay() -> Overlay {
 25    Overlay {
 26        children: SmallVec::new(),
 27        anchor_corner: AnchorCorner::TopLeft,
 28        fit_mode: OverlayFitMode::SwitchAnchor,
 29        anchor_position: None,
 30    }
 31}
 32
 33impl Overlay {
 34    /// Sets which corner of the overlay should be anchored to the current position.
 35    pub fn anchor(mut self, anchor: AnchorCorner) -> Self {
 36        self.anchor_corner = anchor;
 37        self
 38    }
 39
 40    /// Sets the position in window co-ordinates
 41    /// (otherwise the location the overlay is rendered is used)
 42    pub fn position(mut self, anchor: Point<Pixels>) -> Self {
 43        self.anchor_position = Some(anchor);
 44        self
 45    }
 46
 47    /// Snap to window edge instead of switching anchor corner when an overflow would occur.
 48    pub fn snap_to_window(mut self) -> Self {
 49        self.fit_mode = OverlayFitMode::SnapToWindow;
 50        self
 51    }
 52}
 53
 54impl ParentElement for Overlay {
 55    fn children_mut(&mut self) -> &mut SmallVec<[AnyElement; 2]> {
 56        &mut self.children
 57    }
 58}
 59
 60impl Element for Overlay {
 61    type State = OverlayState;
 62
 63    fn layout(
 64        &mut self,
 65        _: Option<Self::State>,
 66        cx: &mut WindowContext,
 67    ) -> (crate::LayoutId, Self::State) {
 68        let child_layout_ids = self
 69            .children
 70            .iter_mut()
 71            .map(|child| child.layout(cx))
 72            .collect::<SmallVec<_>>();
 73
 74        let mut overlay_style = Style::default();
 75        overlay_style.position = Position::Absolute;
 76        overlay_style.display = Display::Flex;
 77
 78        let layout_id = cx.request_layout(&overlay_style, child_layout_ids.iter().copied());
 79
 80        (layout_id, OverlayState { child_layout_ids })
 81    }
 82
 83    fn paint(
 84        self,
 85        bounds: crate::Bounds<crate::Pixels>,
 86        element_state: &mut Self::State,
 87        cx: &mut WindowContext,
 88    ) {
 89        if element_state.child_layout_ids.is_empty() {
 90            return;
 91        }
 92
 93        let mut child_min = point(Pixels::MAX, Pixels::MAX);
 94        let mut child_max = Point::default();
 95        for child_layout_id in &element_state.child_layout_ids {
 96            let child_bounds = cx.layout_bounds(*child_layout_id);
 97            child_min = child_min.min(&child_bounds.origin);
 98            child_max = child_max.max(&child_bounds.lower_right());
 99        }
100        let size: Size<Pixels> = (child_max - child_min).into();
101        let origin = self.anchor_position.unwrap_or(bounds.origin);
102
103        let mut desired = self.anchor_corner.get_bounds(origin, size);
104        let limits = Bounds {
105            origin: Point::zero(),
106            size: cx.viewport_size(),
107        };
108        dbg!(limits);
109
110        match self.fit_mode {
111            OverlayFitMode::SnapToWindow => {
112                // Snap the horizontal edges of the overlay to the horizontal edges of the window if
113                // its horizontal bounds overflow
114                if desired.right() > limits.right() {
115                    desired.origin.x -= desired.right() - limits.right();
116                } else if desired.left() < limits.left() {
117                    desired.origin.x = limits.origin.x;
118                }
119
120                // Snap the vertical edges of the overlay to the vertical edges of the window if
121                // its vertical bounds overflow.
122                if desired.bottom() > limits.bottom() {
123                    desired.origin.y -= desired.bottom() - limits.bottom();
124                } else if desired.top() < limits.top() {
125                    desired.origin.y = limits.origin.y;
126                }
127            }
128            OverlayFitMode::SwitchAnchor => {
129                let mut anchor_corner = self.anchor_corner;
130
131                if desired.left() < limits.left() || desired.right() > limits.right() {
132                    anchor_corner = anchor_corner.switch_axis(Axis::Horizontal);
133                }
134
135                if bounds.top() < limits.top() || bounds.bottom() > limits.bottom() {
136                    anchor_corner = anchor_corner.switch_axis(Axis::Vertical);
137                }
138
139                // Update bounds if needed
140                if anchor_corner != self.anchor_corner {
141                    desired = anchor_corner.get_bounds(origin, size)
142                }
143            }
144            OverlayFitMode::None => {}
145        }
146
147        cx.with_element_offset(desired.origin - bounds.origin, |cx| {
148            cx.break_content_mask(|cx| {
149                for child in self.children {
150                    child.paint(cx);
151                }
152            })
153        })
154    }
155}
156
157impl IntoElement for Overlay {
158    type Element = Self;
159
160    fn element_id(&self) -> Option<crate::ElementId> {
161        None
162    }
163
164    fn into_element(self) -> Self::Element {
165        self
166    }
167}
168
169enum Axis {
170    Horizontal,
171    Vertical,
172}
173
174#[derive(Copy, Clone)]
175pub enum OverlayFitMode {
176    SnapToWindow,
177    SwitchAnchor,
178    None,
179}
180
181#[derive(Clone, Copy, PartialEq, Eq)]
182pub enum AnchorCorner {
183    TopLeft,
184    TopRight,
185    BottomLeft,
186    BottomRight,
187}
188
189impl AnchorCorner {
190    fn get_bounds(&self, origin: Point<Pixels>, size: Size<Pixels>) -> Bounds<Pixels> {
191        let origin = match self {
192            Self::TopLeft => origin,
193            Self::TopRight => Point {
194                x: origin.x - size.width,
195                y: origin.y,
196            },
197            Self::BottomLeft => Point {
198                x: origin.x,
199                y: origin.y - size.height,
200            },
201            Self::BottomRight => Point {
202                x: origin.x - size.width,
203                y: origin.y - size.height,
204            },
205        };
206
207        Bounds { origin, size }
208    }
209
210    pub fn corner(&self, bounds: Bounds<Pixels>) -> Point<Pixels> {
211        match self {
212            Self::TopLeft => bounds.origin,
213            Self::TopRight => bounds.upper_right(),
214            Self::BottomLeft => bounds.lower_left(),
215            Self::BottomRight => bounds.lower_right(),
216        }
217    }
218
219    fn switch_axis(self, axis: Axis) -> Self {
220        match axis {
221            Axis::Vertical => match self {
222                AnchorCorner::TopLeft => AnchorCorner::BottomLeft,
223                AnchorCorner::TopRight => AnchorCorner::BottomRight,
224                AnchorCorner::BottomLeft => AnchorCorner::TopLeft,
225                AnchorCorner::BottomRight => AnchorCorner::TopRight,
226            },
227            Axis::Horizontal => match self {
228                AnchorCorner::TopLeft => AnchorCorner::TopRight,
229                AnchorCorner::TopRight => AnchorCorner::TopLeft,
230                AnchorCorner::BottomLeft => AnchorCorner::BottomRight,
231                AnchorCorner::BottomRight => AnchorCorner::BottomLeft,
232            },
233        }
234    }
235}