menuMDUIDocs
color_lens
Новый mdui 2 на базе Material Design 3 и Web Components уже здесь. Перейти к документации mdui 2.

Снэкбары

Снэкбар отображает небольшое всплывающее окно в нижней части экрана, которое может автоматически исчезнуть через некоторое время или после того, как пользователь нажмет на экран в другом месте.

На экране может одновременно отображаться только один снэкбар. Если открыть следующий снэкбар, пока текущий еще не закрыт, он будет помещен в очередь и откроется после закрытия текущего.

Использование

Просто вызовите метод mdui.snackbar(params).

Использование

Снэкбар вызывается напрямую через JavaScript, поэтому HTML-разметка не требуется.

Существует два способа вызова снэкбара:

  • mdui.snackbar(message, params)
  • mdui.snackbar(params)

Оба способа возвращают экземпляр снэкбара.

Параметры, поддерживаемые снэкбаром:

Имя параметраТипПо умолчаниюОписание
messagestringТекст снэкбара. При вызове через mdui.snackbar(params) этот параметр не может быть пустым.
timeoutint4000Задержка автоматического скрытия снэкбара в миллисекундах. Если установлено значение 0, он не будет закрываться автоматически.
positionstringbottomПоложение снэкбара.
  • bottom: Снизу
  • top: Сверху
  • left-top: Левый верхний угол
  • left-bottom: Левый нижний угол
  • right-top: Правый верхний угол
  • right-bottom: Правый нижний угол
buttonTextstringТекст кнопки.
buttonColorstring#90CAF9Цвет текста кнопки. Это может быть название цвета или его значение, например, red, #ffffff, rgba(255, 255, 255, 0.3) и т. д.
closeOnButtonClickbooleantrueЗакрывать ли снэкбар при нажатии на кнопку.
closeOnOutsideClickbooleantrueЗакрывать ли снэкбар при нажатии или касании области вне снэкбара.
onClickfunctionФункция обратного вызова при нажатии на снэкбар.
onButtonClickfunctionФункция обратного вызова при нажатии на кнопку в снэкбаре.
onOpenfunctionФункция обратного вызова при начале открытия снэкбара.
onOpenedfunctionФункция обратного вызова после открытия снэкбара.
onClosefunctionФункция обратного вызова при начале закрытия снэкбара.
onClosedfunctionФункция обратного вызова после закрытия снэкбара.

Методы экземпляра снэкбара:

Имя методаОписание
closeЗакрыть снэкбар. После закрытия экземпляр будет уничтожен.

Пример

Обычный снэкбар

Пример
mdui.snackbar({
  message: 'Message sent'
});

Снэкбар с обратным вызовом

Пример
mdui.snackbar({
  message: 'Archived',
  buttonText: 'undo',
  onClick: function(){
    mdui.alert('Нажатие на снэкбар');
  },
  onButtonClick: function(){
    mdui.alert('Нажатие на кнопку');
  },
  onClose: function(){
    mdui.alert('Закрыто');
  }
});

Снэкбары в разных положениях

Пример
mdui.snackbar({
  message: 'bottom',
  position: 'bottom',
});

mdui.snackbar({
  message: 'top',
  position: 'top',
});

mdui.snackbar({
  message: 'left-top',
  position: 'left-top',
});

mdui.snackbar({
  message: 'left-bottom',
  position: 'left-bottom',
});

mdui.snackbar({
  message: 'right-top',
  position: 'right-top',
});

mdui.snackbar({
  message: 'right-bottom',
  position: 'right-bottom',
});