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::default(),
106 size: cx.viewport_size(),
107 };
108
109 match self.fit_mode {
110 OverlayFitMode::SnapToWindow => {
111 // Snap the horizontal edges of the overlay to the horizontal edges of the window if
112 // its horizontal bounds overflow
113 if desired.right() > limits.right() {
114 desired.origin.x -= desired.right() - limits.right();
115 } else if desired.left() < limits.left() {
116 desired.origin.x = limits.origin.x;
117 }
118
119 // Snap the vertical edges of the overlay to the vertical edges of the window if
120 // its vertical bounds overflow.
121 if desired.bottom() > limits.bottom() {
122 desired.origin.y -= desired.bottom() - limits.bottom();
123 } else if desired.top() < limits.top() {
124 desired.origin.y = limits.origin.y;
125 }
126 }
127 OverlayFitMode::SwitchAnchor => {
128 let mut anchor_corner = self.anchor_corner;
129
130 if desired.left() < limits.left() || desired.right() > limits.right() {
131 anchor_corner = anchor_corner.switch_axis(Axis::Horizontal);
132 }
133
134 if bounds.top() < limits.top() || bounds.bottom() > limits.bottom() {
135 anchor_corner = anchor_corner.switch_axis(Axis::Vertical);
136 }
137
138 // Update bounds if needed
139 if anchor_corner != self.anchor_corner {
140 desired = anchor_corner.get_bounds(origin, size)
141 }
142 }
143 OverlayFitMode::None => {}
144 }
145
146 cx.with_element_offset(desired.origin - bounds.origin, |cx| {
147 cx.break_content_mask(|cx| {
148 for child in self.children {
149 child.paint(cx);
150 }
151 })
152 })
153 }
154}
155
156impl IntoElement for Overlay {
157 type Element = Self;
158
159 fn element_id(&self) -> Option<crate::ElementId> {
160 None
161 }
162
163 fn into_element(self) -> Self::Element {
164 self
165 }
166}
167
168enum Axis {
169 Horizontal,
170 Vertical,
171}
172
173#[derive(Copy, Clone)]
174pub enum OverlayFitMode {
175 SnapToWindow,
176 SwitchAnchor,
177 None,
178}
179
180#[derive(Clone, Copy, PartialEq, Eq)]
181pub enum AnchorCorner {
182 TopLeft,
183 TopRight,
184 BottomLeft,
185 BottomRight,
186}
187
188impl AnchorCorner {
189 fn get_bounds(&self, origin: Point<Pixels>, size: Size<Pixels>) -> Bounds<Pixels> {
190 let origin = match self {
191 Self::TopLeft => origin,
192 Self::TopRight => Point {
193 x: origin.x - size.width,
194 y: origin.y,
195 },
196 Self::BottomLeft => Point {
197 x: origin.x,
198 y: origin.y - size.height,
199 },
200 Self::BottomRight => Point {
201 x: origin.x - size.width,
202 y: origin.y - size.height,
203 },
204 };
205
206 Bounds { origin, size }
207 }
208
209 pub fn corner(&self, bounds: Bounds<Pixels>) -> Point<Pixels> {
210 match self {
211 Self::TopLeft => bounds.origin,
212 Self::TopRight => bounds.upper_right(),
213 Self::BottomLeft => bounds.lower_left(),
214 Self::BottomRight => bounds.lower_right(),
215 }
216 }
217
218 fn switch_axis(self, axis: Axis) -> Self {
219 match axis {
220 Axis::Vertical => match self {
221 AnchorCorner::TopLeft => AnchorCorner::BottomLeft,
222 AnchorCorner::TopRight => AnchorCorner::BottomRight,
223 AnchorCorner::BottomLeft => AnchorCorner::TopLeft,
224 AnchorCorner::BottomRight => AnchorCorner::TopRight,
225 },
226 Axis::Horizontal => match self {
227 AnchorCorner::TopLeft => AnchorCorner::TopRight,
228 AnchorCorner::TopRight => AnchorCorner::TopLeft,
229 AnchorCorner::BottomLeft => AnchorCorner::BottomRight,
230 AnchorCorner::BottomRight => AnchorCorner::BottomLeft,
231 },
232 }
233 }
234}