SDC-UI Style-Guide and Components
This project aims to create a unified UI styled components for multiple development teams who work on the same web-based applications. This repository contains the definition of all the basic widgets and reusable controllers.
Usage
Link the library's CSS file
There are several options to link to sdc-ui CSS file:
SCSS
;
HTML
Webpack)
As Module (Using loading tool, i.e.;
Angular CLI projects
You can add this line to style.css file:
@;
React Code examples
Importing particular component
; // inside component rendering...{ return <Button>I am a Button</Button> ;}
Importing particular component from the react library
; // inside component rendering...{ return <Button>I am a Button</Button> ;}
Importing the entire library
; // inside component rendering...{ return <SDCUIReactButton>I am still a Button</SDCUIReactButton> ;}
Using the library in Angular (2-5)
Add the library to your module
; @
Running storybook
The components in this library are displayed via storybook. Head to http://onap-sdc.github.io/sdc-ui to see the components that are in master
.
While developing, just run npm run storybook
in your terminal to launch a local storybook server where you can see your changes. For deploying storybook to your own fork repository, refer to the guides section below.
Running component-lab
To see angular components in design run: npm run lab
Useful guides
Deploying storybook to a fork's github pages
Having some trouble? Have an issue?
For bugs and issues, please use the issues page
How to Contribute
Contribution can be made only by following these guide lines
- This project combines both
React
&Angular
framework libraries. Hence, every change in the basic HTML files structure, must be followed by changes on the frameworks files accordingly (undersrc/react
andsrc/angular
). - There will be no any 3rd party UI framework imported (i.e.
Bootstrap
,Material
,Foundation
... etc.). - Contribution are done only by the contribution guide. Contributions submitted not in this format and guidelines will not be considered.