图片

图片控件用于展示图片内容，支持动态设置图片地址和图片弹窗浏览。

属性

sg-url

• 说明：图片的 URL 地址
• 类型：string
• 默认值：""

示例

"sg-url":"/images/avatar.jpg"

方法

setSrcById

通过控件 ID 设置图片地址。

语法

setSrcById(id, src)

参数

参数名	类型	必填	说明
id	string	是	图片控件 id
src	string	是	新的图片地址

示例

// 通过 id 改变图片
setSrcById("avatarImg", "/images/new_avatar.jpg");

---

setSrcByName

通过控件 name 设置图片地址。

语法

setSrcByName(name, src)

参数

参数名	类型	必填	说明
name	string	是	图片控件的 name
src	string	是	指定的图片地址

示例

// 通过 name 改变图片
setSrcByName("avatar", "/images/new_avatar.jpg");

---

openImg

打开图片全屏浏览弹窗。

语法

openImg(src, params)

参数

参数名	类型	必填	说明
src	string	是	图片地址
params	Object	是	附加参数

示例

// 打开图片浏览弹窗
openImg("/images/photo.jpg", {title: "照片预览", width: 800, height: 600});

---

showPictureFile

前端预览上传的图片文件。

语法

showPictureFile(file, cb)

参数

参数名	类型	必填	说明
file	Object	是	上传文件对象
cb	function	是	回调函数

示例

// 前端预览图片
var fileInput = document.getElementById("fileInput");
var file = fileInput.files[0];
showPictureFile(file, function(base64Data) {
    document.getElementById("previewImg").src = base64Data;
});

---

formatFileSize

格式化文件大小（如 KB、MB）。

语法

formatFileSize(fileSize)

参数

参数名	类型	必填	说明
fileSize	number	是	文件大小

返回值

返回带单位的文件大小字符串。

示例

// 格式化文件大小
var size = formatFileSize(1024);
console.log(size); // 输出: 1KB

var size2 = formatFileSize(1048576);
console.log(size2); // 输出: 1MB