This is one of the core plugins in PyScript, which is active by default. The splashscreen is the first thing you see when you open a page with Pyscript while it is loading itself and all the necessary resources.


You can control how <py-splashscreen> behaves by setting the value of the splashscreen configuration in your <py-config>.






Whether to close the splashscreen automatically when the page is ready or not



Whether to show the splashscreen or not


Disabling the splashscreen#

If you don’t want the splashscreen to show and log any loading messages, you can disable it by setting the splashscreen option enabled to false.

        enabled = false

Disabling autoclose#

If you want to keep the splashscreen open even after the page is ready, you can disable autoclose by setting autoclose to false.

        autoclose = false

Adding custom messages#

You can add custom messages to the splashscreen. This is useful if you want to show the user that something is happening in the background for your PyScript app.

There are two ways to add your custom messages to the splashscreen, either by dispatching a new custom event, py-status-message to the document:

document.dispatchEvent(new CustomEvent("py-status-message", {detail: "Hello, world!"}))

Or by using the log method of the py-splashscreen tag directly:

const splashscreen = document.querySelector("py-splashscreen")
splashscreen.log("Hello, world!")

If you wish, you can also send messages directly to the splashscreen from your python code:

from js import document

splashscreen = document.querySelector("py-splashscreen")
splashscreen.log("Hello, world!")