1.0.7 • Published 5 years ago

react-native-dropdown-select v1.0.7

Weekly downloads
2
License
MIT
Repository
github
Last release
5 years ago

react-native-dropdown-select

下拉框组件

安装组件:

npm i --save react-native-dropdown-select

展示ui图

使用(这些ui组件的详细方法参数、作用、属性,可查看源文件,里面有详细注释)

import {
DropdownBox,
ButtonImage,
Button,
PickDropdown
} from "react-native-dropdown-select";

/**
单选
**/
<PickDropdown options={this.state.typesList}
              style={styles.dropdwon}
              onSelect={(v)=>this.onSelectDrop(v)}
              defaultValue={"请选择客户"}/>

/**
多选
**/
<PickDropdown options={this.state.typesList}
              multiple={true}
              style={styles.dropdwon}
              onSelect={(v)=>this.onSelectDrop(v)}
              defaultValue={"请选择客户"}/>

/**
图片按钮
**/
<ButtonImage icon={TriangleDown}
             disabled={disabled}
             style={[styles.searchIcon,{
                      width:this.getStyle().height == undefined
                      ? this.getStyle(styles.searchIcon).height
                        : this.styles.height,
                          height:this.styles.height,
                     }]}
             iconStyle={[
                        {
                            width:this.styles.height,
                            height:this.styles.height,
                         },
                          styles.icon,
                          this.getIconStyle()
                      ]}
              onPress={this._onBtnImgPress}/>

/**
按钮
**/
<Button style={styles.multipleBtn}
        textStyle={styles.multipleBtnText}
        onPress={()=>this._onMultiplePress()}
        text={"确定"}/>

DropdownBox 详解

You can also render your option row and row separator by implement renderRow and renderSeparator function.

DropdownBox自定义样式属性

Give the style props as your choice:

  • style: Change the style of the button (basic mode) / container (wrapper mode).
  • textStyle: Change the style of text of the button. Invalid in wrapper mode.
  • dropdownStyle: Change the style of dropdown container.
  • multiple: Change the style of dropdown container.
DropdownBox的api属性
属性类型可选默认值描述
disabledboolYesfalsedisable / enable the component.
defaultIndexnumberYes-1Init selected index. -1: None is selected. This only change the highlight of the dropdown row, you have to give a defaultValue to change the init text.
defaultValuestringYesPlease select...Init text of the button. Invalid in wrapper mode.
optionsarrayYesOptions. The dropdown will show a loading indicator if options is null/undefined.
animatedboolYestrueDisable / enable fade animation.
showsVerticalScrollIndicatorboolYestrueShow / hide vertical scroll indicator.
styleobjectYesStyle of the button.
textStyleobjectYesStyle of the button text. Invalid in wrapper mode.
dropdownStyleobjectYesStyle of the dropdown list.
dropdownTextStyleobjectYesStyle of the dropdown option text.
dropdownTextHighlightStyleobjectYesStyle of the dropdown selected option text.
adjustFramefuncYesThis is a callback after the frame of the dropdown have been calculated and before showing. You will receive a style object as argument with some of the props like width height top left and right. Change them to appropriate values that accord with your requirement and make the new style as the return value of this function.
renderRowfuncYesCustomize render option rows: function(option,index,isSelected) Will render a default row if null/undefined.
renderSeparatorfuncYesCustomize render dropdown list separators. Will render a default thin gray line if null/undefined.
renderButtonTextfuncYesUse this to extract and return text from option object. This text will show on button after option selected. Invalid in wrapper mode.
onDropdownWillShowfuncYesTrigger when dropdown will show by touching the button. Return false can cancel the event.
onDropdownWillHidefuncYesTrigger when dropdown will hide by touching the button. Return false can cancel the event.
onSelectfuncYesTrigger when option row touched with selected index and value. Return false can cancel the event.
accessibleboolYestrueSet accessibility of dropdown modal and dropdown rows
keyboardShouldPersistTapsenum('always', 'never', 'handled')Yes'never'See react-native ScrollView props
multipleboolYesfalseSets single or multiple selections
DropdownBox的方法
方法描述
show()Show the dropdown. Won't trigger onDropdownWillShow.
hide()Hide the dropdown. Won't trigger onDropdownWillHide.
select(idx)Select the specified option of the idx. Select -1 will reset it to display defaultValue. Won't trigger onSelect.

欢迎交流

欢迎提问交流;若有bug,请添加bug截图或代码片段,以便更快更好的解决问题。 欢迎大家一起交流

我的博客