---
title: Globals
description: Globals
---
import Link from '@slint/common-files/src/components/Link.astro';
import { Tabs, TabItem } from '@astrojs/starlight/components';

Declare a global singleton with `global Name { /* .. properties or callbacks .. */ }` to
make properties and callbacks available throughout the entire project. Access them using `Name.property`.

For example, this can be useful for a common color palette:

```slint
global Palette  {
    in-out property<color> primary: blue;
    in-out property<color> secondary: green;
}

export component Example inherits Rectangle {
    background: Palette.primary;
    border-color: Palette.secondary;
    border-width: 2px;
}
```

Export a global to make it accessible from other files (see <Link type="Modules" />). To make your global
visible to native code with the business logic, re-export a global from the file also exporting the main
application component.

```slint
export global Logic  {
    in-out property <int> the-value;
    pure callback magic-operation(int) -> int;
}
// ...
```
<Tabs syncKey="dev-language">
<TabItem label="Rust">

```rust
slint::slint!{
export global Logic {
    in-out property <int> the-value;
    pure callback magic-operation(int) -> int;
}

export component App inherits Window {
    // ...
}
}

fn main() {
    let app = App::new();
    app.global::<Logic>().on_magic_operation(|value| {
        eprintln!("magic operation input: {}", value);
        value * 2
    });
    app.global::<Logic>().set_the_value(42);
    // ...
}
```

</TabItem>
<TabItem label="C++">

```cpp
#include "app.h"

int main() {
    auto app = App::create();
    app->global<Logic>().on_magic_operation([](int value) -> int {
        return value * 2;
    });
    app->global<Logic>().set_the_value(42);
    // ...
}
```
</TabItem>
<TabItem label="NodeJS">

```js
let slint = require("slint-ui");
let file = slint.loadFile("app.slint");
let app = new file.App();
app.Logic.magic_operation = (value) => {
    return value * 2;
};
app.Logic.the_value = 42;
// ...
```
</TabItem>
<TabItem label="Python">

```python
import slint

class App(slint.loader.app.App):
    @slint.callback(global_name="Logic")
    def magic_operation(self, value: int) -> int:
        return value * 2

app = new App()
app.Logic.the_value = 42

# ...
```
</TabItem>
</Tabs>

:::note[Note]
Global singletons are not shared between windows.
This means you may need to initialize the global callback and properties for each window instance you create in your application.
:::

It's possible to re-expose a callback or properties from a global using the two way binding syntax.

```slint
global Logic  {
    in-out property <int> the-value;
    pure callback magic-operation(int) -> int;
}

component SomeComponent inherits Text {
    // use the global in any component
    text: "The magic value is:" + Logic.magic-operation(42);
}

export component MainWindow inherits Window {
    // re-expose the global properties such that the native code
    // can access or modify them
    in-out property the-value <=> Logic.the-value;
    pure callback magic-operation <=> Logic.magic-operation;

    SomeComponent {}
}
```
