telegram-webapp-sdk 0.9.0

Telegram WebApp SDK for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

// SPDX-FileCopyrightText: 2025-2026 RAprogramm <andrey.rozanov.vl@gmail.com>
// SPDX-License-Identifier: MIT

use std::{cell::RefCell, rc::Rc};

use yew::prelude::{hook, use_effect_with, use_state};

use crate::webapp::{EventHandle, SafeAreaInset, TelegramWebApp};

type HandleList = Rc<RefCell<Vec<EventHandle<dyn FnMut()>>>>;

/// Snapshot of `Telegram.WebApp` safe-area insets.
#[derive(Clone, Debug, PartialEq, Default)]
pub struct SafeAreaState {
    /// `WebApp.safeAreaInset`.
    pub area:    Option<SafeAreaInset>,
    /// `WebApp.contentSafeAreaInset`.
    pub content: Option<SafeAreaInset>
}

impl SafeAreaState {
    fn snapshot(app: Option<&TelegramWebApp>) -> Self {
        match app {
            Some(app) => Self {
                area:    app.safe_area_inset(),
                content: app.content_safe_area_inset()
            },
            None => Self::default()
        }
    }
}

/// Yew reactive hook over the safe-area insets.
///
/// Updates on both `safeAreaChanged` and `contentSafeAreaChanged`. The
/// subscriptions are removed on unmount.
#[hook]
pub fn use_safe_area() -> SafeAreaState {
    let state = use_state(|| SafeAreaState::snapshot(TelegramWebApp::instance().as_ref()));

    {
        let state = state.clone();
        use_effect_with((), move |_| {
            let stash: HandleList = Rc::new(RefCell::new(Vec::new()));
            if let Some(app) = TelegramWebApp::instance() {
                {
                    let app_for_handler = app.clone();
                    let state_for_handler = state.clone();
                    if let Ok(handle) = app.on_safe_area_changed(move || {
                        state_for_handler.set(SafeAreaState::snapshot(Some(&app_for_handler)));
                    }) {
                        stash.borrow_mut().push(handle);
                    }
                }
                {
                    let app_for_handler = app.clone();
                    let state_for_handler = state.clone();
                    if let Ok(handle) = app.on_content_safe_area_changed(move || {
                        state_for_handler.set(SafeAreaState::snapshot(Some(&app_for_handler)));
                    }) {
                        stash.borrow_mut().push(handle);
                    }
                }
            }
            move || {
                stash.borrow_mut().clear();
            }
        });
    }

    (*state).clone()
}