react-native-floating-label-inputs
v0.0.4
Published
## About The Package
Downloads
59
Maintainers
Readme
React Native Floating Label Input
About The Package
This is a fully customizable React Native package, and its props extend from React-native textinput props. If your label floats in the text input while focusing or blurring, this is the perfect package for you, with multiple examples to meet your needs. 💅🎉
Getting Started
npm i react-native-floating-label-inputs
or using yarn
yarn add react-native-floating-label-inputs
Props
- All react native text input props are supported in the input field. other than that the package have the following props
| Prop | Type | Default | Description |
| :---------------------------: | :------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| label
| string | "" |label of the input field
| Icon
| JSX.Element | Undefined | Left icon should be supported by the app.
| floatUpRange
| number | 25 | Set the float up Range. if you provide negative number floats down
| rightIcon
| JSX.Element | Undefined | Add right side component, it can be an icon. and should be supported by the up.
| inputStyle
| ViewStyle | {} | Set the input style which means the style of the input texts.
| labelStyle
| TextStyle | {} | Set the label style for the floating label component.
| labelColor
| String | '#111' | Set the lable color.
| containerStyle
| ViewStyle | {} | Set styles to the input container component.
| error
| string or boolean | '' | Set your error message.if error message is passed the border and the label turns red.
Usage
Basic usage example
import {View, Text} from 'react-native';
import React, {useState} from 'react';
import FloatingLabelTextInput from 'react-native-floating-label-inputs';
// @ts-ignore
import Icon from 'react-native-vector-icons/EvilIcons';
export default function CommonExample() {
return (
<FloatingLabelTextInput
label="Name"
onChangeText={text => console.log(text)}
/>
);
}
Lower Float Up Range
floatUpRange
is a prop that gives floating range starting from zero. You should assign the appropriate number depending on your container height. the default value given is 25 but depending on your input container height it may vary.
import {View, Text} from 'react-native';
import React from 'react';
import FloatingLabelTextInput from 'react-native-floating-label-inputs';
export default function LoweFloatUpRange() {
return (
<FloatingLabelTextInput
label="Lower label"
containerStyle={{height: 50}}
floatUpRange={16}
inputStyle={{marginTop: 5}}
error="This field is required"
/>
);
}
Different color depending on your style
- As this package is dynamic you can use own style, Their are 4 styling props to do this.
containerStyle
is responsible for the container that holds the text field.inputStyle
is a style given to the texts that are typed by the user.labelStyle
responsible for styling the lable andlableColor
is color of the label.
import {View, Text} from 'react-native';
import React from 'react';
import FloatingLabelTextInput from 'react-native-floating-label-inputs';
export default function ColoredExample() {
return (
<FloatingLabelTextInput
label="password"
containerStyle={{backgroundColor: '#111'}}
labelStyle={{backgroundColor: '#111'}}
labelColor="#fff"
inputStyle={{color: '#fff'}}
/>
);
}
- Using icon
Set an icon both to the right side (The first icon, which is displayed on the right side of the input field) and left side (The second icon, which is displayed on the left side of the input field)
import React, {useState} from 'react';
import FloatingLabelTextInput from 'react-native-floating-label-inputs';
//@ts-ignore
import FontisoIcon from 'react-native-vector-icons/Fontisto';
import FontAwesome5Icon from 'react-native-vector-icons/FontAwesome5';
function WithIcon() {
const [showPassword, setShowPassword] = useState<boolean>(true);
return (
<FloatingLabelTextInput
label="password"
icon={
<FontisoIcon
name="locked"
color="#111"
size={20}
onPress={() => console.log('Icon pressed')}
/>
}
rightIcon={
!showPassword ? (
<FontAwesome5Icon
name="eye"
color="#111"
size={20}
onPress={() => setShowPassword((s: boolean) => !s)}
/>
) : (
<FontAwesome5Icon
name="eye-slash"
color="#111"
size={20}
onPress={() => setShowPassword((s: boolean) => !s)}
/>
)
}
secureTextEntry={showPassword}
/>
);
}
export default WithIcon;
- TextArea
A floating label for your TextArea
field that can accept multiple lines of text. The label will float up a certain range (specified by the "floatUpRange" prop) as the user types. The "containerStyle" prop that sets the height of the container element, and an "inputStyle" prop that sets the height of the input field itself.
import React from 'react';
import FloatingLabelTextInput from 'react-native-floating-label-inputs';
export default function TextAreaExample() {
return (
<FloatingLabelTextInput
label="Description"
floatUpRange={50}
containerStyle={{height: 100}}
inputStyle={{height: 100}}
multiline={true}
/>
);
}
- Border Bottom With an icon
import React, {useState} from 'react';
import FloatingLabelTextInput from 'react-native-floating-label-inputs';
import FontAwesome5Icon from 'react-native-vector-icons/FontAwesome5';
import FontisoIcon from 'react-native-vector-icons/Fontisto';
export default function BorderBottomWithIcon() {
const [showPassword, setShowPassword] = useState<boolean>(true);
return (
<FloatingLabelTextInput
label="Password"
containerStyle={{
borderWidth: 0,
backgroundColor: '#f5f0e1',
borderBottomWidth: 1,
height: 40,
}}
labelStyle={{backgroundColor: '#f5f0e1'}}
floatUpRange={16}
icon={
<FontisoIcon
name="locked"
color="#111"
size={20}
onPress={() => console.log('Icon pressed')}
/>
}
rightIcon={
!showPassword ? (
<FontAwesome5Icon
name="eye"
color="#111"
size={20}
onPress={() => setShowPassword((s: boolean) => !s)}
/>
) : (
<FontAwesome5Icon
name="eye-slash"
color="#111"
size={20}
onPress={() => setShowPassword((s: boolean) => !s)}
/>
)
}
secureTextEntry={showPassword}
/>
);
}
click here for more examples.
support us
- You can also give as star to our repo.
Authors
Author 1
👤 Dagmawi Zewdu
- GitHub: @Dagic-zewdu
- LinkedIn: Dagi-Zewdu
Author 2
👤 Sentayhu Berhanu
- GitHub: @sentayhu19
- LinkedIn: sentayhu-berhanu
Contribution
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request