@hig/notifications-toast

HIG Toast

Stats

StarsIssuesVersionUpdatedCreatedSize
@hig/notifications-toast
1422432.2.0a year ago3 years agoMinified + gzip package size for @hig/notifications-toast in KB

Readme

Notifications Toast

Toasts are floating message boxes that appear up to a maximum of three at a time (similar events may be grouped). These are primarily informational they report a system occurrence that typically does not require much user action.

Read more about when and how to use the Toast component on the internal wiki.

Getting started

Install the package

yarn add @hig/notifications-toast @hig/theme-context @hig/theme-data

Import the component

import NotificationsToast from '@hig/notifications-toast';

Styling

Use the className prop to pass in a css class name to the outermost container of the component. The class name will also pass down to most of the other styled elements within the component.

NotificationsToast also has a stylesheet prop that accepts a function wherein you can modify NotificationsToast's styles. The original styles, props, and current theme data will be passed to your custom stylesheet function, and it should return an object with the same structure as the original styles. For instance

function customStylesheet(styles, props, themeData) {
  return {
    ...styles,
    toast: {
      ...styles.toast,
      position: "absolute"
    },
    toastImageContainer: {
      ...styles.toastImageContainer,
      borderColor: props.variant === "box"
        ? themeData["basics.colors.secondary.green.100"]
        : themeData["basics.colors.secondary.darkBlue.100"]
    },
    toastBody: {
      ...styles.toastBody,
      cursor: "default"
    },
    toastMessage: {
      ...styles.toastMessage,
      backgroundColor: themeData["colorScheme.reference.accent"]
    },
    toastDismiss: {
      ...styles.toastDismiss,
      padding: "0 12px"
    },
    toastListWrapper: {
      ...styles.toastListWrapper,
      display: "flex"
    },
    toastList: {
      ...styles.toastList,
      flexDirection: "row"
    }
  };
}

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.