API 參考

Svg

放置已驗證、沒有 script 的 SVG 素材作為 native 圖層。

presentation.tsx

<Svg id="brand-mark" x={8} y={82} w={8} h={8} src="assets/mark.svg" />

屬性參考

屬性值應保持字面且可序列化，才能由 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 字串，可用於投影片導覽或連結。
Svg	src	string	是	無 script 的本機 SVG 素材路徑。
	stage	number	—	SVG 動畫階段索引。
	stageDuration	number	—	SVG 階段時間，單位為秒。
	easing	string	—	SVG 階段的 easing。
	sharedScene	string	—	選用；跨投影片共用的場景 key。

使用 id、x、y、w、h，以及位於 assets/ 的相對 src；SVG 檔案必須已驗證且沒有 script。

不可使用遠端可執行 SVG、inline Base64 或電腦絕對路徑；讓 SVG 與簡報放在一起，驗證與匯出才能正常解析。