# @binance/fiat-widget 中文文档

规范地址：https://npmcn.com/package/%40binance/fiat-widget/

版本：1\.1\.26
npm 元数据更新时间：2023-07-25T09:11:47.349Z
中文译文更新时间：2026-11-08T03:00:44.764Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40binance/fiat-widget
原文对照：https://npmcn.com/package/%40binance/fiat-widget/?lang=original

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

- 包体积（解压后）：141 kB，41 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2020-07-09T09:30:41.346Z
- 最新版本发布：2023-07-25T09:11:47.135Z
- 近 30 天下载量：2531（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 0 个）

## 中文简介

1.  你没有被列入任何贸易或经济制裁清单,例如联合国安全理事会制裁清单,被外国资产管制处(美国财政部外国资产管制处)指定为“特别指定国民”,或被列入美国通讯社

## 安装

```sh
npm install @binance/fiat-widget
```

也可以使用：`pnpm add @binance/fiat-widget`、`yarn add @binance/fiat-widget`、`bun add @binance/fiat-widget`

## README

## @ binance/ fiat-widget (英语)

1.  你没有被列入任何贸易或经济制裁清单,例如联合国安全理事会制裁清单,被外国资产管制处(美国财政部外国资产管制处)指定为 " 特别指定国民 " ,或被列入美国商务部的 " 杰出人员名单 " .
    
2.  您不提供任何可能构成非法、非法活动的受限/被禁业务
    

## 安装 根据 HTML CODE 在五分钟内

1.  你可以从你的Binance.com ref id那里得到 [Binance 转诊程序](https://www.binance.com/en/activity/referral)\- 还有比南斯 美国参考自 [Binance.US 转诊方案](https://www.binance.us/en/referral-details)
    
2.  添加下面的代码并输入您的 ref id 1),如果同时拥有Binance.com和Binance. US ref id, 请在“ ref” 和“ us ref” 栏下输入您的 ref id 2, 如果您只有 Binance.com ref id, 请在“ ref” 下输入您的 ref id, 删除“ us ref” 部分
    

```html
<script src="https://public.bnbstatic.com/static/js/ocbs/@binance/fiat-widget.js"></script>
<div id="widget"></div>
```

```javascript
<script>
    window.onload = function () {
        var t = document.querySelector('#widget')
        window.binanceFiatWidget.Widget(t, {
            locale: 'en',
            coinInfo: {
              fiat: '',
              crypto: '',
              isInUS: false
            },
            urlParmas: {
              us_ref: 'your us refId',
              ref: 'your refId'
            }
        })
    }
</script>
```

`finally`,检查跳动链接有参数 `ref`,像这样: `https://www.binance.com/cn/buy-sell-crypto?fiat=USD&crypto=BTC&amount=1000&ref=xxxxxx`

## 安装

```
npm install @binance/fiat-widget

// or cdn

<script src="https://public.bnbstatic.com/static/js/ocbs/@binance/fiat-widget.js"></script>
```

## 使用过的

```html
<div id="widget"></div>
```

```jsx
import {Widget} from '@binance/fiat-widget'

const options = {
    locale: 'en',
    width: 200,
    theme: 'dark',
    coinInfo: {
      fiat: '',
      crypto: '',
      isInUS: false
    },
    urlParmas: {
        ref: '',
        us_ref: '',
        utm_source: ''
    }
}

Widget('#widget', options)
```

-   反应

```jsx
import {Widget, unloadWidget} from '@binance/fiat-widget'
const app = () => {
    const t = useRef<HTMLDivElement>(null)
    // or
    // const t = document.querySelector('#test')

    useEffect(() => {
        if (t) {
            Widget(t)
        }
        return () => unloadWidget()
    }, [])
    return (<div id="#test" ref={r}></div>)
}
```

## 参数

-   埃尔: `selector` 或者说 `DOM element`
    
-   选项。本地化 : `string`
    
    `i18n`, (中文(简体) ), `nullable`,默认值:“en”
    
    选择 : `'cn','de','en','es','fr','id','it','kr','nl','pl','pt','ru','tr','tw','ua','vn',`,不支持的语境会倒向英语
    
