@univerjs/sheets-drawing-ui 1.0.2 → 1.0.4

package/lib/cjs/index.js

@@ -3718,7 +3718,7 @@ const menuSchema = {
 //#endregion
 //#region package.json
 var name = "@univerjs/sheets-drawing-ui";
-var version = "1.0.2";
+var version = "1.0.4";
 
 //#endregion
 //#region src/config/config.ts
@@ -3949,9 +3949,19 @@ function MobileBatchSaveImagesDialog() {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BatchSaveImagesDialog, { SelectComponent: _univerjs_design.MobileSelect });
 }
 
+//#endregion
+//#region src/views/sheet-image-panel/sheet-drawing-panel.util.ts
+function isSheetDrawing(drawing) {
+	return Boolean(drawing && "sheetTransform" in drawing && drawing.sheetTransform);
+}
+
 //#endregion
 //#region src/views/sheet-image-panel/SheetDrawingAnchor.tsx
 const SheetDrawingAnchor = (props) => {
+	function getAnchorKind(value) {
+		if (value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Position || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Both || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.None) return value;
+		return null;
+	}
 	const commandService = (0, _univerjs_ui.useDependency)(_univerjs_core.ICommandService);
 	const localeService = (0, _univerjs_ui.useDependency)(_univerjs_core.LocaleService);
 	const drawingManagerService = (0, _univerjs_ui.useDependency)(_univerjs_drawing.IDrawingManagerService);
@@ -4067,12 +4077,389 @@ const SheetDrawingAnchor = (props) => {
 		}) })]
 	});
 };
