vue-quest-ui 0.0.36 → 0.0.38
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -95
- package/dist/vue-quest-ui.css +1 -1
- package/dist/vue-quest-ui.js +374 -306
- package/dist/vue-quest-ui.umd.cjs +1 -1
- package/package.json +1 -1
- package/src/components/shared/ui/QstButton.vue +22 -18
- package/src/components/shared/ui/QstIcon.vue +73 -2
- package/src/components/shared/ui/QstModal.vue +1 -1
package/README.md
CHANGED
|
@@ -1,98 +1,106 @@
|
|
|
1
|
-
# Vue Quest UI
|
|
2
|
-
|
|
3
|
-
Vue Quest UI is a collection of reusable Vue components that are designed to help you quickly build modern and responsive user interfaces for your Vue.js projects.
|
|
4
|
-
|
|
5
|
-
## Installation
|
|
6
|
-
|
|
7
|
-
You can easily install Vue Quest UI via npm:
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
npm i vue-quest-ui
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Usage
|
|
14
|
-
To use Vue Quest UI in your Vue.js project, you can register the components globally as an entire library or individually, or locally.
|
|
15
|
-
|
|
16
|
-
### 1. Global Registration:
|
|
17
|
-
In your main.js (or main.ts) file, use the <b>install</b> function to register all components globally. All the components in the library will be installed in your project. They can then be used as custom components in any part of your project.
|
|
18
|
-
|
|
19
|
-
```javascript
|
|
20
|
-
import { createApp } from 'vue';
|
|
21
|
-
import App from './App.vue';
|
|
22
|
-
import { install } from 'vue-quest-ui'; // Import the install function
|
|
23
|
-
|
|
24
|
-
const app = createApp(App);
|
|
25
|
-
|
|
26
|
-
app.use(install); // Register all components globally
|
|
27
|
-
|
|
28
|
-
app.mount('#app');
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
### 2. Selective Registration:
|
|
32
|
-
If you only want to import specific components instead of the entire library, you can use the <b>installGlobalComponents</b> function. Pass a string array of the component names you'd like to import, these components will then be globally imported.
|
|
33
|
-
|
|
34
|
-
```javascript
|
|
35
|
-
import { createApp } from 'vue';
|
|
36
|
-
import App from './App.vue';
|
|
37
|
-
import { installGlobalComponents } from 'vue-quest-ui';
|
|
38
|
-
|
|
39
|
-
const app = createApp(App);
|
|
40
|
-
|
|
41
|
-
installGlobalComponents(app, ['QstIcon']); // Register only the QstIcon component globally
|
|
42
|
-
|
|
43
|
-
app.mount('#app');
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
### 3. Manual Registration:
|
|
47
|
-
You can also import and register individual components manually globally, or locally in each file that they'll be used in.
|
|
48
|
-
|
|
49
|
-
```javascript
|
|
50
|
-
// main.js/main.ts
|
|
51
|
-
import { createApp } from 'vue';
|
|
52
|
-
import App from './App.vue';
|
|
53
|
-
import { QstIcon } from 'vue-quest-ui';
|
|
54
|
-
|
|
55
|
-
const app = createApp(App);
|
|
56
|
-
|
|
57
|
-
// Manually register the QstIcon component
|
|
58
|
-
app.component('QstIcon', QstIcon);
|
|
59
|
-
|
|
60
|
-
app.mount('#app');
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
```javascript
|
|
64
|
-
// file for a component or page where the component will be used
|
|
65
|
-
import { QstIcon } from 'vue-quest-ui';
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
```html
|
|
69
|
-
<div>
|
|
70
|
-
<qst-icon icon="clarity:email-solid" />
|
|
71
|
-
</div>
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
##
|
|
75
|
-
Vue Quest UI
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
1
|
+
# Vue Quest UI
|
|
2
|
+
|
|
3
|
+
Vue Quest UI is a collection of reusable Vue components that are designed to help you quickly build modern and responsive user interfaces for your Vue.js projects.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
You can easily install Vue Quest UI via npm:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm i vue-quest-ui
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Usage
|
|
14
|
+
To use Vue Quest UI in your Vue.js project, you can register the components globally as an entire library or individually, or locally.
|
|
15
|
+
|
|
16
|
+
### 1. Global Registration:
|
|
17
|
+
In your main.js (or main.ts) file, use the <b>install</b> function to register all components globally. All the components in the library will be installed in your project. They can then be used as custom components in any part of your project.
|
|
18
|
+
|
|
19
|
+
```javascript
|
|
20
|
+
import { createApp } from 'vue';
|
|
21
|
+
import App from './App.vue';
|
|
22
|
+
import { install } from 'vue-quest-ui'; // Import the install function
|
|
23
|
+
|
|
24
|
+
const app = createApp(App);
|
|
25
|
+
|
|
26
|
+
app.use(install); // Register all components globally
|
|
27
|
+
|
|
28
|
+
app.mount('#app');
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
### 2. Selective Registration:
|
|
32
|
+
If you only want to import specific components instead of the entire library, you can use the <b>installGlobalComponents</b> function. Pass a string array of the component names you'd like to import, these components will then be globally imported.
|
|
33
|
+
|
|
34
|
+
```javascript
|
|
35
|
+
import { createApp } from 'vue';
|
|
36
|
+
import App from './App.vue';
|
|
37
|
+
import { installGlobalComponents } from 'vue-quest-ui';
|
|
38
|
+
|
|
39
|
+
const app = createApp(App);
|
|
40
|
+
|
|
41
|
+
installGlobalComponents(app, ['QstIcon']); // Register only the QstIcon component globally
|
|
42
|
+
|
|
43
|
+
app.mount('#app');
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### 3. Manual Registration:
|
|
47
|
+
You can also import and register individual components manually globally, or locally in each file that they'll be used in.
|
|
48
|
+
|
|
49
|
+
```javascript
|
|
50
|
+
// main.js/main.ts
|
|
51
|
+
import { createApp } from 'vue';
|
|
52
|
+
import App from './App.vue';
|
|
53
|
+
import { QstIcon } from 'vue-quest-ui';
|
|
54
|
+
|
|
55
|
+
const app = createApp(App);
|
|
56
|
+
|
|
57
|
+
// Manually register the QstIcon component
|
|
58
|
+
app.component('QstIcon', QstIcon);
|
|
59
|
+
|
|
60
|
+
app.mount('#app');
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
```javascript
|
|
64
|
+
// file for a component or page where the component will be used
|
|
65
|
+
import { QstIcon } from 'vue-quest-ui';
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
```html
|
|
69
|
+
<div>
|
|
70
|
+
<qst-icon icon="clarity:email-solid" />
|
|
71
|
+
</div>
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Styles
|
|
75
|
+
All the necessary styles for Vue Quest UI can be imported in your main.js file. Some components also include a color prop, which allows you to choose an accent color. By default, this uses the primary-color CSS variable. If you define the primary-color variable in your project, it will automatically apply to all components that use the color prop, so you won’t need to set it individually for each one.
|
|
76
|
+
|
|
77
|
+
```javascript
|
|
78
|
+
import 'vue-quest-ui/dist/vue-quest-ui.css';
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Configuration
|
|
82
|
+
Vue Quest UI requires iconify for the icons throughout the project. If it's not already installed, it will be installed alongside vue-quest-ui as a dependency.
|
|
83
|
+
|
|
84
|
+
All components can be customized based on your needs by passing props to them. Review the props available for each component below.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
|
|
96
104
|
|
|
97
105
|
|
|
98
106
|
## Components
|