Skip to content

Latest commit

 

History

History
193 lines (160 loc) · 4.87 KB

README.md

File metadata and controls

193 lines (160 loc) · 4.87 KB

react-native-picker

npm version dependency status

ui3 ui4

Documentation

Params

Key Description Type Default
pickerConfirmBtnText string confirm
pickerCancelBtnText string cancel
pickerTitleText string pls select
pickerConfirmBtnColor array [1, 186, 245, 1]
pickerCancelBtnColor array [1, 186, 245, 1]
pickerTitleColor array [20, 20, 20, 1]
pickerToolBarBg array [232, 232, 232, 1]
pickerBg array [196, 199, 206, 1]
pickerToolBarFontSize number 16
wheelFlex array [1, 1, 1]
pickerFontSize number 16
pickerFontColor array [31, 31, 31, 1]
pickerData array
selectedValue array
onPickerConfirm function
onPickerCancel function
onPickerSelect function

Methods

Name Description Type Default
init init and pass parameters to picker
toggle show or hide picker
show show picker
hide hide picker
select select a row array
isPickerShow get status of picker, return a boolean

Usage

Step 1 - install

	npm install react-native-picker --save

Step 2 - link

	react-native link

Step 3 - import and use in project

    import Picker from 'react-native-picker';
    let data = [];
    for(var i=0;i<100;i++){
        data.push(i);
    }

    Picker.init({
        pickerData: data,
        selectedValue: [59],
        onPickerConfirm: data => {
            console.log(data);
        },
        onPickerCancel: data => {
            console.log(data);
        },
        onPickerSelect: data => {
            console.log(data);
        }
    });
    Picker.show();
	

Integration With Existing Apps (iOS)

The Podfile will like below:

platform :ios, '8.0'
target 'YourTarget' do
    pod 'React', :path => '../YOUR_REACT_NATIVE_PROJECT/node_modules/react-native', :subspecs => [
    'Core',
    ...
    ]
    pod 'Picker', :path => '../YOUR_REACT_NATIVE_PROJECT/node_modules/react-native-picker'
end

After you have updated the Podfile of the existing app, you can install react-native-picker like below:

$ pod install

Notice

support two modes:

1. parallel: such as time picker, wheels have no connection with each other

2. cascade: such as date picker, address picker .etc, when front wheel changed, the behind wheels will all be reset

parallel:

  • single wheel:
	pickerData = [1,2,3,4];
	selectedValue = 3;
  • two or more wheel:
	pickerData = [
		[1,2,3,4],
		[5,6,7,8],
		...
	];
	selectedValue = [1, 5];

cascade:

  • two wheel
    pickerData = [
        {
            a: [1, 2, 3, 4]
        },
        {
            b: [5, 6, 7, 8]
        },
        ...
    ];
    selectedValue = ['a', 2];
  • three wheel
    pickerData = [
        {
            a: [
                {
                    a1: [1, 2, 3, 4]
                },
                {
                    a2: [5, 6, 7, 8]
                },
                {
                    a3: [9, 10, 11, 12]
                }
            ]
        },
        {
            b: [
                {
                    b1: [11, 22, 33, 44]
                },
                {
                    b2: [55, 66, 77, 88]
                },
                {
                    b3: [99, 1010, 1111, 1212]
                }
            ]
        },
        {
            c: [
                {
                    c1: ['a', 'b', 'c']
                },
                {
                    c2: ['aa', 'bb', 'cc']
                },
                {
                    c3: ['aaa', 'bbb', 'ccc']
                }
            ]
        },
        ...
    ]

For pure javascript version -> v3.0.5