-function isSheetDrawing(drawing) {
-	return Boolean(drawing && "sheetTransform" in drawing && "axisAlignSheetTransform" in drawing);
+
+//#endregion
+//#region src/commands/operations/preview-sheet-image-opacity.operation.ts
+const PreviewSheetImageOpacityOperation = {
+	id: "sheet.operation.preview-image-opacity",
+	type: _univerjs_core.CommandType.OPERATION,
+	handler: (accessor, params) => {
+		var _renderManagerService;
+		if (!params || !Number.isFinite(params.opacity)) return false;
+		const scene = (_renderManagerService = accessor.get(_univerjs_engine_render.IRenderManagerService).getRenderUnitById(params.unitId)) === null || _renderManagerService === void 0 ? void 0 : _renderManagerService.scene;
+		const image = scene === null || scene === void 0 ? void 0 : scene.getObject((0, _univerjs_drawing.getDrawingShapeKeyByDrawingSearch)(params));
+		if (!(image instanceof _univerjs_engine_render.Image)) return false;
+		image.setOpacity(Math.min(Math.max(params.opacity, 0), 1));
+		return true;
+	}
+};
+
+//#endregion
+//#region src/views/sheet-image-panel/SheetImageTransparencySlider.tsx
+const MIN_TRANSPARENCY = 0;
+const MAX_TRANSPARENCY = 100;
+const TRANSPARENCY_STEP = 1;
+const TRANSPARENCY_PAGE_STEP = 10;
+const DRAG_PREVIEW_INTERVAL = 50;
+function SheetImageTransparencySlider(props) {
+	const { value, shortcuts, ariaLabel, disabled = false, onChange, onChangeComplete } = props;
+	const localeService = (0, _univerjs_ui.useDependency)(_univerjs_core.LocaleService);
+	const isRtl = (0, _univerjs_ui.useObservable)(localeService.direction$, localeService.getDirection()) === "rtl";
+	const sliderRailRef = (0, react.useRef)(null);
+	const dragValueRef = (0, react.useRef)(value);
+	const pendingDragValueRef = (0, react.useRef)(null);
+	const lastPreviewedDragValueRef = (0, react.useRef)(value);
+	const dragPreviewTimerRef = (0, react.useRef)(null);
+	const dragCleanupRef = (0, react.useRef)(null);
+	const [isDragging, setIsDragging] = (0, react.useState)(false);
+	const [dragValue, setDragValue] = (0, react.useState)(value);
+	(0, react.useEffect)(() => () => {
+		var _dragCleanupRef$curre;
+		(_dragCleanupRef$curre = dragCleanupRef.current) === null || _dragCleanupRef$curre === void 0 || _dragCleanupRef$curre.call(dragCleanupRef);
+		clearDragPreviewTimer();
+	}, []);
+	function getValueByClientX(clientX) {
+		const rail = sliderRailRef.current;
+		if (!rail) return value;
+		const railRect = rail.getBoundingClientRect();
+		if (railRect.width <= 0) return value;
+		let ratio = (clientX - railRect.left) / railRect.width;
+		ratio = Math.min(Math.max(ratio, 0), 1);
+		if (isRtl) ratio = 1 - ratio;
+		return normalizeTransparency$1(MIN_TRANSPARENCY + ratio * 100);
+	}
+	function clearDragPreviewTimer() {
+		if (dragPreviewTimerRef.current != null) {
+			window.clearTimeout(dragPreviewTimerRef.current);
+			dragPreviewTimerRef.current = null;
+		}
+	}
+	function previewDragValue(nextValue) {
+		if (nextValue === lastPreviewedDragValueRef.current) return;
+		lastPreviewedDragValueRef.current = nextValue;
+		onChange === null || onChange === void 0 || onChange(nextValue);
+	}
+	function flushDragPreview() {
+		clearDragPreviewTimer();
+		const nextValue = pendingDragValueRef.current;
+		pendingDragValueRef.current = null;
+		if (nextValue != null) previewDragValue(nextValue);
+	}
+	function scheduleDragPreview(nextValue) {
+		pendingDragValueRef.current = nextValue;
+		if (dragPreviewTimerRef.current != null) return;
+		dragPreviewTimerRef.current = window.setTimeout(() => {
+			dragPreviewTimerRef.current = null;
+			const pendingValue = pendingDragValueRef.current;
+			pendingDragValueRef.current = null;
+			if (pendingValue != null) previewDragValue(pendingValue);
+		}, DRAG_PREVIEW_INTERVAL);
+	}
+	function updateDragValue(clientX) {
+		const nextValue = getValueByClientX(clientX);
+		dragValueRef.current = nextValue;
+		setDragValue(nextValue);
+		return nextValue;
+	}
+	function handlePointerDown(e) {
+		var _dragCleanupRef$curre2;
+		if (disabled) return;
+		e.preventDefault();
+		e.stopPropagation();
+		(_dragCleanupRef$curre2 = dragCleanupRef.current) === null || _dragCleanupRef$curre2 === void 0 || _dragCleanupRef$curre2.call(dragCleanupRef);
+		clearDragPreviewTimer();
+		pendingDragValueRef.current = null;
+		lastPreviewedDragValueRef.current = value;
+		setIsDragging(true);
+		scheduleDragPreview(updateDragValue(e.clientX));
+		function cleanup() {
+			window.removeEventListener("pointermove", handlePointerMove);
+			window.removeEventListener("pointerup", handlePointerUp);
+			window.removeEventListener("pointercancel", handlePointerUp);
+			dragCleanupRef.current = null;
+		}
+		function handlePointerMove(event) {
+			scheduleDragPreview(updateDragValue(event.clientX));
+		}
+		function handlePointerUp() {
+			cleanup();
+			flushDragPreview();
+			setIsDragging(false);
+			onChangeComplete === null || onChangeComplete === void 0 || onChangeComplete(dragValueRef.current);
+		}
+		dragCleanupRef.current = cleanup;
+		window.addEventListener("pointermove", handlePointerMove);
+		window.addEventListener("pointerup", handlePointerUp);
+		window.addEventListener("pointercancel", handlePointerUp);
+	}
+	function handleSliderKeyDown(e) {
+		let nextValue = null;
+		if (e.key === "ArrowLeft" || e.key === "ArrowDown") nextValue = value - TRANSPARENCY_STEP;
+		else if (e.key === "ArrowRight" || e.key === "ArrowUp") nextValue = value + TRANSPARENCY_STEP;
+		else if (e.key === "PageDown") nextValue = value - TRANSPARENCY_PAGE_STEP;
+		else if (e.key === "PageUp") nextValue = value + TRANSPARENCY_PAGE_STEP;
+		else if (e.key === "Home") nextValue = MIN_TRANSPARENCY;
+		else if (e.key === "End") nextValue = MAX_TRANSPARENCY;
+		if (nextValue == null || disabled) return;
+		e.preventDefault();
+		e.stopPropagation();
+		const normalizedValue = normalizeTransparency$1(nextValue);
+		onChange === null || onChange === void 0 || onChange(normalizedValue);
+		onChangeComplete === null || onChangeComplete === void 0 || onChangeComplete(normalizedValue);
+	}
+	const visualValue = isDragging ? dragValue : value;
+	const sliderOffset = normalizeTransparency$1(visualValue);
+	const handleOffset = isRtl ? MAX_TRANSPARENCY - sliderOffset : sliderOffset;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: (0, _univerjs_design.clsx)("univer-flex univer-select-none univer-items-center univer-gap-1.5", { "univer-cursor-not-allowed": disabled }),
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "univer-flex univer-h-6 univer-min-w-0 univer-flex-1 univer-items-center",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: (0, _univerjs_design.clsx)("univer-relative univer-h-1.5 univer-w-full univer-rounded-full univer-bg-gray-200 univer-px-1.5 univer-transition-colors dark:!univer-bg-gray-600", { "univer-opacity-60": disabled }),
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					ref: sliderRailRef,
+					"data-u-comp": "sheet-image-transparency-slider-track",
+					className: "univer-relative univer-h-1.5 univer-bg-gray-200 dark:!univer-bg-gray-600",
+					onPointerDown: handlePointerDown,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: (0, _univerjs_design.clsx)("univer-bg-primary-500/60 univer-absolute univer-top-0 univer-h-full univer-rounded-full", isRtl ? "univer-right-0" : "univer-left-0"),
+						style: { width: `${sliderOffset}%` }
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						className: (0, _univerjs_design.clsx)("univer-absolute univer-top-1/2 univer-size-3.5 -univer-translate-x-1/2 -univer-translate-y-1/2 univer-rounded-full univer-bg-gray-0 univer-shadow-sm focus-visible:univer-outline-none focus-visible:univer-ring-2 focus-visible:univer-ring-primary-100 dark:!univer-bg-gray-800", _univerjs_design.borderClassName, {
+							"univer-cursor-pointer hover:univer-border-primary-600 hover:univer-shadow-md": !disabled,
+							"univer-cursor-not-allowed": disabled,
+							"univer-scale-105 univer-border-primary-600 univer-shadow-md": isDragging,
+							"univer-transition-all": !isDragging,
+							"univer-transition-none": isDragging
+						}),
+						role: "slider",
+						"aria-label": ariaLabel,
+						"aria-valuemin": MIN_TRANSPARENCY,
+						"aria-valuemax": MAX_TRANSPARENCY,
+						"aria-valuenow": visualValue,
+						"aria-valuetext": `${visualValue}%`,
+						disabled,
+						type: "button",
+						style: { left: `${handleOffset}%` },
+						onKeyDown: handleSliderKeyDown
+					})]
+				})
+			})
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetImageTransparencyInput, {
+			value,
+			shortcuts,
+			ariaLabel,
+			disabled,
+			onChange,
+			onChangeComplete
+		})]
+	});
+}
+function SheetImageTransparencyInput(props) {
+	const { value, shortcuts, ariaLabel, disabled = false, onChange, onChangeComplete } = props;
+	const iconManager = (0, _univerjs_ui.useDependency)(_univerjs_ui.IconManager);
+	const isEditingRef = (0, react.useRef)(false);
+	const [listVisible, setListVisible] = (0, react.useState)(false);
+	const [inputValue, setInputValue] = (0, react.useState)(() => `${value}%`);
+	(0, react.useEffect)(() => {
+		if (!isEditingRef.current) setInputValue(`${value}%`);
+	}, [value]);
+	function emitValue(nextValue) {
+		const normalizedValue = normalizeTransparency$1(nextValue);
+		onChange === null || onChange === void 0 || onChange(normalizedValue);
+		onChangeComplete === null || onChangeComplete === void 0 || onChangeComplete(normalizedValue);
+	}
+	function handleSelect(nextValue) {
+		if (disabled) return;
+		setListVisible(false);
+		emitValue(nextValue);
+	}
+	function handleFocus() {
+		if (disabled) return;
+		isEditingRef.current = true;
+		setInputValue(String(value));
+	}
+	function commitInput() {
+		if (disabled || !isEditingRef.current) return;
+		const parsedValue = parseTransparency(inputValue);
+		isEditingRef.current = false;
+		if (parsedValue == null) {
+			setInputValue(`${value}%`);
+			return;
+		}
+		if (parsedValue === value) {
+			setInputValue(`${parsedValue}%`);
+			return;
+		}
+		emitValue(parsedValue);
+	}
+	function handleKeyDown(e) {
+		e.stopPropagation();
+		if (e.key === "Enter") {
+			e.preventDefault();
+			commitInput();
+			e.currentTarget.blur();
+		}
+	}
+	const items = [{
+		type: "radio",
+		value: value.toString(),
+		options: shortcuts.map((shortcut) => ({
+			value: shortcut.toString(),
+			label: `${shortcut}%`
+		})),
+		onSelect: (selectedValue) => handleSelect(Number(selectedValue))
+	}];
+	const MoreDownIcon = iconManager.get("MoreDownIcon");
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: (0, _univerjs_design.clsx)("univer-flex univer-h-6 univer-w-[68px] univer-flex-shrink-0 univer-items-center univer-overflow-hidden univer-rounded-md univer-border univer-border-gray-200 univer-bg-gray-0 dark:!univer-border-gray-600 dark:!univer-bg-gray-800", { "univer-opacity-60": disabled }),
+		onClick: (e) => e.stopPropagation(),
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_design.Input, {
+			className: "univer-box-border univer-h-6 univer-min-w-0 univer-flex-1 univer-border-none univer-bg-transparent [&_input:focus]:!univer-ring-0 [&_input]:univer-h-6 [&_input]:univer-w-full [&_input]:univer-border-none [&_input]:!univer-bg-transparent [&_input]:univer-px-1 [&_input]:univer-text-center [&_input]:univer-text-xs [&_input]:univer-tabular-nums",
+			inputClass: "univer-w-full",
+			size: "mini",
+			"aria-label": ariaLabel,
+			value: inputValue,
+			disabled,
+			type: "text",
+			onChange: setInputValue,
+			onFocus: handleFocus,
+			onBlur: commitInput,
+			onKeyDown: handleKeyDown
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_design.DropdownMenu, {
+			align: "end",
+			items,
+			open: listVisible,
+			disabled,
+			onOpenChange: setListVisible,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_design.Button, {
+				className: "univer-h-6 univer-w-4 univer-rounded-none univer-p-0",
+				size: "small",
+				variant: "text",
+				"aria-label": ariaLabel,
+				disabled,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MoreDownIcon, { className: "univer-size-3 univer-text-gray-500 dark:!univer-text-gray-300" })
+			})
+		})]
+	});
 }
