indreka-field-number
v1.1.3
Published
The input field number is a fundamental component of our design system. It provides a way for users to provide some numerical information for various purposes such as age, otp, contact number, etc.
Downloads
2
Readme
Introduction
The input field number is a fundamental component of our design system. It provides a way for users to provide some numerical information for various purposes such as age, otp, contact number, etc.
Input Field Number
The table below provides the size specifications:
| Size | Height |
| ------------- | ------ |
| Mobile
| 36 px |
| Tablet
| 38 px |
| Web/Desktop
| 40 px |
Input Field Number Colors
The table below provides the color specifications: | Color | Hex code | | --------- | ------- | | Primary-1 | #FFB42A | | Neutral-1 | #262626 | | Neutral-2 | #6C6969 | | Neutral-3 | #FFFFFF | | Accent-1 | #C7413A |
Input Field Number States
The Input Field Number component has several states, depending on the user's interaction with it | STATE | Description | | -------- | ---------------------------------------------------------------------- | | Default | The initial state of the Input Field component | | Hover | When the user hovers the mouse pointer over the Input Field | | Focus | When the user clicks on the Input Field | | Error | When the user gives incorrect password to display the error | | Disabled | When the Input Field is not available for interaction |
indreka-field-number component
The <indreka-field-number></indreka-field-number>
component having the following property:
id
having type of string.name
having type of string.disabled
having type of boolean.required
having type of boolean.placeholder
having type of string.label
having type of string.labelId
having type of string.min
having type of number.max
having type of number.step
having type of number.value
having type of number.errorMessage
having type of string.helperEnabled
having type of boolean.helperMessage
having type of string.iconRight
having type of array.iconLeft
having type of array.
use
<indreka-field-number>Text</indreka-field-number>
-- Text here will set the Label for the input field
we can pass attributes inside like:
id
<indreka-field-number id="idName"></indreka-field-number>
-- This will set an id for the checkbox and also set the 'for' attribute for the label as well.
name
<indreka-field-number name="name"></indreka-field-number>
-- This will add a name for the input field that will go with the entered password.
disabled
<indreka-field-number disabled></indreka-field-number>
-- This will disable the input field preventing the user to perform any action the input field.
required
<indreka-field-number required></indreka-field-number>
-- This will make the input field mandatory, if no value is provided, an error message will be shown below the field.
placeholder
<indreka-field-number placeholder="placeholderName"></indreka-field-number>
-- This will set a placeholder for the input field.
label
<indreka-field-number label="Number"></indreka-field-number>
---- This will give the label for the inupt field email.
labelId
<indreka-field-number label="labelName"></indreka-field-number>
-- This will give the id for the label which will be shown by aria-labelledby in the input field.
min
<indreka-field-number min=0></indreka-field-number>
-- This will set a minimum accepted value for the input field.
max
<indreka-field-number max=999></indreka-field-number>
-- This will set a maximum accepted value for the input field.
step
<indreka-field-number step=5></indreka-field-number>
-- This will set the step for increment and decrement for the input field.
value
<indreka-field-number value=120></indreka-field-number>
-- This will store the value of the input field and if set, will show a default value on the input field.
errorMessage
<indreka-field-number errorMessage="message"></indreka-field-number>
-- This will set the error message for required field -- by default 'Required field'.
iconleft
<indreka-field-number iconLeft='["IconType", "IconVersion", "IconName"]'></indreka-field-number>
-- This will add an icon to the left end of the text field and it will take an array as input consisting of the icon's type, version and name (in the same order), You can take reference from the Icon Library.
iconRight
<indreka-field-number iconRight='["IconType", "IconVersion", "IconName"]'></indreka-field-number>
-- This will add an icon to the right end of the text field and it will take an array as input consisting of the icon's type, version and name (in the same order), You can take reference from the Icon Library.
helperEnabled
<indreka-field-number helperEnabled></indreka-field-number>
-- This will enable the helper text below the input field, user must keep this enabled to see the helper text or the error messages.
helperMessage
<indreka-field-number helperMessage="Enter the email"></indreka-field-number>
-- This will allow the user to show a helper message for the field text, this will just be used to display information, no validation checks will be done here.
Angular use
--We are using custom events for values. so need to be implemented in the HTML code to get the input field values.
numberFieldEvent
<indreka-field-number (numberFieldEvent)="eventHandler($event)"></indreka-field-number>
--Example
html
<indreka-field-number (numberFieldEvent)="handleNumberFieldEvent($event)" ></indreka-field-number>
ts
handleNumberFieldEvent(event: Event) {
const customEvent = event as CustomEvent;
console.log(customEvent.detail); -- will provide the value from the input field
}
styles
The max-width and min-width of the input field is given as 120px and 600px respectively. For the custom component the styles cannot be changed.
To change the width and height of the input-field . It can be wrapped between the div tag and it can be changed by giving width and height accordingly.