What is @material/floating-label?
@material/floating-label is a package from the Material Components for the Web (MDC Web) library. It provides a floating label component that can be used in form fields to enhance user experience by animating the label when the input field is focused or filled.
What are @material/floating-label's main functionalities?
Basic Floating Label
This code snippet demonstrates how to create a basic floating label using the @material/floating-label package. The label will float above the input field when the field is focused or filled.
<div class="mdc-floating-label" id="my-label-id">My Label</div>
Floating Label with Input
This example shows how to use the floating label in conjunction with an input field. The label will float above the input field when the user interacts with it.
<div class="mdc-text-field">
<input type="text" class="mdc-text-field__input" aria-labelledby="my-label-id">
<label class="mdc-floating-label" id="my-label-id">My Label</label>
</div>
JavaScript Initialization
This code demonstrates how to initialize the floating label component using JavaScript. This is useful for adding dynamic behavior to the floating label.
import { MDCFloatingLabel } from '@material/floating-label';
const floatingLabel = new MDCFloatingLabel(document.querySelector('.mdc-floating-label'));
Other packages similar to @material/floating-label
react-floating-label-input
react-floating-label-input is a React component that provides similar functionality to @material/floating-label. It allows you to create floating labels for input fields in a React application. Unlike @material/floating-label, which is part of the MDC Web library, react-floating-label-input is specifically designed for React.
floating-label-react
floating-label-react is another React component for creating floating labels. It offers similar features to @material/floating-label but is tailored for use in React applications. It provides a simple API for integrating floating labels with input fields.
vue-mdc-adapter
vue-mdc-adapter is a library that integrates Material Components for the Web with Vue.js. It includes a floating label component similar to @material/floating-label. This package is ideal for Vue.js developers who want to use Material Design components in their applications.
Floating Label
Floating labels display the type of input a field requires. Every Text Field and Select should have a label, except for full-width text fields, which use the input's placeholder
attribute instead. Labels are aligned with the input line and always visible. They can be resting (when a field is inactive and empty) or floating. The label is a text caption or description for the Text Field.
Design & API Documentation
Installation
npm install @material/floating-label
Basic Usage
HTML Structure
<span class="mdc-floating-label" id="my-label-id">Hint text</span>
Styles
@use "@material/floating-label/mdc-floating-label";
JavaScript Instantiation
import {MDCFloatingLabel} from '@material/floating-label';
const floatingLabel = new MDCFloatingLabel(document.querySelector('.mdc-floating-label'));
Style Customization
CSS Classes
mdc-floating-label | Mandatory. |
mdc-floating-label--float-above | Indicates the label is floating in the floating position. |
mdc-floating-label--shake | Shakes the label. |
mdc-floating-label--required | Indicates the label is required and adds an asterisk. |
Sass Mixins
ink-color($color) | Customizes the ink color of the label. |
fill-color($color) | Customizes the fill color of the label. |
shake-keyframes($modifier, $positionY, $positionX, $scale) | Generates a CSS @keyframes at-rule for an invalid label shake. Used in conjunction with the shake-animation mixin. |
shake-animation($modifier) | Applies shake keyframe animation to label. |
float-position($positionY, $positionX, $scale) | Sets position of label when floating. |
max-width($max-width) | Sets the max width of the label. |
float-transition($duration-ms, $timing-function) | Customizes the duration and optional timing function for the "float" transition. |
MDCFloatingLabel
Properties and Methods
shake(shouldShake: boolean) => void | Proxies to the foundation's shake() method. |
float(shouldFloat: boolean) => void | Proxies to the foundation's float() method. |
setRequired(isRequired: boolean) => void | Proxies to the foundation's setRequired() method. |
getWidth() => number | Proxies to the foundation's getWidth() method. |
Usage Within Frameworks
If you are using a JavaScript framework, such as React or Angular, you can create a Floating Label for your framework. Depending on your needs, you can use the Simple Approach: Wrapping MDC Web Vanilla Components, or the Advanced Approach: Using Foundations and Adapters. Please follow the instructions here.
MDCFloatingLabelAdapter
addClass(className: string) => void | Adds a class to the label element. |
removeClass(className: string) => void | Removes a class from the label element. |
getWidth() => number | Returns the width of the label element. |
registerInteractionHandler(evtType: string, handler: EventListener) => void | Registers an event listener for a given event. |
deregisterInteractionHandler(evtType: string, handler: EventListener) => void | Deregisters an event listener for a given event. |
MDCFloatingLabelFoundation
shake(shouldShake: boolean) | Shakes or stops shaking the label, depending on the value of shouldShake . |
float(shouldFloat: boolean) | Floats or docks the label, depending on the value of shouldFloat . |
setRequired(isRequired: boolean) | Styles the label as required, depending on the value of isRequired . |
getWidth() => number | Returns the width of the label element. |
14.0.0 (2022-04-27)
Bug Fixes
- button: update HCM shim to use the existing focus-ring (a657abb)
- checkbox: Add explicit system color for checkmark in HCM. (8c4da22)
- checkbox: move forced-colors theme out of static styles (bbd1126)
- checkbox: Update checkbox theme styles mixin to accept css vars (c14e977)
- chips: Fix typography selector in GMDC-Wiz chips theming (43c7d87)
- datatable: Adjust data table last row border-radius to support setting row background-color. (ba78e87)
- dialog: Render dividers in Firefox 94 on Windows HCM (fae6c65)
- dialog: Set default z-index for close button in FloatingSheet dialog. (3366a71)
- fab: Add focus ring in HCM. (d57ec74)
- focus-ring: add 2d padding customizability, RTL bugfix (f81fb1d)
- focus-ring: box-sizing bugfix to content-box. If box-sizing border-box is inherited the ring spacing will collapse. (e58552c)
- focus-ring: ignore pointer events (3ef470e)
- focus-ring: RTL bugfix (e00181e)
- iconbutton: Fixed max width and height for high contrast mode focus ring on icon buttons. Display only in forced colors mode. (cf42927)
- iconbutton: Set icon button ripple z-index to -1. (586e740)
- list: Improve a11y for multi-select lists (9736ddc)
- list: Remove conflicting validation for checkbox list in setEnabled (353ca7e)
- list: Update lastSelectedIndex when toggling a checkbox range (dcba26f)
- menusurface: Add a getOwnerDocument() method to MDCMenuSurfaceAdapter to provide a reference to the document that owns the menu surface DOM element. (3486659)
- radio: Fix disabled state in Firefox Windows high contrast mode (23043ac)
- radio: Modify theme styles Sass mixin validation to validate only keys (390220e)
- select: Add border to select menu in HCM. (5d80969)
- select: revert down/up arrow on anchor changing selected index (43d08ba)
- slider: Fix bug where secondary click moves slider thumb. (3ab9565)
- slider: Fix IE11 bug -
unset
is unsupported in IE. (f460e23)
- slider: In updateUI, fix behavior to match jsdoc claim that when thumb param is undefined it updates both thumbs. Input attributes were not being updated at all. (cc4ed13)
- slider: Make the slider errors easier to debug by providing all relevant values in the error message. (8687937)
- snackbar: address Trusted Types violation (cbd9358)
- tooltip: Adjusts logic in
validateTooltipWithCaretDistances
method. (3e30054)
- typography: Fixes typography
theme-styles
mixin... the value being retreived from the $theme
map and css property name was swapped. The mixin would request font-size
/font-weight
/letter-spacing
from the $theme
map (which expects size
/weight
/tracking
)... so these values would always be null
. (32b3913)
- Remove /** @override */ tags from TypeScript code. (c3cdff0)
- Simplify MDCAttachable interface to be any object (Function) that has
attachTo
. (05db65e)
- Snackbar action button ripple color is applied to the ripple element. (4e66fb2)
- Work around bug in Sass (037285f), closes sass/sass#3259
- switch: Restore Firefox 94 HCM outlines (39cf14b)
- textfield: Fix breaking tests due to no valid pointerId being associated with pointer events. (15db4f1)
- tooltip: Only sends notification of a tooltip being hidden if
showTimeout
is not set (indicating that this tooltip is about to be re-shown). (6ca8b8f)
Features
- banner: Add disableAutoClose params for both banner actions to prevent the banner buttons from automatically closing the banner. Add adapter #notifyActionClicked method. (b094eaa)
- chips: add focus ring styles (783f6fd)
- chips: Added elevation tint layer color support in chips (c78ff04)
- data-table: separate table structure into its own mixin (9f9d928)
- dialog: Add styling for floating sheets (78305b6)
- dialog: Add styling for floating sheets with content padding (3e20c1d)
- Dialog: Adds an API to hide the header for GMDC Fullscreen Dialog in non-fullscreen mode (ab4aba1)
- Dialog: Adds an API to set custom position for GMDC Dialog (ea9b5b4)
- Dialog: Adds an API to set custom z-index for GMDC Dialog (96ea061)
- focus-ring: added a new mixin so we can override just the focus-ring color (641ed08)
- focus-ring: added a new mixin so we can override just the focus-ring radius (7321d62)
- iconbutton: Add link icon button Sass. (9803d2d)
- mdc-list: introduce selection change event (7d8ea46)
- menu: allow preferentially opening surface below anchor (261f2db)
- MenuSurface: Add opening event for menus. (53b3cad)
- select: Add theming mixin boilerplate code to select (ae8a6a3)
- select: Add validation getter methods. (bdf1d37)
- select: Added theme mixins to MDC select (dcfe49c)
- slider: Add
minRange
param to range sliders to request a minimum gap between the two thumbs. (8fffcb5)
- slider: Add an option to hide focus styles after pointer interaction. (ec54d90)
- slider: Keep the slider value indicator within the bounds of the slider if possible. (c047f7c)
- state: make context aware (b2fe352)
- switch: Add high contrast mode focus ring to switch (f31a833)
- text-field: Add theming mixin boilerplate code to text-field (eb382f3)
- text-field: Added theme mixins to MDC text field (344d528)
- textfield: adding input-font-size mixin (207230e)
- theme: allow custom property strings in theme.validate-theme() (4e372fb)
- add new class and mixin for open state of a menu item (9a02b6e)
- Indicate which thumb
valueToAriaValueTextFn
and valueToValueIndicatorTextFn
functions are called for. (b6510c8)
- textfield: adding input-font-family mixin (991fb99)
- Describe how to add child lists into a list item. (758ce31)
BREAKING CHANGES
- MenuSurface: Adds #notifyOpening method to menu surface adapter.
PiperOrigin-RevId: 444830518
- slider: Adds #getValueIndicatorContainerWidth method to slider adapter.
PiperOrigin-RevId: 419837612