README

Notification List

Development

# clone the repository if you haven't already
git clone https://github.com/uPortal-contrib/notification-web-components

# navigate to the notification-list folder
cd uPortal-web-components/@uportal/notification-list

# install the goods
npm install

# start the app
npm start

Build

Pretty simple:

npm run build

This will compile your JavaScript in to build/static/js/main.{buildnumbers}.js

Usage

After building, grab the compiled javascript files and place it on your page. You can now place <notification-list> anywhere on your page.

Here's the guts of that html file:

<notification-list> </notification-list>

Note: The component includes bootstrap, so that you can use bootstrap's styles in your content slots. However, font-awesome has issues crossing the shadow-dom boundry, so that if you include an icon in the content slot, you also need to include a <link> to the font-awesome stylesheet from uPortal (or elsewhere if you wish).

Notice

We have a /proxy/ leading the oidc-url attribute. This is a developer convenience to be able to query against your local running instance of uPortal. The proxy is configured in package.json:

  "proxy": {
    "/proxy": {
      "target": "http://localhost:8080",
      "changeOrigin": true,
      "pathRewrite": {
        "^/proxy": "/"
      }
    }
  },

Attributes

<notification-list> takes the following attributes:

`notification-api-url`

Url to connect notification-endpoint. Defaults to /NotificationPortlet/api/v2/notifications.

<notification-list oidc-url="/NotificationPortlet/api/v2/notifications"></notification-list>

`oidc-url`

Url to connect to oidc. The default for this value is /uPortal/api/v5-1/userinfo.

<notification-list oidc-url="/uPortal/api/v5-1/userinfo"></notification-list>

`color-map`

A map of colors associated with notification categories. The component will choose the first category defined to determine this.

<notification-list
    color-map='{
  "Announcement": "#6649bb",
  "Holds": "#487df9",
  "To-Do": "#c85a89"
}'
></notification-list>

`debug`

Skips oidc call for api token.

<notification-list debug></notification-list

Theming

Currently this component supports CSS Variables for overriding button colors. Defining the following variables will change the colors for the component accordingly. They will fall back to the colors described below.

You should define this in your custom stylesheet.

fg = foreground (text) bg = background

:root {
    --notif-list-icon-ph-color: #999; /* color of list icon (category) default color */
    --notif-unread-bg-color: aliceblue; /* background color of unread notifications */
    --notif-read-bg-color: white; /* background color of read notifications */
    --notif-highlight-bg-color: honeydew; /* background color of highlighted notifications */
    --notif-list-item-dd-width: 12px; /* size of ellipsis-v icon trigger for dropdown */
    --notif-list-item-dd-height: 28px; /* size of ellipsis-v icon trigger for dropdown */
}

Usage no npm install needed!