
vCard(Virtual Contact File)是一种用于电子名片的标准文件格式,常用于交换个人或公司的联系信息。它本质上是一个纯文本文件,包含一系列属性-值对,每个属性代表联系人信息的一个方面。vCard有多个版本,其中vCard 4.0是最新且推荐使用的版本,它提供了更强大的功能和更好的国际化支持。理解vCard的属性结构是正确生成文件的关键。
除了常见的姓名(FN)、电话(TEL)和电子邮件(EMAIL)之外,vCard标准定义了大量属性来描述联系人的方方面面,例如:
在JavaScript中生成vCard时,只需将这些属性及其对应的值以正确的格式追加到vCard字符串中即可。每个属性通常独占一行,并以换行符 \n 分隔。
示例代码:添加额外联系人详情
立即学习“Java免费学习笔记(深入)”;
以下代码演示了如何在一个点击事件中,基于一个包含丰富信息的JavaScript对象,构建一个包含更多细节的vCard字符串。
document.getElementById("save-btn").addEventListener("click", function() {
// 1. 定义包含所有联系人信息的JavaScript对象
var contact = {
name: "John Smith",
phone: "555-555-5555",
email: "john.smith@example.com", // 清理后的邮件地址
company: "Acme Corp",
jobTitle: "Software Engineer",
address: {
street: "123 Main St",
city: "Anytown",
state: "CA",
zip: "90210",
country: "USA"
},
website: "https://www.acmecorp.com",
notes: "这是一个关于John Smith的备注,他是一名优秀的软件工程师。"
};
// 2. 构建vCard字符串的头部和基本信息
// 推荐使用 vCard 4.0 版本
var vcard = "BEGIN:VCARD\nVERSION:4.0\n";
// 格式化姓名 (FN: Formatted Name)
vcard += "FN:" + contact.name + "\n";
// 电话 (TEL: Telephone)
vcard += "TEL;TYPE=work,voice:" + contact.phone + "\n";
// 电子邮件 (EMAIL)
vcard += "EMAIL;TYPE=work:" + contact.email + "\n";
// 3. 添加更多详细属性
if (contact.company) {
vcard += "ORG:" + contact.company + "\n";
}
if (contact.jobTitle) {
vcard += "TITLE:" + contact.jobTitle + "\n";
}
if (contact.address) {
// ADR 属性格式: PO Box; Extended Address; Street; City; State; Postal Code; Country
// 如果某些字段为空,使用双分号 ;;
vcard += "ADR;TYPE=work:;;" + contact.address.street + ";" +
contact.address.city + ";" + contact.address.state + ";" +
contact.address.zip + ";" + contact.address.country + "\n";
}
if (contact.website) {
vcard += "URL;TYPE=work:" + contact.website + "\n";
}
if (contact.notes) {
// 注意:如果备注内容包含特殊字符,可能需要进行转义。
// vCard 4.0 通常会自动处理,但复杂文本仍需注意。
vcard += "NOTE:" + contact.notes + "\n";
}
// 4. vCard字符串的尾部
vcard += "END:VCARD";
// 5. 将vCard字符串转换为Blob并创建下载链接
var blob = new Blob([vcard], {
type: "text/vcard;charset=utf-8" // 明确指定字符集
});
var url = URL.createObjectURL(blob);
const newLink = document.createElement('a');
newLink.download = contact.name + ".vcf";
newLink.textContent = "点击下载 " + contact.name + " 的联系方式"; // 更好的用户提示
newLink.href = url;
// 模拟点击下载
newLink.click();
// 释放URL对象,避免内存泄漏
URL.revokeObjectURL(url);
});为vCard添加照片是一个非常实用的功能。vCard的PHOTO属性支持两种主要方式来包含图片:
vCard 4.0 中的 PHOTO 属性格式:
URI方式: PHOTO;MEDIATYPE=image/jpeg:http://example.com/photo.jpg
Base64编码方式: PHOTO;ENCODING=BASE64;TYPE=JPEG:[base64-data]
考虑到实际应用和文件大小,通常优先选择URI方式。
示例代码:集成照片(URI方式)
在上述代码的基础上,我们只需在contact对象中添加一个photoUrl属性,并在构建vCard字符串时加入PHOTO行。
document.getElementById("save-btn").addEventListener("click", function() {
var contact = {
name: "John Smith",
phone: "555-555-5555",
email: "john.smith@example.com",
company: "Acme Corp",
jobTitle: "Software Engineer",
address: {
street: "123 Main St",
city: "Anytown",
state: "CA",
zip: "90210",
country: "USA"
},
website: "https://www.acmecorp.com",
notes: "这是一个关于John Smith的备注,他是一名优秀的软件工程师。",
// 添加照片URL
photoUrl: "https://via.placeholder.com/150/0000FF/FFFFFF?text=JS+VCard" // 示例图片URL
};
var vcard = "BEGIN:VCARD\nVERSION:4.0\n";
vcard += "FN:" + contact.name + "\n";
vcard += "TEL;TYPE=work,voice:" + contact.phone + "\n";
vcard += "EMAIL;TYPE=work:" + contact.email + "\n";
if (contact.company) {
vcard += "ORG:" + contact.company + "\n";
}
if (contact.jobTitle) {
vcard += "TITLE:" + contact.jobTitle + "\n";
}
if (contact.address) {
vcard += "ADR;TYPE=work:;;" + contact.address.street + ";" +
contact.address.city + ";" + contact.address.state + ";" +
contact.address.zip + ";" + contact.address.country + "\n";
}
if (contact.website) {
vcard += "URL;TYPE=work:" + contact.website + "\n";
}
if (contact.notes) {
vcard += "NOTE:" + contact.notes + "\n";
}
// 添加 PHOTO 属性 (vCard 4.0, URI 方式)
if (contact.photoUrl) {
// 假设图片是JPEG格式,如果图片类型不确定,可能需要更复杂的逻辑判断
vcard += "PHOTO;MEDIATYPE=image/jpeg:" + contact.photoUrl + "\n";
}
vcard += "END:VCARD";
var blob = new Blob([vcard], {
type: "text/vcard;charset=utf-8"
});
var url = URL.createObjectURL(blob);
const newLink = document.createElement('a');
newLink.download = contact.name + ".vcf";
newLink.href = url;
newLink.click();
URL.revokeObjectURL(url);
});关于Base64编码方式的注意事项:
如果选择Base64编码方式,您需要先将图片文件(例如用户上传的头像)读取为Base64字符串。这通常涉及使用FileReader API或在服务器端进行处理。由于这会增加客户端JavaScript的复杂性,且可能导致vCard文件过大,因此在大多数网页场景下,URI方式更为简便高效。
通过本教程,您应该已经掌握了如何使用JavaScript生成功能更丰富的vCard文件,包括添加公司、职位、地址等详细信息,以及集成联系人照片。理解vCard的属性结构和版本差异是关键。选择合适的图片嵌入方式(URI或Base64)取决于您的具体需求和对文件大小的考量。遵循最佳实践,可以确保您生成的vCard文件具有良好的兼容性和用户体验。
以上就是JavaScript生成vCard:添加照片与丰富联系人信息的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号