-function getAnchorKind(value) {
-	if (value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Position || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Both || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.None) return value;
-	return null;
+function parseTransparency(rawValue) {
+	const normalizedValue = rawValue.trim().replace(/%$/, "").trim();
+	if (normalizedValue === "") return null;
+	const parsedValue = Number(normalizedValue);
+	return Number.isFinite(parsedValue) ? normalizeTransparency$1(parsedValue) : null;
+}
+function normalizeTransparency$1(value) {
+	return Math.min(Math.max(Math.round(value), MIN_TRANSPARENCY), MAX_TRANSPARENCY);
+}
+
+//#endregion
+//#region src/views/sheet-image-panel/SheetImageTransparency.tsx
+const IMAGE_TRANSPARENCY_PRESETS = [
+	0,
+	15,
+	30,
+	50,
+	65,
+	80
+];
+const SheetImageTransparency = ({ drawings }) => {
+	const commandService = (0, _univerjs_ui.useDependency)(_univerjs_core.ICommandService);
+	const localeService = (0, _univerjs_ui.useDependency)(_univerjs_core.LocaleService);
+	const sheetDrawingService = (0, _univerjs_ui.useDependency)(_univerjs_sheets_drawing.ISheetDrawingService);
+	const drawingParam = isSheetDrawing(drawings[0]) ? drawings[0] : void 0;
+	const currentDrawing = drawingParam ? sheetDrawingService.getDrawingByParam(drawingParam) ?? drawingParam : void 0;
+	const image = (currentDrawing === null || currentDrawing === void 0 ? void 0 : currentDrawing.drawingType) === _univerjs_core.DrawingTypeEnum.DRAWING_IMAGE ? currentDrawing : void 0;
+	const modelOpacity = (0, _univerjs_drawing.normalizeImageOpacity)(image === null || image === void 0 ? void 0 : image.opacity);
+	const modelTransparency = Math.round((1 - modelOpacity) * 100);
+	const [previewState, setPreviewState] = (0, react.useState)(null);
+	const previewPendingRef = (0, react.useRef)(false);
+	const [, setModelRevision] = (0, react.useState)(0);
+	const transparency = image && (previewState === null || previewState === void 0 ? void 0 : previewState.unitId) === image.unitId && previewState.subUnitId === image.subUnitId && previewState.drawingId === image.drawingId ? previewState.transparency : modelTransparency;
+	(0, react.useEffect)(() => {
+		if (!drawingParam) return;
+		const subscription = sheetDrawingService.update$.subscribe((updatedDrawings) => {
+			if (updatedDrawings.some((updatedDrawing) => updatedDrawing.unitId === drawingParam.unitId && updatedDrawing.subUnitId === drawingParam.subUnitId && updatedDrawing.drawingId === drawingParam.drawingId)) setModelRevision((revision) => revision + 1);
+		});
+		return () => subscription.unsubscribe();
+	}, [drawingParam, sheetDrawingService]);
+	(0, react.useEffect)(() => {
+		previewPendingRef.current = false;
+		return () => {
+			if (!previewPendingRef.current || !image) return;
+			commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+				unitId: image.unitId,
+				subUnitId: image.subUnitId,
+				drawingId: image.drawingId,
+				opacity: modelOpacity
+			});
+		};
+	}, [
+		commandService,
+		image,
+		modelOpacity,
+		modelTransparency
+	]);
+	if (!image) return null;
+	const title = localeService.t("sheets-drawing-ui.image-transparency.title");
+	const { unitId, subUnitId, drawingId } = image;
+	function previewTransparency(nextTransparency) {
+		const normalizedTransparency = normalizeTransparency(nextTransparency);
+		const opacity = transparencyToOpacity(normalizedTransparency);
+		previewPendingRef.current = true;
+		setPreviewState({
+			unitId,
+			subUnitId,
+			drawingId,
+			transparency: normalizedTransparency
+		});
+		commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+			unitId,
+			subUnitId,
+			drawingId,
+			opacity
+		});
+	}
+	function commitTransparency(nextTransparency) {
+		const opacity = transparencyToOpacity(normalizeTransparency(nextTransparency));
+		previewPendingRef.current = false;
+		setPreviewState(null);
+		if (opacity === modelOpacity) return;
+		if (!commandService.syncExecuteCommand(_univerjs_sheets_drawing.SetSheetDrawingCommand.id, {
+			unitId,
+			drawings: [{
+				unitId,
+				subUnitId,
+				drawingId,
+				opacity
+			}]
+		})) commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+			unitId,
+			subUnitId,
+			drawingId,
+			opacity: modelOpacity
+		});
+	}
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "univer-grid univer-gap-2 univer-py-2 univer-text-gray-400",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("header", {
+			className: "univer-text-gray-600 dark:!univer-text-gray-200",
+			children: title
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetImageTransparencySlider, {
+			value: transparency,
+			shortcuts: IMAGE_TRANSPARENCY_PRESETS,
+			ariaLabel: title,
+			onChange: previewTransparency,
+			onChangeComplete: commitTransparency
+		})]
+	});
+};
+function normalizeTransparency(transparency) {
+	if (!Number.isFinite(transparency)) return 0;
+	return Math.min(Math.max(Math.round(transparency), 0), 100);
+}
+function transparencyToOpacity(transparency) {
+	return (100 - transparency) / 100;
 }
 
 //#endregion
