@dloizides/ui-payments

中文文档
0.4.5发布于 2026/10/25MITTypeScriptESM + CJS零依赖近 30 天下载 2117

Brand-agnostic React Native (RN-web) Stripe credentials card: connection status badge, masked key, webhook URL row, secret inputs with key-shape validation, payments switch and save/test/clear callbacks. Labels come in as props. Part of the dloizides.com

原始使用文档

@dloizides/ui-payments

Stripe credentials card for the dloizides.com RN-web portals. Generalised from agora-web's StripeConnectCard and kefi-web's StripeCredentialsSection.

import { StripeCredentialsCard } from '@dloizides/ui-payments';

<StripeCredentialsCard
  connection={{ configured, paymentsEnabled, secretKeyLast4, webhookUrl }}
  labels={labels}
  onSave={(s) => mutateAsync(s)}
  onClear={disconnect}
  onTest={testConnection}
  onCopyWebhookUrl={copy}
/>
  • No i18n inside: every string, hint and placeholder is a labels field.
  • Colours come from the @dloizides/ui-feedback theme; badges use @dloizides/theme-web badgeColors.
  • Every button is a @dloizides/ui-buttons Button (44 px floor at every size).
  • onSave receives trimmed secrets; undefined means keep the stored value. A resolved promise clears the typed secrets.

Helpers: isStripeSecretKeyShape, isStripeWebhookSecretShape, keyLast4, maskedKey, deriveStripeState, stripeStateColors, canSaveStripeDraft, buildStripeSubmission.

版本与发布记录

@dloizides/ui-payments 共发布 11 个版本,首次发布于 2026/10/25;过去 12 个月发布了 11 个版本。

版本发布日期距今
0.4.5latest2026/10/2519 天前
0.4.42026/10/2519 天前
0.4.32026/10/2519 天前
0.4.22026/10/2519 天前
0.4.12026/10/2519 天前
0.4.02026/10/2519 天前

关于 @dloizides/ui-payments 的常见问题

@dloizides/ui-payments 是什么?

Brand-agnostic React Native (RN-web) Stripe credentials card: connection status badge, masked key, webhook URL row, secret inputs with key-shape validation, payments switch and save/test/clear callbacks. Labels come in as props. Part of the dloizides.com

如何安装 @dloizides/ui-payments?

在项目目录运行 npm install @dloizides/ui-payments,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18.0.0)、react-native(>=0.74.0)、@dloizides/ui-forms(>=1.18.7)、@dloizides/theme-web(>=1.3.0)、@dloizides/ui-layout(>=1.28.0)、@dloizides/ui-buttons(>=1.21.0)、@dloizides/ui-feedback(>=1.16.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@dloizides/ui-payments 支持 TypeScript 吗?

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

@dloizides/ui-payments 支持 ESM 还是 CommonJS?

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

@dloizides/ui-payments 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dloizides/ui-payments 可以商用吗?

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

@dloizides/ui-payments 的下载量有多少?

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

@dloizides/ui-payments 还在维护吗?

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