# @carlos3g/element-dropdown 中文文档

规范地址：https://npmcn.com/package/%40carlos3g/element-dropdown/

版本：2\.18\.1
npm 元数据更新时间：2026-04-22T21:49:44.920Z
中文译文更新时间：2026-11-09T16:15:44.591Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40carlos3g/element-dropdown
原文对照：https://npmcn.com/package/%40carlos3g/element-dropdown/?lang=original
项目主页：https://github.com/carlos3g/element-dropdown#readme
源码仓库：https://github.com/carlos3g/element-dropdown

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

- 包体积（解压后）：559 kB，203 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- peer 依赖：react \*，react-native \*
- 首次发布：2026-04-18T23:25:45.164Z
- 最新版本发布：2026-04-22T21:49:44.643Z
- 近 30 天下载量：2226（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

保留 React 原生倒计时和多选择 。 drop-in-fork of reaction-native-element-dropped Dropped,通过npm Trusted Publishing以签名发布方式积极运输上游错误修复.

## 安装

```sh
npm install @carlos3g/element-dropdown
```

也可以使用：`pnpm add @carlos3g/element-dropdown`、`yarn add @carlos3g/element-dropdown`、`bun add @carlos3g/element-dropdown`

## README

[![](https://github.com/hoaphantn7604/file-upload/blob/master/document/dropdown/react-native-element-dropdown-demo.png)](https://github.com/hoaphantn7604/file-upload/blob/master/document/dropdown/react-native-element-dropdown-demo.png)

# `react-native-element-dropdown`,维护.

📚 **[完整文件 ∗∗](https://carlos3g.github.io/element-dropdown/)**

滴入的一分叉 [`react-native-element-dropdown`](https://github.com/hoaphantn7604/react-native-element-dropdown)。bugs 得到固定,工具链保持当前状态,每一份发布都签名。 相同的 API, 相同的组件(`Dropdown`, (中文(简体) ), `MultiSelect`, (中文(简体) ), `SelectCountry`),同道具——改变两行并保持通航.

```sh
npm install @carlos3g/element-dropdown
```

```diff
- import { Dropdown } from 'react-native-element-dropdown';
+ import { Dropdown } from '@carlos3g/element-dropdown';
```

## 为何这个叉子

最初的套装没有保存下来——一个很大的未决问题积压,加上多年未受影响的清洁社区公关。 如果你已经上场了 `react-native-element-dropdown`你可能至少撞到一个

-   `Invariant Violation: scrollToIndex out of range` 查找长列表时
-   重新打开框架时, 列表会在错误的位置闪出
-   `IDropdownRef` 编号 : `IMultiSelectRef` 创建网页或博览会时丢失
-   每个物品都有不可逾越的 `padding: 17` —— 说 `itemContainerStyle` 无法收缩
-   多选择触发用途 `placeholderStyle` 即使你选了什么东西

固定的——还有更多的。 见路线图 [`docs/upstream-triage.md`](https://npmcn.com/package/%40carlos3g/element-dropdown/docs/upstream-triage.md) 详细情况 [发布注释](https://github.com/carlos3g/element-dropdown/releases)。 。 。 .

## 你得到的东西

-   **下放 + 多选择 + 选择国家** - 三个组件,一个包, 同样的感觉在iOS和Android上
-   **降入移徙** ——公共API不变 `react-native-element-dropdown@2.12.x`, (中文(简体) ), `peerDependencies: *`
-   **主动维修** — 上游错误在每次发行中都会被三进制并固定;参见当前集的更改日志
-   **更好的默认** ——通过 `disabledField`, (中文(简体) ), `hitSlop` 为更大的水龙头目标, `allowFontScaling`, (中文(简体) ), `isInsideModal` 用于嵌入式 Modal 定位
-   **适当无障碍** - 触发器宣布为 `combobox`,项目显示选定/损坏状态
-   **真正的测试套房** ——整合测试涵盖核心互动流量
-   **已签名的版本** ——通过npm Trusted Publishing出版,每个版本都有出处证明

## 快速实例

```tsx
import { useState } from 'react';
import { Dropdown } from '@carlos3g/element-dropdown';

const data = [
  { label: 'Apple', value: 'apple' },
  { label: 'Banana', value: 'banana' },
];

export function FruitPicker() {
  const [value, setValue] = useState<string | null>(null);
  return (
    <Dropdown
      data={data}
      labelField="label"
      valueField="value"
      placeholder="Pick a fruit"
      value={value}
      onChange={(item) => setValue(item.value)}
    />
  );
}
```

完整的API(Drop down,多选取,Select Constitution),迁移指南和18个实际操作的食谱,见: **[文档](https://carlos3g.github.io/element-dropdown/)**。 。 。 .

## 与 AI 助手使用

这个软件包的设计是为了与LLM能动的工具(克洛德, Cursor, GitHub Copilot, ChatGPT, Aider等)很好地工作:

-   **`llms.txt` 编号 : `llms-full.txt`** ——docs站点在根部披露两个文件,紧随其后 [维基百科中的相关条目: 维基语录链接:名人名言](https://llmstxt.org/) 标准 :
    -   [`/llms.txt`](https://carlos3g.github.io/element-dropdown/llms.txt) 短清单,每页都有链接
    -   [`/llms-full.txt`](https://carlos3g.github.io/element-dropdown/llms-full.txt) – 每个 doc 页面被压缩,优化为单个获取
-   **里奇·联署文件** 在每一个道具英寸 `DropdownProps`, (中文(简体) ), `MultiSelectProps`,以及 `SelectCountryProps` ——您的IDE的IntelliSense(以及任何与之相融合的AI)看到 `@default`, (中文(简体) ), `@example`,并链接到每个道具的匹配指南.
-   **稳定, 空降 API** - 特工可以安全地重建现有 `react-native-element-dropdown` 代码库只需更改安装名称并导入路径即可.

### 样本提示

> "我正在使用 `@carlos3g/element-dropdown`。在 [https://carlos3g.github.io/element-drowdown/llms-full.txt (中文(简体) )](https://carlos3g.github.io/element-dropdown/llms-full.txt) 帮我盖个房子 `<UserPicker>` 包围的组件 `MultiSelect`,解析搜索, 粘贴与 `onEndReached`,并显示粘着的模式头 有计数器。"

## 演示

[![](https://github.com/hoaphantn7604/file-upload/blob/master/document/dropdown/react-native-element-dropdown-thumbnal.jpg)](https://youtu.be/FhTDR_Ad_14)

  

![](https://github.com/hoaphantn7604/file-upload/blob/master/document/dropdown/react-native-drpdown.gif) ![](https://github.com/hoaphantn7604/file-upload/blob/master/document/dropdown/react-native-multiselect.gif)

## 捐款

参见上游区划 [`docs/upstream-triage.md`](https://npmcn.com/package/%40carlos3g/element-dropdown/docs/upstream-triage.md) (a) 现有路线图和优先排序的上游问题和值得移植的公关事项清单。 问题和拉动请求是接口——请在存档时包括一个再Pro.

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40carlos3g/element-dropdown/LICENSE)。这是叉;原始版权在贡献元数据中保存.

## 常见问题

### @carlos3g/element-dropdown 是什么？

保留 React 原生倒计时和多选择 。 drop-in-fork of reaction-native-element-dropped Dropped,通过npm Trusted Publishing以签名发布方式积极运输上游错误修复\.

### 如何安装 @carlos3g/element-dropdown？

在项目目录运行 npm install @carlos3g/element-dropdown，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @carlos3g/element-dropdown 支持 TypeScript 吗？

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

### @carlos3g/element-dropdown 支持 ESM 还是 CommonJS？

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

### @carlos3g/element-dropdown 需要什么版本的 Node\.js？

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

### @carlos3g/element-dropdown 可以商用吗？

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

### @carlos3g/element-dropdown 的下载量有多少？

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

### @carlos3g/element-dropdown 还在维护吗？

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