@univerjs/sheets-drawing-ui 0.24.0 → 0.25.0

package/lib/locale/pt-BR.js

@@ -0,0 +1,60 @@
+//#region src/locale/pt-BR.ts
+const locale = { "sheets-drawing-ui": {
+	title: "Imagem",
+	upload: {
+		float: "Imagem flutuante",
+		cell: "Imagem de célula"
+	},
+	panel: { title: "Editar imagem" },
+	save: {
+		title: "Salvar imagens de célula",
+		menuLabel: "Salvar imagens de célula",
+		imageCount: "Contagem de imagens",
+		fileNameConfig: "Nome do arquivo",
+		useRowCol: "Usar endereço da célula (A1, B2...)",
+		useColumnValue: "Usar valor da coluna",
+		selectColumn: "Selecionar coluna",
+		cancel: "Cancelar",
+		confirm: "Salvar",
+		saving: "Salvando...",
+		error: "Falha ao salvar imagens de célula"
+	},
+	"image-popup": {
+		replace: "Substituir",
+		delete: "Excluir",
+		edit: "Editar",
+		crop: "Cortar",
+		reset: "Redefinir tamanho",
+		flipH: "Inverter horizontalmente",
+		flipV: "Inverter verticalmente"
+	},
+	"update-status": {
+		exceedMaxSize: "O tamanho da imagem excede o limite, o limite é {0}M",
+		invalidImageType: "Tipo de imagem inválido",
+		exceedMaxCount: "Apenas {0} imagens podem ser enviadas de cada vez",
+		invalidImage: "Imagem inválida"
+	},
+	"drawing-anchor": {
+		title: "Propriedades da âncora",
+		both: "Mover e dimensionar com as células",
+		position: "Mover, mas não dimensionar com as células",
+		none: "Não mover nem dimensionar com as células"
+	},
+	"cell-image": {
+		pasteTitle: "Colar como imagem de célula",
+		pasteContent: "Colar uma imagem de célula substituirá o conteúdo existente da célula, continuar colando",
+		pasteError: "Copiar e colar imagem de célula da planilha não é suportado nesta unidade"
+	},
+	permission: { dialog: { editErr: "O intervalo está protegido e você não tem permissão de edição. Para editar, entre em contato com o criador." } },
+	shortcut: {
+		"drawing-view": "Visualização do desenho",
+		"drawing-move-down": "Mover desenho para baixo",
+		"drawing-move-up": "Mover desenho para cima",
+		"drawing-move-left": "Mover desenho para esquerda",
+		"drawing-move-right": "Mover desenho para direita",
+		"drawing-delete": "Excluir desenho"
+	}
+} };
+
+//#endregion
+export { locale as default };

package/lib/locale/ru-RU.js

@@ -1,25 +1,23 @@
 //#region src/locale/ru-RU.ts
