@smui/floating-label

Svelte Material UI - Floating Label

A floating label in an input field. This is usually provided by the input component, but you can set it up manually.

See MDC Floating Label for more information on API and Sass mixins.

See the Sass variable file for styling variables.

Installation

You won't generally need to install this package, unless you're manually creating text fields.

npm install --save-dev @smui/floating-label

Basic Usage

<script>
  import Textfield, {Input} from '@smui/textfield';
  import FloatingLabel from '@smui/floating-label';
  import LineRipple from '@smui/line-ripple';

  let name = '';
</script>

<!--
  Normally you wouldn't provide a floating label, but you can manually set up a
  textfield like this:
-->
<Textfield>
  <Input bind:value={name} id="name-input" />
  <FloatingLabel for="name-input">Name</FloatingLabel>
  <LineRipple />
</Textfield>

Demo

in action: https://sveltematerialui.com/#/demo/textfield

demo code: https://github.com/hperrin/svelte-material-ui/blob/master/site/demos/Textfield.svelte

Exports

(default)

A Floating Label component.

Props / Defaults

• use: [] - An array of actions and/or action/property arrays.
• class: '' - A CSS class string.
• for: '' - The ID of the input the label is to be associated with.
• wrapped: false - If the label is wrapped, a span element is used with no for attribute, otherwise, a label element is used with a for attribute.

Events

All standard UI events are forwarded.

Functions

• shake(boolean) - Shakes the label element.
• float(boolean) - Floats the label element.
• getWidth() - Get the width of the label element.

Changelog

1.0.0-beta.15 (2019-09-13)

Bug Fixes

• fixed ClassAdder components to allow SSR (de0daa1), closes #29
• forgot the dialog excludes (78e6ca9)
• let dialog buttons be links, even though it's not MDC compliant (e504cd7)
• prefer direct for prop over context on floating label (9184532)