Gravatar 快速编辑器
Gravatar Quick Editor是一个JavaScript库,允许用户将Gravatar Quick Editor整合到他们的网络应用中,通过弹出窗口方便地编辑Gravatar的配置. 图书馆既提供高级控制的核心类,也提供快速设置的简化类.
特征
- 与您的网络应用程序简单整合 .
- 高级使用的核心功能.
- 简化了快速整合的设置.
- 支持使用PostMessage API实时更新Avatar图像.
- TypeScript支持类型完成和验证.
安装
用国家防范机制或Yarn安装
使用 npm 或纱线安装软件包 :
npm install @gravatar-com/quick-editor
yarn add @gravatar-com/quick-editor
用 UNPKG 安装
导入库如下:
<!-- Import the library -->
<script src="https://unpkg.com/@gravatar-com/[email protected]" defer></script>
<script>
// The library is accessible as a global variable
console.log( Gravatar );
</script>
替换
x.x.x带有最新版本编号。 请参看UNPKG的 文档 更多信息.
使用量
重力卡塔尔快编辑器
这个 GravatarQuickEditor class通过自动设置事件处理器来简化设置过程来打开弹出并更新页面上的avatar元素.
示例
import { GravatarQuickEditor } from '@gravatar-com/quick-editor';
document.addEventListener( 'DOMContentLoaded', () => {
new GravatarQuickEditor( {
email: '[email protected]',
editorTriggerSelector: '#edit-profile',
avatarSelector: '#gravatar-avatar',
scope: [ 'avatars' ],
} );
} );
重力卡塔尔快编辑器
这个 GravatarQuickEditorCore class提供了对Gravatar快编辑器功能的高级控制,允许开发者触发弹出事件并设置配置更新回调.
核心示例
import { GravatarQuickEditorCore } from '@gravatar-com/quick-editor';
document.addEventListener( 'DOMContentLoaded', () => {
const quickEditorCore = new GravatarQuickEditorCore( {
email: '[email protected]',
scope: [ 'avatars', 'about' ],
onProfileUpdated: () => {
console.log( 'Profile updated!' );
},
onOpened: () => {
console.log( 'Editor opened!' );
},
} );
document.getElementById( 'edit-profile' ).addEventListener( 'click', () => {
quickEditorCore.open();
} );
} );
API 密码
Gravatar 快速编辑器 API
new GravatarQuickEditor(options: QuickEditorOptions);
快速编辑器选项类型
type QuickEditorOptions = {
email: string;
editorTriggerSelector: string;
avatarSelector?: string;
scope?: Scope;
locale?: string;
avatarRefreshDelay?: number;
};
-
email: string数字 : 与 Gravatar 配置相关的电子邮件地址 。 用于识别要编辑的配置文件 . -
editorTriggerSelector: string数字 : HTML 元素(如按钮)的 CSS 选择器会触发Gravatar快速编辑器弹出器的打开. -
avatarSelector: string数字 : 显示 Gravatar 的 HTML 图像元素的 CSS 选择器 。 当图像更新时,图像会自动被刷新. -
scope: Scope数字 : 指定在弹出时可以编辑配置文件的哪些部分的数组 。 检查 有效范围值列表 -
locale: string数字 : Gravatar 编辑器接口的语言设置 。 这可用于设置编辑器UI的语言. -
avatarRefreshDelay: number数字 : Avatar 图像之前的毫秒延迟在更新后被刷新. 这可以帮助确保任何缓存在显示新图像之前被破解. -
utm: string数字 : 用于确定快编辑器使用地的代码.
在更新可视化图像时,为绕过浏览器缓存,快编辑器会添加一个
t参数中含有当前时间戳到avatar URL.
重力卡塔尔快编辑器Core API
new GravatarQuickEditorCore(options: QuickEditorCoreOptions);
快速编辑器选择类型
type QuickEditorCoreOptions = Partial< {
email: string;
scope: Scope;
locale: string;
onProfileUpdated: OnProfileUpdated;
onOpened: OnOpened;
} >;
-
email: string数字 : 与 Gravatar 配置相关的电子邮件地址 。 用于识别要编辑的配置文件 . -
scope: Scope数字 : 指定在弹出时可以编辑配置文件的哪些部分的数组 。 检查 有效范围值列表 -
locale: string数字 : Gravatar 编辑器接口的语言设置 。 这可用于设置编辑器UI的语言. -
onProfileUpdated: ( type: ProfileUpdatedType ) => void数字 : 当配置更新时调用回调函数 。 当用户保存其配置文件的更改时,这可用于触发应用程序中的附加动作. 它会收到一个类型参数ProfileUpdatedType具有以下一种值:'avatar_updated' | 'profile_updated' -
onOpened: () => void数字 : 一个在编辑器弹出时被调用的回调功能. 当弹出时,这可用于记录,分析或其他动作. -
onClosed: () => void数字 : 一个在编辑器弹出后被调用的回调功能.
公职
open: ( email?: string ) => boolean: 触发Gravatar快速编辑器弹出功能. 它可以接收一个电子邮件地址来识别要编辑的配置文件.true如果成功打开,则返回,false否则.close: () => void: 关闭打开的Gravatar快编辑器弹出.isOpen: () => boolean编号: 返回true如果弹出是打开的,false否则.
有效范围值
aboutavatarsverified-accountslinksinterestscontact-infowalletphotosdesignprivacy
贡献给 Gravatar 快速编辑器
我们欢迎为这一项目提供捐款。 请遵循本报告概述的准则 捐款额 文档.
许可证
Gravatar Hovercards公司根据下列规定获得许可证: GNU 通用公共许可证 v2( 或以后)。 。 。 .