QuartzUINavigationPolicy: declaration reference

0.57.0-dev · beta source documentation. Native, Blueprint, Editor and rendering examples are source-reviewed, not executed in Unreal during this scan. See validation and limits.

Pinned source (source: Source/QuartzUIRuntime/Public/QuartzUINavigationPolicy.h) · integration recipe · practical guide

EQuartzUITopLevelNavigationDecision

Internal type. Top Level Navigation Decision: a declared type in exact-origin main-frame/subframe navigation decisions; use its exact fields/operations below.

Prerequisites / integration: Installed source plugin; Editor tools additionally require a compiled compatible host Editor target. Use the QuartzUINavigationPolicy recipe in the host module QuartzUIRuntime.

Minimal example / lifecycle: Use registered app URLs; inspect OnNavigationBlocked. Pure decisions reused by active browser session.

Avoid: Allowing popups or foreign origins as a workaround. This named helper is runtime-owned; inspect/use it through the owner above rather than constructing it in gameplay.

Exact source line (source: Source/QuartzUIRuntime/Public/QuartzUINavigationPolicy.h#L5)

FQuartzUINavigationPolicy

Internal type. Pure same-origin policy for documents loaded into one QuartzUI browser view.

Minimal example / lifecycle: Use registered app URLs; inspect OnNavigationBlocked. Pure decisions reused by active browser session.

Avoid: Allowing popups or foreign origins as a workaround. This named helper is runtime-owned; inspect/use it through the owner above rather than constructing it in gameplay.

Exact source line (source: Source/QuartzUIRuntime/Public/QuartzUINavigationPolicy.h#L14)

Complete header

Source snapshot, not an additional example. Unreal annotations distinguish exposed Blueprint nodes from native-only/private methods.

#pragma once

#include "CoreMinimal.h"

enum class EQuartzUITopLevelNavigationDecision : uint8
{
	Block,
	AllowPackaged,
	AllowDevelopment,
	AllowOpaqueDocument
};

/** Pure same-origin policy for documents loaded into one QuartzUI browser view. */
class QUARTZUIRUNTIME_API FQuartzUINavigationPolicy final
{
public:
	static constexpr int32 MaxUrlLength = 2048;

	/** Accepts only https://<valid-app-id>.quartzui.test with no path or authority tricks. */
	static bool IsValidPackagedOrigin(const FString& Origin);

	/** The development origin must already be active in the Editor-owned registry. */
	static EQuartzUITopLevelNavigationDecision EvaluateTopLevelUrl(
		const FString& Url,
		const FString& AllowedPackagedOrigin,
		const FString& ActiveDevelopmentOrigin = FString());
};