# @behold/svelte 中文文档

规范地址：https://npmcn.com/package/%40behold/svelte/

版本：0\.1\.7
npm 元数据更新时间：2025-09-24T23:21:03.922Z
中文译文更新时间：2026-11-07T20:54:51.204Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40behold/svelte
原文对照：https://npmcn.com/package/%40behold/svelte/?lang=original
项目主页：https://behold.so/
源码仓库：https://github.com/BeholdSocial/behold-svelte

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：7.7 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：svelte \>=4\.0\.0
- 首次发布：2024-02-24T14:25:56.260Z
- 最新版本发布：2025-09-24T23:21:03.685Z
- 近 30 天下载量：3999（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

斯韦尔特官方网站

## 安装

```sh
npm install @behold/svelte
```

也可以使用：`pnpm add @behold/svelte`、`yarn add @behold/svelte`、`bun add @behold/svelte`

## README

# 斯维尔特的官方视窗部件

[![Behold](https://img.shields.io/badge/Behold-ccf5a3.svg?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgdmlld0JveD0iMCAwIDM0IDI0Ij48cGF0aCBkPSJNMzMuNywxMC43QzMwLjcsNC40LDI0LjQsMCwxNywwLDkuNiwwLDMuMiw0LjQuMywxMC44Yy0uNC44LS40LDEuNywwLDIuNSwzLDYuMyw5LjQsMTAuNywxNi44LDEwLjcsNy40LDAsMTMuOC00LjQsMTYuNy0xMC44LjQtLjguNC0xLjcsMC0yLjVoMFpNMjMuNiwxMi41bC00LDIuMi0yLjIsNGMtLjIuNC0uNy40LS45LDBsLTIuMi00LTQtMi4yYy0uNC0uMi0uNC0uNywwLTFsNC0yLjIsMi4yLTRjLjItLjQuNy0uNC45LDBsMi4yLDQsNCwyLjJjLjQuMi40LjcsMCwxWiIgZmlsbD0iIzE5MTkxOSIvPjwvc3ZnPg==)](https://behold.so/) ![Svelte](https://img.shields.io/badge/svelte-%23f1413d.svg?style=for-the-badge&logo=svelte&logoColor=white)

## 关于

此软件包包含一个 Svelte 版本的 [见嵌入的部件](https://behold.so/docs/widget/)它是一个轻量级的便利包装器, 围绕核心的“ 视窗” 部件网络组件, 可以轻松地融入您的 Svelte 工程 .

## 安装

以您选择的软件包管理器安装开始 :

```jsx
npm install @behold/svelte

// or
pnpm add @behold/svelte

// or
yarn add @behold/svelte
```

## 使用量

### 1\. 进口部件

```js
import BeholdWidget from "@behold/svelte"
```

### 2\. 在您的应用程序中添加

使用它就像你想要的任何其他 Svelte 组件:

```html
<BeholdWidget feedId="YOUR_FEED_ID" />
```

Bye 部件组件接受单个属性 : `feedId`,可以通过打开您在 [见仪表板](https://app.behold.so/) 并点击"Embed代码".

所有配置和定制都由“视窗”管理员处理。 当你在那里做出修改时, 它会自动更新您的部件, 不需要修改代码 。 由于浏览器缓存,变化需要一到两分钟才能出现. 清理您的缓存和匿名/ 私人窗口将有所帮助 .

![Behold feed settings page](https://npmcn.com/package/%40behold/svelte/readme-images/find-your-feed-id-1.png) ![Behold feed embed code page](https://npmcn.com/package/%40behold/svelte/readme-images/find-your-feed-id-2.png)

## 装入事件

此组件在初始渲染后释放出负载事件 。 其用途如下:

```js
<BeholdWidget on:load={() => console.log("Loaded!")} feedId="YOUR_FEED_ID" />
```

## 关于安全部门改革的说明

这个组件依赖于只使用客户端的API,不会被SSR或SSG预发. 也就是说,在它达到0px高度之前,会有短暂的一刻。 您可以通过将尺寸应用到带有CSS的容器元件来防止这可能造成的布局转移.

## 其他框架构成部分

[![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge&logo=react&logoColor=%2361DAFB)](https://www.npmjs.com/package/@behold/react) [![Preact](https://img.shields.io/badge/preact-%2320232a.svg?style=for-the-badge&logo=preact&logoColor=%23ae80ff)](https://www.npmjs.com/package/@behold/preact) [![Vue.js](https://img.shields.io/badge/vuejs-%2335495e.svg?style=for-the-badge&logo=vuedotjs&logoColor=%234FC08D)](https://www.npmjs.com/package/@behold/vue) [![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white)](https://www.npmjs.com/package/@behold/angular) [![SolidJS](https://img.shields.io/badge/SolidJS-2c4f7c?style=for-the-badge&logo=solid&logoColor=c8c9cb)](https://www.npmjs.com/package/@behold/solid)

## 常见问题

### @behold/svelte 是什么？

斯韦尔特官方网站

### 如何安装 @behold/svelte？

在项目目录运行 npm install @behold/svelte，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（\>=4\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @behold/svelte 支持 TypeScript 吗？

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

### @behold/svelte 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @behold/svelte 可以商用吗？

@behold/svelte 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @behold/svelte 的下载量有多少？

根据 npm 官方下载统计，@behold/svelte 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,999 次，日均约 133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @behold/svelte 还在维护吗？

最新版本 0\.1\.7 发布于 2025/09/25（1\.1 年前）；至今共发布 8 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/02/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

