@cleartrip/ct-design-badge

中文文档
5.32.0发布于 2026/11/16ISCTypeScriptESM + CJS近 30 天下载 1.8万

Badge component

原始使用文档
文档目录12 节
  1. Installation
  2. Peer dependencies
  3. Usage
  4. Basic
  5. Props
  6. BadgeVariants
  7. BadgeSizes
  8. BadgeColors
  9. BadgeGradientColors
  10. BadgeGradient
  11. Accessibility
  12. Migration

Badge

A small status indicator component typically used to show counts or status.


Installation

npm install @cleartrip/ct-design-badge
# or
pnpm add @cleartrip/ct-design-badge

Peer dependencies

# Required for all targets
npm install react

# Web only
npm install react-dom

# React Native only
npm install react-native

Usage

Basic

import { Badge } from '@cleartrip/ct-design-badge';

function Example() {
  return <Badge>{/* Basic usage */}</Badge>;
}

Props

PropTypeDefaultRequiredDescription
variantBadgeVariant—NoThe variant of the badge. Defaults to 'solid'.
sizeBadgeSize—NoThe size of the badge. Defaults to 'standard'.
prefixIconNodeReactNode—NoThe node representing the prefix icon of the badge.
textReactNode—✅ YesThe main content of the badge.
colorSchemeBadgeColor—NoThe color scheme of the badge. Default value is 'default'.
styleConfigIBadgeStyleConfig—NoStyle configuration for different parts of the badge.

BadgeVariants

  • SOLID — solid
  • SUBTLE — subtle

BadgeSizes

  • STANDARD — standard
  • MICRO — micro
  • NANO — nano

BadgeColors

  • CURACAO — curacao
  • CURACAO_900 — curacao900
  • BLUE — blue
  • DEFAULT — default
  • GREEN — green
  • GREEN_500 — green500
  • MARGARITA_250 — margarita250
  • MARGARITA_100 — margarita100
  • ORANGE_100 — orange100
  • ORANGE_250 — orange250
  • ORANGE_500 — orange500
  • PINA_COLADA — pinaColada
  • NEUTRAL_700 — neutral700
  • RED — red
  • RED_500 — red500
  • YELLOW — yellow
  • ALERT_500 — alert500
  • LINK — link
  • LINK_TEXT — linkText
  • BLUE100 — blue100
  • BLUE_500 — blue500
  • BLUE_900 — blue900
  • WHITE — white
  • PINA_COLADA750 — pinaColada750
  • PINA_COLADA100 — pinaColada100
  • BROWN — brown
  • BLACK — black
  • GRAY800 — gray800

BadgeGradientColors

  • GREEN_500 — green500
  • GREEN_600 — green600
  • PURPLE_100 — purple100
  • PURPLE_250 — purple250
  • GRAY_100 — gray100
  • GRAY_250 — gray250
  • AQUA_100 — aqua100
  • AQUA_250 — aqua250
  • BLACK — black
  • PINA_COLADA100 — pinaColada100

BadgeGradient

  • BLACKCURRENT — blackcurrent
  • PINOT_NOIR — pinotnoir
  • ASPHALT — asphalt
  • BLACK — black

Accessibility

  • The component follows accessibility best practices
  • Ensure proper ARIA attributes are provided where needed
  • Test with screen readers to ensure usability

Migration

If migrating from a previous version:

- import { Badge } from 'yagami/core/components';
+ import { Badge } from '@cleartrip/ct-design-badge';

版本与发布记录

@cleartrip/ct-design-badge 共发布 1,032 个版本,首次发布于 2024/01/11;过去 12 个月发布了 671 个版本。

版本发布日期距今
5.32.0latest2026/11/16今天
5.32.0-SNAPSHOT-5.32.0-SNAPSHOT-bs-height-check-161120161537.02026/11/16今天
5.32.0-SNAPSHOT-bs-height-check-151120162243.02026/11/16今天
2.33.0-SNAPSHOT-hdp-revamp-v3.02026/11/124 天前
2.33.0-SNAPSHOT-hdp-revamp-v2.02026/11/124 天前
5.32.0-SNAPSHOT-biztrip-rn-sme-snapshot-11-11-26.02026/11/115 天前

其他发布通道:SNAPSHOT-badgecarousel → 1.2.0-SNAPSHOT-badgecarousel.0,SNAPSHOT-carousel-spacer-badge → 1.2.0-SNAPSHOT-carousel-spacer-badge.2,SNAPSHOT-carousel-spacer-badge-calendar → 1.2.0-SNAPSHOT-carousel-spacer-badge-calendar.3,SNAPSHOT-carousel-spacer-badge-carousel → 1.2.0-SNAPSHOT-carousel-spacer-badge-carousel.1,SNAPSHOT-carousel-typography → 1.3.1-SNAPSHOT-carousel-typography.0,SNAPSHOT-animatedcarousel → 1.5.0-SNAPSHOT-animatedcarousel.0。

关于 @cleartrip/ct-design-badge 的常见问题

@cleartrip/ct-design-badge 是什么?

Badge component

如何安装 @cleartrip/ct-design-badge?

在项目目录运行 npm install @cleartrip/ct-design-badge,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.8.0)、react-dom(>=16.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cleartrip/ct-design-badge 支持 TypeScript 吗?

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

@cleartrip/ct-design-badge 支持 ESM 还是 CommonJS?

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

@cleartrip/ct-design-badge 可以商用吗?

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

@cleartrip/ct-design-badge 的下载量有多少?

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

@cleartrip/ct-design-badge 还在维护吗?

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