-adisagar2003-react-share-on-social

中文文档
1.0.9发布于 2022/11/02MITTypeScriptESM + CJS

如果支持,使用Web共享API的本机共享,如果不支持,一个美丽的回退。

中文使用文档
文档目录10 节
  1. 演示
  2. 功能
  3. 安装
  4. 使用
  5. 所需道具
  6. 可选道具
  7. 支持社交媒体
  8. 有什么区别? react-share-on-social 和 react-web-share ?
  9. 贡献
  10. 许可证

react-share-on-social

: smiling_face_with_three_hearts:: stuck_out_tongue_winking_eye: money_mouth_face:太阳镜:partying_face:

如果支持原生共享,则提供美丽的备用方案;如果不支持,则提供美丽的备用方案。

一、 ~8kb 轻松的社交媒体分享包,最初来自 反应 - 网络共享.

npm bundle size Maintenance npm NPM
通过❤︎增强 卡尔·塞勒格伦,最初由 严厉的Zalavadiya.

react-share-on-social fallback preview

功能

安装

npm install react-share-on-social

或者,如果你用的是纱线:

yarn add react-share-on-social

使用

传递 linkFavicon prop 大幅改善了使用回退功能的设备的用户体验。 linkFavicon回退反而会产生一个灰色方框。

注意:Web Share API仅在安全上下文中(HTTPS)可用。阅读更多 在这里.

import React from "react";
import ShareOnSocial from "react-share-on-social";
import favicon from "../assets/favicon.png";

const Example = () => {
  return (
    <ShareOnSocial
      textToShare="Check out this new wardrobe I just found from IKEA!"
      link="https://ikea.com/wardrobes/kalle"
      linkTitle="KALLE Wardorbe which chooses your clothes for you using AI - IKEA"
      linkMetaDesc="Stop going through the agony of choosing clothes that fit the weather and your mood."
      linkFavicon={favicon}
      noReferer
    >
      <button>Share this product</button>
    </ShareOnSocial>
  );
};

所需道具

财产类型描述
textToSharestring文章中出现的文字。
linkURL要共享的URL。
linkTitlestring的链接标题 <title> 标签。
linkMetaDescstring链接的元描述,应该对应于 <meta og:description> 标签。
linkFaviconHTMLImageElement这是显示在th popup fallback的头一个小的图像。

可选道具

财产类型默认的描述
shareToArray<string>["facebook", "twitter", ... , "email"]所有应该出现在后备的社交媒体渠道的列表。
noRefererbooleanfalse如果社交媒体按钮应该有一个 noreferrer 不管有没有标签。
backdropColorstringrgba(0,0,0,0.4)背景幕布的背景颜色。
closeTextstringClose关闭按钮的标签。
copyToClipboardTextstringCopy to clipboard“复制到剪贴板” 按钮的标签。
copySuccessTextstringCopied成功复制后,将副本标签发送至剪贴板按钮。
onSocialClick() => void() => null当用户单击回退中的任何社交媒体按钮时调用的回调。

支持社交媒体

支持的道具通过共享URL传递给每个服务,并将出现在post draft中。 | 社交媒体 | 支持的道具 |
――――――――――――― | Facebook | link | | Twitter | link, textToShare | | Whatsapp | link | | Reddit | link, textToShare | | LinkedIn | link, linkTitle, textToShare | | Pinterest | link | |电报| link, textToShare | 电子邮件 | link, textToShare |

有什么区别? react-share-on-social 和 react-web-share?

  • 回退更丰富的标题和改进的复制到剪贴板的功能

  • 道具被重新结构化以提高可用性

  • 支持Pinterest

  • 社交媒体服务在最小窗口中打开,而不是在新选项卡中打开

贡献

所以你想出力?很好,这个世界需要更多像你这样勇敢的战士。贡献使开源社区成为一个学习、启发和创造的神奇场所。我们和社区都非常感谢您做出的任何贡献。

  • 如果你发现一个错字,错误或想要添加一个功能,创建一个问题或添加一个拉取请求与你想要添加的代码!

  • 关于bug,请确保您的问题是:

    • 可重复的包括重现问题的步骤。

    • 具体的包含尽可能多的细节:你使用的设备、你如何与网站互动等。

    • 作用域为单个Bug。每个问题对应一个缺陷。

许可证

麻省理工学院

版本与发布记录

-adisagar2003-react-share-on-social 共发布 1 个版本,首次发布于 2022/11/02;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.9latest2022/11/024 年前

关于 -adisagar2003-react-share-on-social 的常见问题

-adisagar2003-react-share-on-social 是什么?

如果支持,使用Web共享API的本机共享,如果不支持,一个美丽的回退。

如何安装 -adisagar2003-react-share-on-social?

在项目目录运行 npm install -- -adisagar2003-react-share-on-social,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=17)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

-adisagar2003-react-share-on-social 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

-adisagar2003-react-share-on-social 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

-adisagar2003-react-share-on-social 可以商用吗?

-adisagar2003-react-share-on-social 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

-adisagar2003-react-share-on-social 还在维护吗?

最新版本 1.0.9 发布于 2022/11/02(4 年前);至今共发布 1 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/11/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。