@justeattakeaway/pie-form-label
v0.14.4
Published
PIE Design System Form Label built using Web Components
Downloads
1,344
Maintainers
Keywords
Readme
Table of Contents
pie-form-label
pie-form-label
is a Web Component built using the Lit library.
This component can be easily integrated into various frontend frameworks and customized through a set of properties.
Installation
To install pie-form-label
in your application, run the following on your command line:
npm i @justeattakeaway/pie-form-label
yarn add @justeattakeaway/pie-form-label
For full information on using PIE components as part of an application, check out the Getting Started Guide.
Importing the component
JavaScript
// Default – for Native JS Applications, Vue, Angular, Svelte, etc.
import { PieFormLabel } from '@justeattakeaway/pie-form-label';
// If you don't need to reference the imported object, you can simply
// import the module which registers the component as a custom element.
import '@justeattakeaway/pie-form-label';
React
// React
// For React, you will need to import our React-specific component build
// which wraps the web component using @lit/react
import { PieFormLabel } from '@justeattakeaway/pie-form-label/dist/react';
[!NOTE] When using the React version of the component, please make sure to also include React as a peer dependency in your project.
Peer Dependencies
[!IMPORTANT] When using
pie-form-label
, you will also need to include a couple of dependencies to ensure the component renders as expected. See the PIE Wiki for more information and how to include these in your application.
Props
| Property | Type | Default | Description |
|---|---|---|---|
| for | String
| undefined
| Analog to the native html for
attribute, it defines the association of the PIE Form Label with another PIE Web Component |
| optional | String
| undefined
| Sets an optional text to be placed next to the main label |
| trailing | String
| undefined
| Sets a trailing text at the end of the label component |
In your markup or JSX, you can then use these to set the properties for the pie-form-label
component:
<!-- Native HTML -->
<pie-form-label for="username">Label</pie-form-label>
<pie-text-input id="username" name="username" type="text"></pie-text-input>
<!-- JSX -->
<PieFormLabel for="username">Label</PieFormLabel>
<PieTextInput id="username" name="username" type="text"></PieTextInput>
Note that the for
prop should match the id
of the input element you want to associate the label with.
Contributing
Check out our contributing guide for more information on local development and how to run specific component tests.