-   选项.width : `number`
    
    `width`, (中文(简体) ), `nullable`, (中文(简体) ),
    
    如果不设定宽度, 默认值为 el. offsetWidth
    
    范围 : `200` - 说吧 `500`
    
-   选项。 主题: `string`
    
    `theme`, (中文(简体) ), `nullable`,默认值:“光”
    
    选择 : `'light' | 'dark'`
    
-   选项.urlPharmas
    
    -   选项.urlPharmas.ref: `string`
        
        `ref id`, (中文(简体) ), `nullable`
        
    -   选项.urlPharmas.us ref: `string`
        
        输入您的参考文献 1 。 如果你同时拥有Binance.com和Binance的话. US ref id, 请分别在"ref"和"us ref"两节下输入您的 ref id 。 如果您只有 Binance.com ref id, 请在“ ref” 下输入您的 ref id, 删除“ us ref” 部分
        
        `us_ref id`, (中文(简体) ), `nullable`
        
    -   选项.urlPharmas.utm source: `string`
        
        `UTM source`, (中文(简体) ), `nullable`
        
-   选项.coinInfo
    
    -   选项.coinInfo.fiat: `string`
        
        `fiat name`, (中文(简体) ), `nullable`
        
    -   选项.coinfo.crypto: `string`
        
        `crypto name`, (中文(简体) ), `nullable`
        
    -   选项.coinInfo.isInUS: `string`
        
        对于美国Widget Partners(例如,网站流量的50%是在美国),请输入真实信息。 对美国居民来说, 对于国际部件伙伴,请输入虚假.
        
        选择 : `true | false`
        
-   选项. api host: `string`
    
    覆盖 `getCoinListApi`, (中文(简体) ), `nullable`
    
-   选项.us api host: `string`
    
    覆盖 `getUsCoinListApi`, (中文(简体) ), `nullable`
    
-   选项。skeletonScreen : `boolean`
    
    `nullable`默认值 `true`,显示占位符部件
    

## API 密码

-   设置 XXX
    
    `setXXX` 是更改部件字符的函数, 您可以使用它 `chaining` 喜欢 `jquery`,则需要使用 `render` 来完成它
    

```javascript
const w = widget(container, opt)
w.setTheme('dark').setLocale('cn').render()
```

```
- setTheme

    change the theme
```

```javascript
const w = widget(container, opt)
w.setTheme('dark').render()
```

```
- setLocale

    change the locale
```

```javascript
const w = widget(container, opt)
w.setLocale('cn').render()
```

-   提交
    
    渲染部件( 在 `.setXXX()` 有必要)
    

```javascript
const w = widget(container, opt)
w.setTheme('dark').render()
```

```
render will fetch api, so `render` return a `Promise`
```

```javascript
const w = widget(container, opt)
w.setTheme('dark').render().then(v => alert('has render'))
```

-   卸载部件
    
    从页面中去掉部件, 也许你会在 React shocks 中使用它来替换 `setXXX()`
    

```javascript
useEffect(() => {
  if (t?.current) {
      w = Widget(t.current, {
          theme: theme
      })
  }
  return () => unloadWidget()
}, [theme])
```

## 常见问题

### @binance/fiat-widget 是什么？

你没有被列入任何贸易或经济制裁清单,例如联合国安全理事会制裁清单,被外国资产管制处\(美国财政部外国资产管制处\)指定为“特别指定国民”,或被列入美国通讯社

### 如何安装 @binance/fiat-widget？

在项目目录运行 npm install @binance/fiat-widget，或使用 pnpm add / yarn add / bun add。

### @binance/fiat-widget 支持 TypeScript 吗？

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

### @binance/fiat-widget 支持 ESM 还是 CommonJS？

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

### @binance/fiat-widget 可以商用吗？

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

### @binance/fiat-widget 的下载量有多少？

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

### @binance/fiat-widget 还在维护吗？

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