Framework Directives

Prisma PHP PulsePoint

A guide to the HTML attributes that power the architecture. These are split between Prisma PHP (Navigation & Lifecycle) and PulsePoint (Reactive DOM Engine).

Prisma PHP: Lifecycle & Navigation

pp-spa

Enables "Soft Navigation" (SPA feel).
By default, <body pp-spa="true"> makes all anchors behave like SPA links. You can toggle this on specific links.

// Force full reload

<a href="/logout" pp-spa="false">Logout</a>

pp-loading-content

Defines a placeholder area that is automatically populated with the contents of the file loading.php while Prisma PHP fetches the next page. The markup inside loading.php (skeletons, spinners, or any placeholder HTML) will be injected here to prevent dashboard flicker during navigation.


                        <div pp-loading-content="true">
                        <!-- loading.php - file content -->
                        </div>

pp-reset-scroll

Dashboard Helper

Forces the scroll container to reset to top during SPA navigation.

Note: Native Tailwind CSS utilities are preferred over this directive. Only use this if you cannot use scroll-smooth.

layout.php

Prefer using native Tailwind scroll utilities. If your scroll container already uses overflow-y-auto and scroll-smooth, the attribute pp-reset-scroll="true" is unnecessary. Use the attribute only when you need Prisma PHP to enforce scroll reset on navigation for custom/non-Tailwind scroll containers.


                            <main class="flex-1 h-full overflow-y-auto scroll-smooth">

                                <!-- Page Content -->

                            </main>



                            <main class="flex-1 h-full" pp-reset-scroll="true">

                                <!-- Page Content -->

                            </main>

PulsePoint: Reactive Engine


                            pp-component

Core

Marks a DOM element as an isolated component root. When you write <Card /> in Prisma PHP, this attribute is automatically added to the output HTML.

PulsePoint Docs

pp-for

Reactive list rendering. Iterates over an array in the state.

View Docs →

pp-ref

Assigns a direct DOM reference for manual manipulation via JS.

View Docs →

pp-spread

Dynamically spreads an object of attributes onto the element.

View Docs →

pp-ignore

Prevents Mustache {{ }} compilation within this tag.

View Docs →