# <stl:share> 分享标签
<stl:share
title="标题"
image="图片"
description="描述"
url="分享网址"
source="来源"
sites="分享目的站点"
disabled="禁用分享的站点"
wechatQrcodeTitle="微信二维码提示文字"
wechatQrcodeHelper="微信二维码下方说明">
</stl:share>
# 说明
通过 <stl:share>
实现前台页面分享功能。
<stl:share>
标签所有属性均为可选设置,可以不设置直接使用 <stl:share></stl:share>
,分享插件将获取当前栏目/内容的信息作为标题、图片及描述,如果当前栏目/内容未获取到信息,分享标签使用后台分享设置中设置的默认值。
# 解析
根据分享目的站点设置的不同,分享标签将显示不同的分享 ICON,默认分享目的地为微信、微博、QQ、QQ 空间以及豆瓣:
# 属性
属性 | 说明 |
---|---|
title | 标题 |
image | 图片 |
description | 描述 |
url | 分享网址 |
source | 来源 |
sites | 分享目的站点 |
disabled | 禁用分享的站点 |
wechatQrcodeTitle | 微信二维码提示文字 |
wechatQrcodeHelper | 微信二维码下方说明 |
# title - 标题
如果当前页面为栏目页,默认读取栏目名称作为标题。
如果当前页面为内容页,默认读取内容标题作为标题。
如果设置标题属性,分享标签将使用属性中的值作为标题。
<!-- 指定标题 -->
<stl:share title="标题"></stl:share>
# image - 图片
如果当前页面为栏目页,默认读取栏目图片作为图片。
如果当前页面为内容页,默认读取内容图片作为图片。
如果设置图片属性,分享标签将使用属性中的值作为图片。
<!-- 指定站点图片作为图片 -->
<stl:share image="{stl:site type=imageUrl}"></stl:share>
# description - 描述
如果当前页面为栏目页,默认读取栏目简介作为描述。
如果当前页面为内容页,默认读取内容概述作为描述。
如果设置描述属性,分享标签将使用属性中的值作为描述。
<!-- 指定站点描述作为描述 -->
<stl:share image="{stl:site type=description}"></stl:share>
# url 分享网址
分享网址,默认使用当前页面的地址(window.location.href)。
<!-- 指定分享网址 -->
<stl:share url="https://sscms.com"></stl:share>
# source - 来源
来源(QQ空间会用到), 默认读取head标签:<meta name="site" content="https://sscms.com" />
。
# sites - 分享目的站点
如果不设置此属性,默认为值为 wechat,weibo,qq,qzone,douban
。
以下是所有可选值:
"wechat"
微信。"weibo"
新浪微博。"qq"
QQ"qzone"
QQ 空间。"douban"
豆瓣。"facebook"
FACEBOOK"twitter"
TWITTER。"google"
GOOGLE。
# disabled - 禁用分享的站点
如果不设置此属性,默认为值为 facebook,twitter,google
。
以下是所有可选值:
"wechat"
微信。"weibo"
新浪微博。"qq"
QQ"qzone"
QQ 空间。"douban"
豆瓣。"facebook"
FACEBOOK"twitter"
TWITTER。"google"
GOOGLE。
# wechatQrcodeTitle - 微信二维码提示文字
微信二维码提示文字,默认为:微信扫一扫:分享
。
# wechatQrcodeHelper - 微信二维码下方说明
微信二维码下方说明文字,默认为:<p>微信里点“发现”,扫一下</p><p>二维码便可将本文分享至朋友圈。</p>
。
# 示例
# 设置描述
<stl:share description="分享插件"></stl:share>
# 设置微信二维码标题
<stl:share wechatQrcodeTitle="请打开微信扫一扫"></stl:share>