API 參考

Image

放置選定簡報 assets 資料夾中的可攜靜態圖片。

presentation.tsx

<Image id="cover" x={52} y={8} w={40} h={84} src="assets/cover.webp" alt="具描述性的主體" fit="cover" />

屬性參考

屬性值應保持字面且可序列化，才能由 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 字串，可用於投影片導覽或連結。
Image	src	string	是	可攜的本機圖片路徑，通常位於 assets/。
	alt	string	—	圖片替代說明。
	fit	cover \| contain \| fill \| scale-down	—	圖片內容填滿框架的方式。
	cropX / cropY	number	—	圖片在框架內的位移，單位為百分比。
	scaleX / scaleY	number	—	圖片內容在各軸向的縮放比例。
	radius	number	—	框架圓角半徑。
	filter	string	—	Paper 圖片濾鏡識別字。
	filterPreset	string	—	所選圖片濾鏡的 preset。
	filterDistortion / filterSize / filterAngle / filterContrast / filterSpeed / filterDetail	number	—	所選 Paper 濾鏡的細部控制值。

必要語法

使用 id、x、y、w、h 與 src；src 應是已驗證的相對素材路徑，例如 assets/cover.webp。

無障礙與裁切

請提供有意義的 alt 描述；要讓圖片填滿 frame 時使用 fit="cover"。不可使用絕對路徑、blob URL 或 Base64。