@@ -4097,7 +4484,11 @@ const SheetDrawingPanel = () => {
 	const drawings = (0, _univerjs_ui.useObservable)(() => drawingManagerService.focus$, drawingManagerService.getFocusDrawings(), false, [drawingManagerService]);
 	return !!(drawings === null || drawings === void 0 ? void 0 : drawings.length) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "univer-text-sm",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_drawing_ui.DrawingCommonPanel, { drawings }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetDrawingAnchor, { drawings })]
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_drawing_ui.DrawingCommonPanel, { drawings }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetImageTransparency, { drawings }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetDrawingAnchor, { drawings })
+		]
 	});
 };
 
@@ -4515,8 +4906,26 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 		this._sheetSkeletonService = _sheetSkeletonService;
 		this._sheetDrawingService = _sheetDrawingService;
 		this._drawingManagerService = _drawingManagerService;
+		_defineProperty(this, "_renderTimeout", void 0);
 		this._commandListener();
 	}
+	dispose() {
+		this._cancelPendingRender();
+		super.dispose();
+	}
+	_cancelPendingRender() {
+		if (this._renderTimeout !== void 0) {
+			clearTimeout(this._renderTimeout);
+			this._renderTimeout = void 0;
+		}
+	}
+	_scheduleRender(callback) {
+		this._cancelPendingRender();
+		this._renderTimeout = setTimeout(() => {
+			this._renderTimeout = void 0;
+			callback();
+		}, 0);
+	}
 	_commandListener() {
 		this.disposeWithMe(this._commandService.onCommandExecuted((command) => {
 			if (command.id === _univerjs_sheets.SetWorksheetActiveOperation.id) {
@@ -4531,7 +4940,7 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 		}));
 	}
 	_clearDrawings(selfUnitId) {
-		setTimeout(() => {
+		this._scheduleRender(() => {
 			const drawingMap = this._drawingManagerService.drawingManagerData;
 			const removeDrawings = [];
 			Object.keys(drawingMap ?? {}).forEach((unitId) => {
@@ -4549,10 +4958,11 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 		});
 	}
 	_updateDrawings(showUnitId, showSubunitId) {
-		setTimeout(() => {
+		this._scheduleRender(() => {
 			const sheetSkeletonParam = this._sheetSkeletonService.getSkeletonParam(showUnitId, showSubunitId);
 			const drawingMap = this._drawingManagerService.drawingManagerData;
 			const insertDrawings = [];
+			const refreshedDrawings = [];
 			const removeDrawings = [];
 			Object.keys(drawingMap ?? {}).forEach((unitId) => {
 				if (unitId !== showUnitId) return;
@@ -4563,17 +4973,19 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 					Object.keys(drawingData).forEach((drawingId) => {
 						if (unitId === showUnitId && subUnitId === showSubunitId) {
 							const drawing = drawingData[drawingId];
-							if (drawing.sheetTransform && drawing.anchorType !== _univerjs_sheets_drawing.SheetDrawingAnchorType.None) drawing.transform = (0, _univerjs_sheets_drawing.drawingPositionToTransform)(drawing.sheetTransform, sheetSkeletonParam);
+							if (sheetSkeletonParam && drawing.sheetTransform && drawing.anchorType !== _univerjs_sheets_drawing.SheetDrawingAnchorType.None) refreshedDrawings.push((0, _univerjs_sheets_drawing.applySheetDrawingPlacement)(drawing, (0, _univerjs_sheets_drawing.getSheetDrawingPlacement)(drawing), sheetSkeletonParam.skeleton));
 							insertDrawings.push(drawingData[drawingId]);
 						} else removeDrawings.push(drawingData[drawingId]);
 					});
 				});
 			});
+			this._sheetDrawingService.refreshTransform(refreshedDrawings);
+			this._drawingManagerService.refreshTransform(refreshedDrawings);
 			this._sheetDrawingService.removeNotification(removeDrawings);
 			this._sheetDrawingService.addNotification(insertDrawings);
 			this._drawingManagerService.removeNotification(removeDrawings);
 			this._drawingManagerService.addNotification(insertDrawings);
-		}, 0);
+		});
 	}
 };
 SheetDrawingActiveRenderController = __decorate([
@@ -5633,7 +6045,8 @@ let SheetDrawingUIController = class SheetDrawingUIController extends _univerjs_
 			MoveDrawingsCommand,
 			DeleteDrawingsCommand,
 			SaveCellImagesCommand,
-			FlipSheetDrawingCommand
+			FlipSheetDrawingCommand,
+			PreviewSheetImageOpacityOperation
 		].forEach((command) => this.disposeWithMe(this._commandService.registerCommand(command)));
 	}
 	_initShortcuts() {

package/lib/cjs/locale/ar-SA.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "يمكن رفع {0} صور فقط في المرة الواحدة",
 		invalidImage: "صورة غير صالحة"
 	},
+	"image-transparency": { title: "الشفافية" },
 	"drawing-anchor": {
 		title: "خصائص المرساة",
 		both: "النقل والتحجيم مع الخلايا",

package/lib/cjs/locale/ca-ES.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Només es poden pujar {0} imatges alhora",
 		invalidImage: "Imatge no vàlida"
 	},
+	"image-transparency": { title: "Transparència" },
 	"drawing-anchor": {
 		title: "Propietats d’ancoratge",
 		both: "Mou i canvia la mida amb les cel·les",

package/lib/cjs/locale/de-DE.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Es können nur {0} Bilder gleichzeitig hochgeladen werden",
 		invalidImage: "Ungültiges Bild"
 	},
+	"image-transparency": { title: "Transparenz" },
 	"drawing-anchor": {
 		title: "Anker-Eigenschaften",
 		both: "Mit Zellen verschieben und skalieren",

package/lib/cjs/locale/en-US.js

@@ -54,6 +54,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Only {0} images can be uploaded at a time",
 		invalidImage: "Invalid image"
 	},
+	"image-transparency": { title: "Transparency" },
 	"drawing-anchor": {
 		title: "Anchor Properties",
 		both: "Move and size with cells",

package/lib/cjs/locale/es-ES.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Solo se pueden subir {0} imágenes a la vez",
 		invalidImage: "Imagen no válida"
 	},
+	"image-transparency": { title: "Transparencia" },
 	"drawing-anchor": {
 		title: "Propiedades de anclaje",
 		both: "Mover y cambiar tamaño con las celdas",

package/lib/cjs/locale/fa-IR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "فقط {0} تصویر می‌توانند همزمان آپلود شوند",
 		invalidImage: "تصویر نامعتبر است"
 	},
+	"image-transparency": { title: "شفافیت" },
 	"drawing-anchor": {
 		title: "خواص لنگر",
 		both: "جابه‌جایی و تغییر اندازه با سلول‌ها",

package/lib/cjs/locale/fr-FR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Seulement {0} images peuvent être téléchargées à la fois",
 		invalidImage: "Image invalide"
 	},
+	"image-transparency": { title: "Transparence" },
 	"drawing-anchor": {
 		title: "Propriétés de l'ancre",
 		both: "Déplacer et redimensionner avec les cellules",

package/lib/cjs/locale/id-ID.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Hanya {0} gambar yang dapat diunggah dalam satu waktu",
 		invalidImage: "Gambar tidak valid"
 	},
+	"image-transparency": { title: "Transparansi" },
 	"drawing-anchor": {
 		title: "Properti Jangkar",
 		both: "Pindah dan ukur bersama sel",

package/lib/cjs/locale/it-IT.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "È possibile caricare solo {0} immagini alla volta",
 		invalidImage: "Immagine non valida"
 	},
+	"image-transparency": { title: "Trasparenza" },
 	"drawing-anchor": {
 		title: "Proprietà ancoraggio",
 		both: "Sposta e ridimensiona con le celle",

package/lib/cjs/locale/ja-JP.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "一度にアップロードできるのは {0} 個までです",
 		invalidImage: "無効な画像です"
 	},
+	"image-transparency": { title: "透明度" },
 	"drawing-anchor": {
 		title: "プロパティ",
 		both: "セルに合わせて移動やサイズ変更をする",

package/lib/cjs/locale/ko-KR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "한 번에 {0}개까지만 업로드할 수 있습니다",
 		invalidImage: "유효하지 않은 이미지입니다"
 	},
+	"image-transparency": { title: "투명도" },
 	"drawing-anchor": {
 		title: "고정 위치 설정",
 		both: "셀과 함께 이동 및 크기 조절",

package/lib/cjs/locale/pl-PL.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Jednocześnie można przesłać tylko {0} obrazów",
 		invalidImage: "Nieprawidłowy obraz"
 	},
+	"image-transparency": { title: "Przezroczystość" },
 	"drawing-anchor": {
 		title: "Właściwości kotwicy",
 		both: "Przesuwaj i zmieniaj rozmiar razem z komórkami",

package/lib/cjs/locale/pt-BR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Apenas {0} imagens podem ser enviadas de cada vez",
 		invalidImage: "Imagem inválida"
 	},
+	"image-transparency": { title: "Transparência" },
 	"drawing-anchor": {
 		title: "Propriedades da âncora",
 		both: "Mover e dimensionar com as células",

package/lib/cjs/locale/ru-RU.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "За один раз можно загрузить только {0} изображений",
 		invalidImage: "Недопустимое изображение"
 	},
+	"image-transparency": { title: "Прозрачность" },
 	"drawing-anchor": {
 		title: "Свойства привязки",
 		both: "Перемещать и изменять размер с ячейками",

package/lib/cjs/locale/sk-SK.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Naraz možno nahrať iba {0} obrázkov",
 		invalidImage: "Neplatný obrázok"
 	},
+	"image-transparency": { title: "Priehľadnosť" },
 	"drawing-anchor": {
 		title: "Vlastnosti ukotvenia",
 		both: "Presúvať a meniť veľkosť s bunkami",

package/lib/cjs/locale/vi-VN.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Chỉ có thể tải lên {0} hình ảnh một lần",
 		invalidImage: "Hình ảnh không hợp lệ"
 	},
+	"image-transparency": { title: "Độ trong suốt" },
 	"drawing-anchor": {
 		title: "Thuộc tính neo",
 		both: "Di chuyển và thay đổi kích thước cùng với ô",

package/lib/cjs/locale/zh-CN.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "图片只能一次上传{0}张",
 		invalidImage: "无效图片"
 	},
+	"image-transparency": { title: "透明度" },
 	"drawing-anchor": {
 		title: "锚点属性",
 		both: "与单元格一起移动和调整大小",