Skip to main content

aylis_core/
system_bars.rs

1//! As barras do sistema no celular (a de status e a de navegação), pedidas pelo componente
2//! `SystemBars` (decidido em 14/11). O `Ui` guarda o pedido e a plataforma aplica: o Android
3//! pinta as barras e esconde; o iOS escolhe a cor dos ícones e esconde (a cor da barra no iOS
4//! é o que o app desenha por baixo dela: a faixa que o núcleo pinta, [`Ui::paints_status_strip`]);
5//! o navegador põe a cor na `theme-color` da página. Sem pedido, a plataforma faz o de sempre
6//! (no Android, as barras com o fundo do form principal).
7
8use std::sync::atomic::{AtomicBool, Ordering};
9
10use crate::color::Color;
11use crate::ui::Ui;
12
13/// A cor dos ícones da barra (relógio, bateria).
14#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
15pub enum BarIcons {
16    /// Pela claridade da cor da barra (escuros sobre fundo claro).
17    #[default]
18    Auto,
19    /// Ícones claros (para barra escura).
20    Light,
21    /// Ícones escuros (para barra clara).
22    Dark,
23}
24
25impl crate::prop::PropEnum for BarIcons {
26    const NAMES: &'static [&'static str] = &["auto", "light", "dark"];
27    fn from_index(i: usize) -> Option<Self> {
28        [BarIcons::Auto, BarIcons::Light, BarIcons::Dark].get(i).copied()
29    }
30    fn index(self) -> usize {
31        self as usize
32    }
33}
34
35/// O que o app pede às barras (sem cor: a do fundo do form, como sem pedido).
36#[derive(Clone, Debug, PartialEq)]
37pub struct SystemBarsStyle {
38    pub status_color: Option<Color>,
39    /// Sem cor: a da barra de status.
40    pub navigation_color: Option<Color>,
41    pub icons: BarIcons,
42    pub status_visible: bool,
43    pub navigation_visible: bool,
44}
45
46impl Default for SystemBarsStyle {
47    fn default() -> Self {
48        Self { status_color: None, navigation_color: None, icons: BarIcons::Auto, status_visible: true, navigation_visible: true }
49    }
50}
51
52impl SystemBarsStyle {
53    /// Os ícones escuros (para uma barra de cor `background`)?
54    pub fn dark_icons(&self, background: Color) -> bool {
55        match self.icons {
56            BarIcons::Dark => true,
57            BarIcons::Light => false,
58            BarIcons::Auto => 0.299 * background.r as f32 + 0.587 * background.g as f32 + 0.114 * background.b as f32 > 140.0,
59        }
60    }
61}
62
63/// A plataforma tem barras que o app escolhe (o Android, o iOS, o navegador).
64static AVAILABLE: AtomicBool = AtomicBool::new(false);
65
66/// A plataforma diz que aplica o pedido das barras (o `available` do `SystemBars`).
67pub fn set_available(available: bool) {
68    AVAILABLE.store(available, Ordering::Relaxed);
69}
70
71/// As barras do sistema aplicam o pedido nesta plataforma.
72pub fn available() -> bool {
73    AVAILABLE.load(Ordering::Relaxed)
74}
75
76impl Ui {
77    /// O pedido das barras (o `SystemBars`; o último aplicado vale para o app todo).
78    pub fn set_system_bars(&mut self, style: Option<SystemBarsStyle>) {
79        if self.system_bars != style {
80            self.system_bars = style;
81            self.system_bars_version += 1;
82            self.request_repaint();
83        }
84    }
85
86    /// O pedido das barras, se houver.
87    pub fn system_bars(&self) -> Option<&SystemBarsStyle> {
88        self.system_bars.as_ref()
89    }
90
91    /// Muda a cada pedido novo: a plataforma aplica quando muda.
92    pub fn system_bars_version(&self) -> u64 {
93        self.system_bars_version
94    }
95
96    /// Onde a barra de status não tem cor própria (o iOS), o núcleo pinta a faixa dela (a área
97    /// segura de cima do form principal) com a cor pedida.
98    pub fn set_paints_status_strip(&mut self, paints: bool) {
99        self.paints_status_strip = paints;
100    }
101
102    pub fn paints_status_strip(&self) -> bool {
103        self.paints_status_strip
104    }
105
106    /// A faixa da barra de status a pintar por cima de `root` (nas coordenadas dele), com a cor.
107    pub(crate) fn status_strip(&self, root: crate::component::ComponentId) -> Option<(crate::geometry::RectF, Color)> {
108        if !self.paints_status_strip || self.main_form() != Some(root) {
109            return None;
110        }
111        let style = self.system_bars.as_ref().filter(|s| s.status_visible)?;
112        let color = style.status_color?;
113        let cb = self.cb(root)?;
114        let top = cb.safe_area.top;
115        (top > 0.0).then(|| (crate::geometry::RectF::new(0.0, 0.0, cb.bounds().width, top), color))
116    }
117}