为你的网站添加“分享到Teams”按钮
Microsoft Teams是一个围绕沟通协作的平台,信息分享是很重要的。那么,如果你有一个网站,如何让你的用户很容易地将网站内容分享到Teams呢?
下面通过实例讲解如何实现这个目的。熟悉我的朋友可能知道,我长期撰写技术博客,而博客园也是我认为中国做的很不错的博客平台,默认情况,目前博客园提供的模板中已经包含了一些分享的能力,包括分享到微博、微信等。下面我尝试为它添加分享到Teams的功能。
为网站添加“分享到Teams”按钮
Microsoft Teams提供了一个专门的库,可以很容易地生成分享按钮。下面的完整代码,请大家参考一下,其实逻辑很简单,我在现有分享工具栏的前面插入了一个按钮,并且按照规定定义了有关的属性。
<!--
概要:在博客园的博客页面底部增加“分享到Teams”的按钮
作者:陈希章
来源:《Microsoft Teams 平台完全手册》
网址:https://teamsplatform.xizhang.com
-->
<!--引入Teams的分享脚本库-->
<script
async
defer
src="https://teams.microsoft.com/share/launcher.js"
></script>
<!--定义合适的样式-->
<style>
.divblock {
padding: 10px;
border: #c0c0c0 1px dashed;
display: table-cell;
vertical-align: middle;
}
</style>
<!--在页面的合适位置放置这个按钮-->
<script>
document.getElementById("green_channel").setAttribute("class", "divblock");
let sharebutton = document.createElement("div");
sharebutton.id = "green_channel_teams";
<!--这个属性很重要,决定了分享时提供给Teams的网页链接-->
sharebutton.setAttribute("data-href", window.location.href);
<!--这个按钮必须至少有teams-share-button 这个样式 -->
sharebutton.setAttribute("class", "divblock teams-share-button");
<!--你可以通过属性设置分享的一些辅助文字说明-->
sharebutton.setAttribute("data-msg-text", "分享好文章:"+ document.title +" <br /> ");
document
.getElementById("blog_post_info")
.insertBefore(sharebutton, document.getElementById("green_channel"));
shareToMicrosoftTeams.renderButtons();
document
.getElementById("green_channel_teams")
.getElementsByTagName("img")[0].style.marginTop = "10px";
</script>
现在可以把这段代码添加到我的博客后台设置中,请注意要添加到 “博客侧边栏公告” 这个区域,只有这里是允许JS代码的。
保存后,打开某个文章,就可以看到下方分享栏会多出来一个Teams的按钮。
点击此按钮,会自动弹出一个对话框,并且把相关文字和链接都按照规定组合好,你只需要在“共享到”这个框中搜索团队或频道,然后点击 “共享”按钮即可。
如果当前没有登录Teams,则在显示分享对话框前会提示用户登录。
网页元数据定义
在分享到Teams时,会尝试进行网页的预览(如上图所示,通过链接可以解析得到标题和内容简介),以便给用户更加好的体验。那么这个是怎么实现的呢?
其实这个很简单的,你的网页只要按照下面的约定在Head中定义元数据即可。
考虑到对搜索引擎和不同平台的兼容性,我的建议是两个版本都定义。如果两者都定义了,Teams会以Open Graph定义的为准。
我们回过头去看刚才分享的博客园文章源代码
可以看出当前网页定义了title, description,og:description, 所以在分享时能解析出标题和描述,但没有定义缩略图,而且定义标题和内容摘要也不是特别规范。下面这个例子是完整定义后的效果。
感谢博客园提供的平台,以及允许自定义页面的能力。如果默认能把“分享到Teams”的按钮加上,并且在网页元数据这个部分能够规范一点就更好了。