API 參考

HtmlEmbed

放置受控、已匯入的本機 HTML，不把它當成任意網頁程式碼。

presentation.tsx

<HtmlEmbed id="imported-page" x={8} y={20} w={84} h={60} src="assets/source.html" />

屬性參考

屬性值應保持字面且可序列化，才能由 Canvas、Inspector、驗證與匯出流程可靠處理。

API	屬性	型別／值	必要	說明
所有原生圖層共用 props	id	string	是	穩定且唯一的圖層識別字。每個可見的原生圖層都必須提供。
	x	number	是	相對於投影片畫布左側的位置百分比。
	y	number	是	相對於投影片畫布頂端的位置百分比。
	w	number	是	圖層寬度，單位為畫布百分比。
	h	number	是	圖層高度，單位為畫布百分比。
	groupId	string	—	在不加入 wrapper 元素的情況下，將原生子圖層編組。
	groupName	string	—	在 Workbench 顯示的群組名稱。
	sharedId	string	—	連接相鄰 Morph 投影片中的同型圖層；在同一張投影片內必須唯一。
	rotation	number	—	順時針旋轉角度。
	opacity	number	—	圖層不透明度，範圍為 0 到 1。
	motion	JSON string	—	版本化的宣告式動作序列 JSON 字串；仍須保留完整的靜態最終畫面。
	interaction	JSON string	—	版本化的點擊互動 JSON 字串，可用於投影片導覽或連結。
HtmlEmbed	src	string	是	受控的本機 HTML 素材路徑。
	page	number	—	要顯示的 HTML 簡報頁碼；從 1 開始。
	sharedScene	string	—	選用；跨投影片共用的場景 key。

使用 id、x、y、w、h，以及指向 assets/ 下已匯入 HTML 的相對 src；來源必須是受控的本機檔案。

不可使用外部 URL、Base64、blob URL 或任意 inline HTML；OpenSlideX 會將瀏覽器原生 HTML 留在受保護的本機素材與 sandbox 邊界內。