-const locale = {
-	sheetImage: {
-		title: "Изображение",
-		upload: {
-			float: "Плавающее изображение",
-			cell: "Изображение в ячейке"
-		},
-		panel: { title: "Редактировать изображение" },
-		save: {
-			title: "Сохранить изображения ячеек",
-			menuLabel: "Сохранить изображения ячеек",
-			imageCount: "Количество изображений",
-			fileNameConfig: "Имя файла",
-			useRowCol: "Использовать адрес ячейки (A1, B2...)",
-			useColumnValue: "Использовать значение столбца",
-			selectColumn: "Выбрать столбец",
-			cancel: "Отмена",
-			confirm: "Сохранить",
-			saving: "Сохранение...",
-			error: "Не удалось сохранить изображения ячеек"
-		}
+const locale = { "sheets-drawing-ui": {
+	title: "Изображение",
+	upload: {
+		float: "Плавающее изображение",
+		cell: "Изображение в ячейке"
+	},
+	panel: { title: "Редактировать изображение" },
+	save: {
+		title: "Сохранить изображения ячеек",
+		menuLabel: "Сохранить изображения ячеек",
+		imageCount: "Количество изображений",
+		fileNameConfig: "Имя файла",
+		useRowCol: "Использовать адрес ячейки (A1, B2...)",
+		useColumnValue: "Использовать значение столбца",
+		selectColumn: "Выбрать столбец",
+		cancel: "Отмена",
+		confirm: "Сохранить",
+		saving: "Сохранение...",
+		error: "Не удалось сохранить изображения ячеек"
 	},
 	"image-popup": {
 		replace: "Заменить",
@@ -30,24 +28,33 @@ const locale = {
 		flipH: "Отразить по горизонтали",
 		flipV: "Отразить по вертикали"
 	},
-	"drawing-anchor": {
-		title: "Свойства привязки",
-		both: "Перемещать и изменять размер с ячейками",
-		position: "Перемещать, но не изменять размер с ячейками",
-		none: "Не перемещать и не изменять размер с ячейками"
-	},
 	"update-status": {
 		exceedMaxSize: "Размер изображения превышает лимит, лимит составляет {0}М",
 		invalidImageType: "Недопустимый тип изображения",
 		exceedMaxCount: "За один раз можно загрузить только {0} изображений",
 		invalidImage: "Недопустимое изображение"
 	},
+	"drawing-anchor": {
+		title: "Свойства привязки",
+		both: "Перемещать и изменять размер с ячейками",
+		position: "Перемещать, но не изменять размер с ячейками",
+		none: "Не перемещать и не изменять размер с ячейками"
+	},
 	"cell-image": {
 		pasteTitle: "Вставить как изображение ячейки",
 		pasteContent: "Вставка изображения ячейки перезапишет существующее содержимое ячейки, продолжить вставку",
 		pasteError: "Копирование и вставка изображения ячейки не поддерживается в этом блоке"
+	},
+	permission: { dialog: { editErr: "Диапазон защищен, и у вас нет разрешения на редактирование. Для редактирования свяжитесь с создателем." } },
+	shortcut: {
+		"drawing-view": "Вид изображения",
+		"drawing-move-down": "Переместить изображение вниз",
+		"drawing-move-up": "Переместить изображение вверх",
+		"drawing-move-left": "Переместить изображение влево",
+		"drawing-move-right": "Переместить изображение вправо",
+		"drawing-delete": "Удалить изображение"
 	}
-};
+} };
 
 //#endregion
 export { locale as default };

package/lib/locale/sk-SK.js

@@ -1,25 +1,23 @@
 //#region src/locale/sk-SK.ts
-const locale = {
-	sheetImage: {
-		title: "Obrázok",
-		upload: {
-			float: "Plávajúci obrázok",
-			cell: "Obrázok v bunke"
-		},
-		panel: { title: "Upraviť obrázok" },
-		save: {
-			title: "Uložiť obrázky buniek",
-			menuLabel: "Uložiť obrázky buniek",
-			imageCount: "Počet obrázkov",
-			fileNameConfig: "Názov súboru",
-			useRowCol: "Použiť adresu bunky (A1, B2...)",
-			useColumnValue: "Použiť hodnotu stĺpca",
-			selectColumn: "Vybrať stĺpec",
-			cancel: "Zrušiť",
-			confirm: "Uložiť",
-			saving: "Ukladá sa...",
-			error: "Nepodarilo sa uložiť obrázky buniek"
-		}
+const locale = { "sheets-drawing-ui": {
+	title: "Obrázok",
+	upload: {
+		float: "Plávajúci obrázok",
+		cell: "Obrázok v bunke"
+	},
+	panel: { title: "Upraviť obrázok" },
+	save: {
+		title: "Uložiť obrázky buniek",
+		menuLabel: "Uložiť obrázky buniek",
+		imageCount: "Počet obrázkov",
+		fileNameConfig: "Názov súboru",
+		useRowCol: "Použiť adresu bunky (A1, B2...)",
+		useColumnValue: "Použiť hodnotu stĺpca",
+		selectColumn: "Vybrať stĺpec",
+		cancel: "Zrušiť",
+		confirm: "Uložiť",
+		saving: "Ukladá sa...",
+		error: "Nepodarilo sa uložiť obrázky buniek"
 	},
 	"image-popup": {
 		replace: "Nahradiť",
@@ -30,24 +28,33 @@ const locale = {
 		flipH: "Prevrátiť vodorovne",
 		flipV: "Prevrátiť zvisle"
 	},
-	"drawing-anchor": {
-		title: "Vlastnosti ukotvenia",
-		both: "Presúvať a meniť veľkosť s bunkami",
-		position: "Presúvať, ale nemeniť veľkosť s bunkami",
-		none: "Nepresúvať ani nemeniť veľkosť s bunkami"
-	},
 	"update-status": {
 		exceedMaxSize: "Veľkosť obrázka prekračuje limit, limit je {0}M",
 		invalidImageType: "Neplatný typ obrázka",
 		exceedMaxCount: "Naraz možno nahrať iba {0} obrázkov",
 		invalidImage: "Neplatný obrázok"
 	},
+	"drawing-anchor": {
+		title: "Vlastnosti ukotvenia",
+		both: "Presúvať a meniť veľkosť s bunkami",
+		position: "Presúvať, ale nemeniť veľkosť s bunkami",
+		none: "Nepresúvať ani nemeniť veľkosť s bunkami"
+	},
 	"cell-image": {
 		pasteTitle: "Prilepiť ako obrázok bunky",
 		pasteContent: "Prilepením obrázka bunky sa prepíše existujúci obsah bunky, pokračovať",
 		pasteError: "Kopírovanie a prilepovanie obrázkov buniek v tomto module nie je podporované"
+	},
+	permission: { dialog: { editErr: "Rozsah je chránený a nemáte oprávnenie na úpravy. Ak chcete upravovať, kontaktujte autora." } },
+	shortcut: {
+		"drawing-view": "Zobrazenie kresby",
+		"drawing-move-down": "Posunúť kresbu nadol",
+		"drawing-move-up": "Posunúť kresbu nahor",
+		"drawing-move-left": "Posunúť kresbu doľava",
+		"drawing-move-right": "Posunúť kresbu doprava",
+		"drawing-delete": "Odstrániť kresbu"
 	}
-};
+} };
 
 //#endregion
 export { locale as default };

package/lib/locale/vi-VN.js

@@ -1,25 +1,23 @@
 //#region src/locale/vi-VN.ts
-const locale = {
-	sheetImage: {
-		title: "Hình ảnh",
-		upload: {
-			float: "Hình ảnh nổi",
-			cell: "Hình ảnh trong ô"
-		},
-		panel: { title: "Chỉnh sửa hình ảnh" },
-		save: {
-			title: "Lưu hình ảnh ô",
-			menuLabel: "Lưu hình ảnh ô",
-			imageCount: "Số lượng hình ảnh",
-			fileNameConfig: "Tên tệp",
-			useRowCol: "Sử dụng địa chỉ ô (A1, B2...)",
-			useColumnValue: "Sử dụng giá trị cột",
-			selectColumn: "Chọn cột",
-			cancel: "Hủy",
-			confirm: "Lưu",
-			saving: "Đang lưu...",
-			error: "Lưu hình ảnh ô thất bại"
-		}
+const locale = { "sheets-drawing-ui": {
+	title: "Hình ảnh",
+	upload: {
+		float: "Hình ảnh nổi",
+		cell: "Hình ảnh trong ô"
+	},
+	panel: { title: "Chỉnh sửa hình ảnh" },
+	save: {
+		title: "Lưu hình ảnh ô",
+		menuLabel: "Lưu hình ảnh ô",
+		imageCount: "Số lượng hình ảnh",
+		fileNameConfig: "Tên tệp",
+		useRowCol: "Sử dụng địa chỉ ô (A1, B2...)",
+		useColumnValue: "Sử dụng giá trị cột",
+		selectColumn: "Chọn cột",
+		cancel: "Hủy",
+		confirm: "Lưu",
+		saving: "Đang lưu...",
+		error: "Lưu hình ảnh ô thất bại"
 	},
 	"image-popup": {
 		replace: "Thay thế",
@@ -30,24 +28,33 @@ const locale = {
 		flipH: "Lật ngang",
 		flipV: "Lật dọc"
 	},
-	"drawing-anchor": {
-		title: "Thuộc tính neo",
-		both: "Di chuyển và thay đổi kích thước cùng với ô",
-		position: "Di chuyển nhưng không thay đổi kích thước với ô",
-		none: "Không di chuyển hoặc thay đổi kích thước với ô"
-	},
 	"update-status": {
 		exceedMaxSize: "Kích thước hình ảnh vượt quá giới hạn, giới hạn là {0}M",
 		invalidImageType: "Loại hình ảnh không hợp lệ",
 		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ệ"
 	},
+	"drawing-anchor": {
+		title: "Thuộc tính neo",
+		both: "Di chuyển và thay đổi kích thước cùng với ô",
+		position: "Di chuyển nhưng không thay đổi kích thước với ô",
+		none: "Không di chuyển hoặc thay đổi kích thước với ô"
+	},
 	"cell-image": {
 		pasteTitle: "Dán như hình ảnh ô",
 		pasteContent: "Dán hình ảnh ô sẽ ghi đè lên nội dung hiện có của ô, tiếp tục dán",
 		pasteError: "Sao chép và dán hình ảnh ô không được hỗ trợ trong đơn vị này"
+	},
+	permission: { dialog: { editErr: "Phạm vi này đã được bảo vệ, hiện không có quyền chỉnh sửa. Nếu cần chỉnh sửa, vui lòng liên hệ với người tạo." } },
+	shortcut: {
+		"drawing-view": "Chế độ xem bản vẽ",
+		"drawing-move-down": "Move Drawing down",
+		"drawing-move-up": "Move Drawing up",
+		"drawing-move-left": "Move Drawing left",
+		"drawing-move-right": "Move Drawing right",
+		"drawing-delete": "Delete Drawing"
 	}
-};
+} };
 
 //#endregion
 export { locale as default };

package/lib/locale/zh-CN.js

@@ -1,25 +1,23 @@
 //#region src/locale/zh-CN.ts
-const locale = {
-	sheetImage: {
-		title: "图片",
-		upload: {
-			float: "浮动图片",
-			cell: "单元格图片"
-		},
-		panel: { title: "编辑图片" },
-		save: {
-			title: "保存单元格图片",
-			menuLabel: "保存单元格图片",
-			imageCount: "图片数量",
-			fileNameConfig: "文件名",
-			useRowCol: "使用单元格地址 (A1, B2...)",
-			useColumnValue: "使用某列的值",
-			selectColumn: "选择列",
-			cancel: "取消",
-			confirm: "保存",
-			saving: "保存中...",
-			error: "保存单元格图片失败"
-		}
+const locale = { "sheets-drawing-ui": {
+	title: "图片",
+	upload: {
+		float: "浮动图片",
+		cell: "单元格图片"
+	},
+	panel: { title: "编辑图片" },
+	save: {
+		title: "保存单元格图片",
+		menuLabel: "保存单元格图片",
+		imageCount: "图片数量",
+		fileNameConfig: "文件名",
+		useRowCol: "使用单元格地址 (A1, B2...)",
+		useColumnValue: "使用某列的值",
+		selectColumn: "选择列",
+		cancel: "取消",
+		confirm: "保存",
+		saving: "保存中...",
+		error: "保存单元格图片失败"
 	},
 	"image-popup": {
 		replace: "替换",
@@ -30,24 +28,33 @@ const locale = {
 		flipH: "水平翻转",
 		flipV: "垂直翻转"
 	},
-	"drawing-anchor": {
-		title: "锚点属性",
-		both: "与单元格一起移动和调整大小",
-		position: "移动但不调整大小与单元格",
-		none: "不要移动或调整大小与单元格"
-	},
 	"update-status": {
 		exceedMaxSize: "图片大小超过限制, 限制为{0}M",
 		invalidImageType: "图片类型错误",
 		exceedMaxCount: "图片只能一次上传{0}张",
 		invalidImage: "无效图片"
 	},
+	"drawing-anchor": {
+		title: "锚点属性",
+		both: "与单元格一起移动和调整大小",
+		position: "移动但不调整大小与单元格",
+		none: "不要移动或调整大小与单元格"
+	},
 	"cell-image": {
 		pasteTitle: "粘贴为单元格图片",
 		pasteContent: "粘贴单元格图片将覆盖单元格中的现有内容，继续粘贴",
 		pasteError: "此单元中不支持单元格图片复制粘贴"
+	},
+	permission: { dialog: { editErr: "该范围已被保护，目前无编辑权限。如需编辑，请联系创建者。" } },
+	shortcut: {
+		"drawing-view": "绘图视图",
+		"drawing-move-down": "下移绘图",
+		"drawing-move-up": "上移绘图",
+		"drawing-move-left": "左移绘图",
+		"drawing-move-right": "右移绘图",
+		"drawing-delete": "删除绘图"
 	}
-};
+} };
 
 //#endregion
 export { locale as default };

package/lib/locale/zh-HK.js

@@ -0,0 +1,60 @@
+//#region src/locale/zh-HK.ts
+const locale = { "sheets-drawing-ui": {
+	title: "圖片",
+	upload: {
+		float: "浮動圖片",
+		cell: "儲存格圖片"
+	},
+	panel: { title: "編圖" },
+	save: {
+		title: "儲存儲存格圖片",
+		menuLabel: "儲存儲存格圖片",
+		imageCount: "圖片數量",
+		fileNameConfig: "檔案名稱",
+		useRowCol: "使用儲存格地址 (A1, B2...)",
+		useColumnValue: "使用某欄的值",
+		selectColumn: "選擇欄",
+		cancel: "取消",
+		confirm: "儲存",
+		saving: "儲存中...",
+		error: "儲存儲存格圖片失敗"
+	},
+	"image-popup": {
+		replace: "替換",
+		delete: "刪除",
+		edit: "編輯",
+		crop: "裁切",
+		reset: "重置大小",
+		flipH: "水平翻轉",
+		flipV: "垂直翻轉"
+	},
+	"update-status": {
+		exceedMaxSize: "圖片大小超過限制, 限制為{0}M",
+		invalidImageType: "圖片類型錯誤",
+		exceedMaxCount: "圖片只能一次上傳{0}張",
+		invalidImage: "無效圖片"
+	},
+	"drawing-anchor": {
+		title: "錨點屬性",
+		both: "與儲存格一起移動和調整大小",
+		position: "移動但不調整大小與儲存格",
+		none: "不要移動或調整大小與儲存格"
+	},
+	"cell-image": {
+		pasteTitle: "貼上為儲存格圖片",
+		pasteContent: "貼上儲存格圖片將覆蓋儲存格中的現有內容，繼續貼上",
+		pasteError: "此儲存格不支援儲存格圖片複製貼上"
+	},
+	permission: { dialog: { editErr: "該範圍已被保護，目前無編輯權限。如需編輯，請聯絡創建者。 " } },
+	shortcut: {
+		"drawing-view": "繪圖檢視",
+		"drawing-move-down": "下移繪圖",
+		"drawing-move-up": "上移繪圖",
+		"drawing-move-left": "左移繪圖",
+		"drawing-move-right": "右移繪圖",
+		"drawing-delete": "刪除繪圖"
+	}
+} };
+
+//#endregion
+export { locale as default };

package/lib/locale/zh-TW.js

@@ -1,25 +1,23 @@
 //#region src/locale/zh-TW.ts
-const locale = {
-	sheetImage: {
-		title: "圖片",
-		upload: {
-			float: "浮動圖片",
-			cell: "儲存格圖片"
-		},
-		panel: { title: "編圖" },
-		save: {
-			title: "儲存儲存格圖片",
-			menuLabel: "儲存儲存格圖片",
-			imageCount: "圖片數量",
-			fileNameConfig: "檔案名稱",
-			useRowCol: "使用儲存格地址 (A1, B2...)",
-			useColumnValue: "使用某欄的值",
-			selectColumn: "選擇欄",
-			cancel: "取消",
-			confirm: "儲存",
-			saving: "儲存中...",
-			error: "儲存儲存格圖片失敗"
-		}
+const locale = { "sheets-drawing-ui": {
+	title: "圖片",
+	upload: {
+		float: "浮動圖片",
+		cell: "儲存格圖片"
+	},
+	panel: { title: "編圖" },
+	save: {
+		title: "儲存儲存格圖片",
+		menuLabel: "儲存儲存格圖片",
+		imageCount: "圖片數量",
+		fileNameConfig: "檔案名稱",
+		useRowCol: "使用儲存格地址 (A1, B2...)",
+		useColumnValue: "使用某欄的值",
+		selectColumn: "選擇欄",
+		cancel: "取消",
+		confirm: "儲存",
+		saving: "儲存中...",
+		error: "儲存儲存格圖片失敗"
 	},
 	"image-popup": {
 		replace: "替換",
@@ -30,24 +28,33 @@ const locale = {
 		flipH: "水平翻轉",
 		flipV: "垂直翻轉"
 	},
-	"drawing-anchor": {
-		title: "錨點屬性",
-		both: "與儲存格一起移動和調整大小",
-		position: "移動但不調整大小與儲存格",
-		none: "不要移動或調整大小與儲存格"
-	},
 	"update-status": {
 		exceedMaxSize: "圖片大小超過限制, 限制為{0}M",
 		invalidImageType: "圖片類型錯誤",
 		exceedMaxCount: "圖片只能一次上傳{0}張",
 		invalidImage: "無效圖片"
 	},
+	"drawing-anchor": {
+		title: "錨點屬性",
+		both: "與儲存格一起移動和調整大小",
+		position: "移動但不調整大小與儲存格",
+		none: "不要移動或調整大小與儲存格"
+	},
 	"cell-image": {
 		pasteTitle: "貼上為儲存格圖片",
 		pasteContent: "貼上儲存格圖片將覆蓋儲存格中的現有內容，繼續貼上",
 		pasteError: "此儲存格不支援儲存格圖片複製貼上"
+	},
+	permission: { dialog: { editErr: "該範圍已被保護，目前無編輯權限。如需編輯，請聯絡創建者。 " } },
+	shortcut: {
+		"drawing-view": "繪圖檢視",
+		"drawing-move-down": "下移繪圖",
+		"drawing-move-up": "上移繪圖",
+		"drawing-move-left": "左移繪圖",
+		"drawing-move-right": "右移繪圖",
+		"drawing-delete": "刪除繪圖"
 	}
-};
+} };
 
 //#endregion
 export { locale as default };

package/lib/types/facade/f-range.d.ts

@@ -37,7 +37,8 @@ export interface IFRangeSheetsDrawingUIMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Insert an image into the cell A10
      * const fRange = fWorksheet.getRange('A10');
@@ -55,7 +56,8 @@ export interface IFRangeSheetsDrawingUIMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Save all cell images in range A1:D10
      * const fRange = fWorksheet.getRange('A1:D10');

package/lib/types/facade/f-worksheet.d.ts

@@ -35,7 +35,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns {IFCanvasFloatDomResult | null} float dom info or null if not found
      * @example
      * ```ts
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const floatDom = fWorksheet.getFloatDomById('myFloatDomId');
      * if (floatDom) {
      *   console.log('Float dom position:', floatDom.position);
@@ -50,7 +51,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns {IFCanvasFloatDomResult[]} array of float dom info
      * @example
      * ```ts
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const allFloatDoms = fWorksheet.getAllFloatDoms();
      * allFloatDoms.forEach(floatDom => {
      *   console.log('Float dom ID:', floatDom.id);
@@ -66,7 +68,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns {FWorksheet} The worksheet instance for chaining
      * @example
      * ```ts
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const firstFloatDom = fWorksheet.getAllFloatDoms()[0];
      *
      * if (!firstFloatDom) return;
@@ -103,7 +106,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns {FWorksheet} The worksheet instance for chaining
      * @example
      * ```ts
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Update multiple float doms at once
      * const allFloatDoms = fWorksheet.getAllFloatDoms();
@@ -145,7 +149,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns {FWorksheet} The worksheet instance for chaining
      * @example
      * ```ts
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const firstFloatDom = fWorksheet.getAllFloatDoms()[0];
      *
      * if (!firstFloatDom) return;
@@ -162,7 +167,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns float dom id and dispose function
      * @example
      * ```tsx
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // You should register components at an appropriate time (e.g., when Univer is loaded)
      * // This is a React component. For Vue3 components, the third parameter should be `{ framework: 'vue3' }`
@@ -214,7 +220,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns float dom id and dispose function
      * @example
      * ```tsx
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Register a range loading component
      * const RangeLoading = () => {
@@ -308,7 +315,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @returns float dom id and dispose function
      * @example
      * ```ts
-     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Register a float button component
      * const FloatButton = () => {
@@ -375,7 +383,8 @@ export interface IFWorksheetDrawingUIMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Save cell images from multiple ranges
      * const range1 = fWorksheet.getRange('A1:B10');