嵌入小组件文档

什么是嵌入式小组件？

使用单个 iframe 标签将 Akousa 的 557+ 多种工具嵌入到您自己的网站上。小组件完全响应式、可自定义，并支持所有 20 种语言。

访问嵌入画廊浏览工具、预览效果并复制嵌入代码。自定义主题（亮色/暗色）、语言和尺寸以匹配您的网站。

如何嵌入工具

1. 1访问嵌入画廊或任何工具的文档页面
2. 2复制 iframe 嵌入代码
3. 3将其粘贴到您网站的 HTML 中

嵌入代码示例

'<'iframe src="https://akousa.net/embed/json-formatter?theme=dark&lang=zh" width="100%" height="500" frameborder="0">'<'/iframe>

功能

• ✓访问/embed-gallery的嵌入画廊，浏览所有557+个可嵌入工具。预览每个工具作为嵌入小组件的外观，查看建议的iframe尺寸，并查看实时示例。akousa.net上的每个工具都可免费嵌入。
• ✓从画廊复制即用的iframe代码片段。嵌入URL格式为/embed/[tool-slug]。使用URL参数自定义：?lang=用于语言（20种支持的语言中的任何一种，例如?lang=tr表示土耳其语），?theme=dark用于深色模式，或两者结合（?lang=fr&theme=dark）。iframe具有响应式设计，会适应容器宽度。
• ✓将iframe代码粘贴到您的HTML页面、博客文章、CMS或文档网站中。小组件通过Content Security Policy头和frame-ancestors安全加载，配置为跨域嵌入。无需API密钥、无需注册、无需署名——只需粘贴并发布。嵌入的工具通过Redis跟踪匿名查看次数以用于分析。

自定义选项

• 主题（亮色/暗色/跟随系统）
• 语言（20 种选项）
• 尺寸（通过 HTML 属性设置宽度和高度）

Content Security Policy & Security

All embed widgets use strict Content Security Policy headers with frame-ancestors configured for cross-origin embedding. Data processing happens entirely in the visitor's browser — no user data is transmitted to Akousa servers. The embed is served over HTTPS with the same security standards as the main platform. Your visitors' data stays on their device.

Anonymous Analytics

嵌入式小部件在内部跟踪匿名浏览次数，帮助您了解使用情况。不会从您的访客那里收集个人身份信息。分析过程轻量，不会影响小部件的性能或加载时间。

性能优化

嵌入页面经过预渲染以实现快速初始加载，并定期重新验证。iframe 异步加载，不会阻塞页面渲染。结合延迟加载 (loading="lazy")，嵌入的小部件对您站点的 Core Web Vitals 分数几乎没有影响。

Speakable Structured Data

Each embed page includes Speakable schema markup, making widget content eligible for voice assistant read-aloud. This improves accessibility for visually impaired users and positions your embedded tools for voice search discovery.

常见问题

哪些工具可以嵌入？

所有557+个工具都可以使用/embed/[tool-slug] URL格式嵌入。包括开发者工具、文本处理器、文件转换器和数据生成器。每个嵌入的工具都功能完整——用户可以输入数据、处理并直接在您网站的iframe中复制或下载结果。

嵌入是免费的吗？

是的，嵌入完全免费，没有使用限制、无需署名要求且不需要API密钥。您可以在任意数量的页面上嵌入任意数量的工具。嵌入小组件使用没有速率限制——您的访客可以不受限制地使用。

可以自定义外观吗？

是的！使用URL参数自定义：?theme=dark用于深色模式（默认为浅色），?lang=[locale]用于20种支持语言中的任何一种（例如?lang=ja表示日语）。小组件自动适应容器宽度。您还可以使用iframe元素上的标准HTML/CSS属性设置iframe的宽度、高度和边框样式。

嵌入内容安全吗？

是的。嵌入的小组件使用严格的Content Security Policy (CSP)，配置了frame-ancestors以允许跨域嵌入。所有数据处理都在访客的浏览器中进行——没有用户数据传输到我们的服务器。嵌入使用HTTPS并遵循与akousa.net主平台相同的安全标准。

嵌入工具会拖慢我的网站吗？

Embedded tools load asynchronously within the iframe and do not block your page rendering or affect your site's performance. The iframe loads independently, so even if the widget takes a moment to initialize, your page content appears instantly. The widget code is optimized and cached for fast loading via static generation with periodic revalidation.

可以在 WordPress 上嵌入工具吗？

可以。使用 WordPress 块编辑器中的自定义 HTML 块粘贴 iframe 代码。如果您的安全插件会移除 iframe，请在插件设置中将 akousa.net 加入白名单。该嵌入适用于 WordPress.com 商业版和所有自托管的 WordPress.org 安装。

嵌入式小组件会追踪分析数据吗？

嵌入式小部件仅记录用于内部分析的匿名浏览次数。不会在您的访客上放置 Cookie，不会收集个人数据，也不会在 iframe 内加载第三方跟踪器。您站点自己的分析（Google Analytics、Plausible 等）不受嵌入影响。

嵌入需要配置 CSP 头部吗？

如果您的网站使用内容安全策略，请在 CSP 头部添加 'frame-src https://akousa.net' 以允许 iframe。大多数没有显式 CSP 的网站可以直接使用。嵌入端点本身设置了宽松的 frame-ancestors 头部，因此可以从任何来源加载。

嵌入如何影响页面性能？

每个嵌入式小组件在独立的 iframe 上下文中加载，不会阻塞页面的主线程、DOM 或关键渲染路径。您可以在 iframe 标签中添加 loading="lazy" 以延迟加载，直到小组件滚入视图，进一步改善 Core Web Vitals。

可以在商业项目中使用嵌入工具吗？

可以。您可以自由地在商业网站、SaaS 仪表板、客户项目和内部工具中嵌入任何工具。没有许可费、使用上限或归属要求，仅有每个小组件自动包含的小型「Powered by akousa.net」链接。

相关文档

• 工具文档

  557+个免费在线工具的完整使用指南。了解开发者工具、文本处理器、转换器和生成器——所有工具都在您的浏览器中运行，无需注册。

• 开发者API参考

  Complete documentation for the akousa.net REST API with 104+ endpoints across 13 groups. Integrate tools, games, price data, news, and service status into your applications with a simple, well-documented JSON API.

• Embed Gallery

  The Embed Gallery at /embed-gallery is a dedicated landing page for webmasters. Browse all 557+ embeddable tools, preview how each looks as a widget, check recommended dimensions, and copy the ready-to-use iframe code with one click.

• PDF套件文档

  13个免费PDF工具指南，涵盖合并、拆分、压缩、转换和编辑PDF——所有处理都在浏览器中进行，零上传、零注册、完全隐私。