@carlos3g/element-dropdown

中文文档
2.18.1发布于 2026/04/23MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2226

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

中文使用文档
文档目录8 节
  1. 为何这个叉子
  2. 你得到的东西
  3. 快速实例
  4. 与 AI 助手使用
  5. 样本提示
  6. 演示
  7. 捐款
  8. 许可证

react-native-element-dropdown,维护.

📚 完整文件 ∗∗

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

npm install @carlos3g/element-dropdown
- 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 详细情况 发布注释。 。 。 .

你得到的东西

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

快速实例

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个实际操作的食谱,见: 文档。 。 。 .

与 AI 助手使用

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

  • llms.txt 编号 : llms-full.txt ——docs站点在根部披露两个文件,紧随其后 维基百科中的相关条目: 维基语录链接:名人名言 标准 :
  • 里奇·联署文件 在每一个道具英寸 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 (中文(简体) ) 帮我盖个房子 <UserPicker> 包围的组件 MultiSelect,解析搜索, 粘贴与 onEndReached,并显示粘着的模式头 有计数器。"

演示


捐款

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

许可证

麻省理工学院——见 自由主义。这是叉;原始版权在贡献元数据中保存.

版本与发布记录

@carlos3g/element-dropdown 共发布 8 个版本,首次发布于 2026/04/19;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.18.1latest2026/04/236 个月前
2.18.02026/04/206 个月前
2.17.02026/04/206 个月前
2.16.02026/04/206 个月前
2.15.02026/04/206 个月前
2.14.02026/04/196 个月前

关于 @carlos3g/element-dropdown 的常见问题

@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 和提交记录判断。