Update readme
parent
5127e9b003
commit
ed19bc86bd
98
README.md
98
README.md
|
@ -1,34 +1,88 @@
|
|||
# primevue
|
||||
|
||||
## Project setup
|
||||
```
|
||||
npm install
|
||||
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
|
||||
[![npm version](https://badge.fury.io/js/primevue.svg)](https://badge.fury.io/js/primevue)
|
||||
[![Join the chat at https://gitter.im/primefaces/primevue](https://badges.gitter.im/primefaces/primevue.svg)](https://gitter.im/primefaces/primevue?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
||||
|
||||
|
||||
# PrimeVue
|
||||
|
||||
![alt text](https://www.primefaces.org/wp-content/uploads/2019/05/primevue-logo.png "PrimeVue")
|
||||
|
||||
|
||||
PrimeVue is available at npm, if you have an existing application run the following commands to download PrimeVue and PrimeIcons to your project.
|
||||
|
||||
```js
|
||||
npm install primevue --save
|
||||
npm install primeicons --save
|
||||
```
|
||||
|
||||
### Compiles and hot-reloads for development
|
||||
### Module Loader
|
||||
This is the recommended way if your application uses [vue-cli](https://cli.vuejs.org/) or has a webpack based build with [vue-loader](https://github.com/vuejs/vue-loader) configured. Import the components as .vue files for seamless integration within your project where path of each component is available at the "import" section of a component documentation.
|
||||
|
||||
```js
|
||||
//import {ComponentName} from 'primevue/{componentname}';
|
||||
|
||||
import {Dialog} from 'primevue/dialog';
|
||||
```
|
||||
npm run serve
|
||||
In the next step, register the component with the tag name you'd like to use.
|
||||
```js
|
||||
Vue.component('Dialog', Dialog);
|
||||
```
|
||||
Then you'll be able to utilize the component in your application.
|
||||
```markup
|
||||
<Dialog></Dialog>
|
||||
```
|
||||
|
||||
### Compiles and minifies for production
|
||||
```
|
||||
npm run build
|
||||
### Script Tag
|
||||
Other alternative is utilizing the components directly within the browser with UMD packages.
|
||||
```markup
|
||||
<meta charset="utf-8">
|
||||
<title>calendar demo</title>
|
||||
<script src="https://unpkg.com/vue"></script>
|
||||
<script src="https://unpkg.com/primevue/components/calendar/calendar.umd.js"></script>
|
||||
|
||||
<div id="app">
|
||||
<p-calendar></p-calendar>
|
||||
</div>
|
||||
|
||||
<script>
|
||||
new Vue({
|
||||
components: {
|
||||
'p-calendar': calendar
|
||||
}
|
||||
}).$mount('#app')
|
||||
</script>
|
||||
```
|
||||
|
||||
### Run your tests
|
||||
```
|
||||
npm run test
|
||||
### Dependencies
|
||||
Majority of PrimeVue components (95%) are native and there are some exceptions having 3rd party dependencies such as Quill for Editor.
|
||||
|
||||
In addition, components require PrimeIcons library for icons.
|
||||
```js
|
||||
dependencies: {
|
||||
"vue": "^2.6.10",
|
||||
"primeicons": "^1.0.0"
|
||||
}
|
||||
```
|
||||
|
||||
### Lints and fixes files
|
||||
```
|
||||
npm run lint
|
||||
Here is the list of components with 3rd party dependencies.
|
||||
|
||||
Component | Dependency
|
||||
--- | ---
|
||||
Charts | Charts.js 2.1.x+
|
||||
Editor | Quill.js 1.3.3+
|
||||
FullCalendar | FullCalendar 4.0.2+
|
||||
PrimeFlex | DataView
|
||||
|
||||
|
||||
### Styles
|
||||
The css dependencies are as follows, note that you may change the theme with another one of your choice. If you are using a bundler such as webpack with a css loader you may import them to your main application component.
|
||||
|
||||
```javascript
|
||||
primevue/resources/themes/nova-light/theme.css //theme
|
||||
primevue/resources/primevue.min.css //shared css
|
||||
primeicons/primeicons.css //icons
|
||||
```
|
||||
|
||||
### Run your unit tests
|
||||
```
|
||||
npm run test:unit
|
||||
```
|
||||
|
||||
### Customize configuration
|
||||
See [Configuration Reference](https://cli.vuejs.org/config/).
|
||||
### Quickstart
|
||||
An example application based on vue-cli is available at [github](https://github.com/primefaces/primevue-quickstart).
|
||||
|
|
Loading…
Reference in New Issue