React-Native下拉框控件

前言

因项目需要,自己动手实现了一个下拉框组件,最近得空将控件独立出来开源上传到了github和npm。

github和npm上全英文的readme方便国际友人,这里就写个中文的吧。
如果您觉得对您有帮助请在github上给个Star,达到一定数量我将会把项目提交到awsome-react-native列表中。
如果您有问题可以以任何方式和我取得联系,也可以直接在github上提issue(推荐)。


react-native-modal-dropdown

一个react-native的下拉框组件,支持安卓和iOS。

特点

  • 纯JS组件。
  • 一份代码兼容iOS和Android。
  • 根据按钮位置自动调整下拉框弹出位置。
  • 零配置。 (当然啦,你不传选项的话会显示一个旋转的菊花)
  • 高可定制化。
  • 可通过API代码控制。 (显示、隐藏和选择)

示例

在example里可以找到示例代码。

Sample 1 - Basic and custom
Sample 2 - Within scroll view
Sample 3 - Lazy load

安装

npm i react-native-modal-dropdown --save

使用

基本

先Import组件:

import ModalDropdown from 'react-native-modal-dropdown';

作为组件使用即可:

<ModalDropdown options={['option 1', 'option 2']}/>

自定义

可以通过传入以下样式属性来自定义样式:

  • style: 改变按钮的样式。
  • textStyle: 改变按钮文字样式。
  • dropdownStyle: 改变下拉框的样式。

可以通过实现renderRow方法来自定义下拉框中的选项行。

API

属性(Props)

Prop Type Optional Default Description
disabled bool Yes false 是否禁用组件
defaultIndex number Yes -1 初始选择。 -1: 未选中。这个只会影响选项展示的高亮与否,不会改变初始的按钮文字。若要改变按钮初始文字请参考defaultValue
defaultValue string Yes Please select... 按钮初始文字。
options arrayOf(string) Yes 选项。 null/undefined则下拉框会显示一个加载图标。
style object Yes 按钮样式。
textStyle object Yes 按钮文字样式。
dropdownStyle object Yes 下拉框样式。
renderRow func Yes 自定义选项行的渲染。null/undefined会使用默认的行渲染。
onDropdownWillShow func Yes 下拉框显示前触发。 若实现此方法并返回false可以阻止显示。
onDropdownWillHide func Yes 下拉框隐藏前触发。若实现此方法并返回false可以阻止隐藏。
onSelect func Yes 选择选项时触发并返回indexvalue若实现此方法并返回false可以阻止选择。

方法

Method Description
updatePosition() 手动更新下拉框位置。如果控件放在scroll view里面,需要在scrollViewonScroll方法中调用此方法。
show() 显示下拉框。不会触发onDropdownWillShow
hide() 隐藏下拉框。不会触发onDropdownWillHide
select(idx) 选择给定索引(idx)的选项。不会触发onSelect

后续计划

受到d-a-n/react-native-modal-picker的启发,下个版本将实现控件作为容器!逮谁谁怀孕变成下拉框按钮。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,920评论 25 708
  • 简短说明 收录一些好用的RN第三方组件,以方便日常的使用,大家有什么推荐的也可以跟我说,我加进去。如有冒犯,可以联...
    以德扶人阅读 43,695评论 44 214
  • 持续更新中...... 一套企业级的 UI 设计语言和 React 实现。 https://mobile.ant....
    日不落000阅读 5,795评论 0 35
  • 活动单位:唯品网球俱乐部 活动时间:45分钟 流程: 1.糖老师 介绍网球历史及好处 5分钟 2.回顾教学 糖...
    知了唯知爱阅读 298评论 0 0
  • 羊屎蛋子,羊代谢后从肛门排出的废物,形状颗粒型,呈墨绿色,外表光鲜,内里却一团糟粕。可谓:“金玉其表,败絮其中”。...
    山顶的声音阅读 678评论 1 3