Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/uportal-project/uportal-web-components

A collection of uPortal Web Components and JavaScript utilities
https://github.com/uportal-project/uportal-web-components

gradle hacktoberfest internationalization layout menu openid-connect reactjs typescript uportal vue web-components webjar webjars

Last synced: 3 days ago
JSON representation

A collection of uPortal Web Components and JavaScript utilities

Awesome Lists containing this project

README

        

# uPortal Web Components

[![Build Status](https://github.com/uPortal-contrib/uPortal-web-components/workflows/CI/badge.svg)](https://github.com/uPortal-contrib/uPortal-web-components/actions?workflow=CI)

> A collection of reusable, standardized, and accessible [web components][] for [uPortal][]

## Installation

There are couple options for installing components:

- a [node][] package through [npm][] or [yarn][]
- a [webjar][] through [gradle][] or [maven][]

```bash
# install with npm
npm install @uportal/{package name goes here}

# install with yarn
yarn add @uportal/{package name goes here}
```

_install with maven_

```xml

org.webjars.npm
uportal__{package name goes here}
{version number goes here}

```

_install with gradle_

```gradle
compile 'org.webjars.npm:uportal__{package name goes here}:{version number goes here}'
```

## Usage

To install any component, add a tag with the component's name, and a script tag pointing to the JavaScript bundle for that component.

For example an `example-component` would be loaded by adding

```html

```

## Components

- [API Template Vue](@uportal/api-template-vue/README.md)
- [Content Carousel](@uportal/content-carousel/README.md)
- [Dashboard Carousel](@uportal/dashboard-carousel/README.md)
- [ESCO Content Menu](@uportal/esco-content-menu/README.md)
- [Eyebrow User Info](@uportal/eyebrow-user-info/README.md)
- [Waffle Menu](@uportal/waffle-menu/README.md)
- [User Profile Menu](@uportal/user-profile-menu/README.md)
- [Grid Carousel](@uportal/grid-carousel/README.md)

## Utilities

- [Open ID Connect](@uportal/open-id-connect/README.md)
- [Portlet Registry to Array](@uportal/portlet-registry-to-array/README.md)

## Contribute

uPortal Components are built by people just like you! Check out [CONTRIBUTING.md][] for ways to get started.

Want to chat with the community and contributors? Join us in [Slack][] and the [Mailing List][]!

## Additional Topics

- [Local Project Setup](docs/en/developer/SETUP.md)
- [Using -SNAPSHOT Builds in uPortal-start](docs/en/developer/SNAPSHOT.md)
- [Project Automation Tools](docs/en/developer/AUTOMATION.md)
- [Project Conventions and Practices](docs/en/developer/CONVENTIONS.md)

[contributing.md]: CONTRIBUTING.md
[gradle]: https://docs.gradle.org
[mailing list]: https://groups.google.com/a/apereo.org/forum/#!forum/uportal-user
[maven]: http://maven.apache.org/
[node]: https://nodejs.org
[npm]: https://docs.npmjs.com/
[slack]: https://apereo.slack.com
[uportal]: https://github.com/Jasig/uPortal
[web components]: https://www.webcomponents.org/introduction
[webjar]: https://www.webjars.org/
[yarn]: https://yarnpkg.com/en/