# @cleartrip/ct-design-loyalty-pill 中文文档

规范地址：https://npmcn.com/package/%40cleartrip/ct-design-loyalty-pill/

版本：1\.0\.11
npm 元数据更新时间：2026-11-16T13:03:58.889Z
中文译文更新时间：2026-11-16T13:07:49.796Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40cleartrip/ct-design-loyalty-pill
原文对照：https://npmcn.com/package/%40cleartrip/ct-design-loyalty-pill/?lang=original

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

- 包体积（解压后）：241 kB，93 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：react \>=16\.8\.0，react-dom \>=16\.8\.0，react-native \>=0\.78\.0，react-native-linear-gradient \>=2\.8\.0
- 首次发布：2026-05-14T18:42:07.224Z
- 最新版本发布：2026-11-16T13:03:58.686Z
- 近 30 天下载量：15987（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：225（近 12 个月 225 个）

## 中文简介

显示用户会员身份的忠心药丸组件

## 安装

```sh
npm install @cleartrip/ct-design-loyalty-pill
```

也可以使用：`pnpm add @cleartrip/ct-design-loyalty-pill`、`yarn add @cleartrip/ct-design-loyalty-pill`、`bun add @cleartrip/ct-design-loyalty-pill`

## README

# 极地紫外线

精英和伙伴忠诚方案的药剂组件(如:Flipkart Black). 支持Web和React Introduct. (原始内容存档于2018-09-29).

* * *

## 安装

```bash
npm install @cleartrip/ct-design-loyalty-pill
# or
pnpm add @cleartrip/ct-design-loyalty-pill
```

### 同伴依赖关系

```bash
# Required for all targets
npm install react
npm install styled-components

# Web only
npm install react-dom

# React Native only
npm install react-native
npm install react-native-linear-gradient
```

* * *

## 使用量

### 基础

```tsx
import { EliteLoyaltyPill, EliteLoyaltyPillStateEnum, LoyaltyProgram } from '@cleartrip/ct-design-loyalty-pill';

function Example() {
  return <EliteLoyaltyPill state={EliteLoyaltyPillStateEnum.UNLOCKED} onClick={() => console.log('clicked')} />;
}
```

### 国家

```tsx
<EliteLoyaltyPill state={EliteLoyaltyPillStateEnum.LOGGED_OUT} />
<EliteLoyaltyPill state={EliteLoyaltyPillStateEnum.LOCKED} />
<EliteLoyaltyPill state={EliteLoyaltyPillStateEnum.UNLOCKED} />
<EliteLoyaltyPill state={EliteLoyaltyPillStateEnum.EXPIRING} />
```

### 伙伴程序( FK Black)

```tsx
<EliteLoyaltyPill loyaltyProgram={LoyaltyProgram.FK_BLACK} href='/fk-black' />
```

### 动画

```tsx
<EliteLoyaltyPill state={EliteLoyaltyPillStateEnum.UNLOCKED} isVisible={lottieComplete} animate={lottieComplete} />
```

* * *

## 道具

| Prop | 类型 | 默认 | 需求 | 说明 |
| --- | --- | --- | --- | --- |
| `state` | `EliteLoyaltyPillState` | —— 说 | 没有 | 大片药丸状态 |
| `loyaltyProgram` | `'ELITE' | 'FK_BLACK'` | `'ELITE'` | 没有 | 忠诚程序; 伙伴模式使用图像避孕药 |
| `loading` | `boolean` | `false` | 没有 | 显示发光的骨架 |
| `error` | `Error | null` | —— 说 | 没有 | 数据层出错 |
| `onClick` | `() => void` | —— 说 | 没有 | 点击/ 按下处理器 |
| `onIntersection` | `() => void` | —— 说 | 没有 | 当药丸进入景点时会起火 |
| `onHover` | `(isHovered: boolean) => void` | —— 说 | 没有 | Hover 调用( 网络) |
| `animate` | `boolean` | `false` | 没有 | 滑入动画 |
| `isVisible` | `boolean` | `true` | 没有 | 何时 `false`药片没有制成 |
| `href` | `string` | —— 说 | 没有 | 伙伴药的链接 |
| `className` | `string` | —— 说 | 没有 | 样式覆盖 (web) |
| `ravenEventPrefix` | `string` | `''` | 没有 | Raven事件前缀 |
| `ravenAttributes` | `Record<string, string | number>` | —— 说 | 没有 | 额外的Raven有效载荷场 |
| `ravenPushCallback` | `RavenPushCallback` | —— 说 | 没有 | Raven 推力函数 |

* * *

## 国家

-   `LOGGED_OUT` - 高级轮廓丸
-   `LOCKED` ——解锁精英(已填充)
-   `UNLOCKED` - 精英(已填充)
-   `EXPIRING` - 精英+警徽
-   `SUSPENDED` 未执行

## 忠诚方案

-   `ELITE` - 国家精英药丸(违约)
-   `FK_BLACK` - 伙伴形象药丸`href` 支持)

* * *

## 无障碍

-   交互式精英丸使用按钮元素
-   伴侣药片使用链接 `href` 提供
-   过期警告徽章以视觉显示

* * *

## 移徙

```diff
- import { LoyaltyPill } from '...'
+ import { EliteLoyaltyPill, EliteLoyaltyPillStateEnum, LoyaltyProgram } from '@cleartrip/ct-design-loyalty-pill';
```

## 常见问题

### @cleartrip/ct-design-loyalty-pill 是什么？

显示用户会员身份的忠心药丸组件

### 如何安装 @cleartrip/ct-design-loyalty-pill？

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

### @cleartrip/ct-design-loyalty-pill 支持 TypeScript 吗？

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

### @cleartrip/ct-design-loyalty-pill 支持 ESM 还是 CommonJS？

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

### @cleartrip/ct-design-loyalty-pill 可以商用吗？

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

### @cleartrip/ct-design-loyalty-pill 的下载量有多少？

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

### @cleartrip/ct-design-loyalty-pill 还在维护吗？

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

