前言
前端工程师日常在开发过程中,经常会使用一些第三方 npm 包进行辅助开发,其中 wsdm-share 是一款非常实用的分享组件,能够方便地在网站上添加分享按钮,有效提高网站的分享度和传播效果。本篇文章将详细介绍 wsdm-share 的使用方法和注意事项,并提供实用的代码示例,希望能够对前端开发工程师有所帮助。
安装 wsdm-share
wsdm-share 是一款基于 jQuery 的分享组件,我们通过 npm 包的方式来安装:
npm install wsdm-share --save
引入 wsdm-share
安装完成后,在需要使用的页面引入 wsdm-share:
-- -------------------- ---- ------- --------- ----- ------ ------ ----- ---------------- ----------------- ------------ ----- ---------------- --------------------------------------------------------------------- ------- ------ ---- ------------------------------ ------- ------------------------------------------------------------ ------- ---------------------------------------------------------------- -------- ---------------------------- - --------------------------------- ----- - ------ ------- ----- ------- ---- --------------------------------------- ---- ----------------------- - --- --- --------- ------- -------
配置参数
wsdm-share 的参数配置非常详细,我们一一来看:
data
- 类型:Object
- 描述:分享内容信息
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
title | String | 分享标题 | '' |
desc | String | 分享描述 | '' |
pic | String | 分享图片链接 | '' |
url | String | 分享链接 | '' |
title
- 类型:String
- 描述:分享标题
desc
- 类型:String
- 描述:分享描述
pic
- 类型:String
- 描述:分享图片链接
url
- 类型:String
- 描述:分享链接
position
- 类型:String
- 描述:分享按钮的位置,支持选择器和 DOM 元素,例如 ".shareContainer" 或 document.getElementById("shareContainer")
size
- 类型:String
- 描述:分享按钮的大小,可选值为 "small" 或 "large"
type
- 类型:Array
- 描述:分享的渠道,可选值为 "weibo"、"qq"、"wechat"、"qqzone"、"tweibo"、"facebook"、"twitter"、"linkedin"、"google" 或 "douban"
color
- 类型:String
- 描述:分享按钮的颜色,可选值为 "default"、"black"、"blue"、"green" 或 "yellow"
showText
- 类型:Boolean
- 描述:是否显示分享按钮的文字,可选值为 true 或 false
text
- 类型:Object
- 描述:文本信息
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
String | 新浪微博分享按钮文字 | '新浪微博' | |
String | QQ 分享按钮文字 | 'QQ' | |
String | 微信分享按钮文字 | '微信' | |
qqzone | String | QQ 空间分享按钮文字 | 'QQ空间' |
tweibo | String | 腾讯微博分享按钮文字 | '腾讯微博' |
String | Facebook 分享按钮文字 | 'Facebook' | |
String | Twitter 分享按钮文字 | 'Twitter' | |
String | LinkedIn 分享按钮文字 | 'LinkedIn' | |
String | Google+ 分享按钮文字 | 'Google+' | |
douban | String | 豆瓣分享按钮文字 | '豆瓣' |
isLimit
- 类型:Boolean
- 描述:是否开启限制,在微信、QQ、QQ 空间中,用户分享次数过多后将需要输入验证码,设置此参数为 true 可限制用户每天分享的次数
limit
- 类型:Number
- 描述:每天允许分享的次数,仅在开启限制时有效
success
- 类型:Function
- 描述:分享成功后的回调函数
error
- 类型:Function
- 描述:分享失败后的回调函数
实际应用
最后,我们将 wsdm-share 的实际应用代码整理如下:
-- -------------------- ---- ------- --------- ----- ------ ------ ----- ---------------- ----------------- ------------ ----- ---------------- --------------------------------------------------------------------- ------- ------ ---- ------------------------------ ------- ------------------------------------------------------------ ------- ---------------------------------------------------------------- -------- ---------------------------- - --------------------------------- ----- - ------ ------- ----- ------- ---- --------------------------------------- ---- ----------------------- -- --------- ------------------- ----- -------- ----- ---------- -------- --------- ----- --------- ----------- ---------- ------ ------- --------- ----- -------- ----- ------ -- -------- ---------- - -------------------- -- ------ ---------- - -------------------- - --- --- --------- ------- -------
总结
wsdm-share 是一款非常实用的分享组件,可以帮助你快速添加分享按钮,提高网站的分享度和传播效果。在应用 wsdm-share 的过程中,我们需要注意设置分享内容信息、分享按钮的位置和大小、选择分享的渠道等。希望通过本篇文章,能够帮助大家更好地应用 wsdm-share,提高前端开发效率,带来更好的用户体验。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600562ee81e8991b448e0a71