Skip to content

Portal ​

Portal renders its children into a different part of the DOM, outside the component's normal hierarchy. Useful for modals, tooltips, and overlays.

Props ​

PropTypeDescription
mountHTMLElementTarget element. Defaults to document.body
childrenJSX.ElementContent to render into the target

Example ​

tsx
import { sig, val, set, mount, Portal, Show } from "@hedystia/view";

function App() {
  const [showModal, setShowModal] = sig(false);

  return (
    <div>
      <button onClick={() => setShowModal(true)}>Open Modal</button>

      <Show when={showModal}>
        <Portal>
          <div
            style={{
              position: "fixed",
              inset: "0",
              backgroundColor: "rgba(0,0,0,0.5)",
              display: "flex",
              alignItems: "center",
              justifyContent: "center",
            }}
            onClick={() => setShowModal(false)}
          >
            <div
              style={{
                background: "white",
                padding: "24px",
                borderRadius: "8px",
              }}
              onClick={(e) => e.stopPropagation()}
            >
              <h2>Modal</h2>
              <p>This is rendered in document.body via Portal.</p>
              <button onClick={() => setShowModal(false)}>Close</button>
            </div>
          </div>
        </Portal>
      </Show>
    </div>
  );
}

mount(App, document.getElementById("root")!);

Custom Mount Target ​

tsx
<Portal mount={document.getElementById("tooltip-root")!}>
  <div class="tooltip">Tooltip content</div>
</Portal>

When the Portal is disposed, its children are automatically removed from the mount target.