SliderSuwak

Komponent suwaka umożliwia wybranie wartości przez przesunięcie uchwytu.

Sposób użycia

Zaimportuj komponent:

import 'mdui/components/slider.js';

Zaimportuj typ TypeScript komponentu:

import type { Slider } from 'mdui/components/slider.js';

Przykład użycia:

<mdui-slider></mdui-slider>

Właściwość JavaScript labelFormatter możesz zmienić format wyświetlanej etykiety tekstowej. Wartość tej właściwości to funkcja, która jako parametr przyjmuje bieżącą wartość suwaka i zwraca tekst, który chcesz wyświetlić.

<mdui-slider class="example-label-formatter"></mdui-slider>

<script>
  const slider = document.querySelector(".example-label-formatter");
  slider.labelFormatter = (value) => `${value} godzin`;
</script>

Źródło

API

Właściwości

Atrybut HTML	Właściwość JavaScript	Typ	Domyślne
`value`	`value`	`number`	`0`
Wartość suwaka, która zostanie wysłana wraz z danymi formularza
	`defaultValue`	`number`	`0`
Wartość domyślna. Po zresetowaniu formularza zostanie przywrócona do tej wartości. Ten atrybut można ustawić tylko za pomocą właściwości JavaScript
`autofocus`	`autofocus`	`boolean`	`false`
Określa, czy element automatycznie uzyskuje fokus po załadowaniu strony.
`tabindex`	`tabIndex`	`number`	-
Określa kolejność elementu podczas nawigacji za pomocą klawiatury (przycisk Tab).
`min`	`min`	`number`	`0`
Minimalna wartość suwaka, domyślnie `0`
`max`	`max`	`number`	`100`
Maksymalna wartość suwaka, domyślnie `100`
`step`	`step`	`number`	`1`
Skok wartości, domyślnie `1`
`tickmarks`	`tickmarks`	`boolean`	`false`
Określa, czy dodać znaczniki podziałki
`nolabel`	`nolabel`	`boolean`	`false`
Określa, czy ukryć podpowiedź tekstową
`disabled`	`disabled`	`boolean`	`false`
Określa, czy komponent jest wyłączony.
`form`	`form`	`string`	-
Powiązany element `<form>`. Wartość tego atrybutu powinna być `id` elementu `<form>` na tej samej stronie. Jeśli ten atrybut nie jest określony, element ten musi być elementem potomnym elementu `<form>`. Ten atrybut umożliwia umieszczenie elementu w dowolnym miejscu na stronie, nie tylko jako element potomny elementu `<form>`.
`name`	`name`	`string`	`''`
Nazwa suwaka, która zostanie wysłana wraz z danymi formularza
	`validity`	`ValidityState`	-
Obiekt stanu walidacji formularza, zobacz `ValidityState`
	`validationMessage`	`string`	-
Jeśli walidacja formularza nie powiedzie się, ten atrybut zawiera komunikat informacyjny. Jeśli walidacja się powiedzie, ten atrybut jest pustym ciągiem znaków
	`labelFormatter`	`(value: number) => string`	-
Funkcja formatująca etykietę. Przyjmuje bieżącą wartość suwaka, a zwraca tekst do wyświetlenia.

Metody

Nazwa	Parametry	Zwraca
`click`		`void`
Symuluje kliknięcie myszą na elemencie
`focus`	`options: FocusOptions` (Opcjonalny)	`void`
Przenosi fokus na bieżący element. Można przekazać obiekt jako parametr, którego właściwości obejmują: `preventScroll`: Domyślnie, po otrzymaniu fokusu przez element, strona przewinie się, aby go wyświetlić. Aby zapobiec przewijaniu strony, ustaw tę właściwość na `true`.
`blur`		`void`
Usuwa fokus z bieżącego elementu
`checkValidity`		`boolean`
Sprawdza poprawność pola formularza. Jeśli nie, zwraca `false` i wywołuje zdarzenie `invalid`; jeśli tak, zwraca `true`
`reportValidity`		`boolean`
Sprawdza poprawność pola formularza. Jeśli nie, zwraca `false` i wywołuje zdarzenie `invalid`; jeśli tak, zwraca `true`. Jeśli walidacja się nie powiedzie, na komponencie wyświetlany jest również komunikat o niepowodzeniu walidacji.
`setCustomValidity`	`message: string`	`void`
Ustawia niestandardowy komunikat o błędzie. Dopóki ten tekst nie jest pusty, oznacza to, że pole nie przeszło walidacji

Zdarzenia

Nazwa
`focus`
Wywoływane po otrzymaniu fokusu
`blur`
Wywoływane po utracie fokusu
`change`
Wywoływane, gdy wartość ulegnie zmianie i element straci fokus
`input`
Wywoływane przy każdej zmianie wartości
`invalid`
Wywoływane, gdy pole formularza nie przejdzie walidacji

CSS Parts

Nazwa
`track-inactive`
Tor w stanie nieaktywnym
`track-active`
Tor w stanie aktywnym
`handle`
Uchwyt
`label`
Tekst podpowiedzi
`tickmark`
Znacznik podziałki

Poprzedni rozdział

SegmentedButton Przycisk segmentowy

Następny rozdział

Snackbar Snackbar

SliderSuwak

Sposób użycia

Przykłady

Wartość domyślna

Stan wyłączony

Zakres

Krok

Znaczniki

Ukrywanie etykiety tekstowej

Modyfikacja etykiety tekstowej

API

Właściwości

Metody

Zdarzenia

CSS Parts