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 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
- ## Configuration
75
- 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.
76
-
77
- All components can be customized based on your needs by passing props to them. Review the props available for each component below.
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