@apexara/ng-components 1.0.0 → 1.0.1
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 +395 -395
- package/fesm2022/apexara-ng-components-button.mjs +9 -9
- package/fesm2022/apexara-ng-components-button.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-carousel.mjs +6 -6
- package/fesm2022/apexara-ng-components-carousel.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-checkbox.mjs +9 -9
- package/fesm2022/apexara-ng-components-checkbox.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-chip.mjs +6 -6
- package/fesm2022/apexara-ng-components-chip.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-datepicker.mjs +51 -51
- package/fesm2022/apexara-ng-components-datepicker.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-dialog.mjs +7 -7
- package/fesm2022/apexara-ng-components-dialog.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-drawer.mjs +7 -7
- package/fesm2022/apexara-ng-components-drawer.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-expander.mjs +7 -7
- package/fesm2022/apexara-ng-components-expander.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-image.mjs +11 -11
- package/fesm2022/apexara-ng-components-image.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-input.mjs +12 -12
- package/fesm2022/apexara-ng-components-input.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-listbox.mjs +9 -9
- package/fesm2022/apexara-ng-components-listbox.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-radiobutton.mjs +9 -9
- package/fesm2022/apexara-ng-components-radiobutton.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-select.mjs +15 -15
- package/fesm2022/apexara-ng-components-select.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-services.mjs +7 -7
- package/fesm2022/apexara-ng-components-services.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-snackbar.mjs +20 -20
- package/fesm2022/apexara-ng-components-snackbar.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-table.mjs +36 -36
- package/fesm2022/apexara-ng-components-table.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-textarea.mjs +9 -9
- package/fesm2022/apexara-ng-components-textarea.mjs.map +1 -1
- package/fesm2022/apexara-ng-components-tooltip.mjs +9 -9
- package/fesm2022/apexara-ng-components-tooltip.mjs.map +1 -1
- package/package.json +1 -1
- package/types/apexara-ng-components-button.d.ts +7 -7
- package/types/apexara-ng-components-carousel.d.ts +4 -4
- package/types/apexara-ng-components-checkbox.d.ts +7 -7
- package/types/apexara-ng-components-chip.d.ts +4 -4
- package/types/apexara-ng-components-datepicker.d.ts +12 -12
- package/types/apexara-ng-components-dialog.d.ts +4 -4
- package/types/apexara-ng-components-drawer.d.ts +4 -4
- package/types/apexara-ng-components-expander.d.ts +4 -4
- package/types/apexara-ng-components-image.d.ts +8 -8
- package/types/apexara-ng-components-input.d.ts +9 -9
- package/types/apexara-ng-components-listbox.d.ts +12 -12
- package/types/apexara-ng-components-radiobutton.d.ts +11 -11
- package/types/apexara-ng-components-select.d.ts +13 -13
- package/types/apexara-ng-components-services.d.ts +4 -4
- package/types/apexara-ng-components-snackbar.d.ts +12 -12
- package/types/apexara-ng-components-table.d.ts +23 -23
- package/types/apexara-ng-components-textarea.d.ts +9 -9
- package/types/apexara-ng-components-tooltip.d.ts +5 -5
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ng-components
|
|
2
2
|
|
|
3
|
-
This package provides custom Angular UI components, developed and maintained by
|
|
3
|
+
This package provides custom Angular UI components, developed and maintained by APEX Soft LLC. <br>
|
|
4
4
|
Website: www.apexara.com
|
|
5
5
|
|
|
6
6
|
# Installation
|
|
@@ -11,38 +11,38 @@ npm install @apexara/ng-components
|
|
|
11
11
|
|
|
12
12
|
# Components
|
|
13
13
|
|
|
14
|
-
[🔽 Button](#
|
|
15
|
-
[🔽 Checkbox](#
|
|
16
|
-
[🔽 Chip](#
|
|
17
|
-
[🔽 Dialog](#
|
|
18
|
-
[🔽 Drawer](#
|
|
19
|
-
[🔽 Expander](#
|
|
20
|
-
[🔽 Image](#
|
|
21
|
-
[🔽 Input](#
|
|
22
|
-
[🔽 Listbox](#
|
|
23
|
-
[🔽 Radiobutton](#
|
|
24
|
-
[🔽 Select](#
|
|
25
|
-
[🔽 Datepicker](#
|
|
26
|
-
[🔽 Carousel](#
|
|
27
|
-
[🔽 Snackbar](#
|
|
28
|
-
[🔽 Table](#
|
|
29
|
-
[🔽 Textarea](#
|
|
30
|
-
[🔽 Tooltip](#
|
|
14
|
+
[🔽 Button](#apex-button-component) <br>
|
|
15
|
+
[🔽 Checkbox](#apex-checkbox-component) <br>
|
|
16
|
+
[🔽 Chip](#apex-checkbox-component) <br>
|
|
17
|
+
[🔽 Dialog](#apex-dialog-component) <br>
|
|
18
|
+
[🔽 Drawer](#apex-drawer-component) <br>
|
|
19
|
+
[🔽 Expander](#apex-expander-component) <br>
|
|
20
|
+
[🔽 Image](#apex-image-component) <br>
|
|
21
|
+
[🔽 Input](#apex-input-component) <br>
|
|
22
|
+
[🔽 Listbox](#apex-listbox-component) <br>
|
|
23
|
+
[🔽 Radiobutton](#apex-radio-button-component) <br>
|
|
24
|
+
[🔽 Select](#apex-select-component) <br>
|
|
25
|
+
[🔽 Datepicker](#apex-datepicker-component) <br>
|
|
26
|
+
[🔽 Carousel](#apex-carousel-component) <br>
|
|
27
|
+
[🔽 Snackbar](#apex-snackbar-service) <br>
|
|
28
|
+
[🔽 Table](#apex-table-component) <br>
|
|
29
|
+
[🔽 Textarea](#apex-textarea-component) <br>
|
|
30
|
+
[🔽 Tooltip](#apex-tooltip-component) <br>
|
|
31
31
|
|
|
32
32
|
|
|
33
33
|
-----------------------------------------------------------------
|
|
34
34
|
|
|
35
|
-
#
|
|
35
|
+
# APEX Button Component
|
|
36
36
|
A simple button
|
|
37
37
|
|
|
38
38
|
## Usage
|
|
39
39
|
>**`parent.component.ts`**
|
|
40
40
|
>```typescript
|
|
41
|
-
>import {
|
|
41
|
+
>import { ApexButtonComponent }
|
|
42
42
|
>from '@apexara/ng-components/button';
|
|
43
43
|
>
|
|
44
44
|
>@Component({
|
|
45
|
-
> imports: [
|
|
45
|
+
> imports: [ ApexButtonComponent ]
|
|
46
46
|
>})
|
|
47
47
|
>
|
|
48
48
|
>export class ButtonExampleComponent {
|
|
@@ -59,7 +59,7 @@ A simple button
|
|
|
59
59
|
>```
|
|
60
60
|
>**`parent.component.html`**
|
|
61
61
|
>```html
|
|
62
|
-
><
|
|
62
|
+
><apex-button
|
|
63
63
|
> [options]="{
|
|
64
64
|
> iconLeft: 'icon.svg',
|
|
65
65
|
> iconRight: 'icon.svg'
|
|
@@ -70,7 +70,7 @@ A simple button
|
|
|
70
70
|
> (focusChange)="handleFocusChange()"
|
|
71
71
|
> (clickChange)="handelClickChange()">
|
|
72
72
|
> Click here
|
|
73
|
-
></
|
|
73
|
+
></apex-button>
|
|
74
74
|
>```
|
|
75
75
|
|
|
76
76
|
### Inputs
|
|
@@ -82,34 +82,34 @@ A simple button
|
|
|
82
82
|
>event emitter to handle clicks
|
|
83
83
|
|
|
84
84
|
>#### focusChange
|
|
85
|
-
>event emitter to focus changes on the a tag inside the
|
|
85
|
+
>event emitter to focus changes on the a tag inside the apex-button
|
|
86
86
|
|
|
87
87
|
>#### link
|
|
88
88
|
>routerLink can be passed to for navigation
|
|
89
89
|
|
|
90
90
|
### CSS Variables
|
|
91
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
91
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-button:
|
|
92
92
|
>
|
|
93
93
|
>```css
|
|
94
|
-
>
|
|
94
|
+
>apex-button {
|
|
95
95
|
> /* Sizes: */
|
|
96
|
-
> --
|
|
96
|
+
> --apex-button-border-radius: 4px;
|
|
97
97
|
>
|
|
98
98
|
> /* Focus outline */
|
|
99
|
-
> --
|
|
99
|
+
> --apex-button-focus-outline: 2px solid #F96138;
|
|
100
100
|
>
|
|
101
101
|
> /* Colors, Fills, Strokes: */
|
|
102
|
-
> --
|
|
102
|
+
> --apex-button-disabled-background-color: #E7E7E7;
|
|
103
103
|
>
|
|
104
|
-
> --
|
|
105
|
-
> --
|
|
104
|
+
> --apex-button-left-svg-fill: #FFFFFF;
|
|
105
|
+
> --apex-button-left-svg-stroke: #FFFFFF00;
|
|
106
106
|
>
|
|
107
|
-
> --
|
|
108
|
-
> --
|
|
107
|
+
> --apex-button-right-svg-fill: #FFFFFF;
|
|
108
|
+
> --apex-button-right-svg-fill: #FFFFFF00;
|
|
109
109
|
>
|
|
110
|
-
> --
|
|
111
|
-
> --
|
|
112
|
-
> --
|
|
110
|
+
> --apex-button-text-color: #FFFFFF;
|
|
111
|
+
> --apex-button-border-color: none;
|
|
112
|
+
> --apex-button-background-color: #0B1222;
|
|
113
113
|
>
|
|
114
114
|
>/* Note: When you want to setup the color of your icon
|
|
115
115
|
> you should experiment with both these variables or consider
|
|
@@ -121,18 +121,18 @@ A simple button
|
|
|
121
121
|
|
|
122
122
|
-----------------------------------------------------------------
|
|
123
123
|
|
|
124
|
-
#
|
|
124
|
+
# APEX Checkbox Component
|
|
125
125
|
A simple checkbox that can project content, be used with FormGroup and have a tooltip displayed
|
|
126
|
-
with a
|
|
126
|
+
with a APEX Tooltip.
|
|
127
127
|
|
|
128
128
|
## Usage
|
|
129
129
|
>**`parent.component.ts`**
|
|
130
130
|
>```typescript
|
|
131
|
-
>import {
|
|
131
|
+
>import { ApexCheckboxComponent, ApexCheckboxOptions }
|
|
132
132
|
>from '@apexara/ng-components/checkbox';
|
|
133
133
|
>
|
|
134
134
|
>@Component({
|
|
135
|
-
> imports: [
|
|
135
|
+
> imports: [ ApexCheckboxComponent ]
|
|
136
136
|
>})
|
|
137
137
|
>
|
|
138
138
|
>export class CheckboxExampleComponent {
|
|
@@ -141,7 +141,7 @@ with a IPI Tooltip.
|
|
|
141
141
|
> checkboxControl: [false, [Validators.required]],
|
|
142
142
|
> });
|
|
143
143
|
>
|
|
144
|
-
> public checkboxOptions:
|
|
144
|
+
> public checkboxOptions: ApexCheckboxOptions = {
|
|
145
145
|
> formGroup: this.formGroup,
|
|
146
146
|
> formControlName: 'checkboxControl',
|
|
147
147
|
> }
|
|
@@ -150,12 +150,12 @@ with a IPI Tooltip.
|
|
|
150
150
|
>```
|
|
151
151
|
>**`parent.component.html`**
|
|
152
152
|
>```html
|
|
153
|
-
><
|
|
153
|
+
><apex-checkbox
|
|
154
154
|
> [checked]="true"
|
|
155
155
|
> [disabled]="false"
|
|
156
156
|
> [options]="checkboxOptions"
|
|
157
157
|
> [tooltip]="'example tooltip text'">
|
|
158
|
-
></
|
|
158
|
+
></apex-checkbox>
|
|
159
159
|
>
|
|
160
160
|
>```
|
|
161
161
|
### Inputs
|
|
@@ -170,32 +170,32 @@ with a IPI Tooltip.
|
|
|
170
170
|
>a text that if present triggers a tooltip component with it inside.
|
|
171
171
|
|
|
172
172
|
>#### formGroup
|
|
173
|
-
>Refference to the FormGroup that the
|
|
173
|
+
>Refference to the FormGroup that the apex-checkbox will handle
|
|
174
174
|
|
|
175
175
|
>#### formControlName
|
|
176
176
|
>Refference to the name of the control that we will access in the FormGroup
|
|
177
177
|
|
|
178
178
|
### CSS Variables
|
|
179
|
-
>Here are all the CSS variables (and their default values) you can set when using
|
|
179
|
+
>Here are all the CSS variables (and their default values) you can set when using apex-checkbox:
|
|
180
180
|
>
|
|
181
181
|
>```css
|
|
182
|
-
>
|
|
182
|
+
>apex-checkbox {
|
|
183
183
|
> /* Sizes */
|
|
184
|
-
> --
|
|
184
|
+
> --apex-checkbox-font-size: 14px;
|
|
185
185
|
>
|
|
186
186
|
> /* Colors, Fills, Strokes: */
|
|
187
|
-
> --
|
|
188
|
-
> --
|
|
189
|
-
> --
|
|
190
|
-
> --
|
|
187
|
+
> --apex-checkbox-background-color: #F7F8FB;
|
|
188
|
+
> --apex-checkbox-wrapper-border-color: transparent;
|
|
189
|
+
> --apex-checkbox-arrow-color: #FFFFFF;
|
|
190
|
+
> --apex-checkbox-tooltip-icon-stroke: #FFFFFF;
|
|
191
191
|
>
|
|
192
|
-
> --
|
|
193
|
-
> --
|
|
194
|
-
> --
|
|
192
|
+
> --apex-checkbox-border-color: #E9E9E9;
|
|
193
|
+
> --apex-checkbox-border-hover-color: #F96138;
|
|
194
|
+
> --apex-checkbox-outline-color: none;
|
|
195
195
|
>
|
|
196
196
|
> /* Other */
|
|
197
|
-
> --
|
|
198
|
-
> --
|
|
197
|
+
> --apex-checkbox-box-shadow-color: #F96138;
|
|
198
|
+
> --apex-checkbox-disabled-opacity: 0.5;
|
|
199
199
|
>}
|
|
200
200
|
>```
|
|
201
201
|
|
|
@@ -203,17 +203,17 @@ with a IPI Tooltip.
|
|
|
203
203
|
|
|
204
204
|
-----------------------------------------------------------------
|
|
205
205
|
|
|
206
|
-
#
|
|
206
|
+
# APEX Chip component
|
|
207
207
|
A simple visual container for displaying a text, state, etc.
|
|
208
208
|
|
|
209
209
|
## Usage
|
|
210
210
|
>**`parent.component.ts`**
|
|
211
211
|
>```typescript
|
|
212
|
-
>import {
|
|
212
|
+
>import { ApexChipComponent }
|
|
213
213
|
>from '@apexara/ng-components/chip';
|
|
214
214
|
>
|
|
215
215
|
>@Component({
|
|
216
|
-
> imports: [
|
|
216
|
+
> imports: [ ApexChipComponent ]
|
|
217
217
|
>})
|
|
218
218
|
>
|
|
219
219
|
>export class ChipExampleComponent { }
|
|
@@ -221,12 +221,12 @@ A simple visual container for displaying a text, state, etc.
|
|
|
221
221
|
>```
|
|
222
222
|
>**`parent.component.html`**
|
|
223
223
|
>```html
|
|
224
|
-
><
|
|
224
|
+
><apex-chip
|
|
225
225
|
> class="with-close-icon"
|
|
226
226
|
> [closeIcon]="true"
|
|
227
227
|
> (closeChange)="chipClose()">
|
|
228
228
|
> With Close Icon
|
|
229
|
-
></
|
|
229
|
+
></apex-chip>
|
|
230
230
|
>```
|
|
231
231
|
>
|
|
232
232
|
|
|
@@ -238,17 +238,17 @@ A simple visual container for displaying a text, state, etc.
|
|
|
238
238
|
>event emitter to handle clicks
|
|
239
239
|
|
|
240
240
|
### CSS Variables
|
|
241
|
-
>Here all the available CSS variables (and their default values) you can set when using
|
|
241
|
+
>Here all the available CSS variables (and their default values) you can set when using apex-chip:
|
|
242
242
|
>
|
|
243
243
|
>```css
|
|
244
|
-
>
|
|
244
|
+
>apex-chip {
|
|
245
245
|
> /* Sizes: */
|
|
246
|
-
> --
|
|
246
|
+
> --apex-chip-font-size: 12px;
|
|
247
247
|
>
|
|
248
248
|
> /* Colors, Fills, Strokes: */
|
|
249
|
-
> --
|
|
250
|
-
> --
|
|
251
|
-
> --
|
|
249
|
+
> --apex-chip-color: #FFFFFF;
|
|
250
|
+
> --apex-chip-background-color: #0B1222;
|
|
251
|
+
> --apex-chip-icon-color: #FFFFFF;
|
|
252
252
|
>}
|
|
253
253
|
>```
|
|
254
254
|
|
|
@@ -256,18 +256,18 @@ A simple visual container for displaying a text, state, etc.
|
|
|
256
256
|
|
|
257
257
|
-----------------------------------------------------------------
|
|
258
258
|
|
|
259
|
-
#
|
|
259
|
+
# APEX Dialog Component
|
|
260
260
|
Simple Dialog component with the option to project everything necessary - close icon, title, description, other content, actions.
|
|
261
261
|
The styling is only for the Dialog itself, the close icon, the title and the description. The content and the actions can be anything so their styling is up to the parent component
|
|
262
262
|
|
|
263
263
|
## Usage
|
|
264
264
|
>**`parent.component.ts`**
|
|
265
265
|
>```typescript
|
|
266
|
-
>import {
|
|
266
|
+
>import { ApexDialogComponent }
|
|
267
267
|
>from '@apexara/ng-components/dialog';
|
|
268
268
|
>
|
|
269
269
|
>@Component({
|
|
270
|
-
> imports: [
|
|
270
|
+
> imports: [ ApexDialogComponent ]
|
|
271
271
|
>})
|
|
272
272
|
>
|
|
273
273
|
>export class DialogExampleComponent { }
|
|
@@ -275,21 +275,21 @@ The styling is only for the Dialog itself, the close icon, the title and the des
|
|
|
275
275
|
>**`parent.component.html`**
|
|
276
276
|
>```html
|
|
277
277
|
>@if (shouldRender) {
|
|
278
|
-
> <
|
|
278
|
+
> <apex-dialog>
|
|
279
279
|
> <ng-template #title>Title Here</ng-template>
|
|
280
280
|
>
|
|
281
281
|
> <ng-template #description>Description Here</ng-template>
|
|
282
282
|
>
|
|
283
283
|
> <ng-template #content>
|
|
284
|
-
> <
|
|
284
|
+
> <apex-input [options]="{ label: 'Name' }"></apex-input>
|
|
285
285
|
> </ng-template>
|
|
286
286
|
>
|
|
287
287
|
> <ng-template #actions>
|
|
288
|
-
> <
|
|
288
|
+
> <apex-button (clickChange)="shouldRender = false">
|
|
289
289
|
> Cancel
|
|
290
|
-
> </
|
|
290
|
+
> </apex-button>
|
|
291
291
|
> </ng-template>
|
|
292
|
-
> </
|
|
292
|
+
> </apex-dialog>
|
|
293
293
|
>}
|
|
294
294
|
>```
|
|
295
295
|
|
|
@@ -313,14 +313,14 @@ The styling is only for the Dialog itself, the close icon, the title and the des
|
|
|
313
313
|
>**`parent.component.html`**
|
|
314
314
|
>```html
|
|
315
315
|
><ng-template #content>
|
|
316
|
-
> <
|
|
316
|
+
> <apex-input [options]="{ label: 'Name' }"></apex-input>
|
|
317
317
|
></ng-template>
|
|
318
318
|
>```
|
|
319
319
|
>
|
|
320
320
|
>**`parent.component.css`**
|
|
321
321
|
>```css
|
|
322
|
-
>
|
|
323
|
-
> --
|
|
322
|
+
>apex-input {
|
|
323
|
+
> --apex-input-error-color: red;
|
|
324
324
|
>}
|
|
325
325
|
>```
|
|
326
326
|
|
|
@@ -329,34 +329,34 @@ The styling is only for the Dialog itself, the close icon, the title and the des
|
|
|
329
329
|
>The Actions are projected with the Select=['actions']. All you need is an HTML element with 'actions' set. In example
|
|
330
330
|
>```html
|
|
331
331
|
><ng-template #actions>
|
|
332
|
-
> <
|
|
332
|
+
> <apex-button>Close</apex-button>
|
|
333
333
|
></ng-template>
|
|
334
334
|
>```
|
|
335
335
|
>**`parent.component.html`**
|
|
336
336
|
>Or with multiple actions:
|
|
337
337
|
>```html
|
|
338
338
|
><ng-template #actions>
|
|
339
|
-
> <
|
|
340
|
-
> <
|
|
339
|
+
> <apex-button (clickChange)="shouldRender = false">Close</apex-button>
|
|
340
|
+
> <apex-button (clickChange)="triggerAction()">Trigger Action</apex-button>
|
|
341
341
|
></ng-template>
|
|
342
342
|
>```
|
|
343
343
|
>Again, the styling of the buttons in this case should happen in the Parent component. You can group them in a div with 'display: flex'
|
|
344
344
|
|
|
345
345
|
### CSS Variables
|
|
346
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
346
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-dialog:
|
|
347
347
|
>
|
|
348
348
|
>```css
|
|
349
|
-
>
|
|
349
|
+
>apex-dialog {
|
|
350
350
|
> /* Sizes: */
|
|
351
|
-
> --
|
|
351
|
+
> --apex-dialog-max-width: 432px;
|
|
352
352
|
>
|
|
353
353
|
> /* Colors, Fills, Strokes: */
|
|
354
|
-
> --
|
|
355
|
-
> --
|
|
356
|
-
> --
|
|
357
|
-
> --
|
|
358
|
-
> --
|
|
359
|
-
> --
|
|
354
|
+
> --apex-dialog-backdrop-background: #0B1222;
|
|
355
|
+
> --apex-dialog-background: #FFFFFF;
|
|
356
|
+
> --apex-dialog-close-icon-color: #0B1222;
|
|
357
|
+
> --apex-dialog-close-icon-hover-color: #F96138;
|
|
358
|
+
> --apex-dialog-title-color: #0B1222;
|
|
359
|
+
> --apex-dialog-description-color: #5D6068;
|
|
360
360
|
>}
|
|
361
361
|
>```
|
|
362
362
|
|
|
@@ -364,18 +364,18 @@ The styling is only for the Dialog itself, the close icon, the title and the des
|
|
|
364
364
|
|
|
365
365
|
-----------------------------------------------------------------
|
|
366
366
|
|
|
367
|
-
#
|
|
367
|
+
# APEX Drawer Component
|
|
368
368
|
Simple Drawer component with the option to project everything necessary - title, description, content, actions.
|
|
369
369
|
The styling is only for the Drawer itself, the title and the description. The content and the actions can be anything so their styling is up to the parent component
|
|
370
370
|
|
|
371
371
|
## Usage
|
|
372
372
|
>**`parent.component.ts`**
|
|
373
373
|
>```typescript
|
|
374
|
-
>import {
|
|
374
|
+
>import { ApexDrawerComponent }
|
|
375
375
|
>from '@apexara/ng-components/drawer';
|
|
376
376
|
>
|
|
377
377
|
>@Component({
|
|
378
|
-
> imports: [
|
|
378
|
+
> imports: [ ApexDrawerComponent ]
|
|
379
379
|
>})
|
|
380
380
|
>
|
|
381
381
|
>export class DrawerExampleComponent { }
|
|
@@ -383,21 +383,21 @@ The styling is only for the Drawer itself, the title and the description. The co
|
|
|
383
383
|
>**`parent.component.html`**
|
|
384
384
|
>```html
|
|
385
385
|
>@if (shouldRender) {
|
|
386
|
-
> <
|
|
386
|
+
> <apex-drawer #drawer (clickChange)="shouldRender = false">
|
|
387
387
|
> <ng-template #title>Title Here</ng-template>
|
|
388
388
|
>
|
|
389
389
|
> <ng-template #description>Description Here</ng-template>
|
|
390
390
|
>
|
|
391
391
|
> <ng-template #content>
|
|
392
|
-
> <
|
|
392
|
+
> <apex-input [options]="{ label: 'Name' }"></apex-input>
|
|
393
393
|
> </ng-template>
|
|
394
394
|
>
|
|
395
395
|
> <ng-template #actions>
|
|
396
|
-
> <
|
|
396
|
+
> <apex-button (clickChange)="drawer.close()">
|
|
397
397
|
> Close
|
|
398
|
-
> </
|
|
398
|
+
> </apex-button>
|
|
399
399
|
> </ng-template>
|
|
400
|
-
> </
|
|
400
|
+
> </apex-drawer>
|
|
401
401
|
>}
|
|
402
402
|
>```
|
|
403
403
|
|
|
@@ -422,14 +422,14 @@ The styling is only for the Drawer itself, the title and the description. The co
|
|
|
422
422
|
>**`parent.component.html`**
|
|
423
423
|
>```html
|
|
424
424
|
><ng-template #content>
|
|
425
|
-
> <
|
|
425
|
+
> <apex-input [options]="{ label: 'Name' }"></apex-input>
|
|
426
426
|
></ng-template>
|
|
427
427
|
>```
|
|
428
428
|
>
|
|
429
429
|
>**`parent.component.css`**
|
|
430
430
|
>```css
|
|
431
|
-
>
|
|
432
|
-
> --
|
|
431
|
+
>apex-input {
|
|
432
|
+
> --apex-input-error-color: red;
|
|
433
433
|
>}
|
|
434
434
|
>```
|
|
435
435
|
|
|
@@ -438,33 +438,33 @@ The styling is only for the Drawer itself, the title and the description. The co
|
|
|
438
438
|
>The Actions are projected with the Select=['actions']. All you need is an HTML element with 'actions' set. In example
|
|
439
439
|
>```html
|
|
440
440
|
><ng-template #actions>
|
|
441
|
-
> <
|
|
441
|
+
> <apex-button>Close</apex-button>
|
|
442
442
|
></ng-template>
|
|
443
443
|
>```
|
|
444
444
|
>**`parent.component.html`**
|
|
445
445
|
>Or with multiple actions:
|
|
446
446
|
>```html
|
|
447
447
|
><ng-template #actions>
|
|
448
|
-
> <
|
|
449
|
-
> <
|
|
448
|
+
> <apex-button (clickChange)="triggerAction1()">Trigger Action 1</apex-button>
|
|
449
|
+
> <apex-button (clickChange)="triggerAction2()">Trigger Action 2</apex-button>
|
|
450
450
|
></ng-template>
|
|
451
451
|
>```
|
|
452
452
|
>Again, the styling of the buttons in this case should happen in the Parent component. You can group them in a div with 'display: flex'
|
|
453
453
|
|
|
454
454
|
### CSS Variables
|
|
455
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
455
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-drawer:
|
|
456
456
|
>
|
|
457
457
|
>```css
|
|
458
|
-
>
|
|
458
|
+
>apex-drawer {
|
|
459
459
|
> /* Sizes: */
|
|
460
|
-
> --
|
|
460
|
+
> --apex-drawer-width: 410px;
|
|
461
461
|
>
|
|
462
462
|
> /* Colors, Fills, Strokes: */
|
|
463
|
-
> --
|
|
464
|
-
> --
|
|
465
|
-
> --
|
|
466
|
-
> --
|
|
467
|
-
> --
|
|
463
|
+
> --apex-drawer-backdrop-background: #0B1222;
|
|
464
|
+
> --apex-drawer-background: #FFFFFF;
|
|
465
|
+
> --apex-drawer-title-color: #0B1222;
|
|
466
|
+
> --apex-drawer-description-color: #5D6068;
|
|
467
|
+
> --apex-drawer-box-shadow: 0px 4px 8px 0px #D6D6D635;
|
|
468
468
|
>}
|
|
469
469
|
>```
|
|
470
470
|
|
|
@@ -472,25 +472,25 @@ The styling is only for the Drawer itself, the title and the description. The co
|
|
|
472
472
|
|
|
473
473
|
-----------------------------------------------------------------
|
|
474
474
|
|
|
475
|
-
#
|
|
475
|
+
# APEX Expander Component
|
|
476
476
|
A simple component that has a title and and expanding option that displays additional text
|
|
477
477
|
by expanding horizontally.
|
|
478
478
|
|
|
479
479
|
## Usage
|
|
480
480
|
>**`parent.component.ts`**
|
|
481
481
|
>```typescript
|
|
482
|
-
>import {
|
|
482
|
+
>import { ApexExpanderComponent }
|
|
483
483
|
>from '@apexara/ng-components/expander';
|
|
484
484
|
>
|
|
485
485
|
>@Component({
|
|
486
|
-
> imports: [
|
|
486
|
+
> imports: [ ApexExpanderComponent ]
|
|
487
487
|
>})
|
|
488
488
|
>
|
|
489
489
|
>export class ExpanderExampleComponent { }
|
|
490
490
|
>```
|
|
491
491
|
>**`parent.component.html`**
|
|
492
492
|
>```html
|
|
493
|
-
><
|
|
493
|
+
><apex-expander [isOpen]="true">
|
|
494
494
|
> <ng-container title>
|
|
495
495
|
> With Variables
|
|
496
496
|
> </ng-container>
|
|
@@ -498,7 +498,7 @@ by expanding horizontally.
|
|
|
498
498
|
> <ng-container content>
|
|
499
499
|
> Lorem Ipsum is simply dummy text of the printing and typesetting industry.<br> Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.<br> It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged.
|
|
500
500
|
> </ng-container>
|
|
501
|
-
><
|
|
501
|
+
><apex-expander>
|
|
502
502
|
>
|
|
503
503
|
>```
|
|
504
504
|
|
|
@@ -511,22 +511,22 @@ by expanding horizontally.
|
|
|
511
511
|
>Set this to stop the content's height from going above a certain number (px).
|
|
512
512
|
|
|
513
513
|
### CSS Variables
|
|
514
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
514
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-expander:
|
|
515
515
|
>```css
|
|
516
|
-
>
|
|
516
|
+
>apex-expander {
|
|
517
517
|
> /* Sizes: */
|
|
518
|
-
> --
|
|
518
|
+
> --apex-expander-border: 0px;
|
|
519
519
|
>
|
|
520
520
|
> /* Colors, Fills, Strokes: */
|
|
521
|
-
> --
|
|
522
|
-
> --
|
|
523
|
-
> --
|
|
524
|
-
> --
|
|
525
|
-
> --
|
|
521
|
+
> --apex-expander-background-color: #FFFFFF;
|
|
522
|
+
> --apex-expander-title-color: #0B1222;
|
|
523
|
+
> --apex-expander-content-color: #5D6068;
|
|
524
|
+
> --apex-expander-chevron-color: #5D6068;
|
|
525
|
+
> --apex-expander-chevron-open-color: #F96138;
|
|
526
526
|
>
|
|
527
|
-
> --
|
|
527
|
+
> --apex-expander-outline-color: none;
|
|
528
528
|
> /* Other */
|
|
529
|
-
> --
|
|
529
|
+
> --apex-expander-box-shadow: 0px 4px 8px 0px rgba(214, 214, 214, 0.35);
|
|
530
530
|
>}
|
|
531
531
|
>```
|
|
532
532
|
|
|
@@ -534,17 +534,17 @@ by expanding horizontally.
|
|
|
534
534
|
|
|
535
535
|
-----------------------------------------------------------------
|
|
536
536
|
|
|
537
|
-
#
|
|
537
|
+
# APEX Image Component
|
|
538
538
|
An image component that fetches an asset and displays it.
|
|
539
539
|
|
|
540
540
|
## Usage
|
|
541
541
|
>**`parent.component.ts`**
|
|
542
542
|
>```typescript
|
|
543
|
-
>import {
|
|
543
|
+
>import { ApexIconComponent }
|
|
544
544
|
>from '@apexara/ng-components/image';
|
|
545
545
|
>
|
|
546
546
|
>@Component({
|
|
547
|
-
> imports: [
|
|
547
|
+
> imports: [ ApexIconComponent ]
|
|
548
548
|
>})
|
|
549
549
|
>
|
|
550
550
|
>export class IconExampleComponent { }
|
|
@@ -554,10 +554,10 @@ An image component that fetches an asset and displays it.
|
|
|
554
554
|
>**`parent.component.html`**
|
|
555
555
|
>```html
|
|
556
556
|
>
|
|
557
|
-
><
|
|
557
|
+
><apex-img
|
|
558
558
|
> [src]="assets/img/example.svg"
|
|
559
559
|
> [ariaLabel]="Example aria label for icon.">
|
|
560
|
-
></
|
|
560
|
+
></apex-img>
|
|
561
561
|
>
|
|
562
562
|
>```
|
|
563
563
|
|
|
@@ -572,18 +572,18 @@ An image component that fetches an asset and displays it.
|
|
|
572
572
|
|
|
573
573
|
-----------------------------------------------------------------
|
|
574
574
|
|
|
575
|
-
#
|
|
575
|
+
# APEX Input Component
|
|
576
576
|
A Simple input field that handles formGroup, outputs validation errors, has helper messages and infos,
|
|
577
577
|
emits click events on customizable icons that can be used to handle input changes.
|
|
578
578
|
|
|
579
579
|
## Usage
|
|
580
580
|
>**`parent.component.ts`**
|
|
581
581
|
>```typescript
|
|
582
|
-
>import {
|
|
582
|
+
>import { ApexInputComponent, ApexInputOptions }
|
|
583
583
|
>from '@apexara/ng-components/input';
|
|
584
584
|
>
|
|
585
585
|
>@Component({
|
|
586
|
-
> imports: [
|
|
586
|
+
> imports: [ ApexInputComponent ]
|
|
587
587
|
>})
|
|
588
588
|
>
|
|
589
589
|
>export class InputExampleComponent {
|
|
@@ -614,8 +614,8 @@ emits click events on customizable icons that can be used to handle input change
|
|
|
614
614
|
>```
|
|
615
615
|
>**`parent.component.html`**
|
|
616
616
|
>```html
|
|
617
|
-
><
|
|
618
|
-
></
|
|
617
|
+
><apex-input [options]="inputOptions">
|
|
618
|
+
></apex-input>
|
|
619
619
|
>
|
|
620
620
|
>```
|
|
621
621
|
|
|
@@ -643,7 +643,7 @@ emits click events on customizable icons that can be used to handle input change
|
|
|
643
643
|
>suffixImg also emits event on clicks enabling additional logic to be added.
|
|
644
644
|
|
|
645
645
|
>#### formGroup
|
|
646
|
-
>Refference to the FormGroup that the
|
|
646
|
+
>Refference to the FormGroup that the apex-input will handle
|
|
647
647
|
|
|
648
648
|
>#### formControlName
|
|
649
649
|
>Refference to the name of the control that we will access in the FormGroup
|
|
@@ -653,39 +653,39 @@ emits click events on customizable icons that can be used to handle input change
|
|
|
653
653
|
>the input Control has the error.
|
|
654
654
|
|
|
655
655
|
### CSS Variables
|
|
656
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
656
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-input:
|
|
657
657
|
>```css
|
|
658
|
-
>
|
|
658
|
+
>apex-input {
|
|
659
659
|
> /* Colors, Fills, Strokes: */
|
|
660
|
-
> --
|
|
661
|
-
> --
|
|
662
|
-
> --
|
|
660
|
+
> --apex-input-header-color: #0B1222;
|
|
661
|
+
> --apex-input-placeholder-color: #0B1222;
|
|
662
|
+
> --apex-input-text-color: #0B1222;
|
|
663
663
|
>
|
|
664
664
|
> /* when there are validator errors we make the text pop-up underneath and change its color */
|
|
665
|
-
> --
|
|
666
|
-
> --
|
|
665
|
+
> --apex-input-error-color: #F96138;
|
|
666
|
+
> --apex-input-border-error-width: 1px;
|
|
667
667
|
>
|
|
668
668
|
> /* Tooltip icon styling */
|
|
669
|
-
> --
|
|
670
|
-
> --
|
|
669
|
+
> --apex-input-tooltip-icon-fill: transparent;
|
|
670
|
+
> --apex-input-tooltip-icon-stroke: #C6C6C6;
|
|
671
671
|
>
|
|
672
672
|
> /* on all validators passed we make the text with this color */
|
|
673
|
-
> --
|
|
674
|
-
> --
|
|
675
|
-
> --
|
|
676
|
-
> --
|
|
673
|
+
> --apex-input-success-color: #14BD6C;
|
|
674
|
+
> --apex-input-border-color: #E9E9E9;
|
|
675
|
+
> --apex-input-border-width: 1px;
|
|
676
|
+
> --apex-input-value-color: #0B1222;
|
|
677
677
|
>
|
|
678
678
|
> /* Left icon fill & stroke : */
|
|
679
|
-
> `--
|
|
680
|
-
> `--
|
|
679
|
+
> `--apex-input-icon-left-fill: #FFFFFF;
|
|
680
|
+
> `--apex-input-icon-left-stroke: transparent;
|
|
681
681
|
>
|
|
682
682
|
> /* Right icon fill & stroke: */
|
|
683
|
-
> --
|
|
684
|
-
> --
|
|
683
|
+
> --apex-input-icon-right-fill: #FFFFFF;
|
|
684
|
+
> --apex-input-icon-right-stroke: transparent;
|
|
685
685
|
>
|
|
686
686
|
> /* Info icon (the one ot top with the label) fill & stroke */
|
|
687
|
-
> `--
|
|
688
|
-
> `--
|
|
687
|
+
> `--apex-input-icon-info-fill: #FFFFFF;
|
|
688
|
+
> `--apex-input-icon-info-stroke: transparent;
|
|
689
689
|
>
|
|
690
690
|
>/* Note: When you want to setup the color of your icon
|
|
691
691
|
> you should experiment with both these variables or consider
|
|
@@ -697,17 +697,17 @@ emits click events on customizable icons that can be used to handle input change
|
|
|
697
697
|
|
|
698
698
|
-----------------------------------------------------------------
|
|
699
699
|
|
|
700
|
-
#
|
|
701
|
-
|
|
700
|
+
# APEX Listbox Component
|
|
701
|
+
APEX Listbox provides selectable options in a list format.
|
|
702
702
|
|
|
703
703
|
## Usage
|
|
704
704
|
>**`parent.component.ts`**
|
|
705
705
|
>```typescript
|
|
706
|
-
>import {
|
|
706
|
+
>import { ApexListboxComponent, ApexListboxOptions }
|
|
707
707
|
>from '@apexara/ng-components/listbox';
|
|
708
708
|
>
|
|
709
709
|
>@Component({
|
|
710
|
-
> imports: [
|
|
710
|
+
> imports: [ ApexListboxComponent ]
|
|
711
711
|
>})
|
|
712
712
|
>
|
|
713
713
|
>export class ListboxExampleComponent {
|
|
@@ -739,10 +739,10 @@ IPI Listbox provides selectable options in a list format.
|
|
|
739
739
|
>**`parent.component.html`**
|
|
740
740
|
>```html
|
|
741
741
|
>
|
|
742
|
-
><
|
|
742
|
+
><apex-listbox
|
|
743
743
|
> [options]="listboxOptions"
|
|
744
744
|
> (selectChange)="$event">
|
|
745
|
-
></
|
|
745
|
+
></apex-listbox>
|
|
746
746
|
>
|
|
747
747
|
>```
|
|
748
748
|
|
|
@@ -752,30 +752,30 @@ IPI Listbox provides selectable options in a list format.
|
|
|
752
752
|
>Label above the listbox container.
|
|
753
753
|
|
|
754
754
|
>#### formGroup
|
|
755
|
-
>Refference to the FormGroup that the
|
|
755
|
+
>Refference to the FormGroup that the apex-listbox will handle a specific control
|
|
756
756
|
|
|
757
757
|
>#### formControlName
|
|
758
758
|
>Refference to the name of the control that we will access in the FormGroup
|
|
759
759
|
|
|
760
760
|
### CSS Variables
|
|
761
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
761
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-listbox:
|
|
762
762
|
|
|
763
763
|
>```css
|
|
764
|
-
>
|
|
764
|
+
>apex-listbox {
|
|
765
765
|
> /* Colors, Fills, Strokes: */
|
|
766
|
-
> --
|
|
767
|
-
> --
|
|
766
|
+
> --apex-listbox-label-color: default;
|
|
767
|
+
> --apex-listbox-background-color: #FFFFFF;
|
|
768
768
|
>
|
|
769
|
-
> --
|
|
770
|
-
> --
|
|
769
|
+
> --apex-listbox-item-color: #00000099;
|
|
770
|
+
> --apex-listbox-item-selected-color: #F96138;
|
|
771
771
|
>
|
|
772
772
|
> /* Border */
|
|
773
|
-
> --
|
|
774
|
-
> --
|
|
773
|
+
> --apex-listbox-border-color: #F2F2F2;
|
|
774
|
+
> --apex-listbox-border-hovor-color: #4B5368;
|
|
775
775
|
>
|
|
776
776
|
> /* Tooltip icon styling */
|
|
777
|
-
> --
|
|
778
|
-
> --
|
|
777
|
+
> --apex-listbox-tooltip-icon-fill: transparent;
|
|
778
|
+
> --apex-listbox-tooltip-icon-stroke: #C6C6C6;
|
|
779
779
|
>
|
|
780
780
|
>/* Note: When you want to setup the color of the icon you
|
|
781
781
|
> should experiment with both these variables >(fill&stroke)
|
|
@@ -787,34 +787,34 @@ IPI Listbox provides selectable options in a list format.
|
|
|
787
787
|
|
|
788
788
|
-----------------------------------------------------------------
|
|
789
789
|
|
|
790
|
-
#
|
|
790
|
+
# APEX Radio-button Component
|
|
791
791
|
Simple styled radio-button that can accept a formGroup and a control.
|
|
792
792
|
|
|
793
793
|
## Usage
|
|
794
794
|
>**`parent.component.html`**
|
|
795
795
|
>```html
|
|
796
|
-
><
|
|
796
|
+
><apex-radio-button
|
|
797
797
|
> [options]="{
|
|
798
798
|
> data: [dataOptionOne, dataOptionTwo],
|
|
799
799
|
> inline: true
|
|
800
800
|
> formGroup: formGroup
|
|
801
801
|
> formControlName: formGroup.controls[controlName]
|
|
802
802
|
> }">
|
|
803
|
-
></
|
|
803
|
+
></apex-radio-button>
|
|
804
804
|
>
|
|
805
|
-
><
|
|
805
|
+
><apex-radio-button
|
|
806
806
|
> [options]="{
|
|
807
807
|
> checked: 1
|
|
808
808
|
> data: [dataOptionsOne, dataOptionTwo]
|
|
809
809
|
> }"
|
|
810
810
|
> (selectChange)="handleChange($event)">
|
|
811
|
-
></
|
|
811
|
+
></apex-radio-button>
|
|
812
812
|
>```
|
|
813
813
|
|
|
814
814
|
### Inputs
|
|
815
815
|
|
|
816
816
|
>#### data
|
|
817
|
-
>Array of elements of type
|
|
817
|
+
>Array of elements of type ApexRadioData
|
|
818
818
|
|
|
819
819
|
>#### inline
|
|
820
820
|
>Property that sets the flex-direction to row instead of column(default)
|
|
@@ -830,22 +830,22 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
830
830
|
>Refference to the name of the control that we will access in the FormGroup
|
|
831
831
|
|
|
832
832
|
### CSS Variables
|
|
833
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
833
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-radio-button:
|
|
834
834
|
|
|
835
835
|
>```css
|
|
836
|
-
>
|
|
837
|
-
> --
|
|
836
|
+
>apex-radio-button {
|
|
837
|
+
> --apex-radio-button-background-color: #FFFFFF;
|
|
838
838
|
>
|
|
839
|
-
> --
|
|
839
|
+
> --apex-radio-button-text-color: #5D6068;
|
|
840
840
|
>
|
|
841
|
-
> --
|
|
842
|
-
> --
|
|
843
|
-
> --
|
|
841
|
+
> --apex-radio-button-unchecked-border-color: #E9E9E9;
|
|
842
|
+
> --apex-radio-button-checked-border-color: #F96138;
|
|
843
|
+
> --apex-radio-button-disabled-border-color: #E7E7E7;
|
|
844
844
|
>
|
|
845
|
-
> --
|
|
845
|
+
> --apex-radio-button-outline-color: none;
|
|
846
846
|
>
|
|
847
|
-
> --
|
|
848
|
-
> --
|
|
847
|
+
> --apex-radio-button-tooltip-icon-fill: transparent;
|
|
848
|
+
> --apex-radio-button-tooltip-icon-stroke: #C6C6C6;
|
|
849
849
|
>}
|
|
850
850
|
>```
|
|
851
851
|
|
|
@@ -853,16 +853,16 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
853
853
|
|
|
854
854
|
-----------------------------------------------------------------
|
|
855
855
|
|
|
856
|
-
#
|
|
856
|
+
# APEX Select Component
|
|
857
857
|
|
|
858
858
|
## Usage
|
|
859
859
|
>**`parent.component.ts`**
|
|
860
860
|
>```typescript
|
|
861
|
-
>import {
|
|
861
|
+
>import { ApexSelectComponent, ApexSelectOptions }
|
|
862
862
|
>from '@apexara/ng-components/select';
|
|
863
863
|
>
|
|
864
864
|
>@Component({
|
|
865
|
-
> imports: [
|
|
865
|
+
> imports: [ ApexSelectComponent ],
|
|
866
866
|
>})
|
|
867
867
|
>
|
|
868
868
|
>export class SelectExampleComponent {
|
|
@@ -875,7 +875,7 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
875
875
|
> // bind any logic to select change or helperText click
|
|
876
876
|
> }
|
|
877
877
|
>
|
|
878
|
-
> public selectOptions:
|
|
878
|
+
> public selectOptions: ApexSelectOptions = {
|
|
879
879
|
> label: 'Example label',
|
|
880
880
|
> data: [
|
|
881
881
|
> { label: 'Any string', value: any },
|
|
@@ -900,74 +900,74 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
900
900
|
>**`parent.component.html`**
|
|
901
901
|
>```html
|
|
902
902
|
>
|
|
903
|
-
><
|
|
903
|
+
><apex-select
|
|
904
904
|
> [options]='selectOptions'
|
|
905
905
|
> (selectChange)='execute()'
|
|
906
906
|
> (helperTextChange)='execute()'>
|
|
907
|
-
><
|
|
907
|
+
><apex-select>
|
|
908
908
|
>```
|
|
909
909
|
|
|
910
910
|
### CSS Variables
|
|
911
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
911
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-select:
|
|
912
912
|
>```css
|
|
913
|
-
>
|
|
913
|
+
>apex-select {
|
|
914
914
|
> /* Dropdown styling */
|
|
915
|
-
> --
|
|
915
|
+
> --apex-select-dropdown-box-shadow: none;
|
|
916
916
|
>
|
|
917
917
|
> /* Input styling */
|
|
918
|
-
> --
|
|
919
|
-
> --
|
|
920
|
-
> --
|
|
918
|
+
> --apex-select-input-text-color: #0B1222;
|
|
919
|
+
> --apex-select-input-text-selected-color: #F96138;
|
|
920
|
+
> --apex-select-input-placeholder-color: #0B1222;
|
|
921
921
|
>
|
|
922
922
|
> /* Chip styling (used on searchable multiple options) */
|
|
923
|
-
> --
|
|
924
|
-
> --
|
|
925
|
-
> --
|
|
926
|
-
> --
|
|
923
|
+
> --apex-select-chip-font-size: 10px;
|
|
924
|
+
> --apex-select-chip-color: #FFFFFF;
|
|
925
|
+
> --apex-select-chip-background-color: #0B1222;
|
|
926
|
+
> --apex-select-chip-icon-color; #FFFFFF;
|
|
927
927
|
>
|
|
928
928
|
> /* tooltip icon styling */
|
|
929
|
-
> --
|
|
930
|
-
> --
|
|
929
|
+
> --apex-select-tooltip-icon-fill: transparent;
|
|
930
|
+
> --apex-input-tooltip-icon-stroke: #C6C6C6;
|
|
931
931
|
>
|
|
932
932
|
> /* Prefix icon styling */
|
|
933
|
-
> --
|
|
934
|
-
> --
|
|
933
|
+
> --apex-select-icon-prefix-fill: #C6C6C6;
|
|
934
|
+
> --apex-select-icon-prefix-stroke: transparent;
|
|
935
935
|
>
|
|
936
936
|
> /* Background color of the input element inside the select */
|
|
937
|
-
> --
|
|
937
|
+
> --apex-select-input-background-color: #FFFFFF00;
|
|
938
938
|
>
|
|
939
939
|
> /* Border color of the input element inside the select */
|
|
940
|
-
> --
|
|
941
|
-
> --
|
|
940
|
+
> --apex-select-input-border-color: #E9E9E9;
|
|
941
|
+
> --apex-select-input-border-width: 1px;
|
|
942
942
|
>
|
|
943
943
|
> /* Options divider color */
|
|
944
|
-
> --
|
|
945
|
-
> --
|
|
944
|
+
> --apex-select-options-divider-color: #E9E9E9;
|
|
945
|
+
> --apex-select-options-divider-height: 1px;
|
|
946
946
|
>
|
|
947
947
|
> /* Border color on hover */
|
|
948
|
-
> --
|
|
948
|
+
> --apex-select-input-border-hover-color: #4B5368;
|
|
949
949
|
>
|
|
950
950
|
> /* Border color on disabled */
|
|
951
|
-
> --
|
|
951
|
+
> --apex-select-input-border-disabled-color: #F2F2F2;
|
|
952
952
|
>
|
|
953
953
|
> /* Border and text color for when Select is invalid */
|
|
954
|
-
> --
|
|
955
|
-
> --
|
|
954
|
+
> --apex-select-invalid-color: #F96138;
|
|
955
|
+
> --apex-select-invalid-border-width: 1px;
|
|
956
956
|
>
|
|
957
957
|
> /* Arrow: */
|
|
958
|
-
> --
|
|
959
|
-
> --
|
|
958
|
+
> --apex-select-arrow-color: #5D6068;
|
|
959
|
+
> --apex-select-arrow-checked-color: #F96138;
|
|
960
960
|
>
|
|
961
961
|
> /* Header: */
|
|
962
|
-
> --
|
|
963
|
-
> --
|
|
962
|
+
> --apex-select-header-color: #0B1222;
|
|
963
|
+
> --apex-select-helper-text-color: #5D6068;
|
|
964
964
|
>
|
|
965
965
|
> /* if type table */
|
|
966
|
-
> --
|
|
966
|
+
> --apex-select-input-table-color: #5D6068;
|
|
967
967
|
>
|
|
968
968
|
> /* Dropdown: */
|
|
969
|
-
> --
|
|
970
|
-
> --
|
|
969
|
+
> --apex-select-dropdown-border-color: #E9E9E9;
|
|
970
|
+
> --apex-select-dropdown-background-color: #FFFFFF;
|
|
971
971
|
>
|
|
972
972
|
>/* Note: When you want to setup the color of your icon
|
|
973
973
|
> you should experiment with both these variables or consider
|
|
@@ -979,15 +979,15 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
979
979
|
|
|
980
980
|
-----------------------------------------------------------------
|
|
981
981
|
|
|
982
|
-
#
|
|
982
|
+
# APEX Datepicker Component
|
|
983
983
|
## Usage
|
|
984
984
|
>**`parent.component.ts`**
|
|
985
985
|
>```typescript
|
|
986
|
-
>import {
|
|
986
|
+
>import { ApexDatepickerComponent, ApexDatepickerOptions }
|
|
987
987
|
>from '@apexara/ng-components/datepicker';
|
|
988
988
|
>
|
|
989
989
|
>@Component({
|
|
990
|
-
> imports: [
|
|
990
|
+
> imports: [ ApexDatepickerComponent ],
|
|
991
991
|
>})
|
|
992
992
|
>
|
|
993
993
|
>export class DatepickerExampleComponent {
|
|
@@ -1024,16 +1024,16 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
1024
1024
|
>```
|
|
1025
1025
|
>**`parent.component.html`**
|
|
1026
1026
|
>```html
|
|
1027
|
-
> <
|
|
1027
|
+
> <apex-datepicker [options]="rangeDateOptions"></apex-datepicker>
|
|
1028
1028
|
>
|
|
1029
|
-
> <
|
|
1029
|
+
> <apex-datepicker [options]="singleDateOptions"></apex-datepicker>
|
|
1030
1030
|
>```
|
|
1031
1031
|
|
|
1032
1032
|
### Inputs
|
|
1033
1033
|
>
|
|
1034
1034
|
>
|
|
1035
1035
|
>#### options
|
|
1036
|
-
>Options are of type
|
|
1036
|
+
>Options are of type ApexDatepickerOptions with the following properties:
|
|
1037
1037
|
>
|
|
1038
1038
|
> label - string - used for how long the snackbar should be displayed
|
|
1039
1039
|
>
|
|
@@ -1050,92 +1050,92 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
1050
1050
|
> the input Control has the error.
|
|
1051
1051
|
>
|
|
1052
1052
|
### CSS Variables
|
|
1053
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
1053
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-datepicker:
|
|
1054
1054
|
>```css
|
|
1055
|
-
>
|
|
1055
|
+
>apex-datepicker {
|
|
1056
1056
|
>
|
|
1057
1057
|
> /* Picker variables */
|
|
1058
|
-
> --
|
|
1059
|
-
> --
|
|
1060
|
-
> --
|
|
1058
|
+
> --apex-datepicker-svg-background-color:#FF7955;
|
|
1059
|
+
> --apex-datepicker-border: 1px solid #E9E9E9;
|
|
1060
|
+
> --apex-datepicker-border-hover-color: #FF7955;
|
|
1061
1061
|
>
|
|
1062
|
-
> --
|
|
1063
|
-
> --
|
|
1062
|
+
> --apex-datepicker-error-color: #F96138;
|
|
1063
|
+
> --apex-datepicker-svg-fill-color #FFFFFF;
|
|
1064
1064
|
>
|
|
1065
|
-
> --
|
|
1065
|
+
> --apex-datepicker-svg-background-hover-color: #F96138;
|
|
1066
1066
|
>
|
|
1067
|
-
> --
|
|
1067
|
+
> --apex-datepicker-input-color: #0B1222;
|
|
1068
1068
|
>
|
|
1069
|
-
> --
|
|
1069
|
+
> --apex-datepicker-header-text-color: #FF7955;
|
|
1070
1070
|
>
|
|
1071
|
-
> --
|
|
1071
|
+
> --apex-calendar-background-color: #FFFFFF;
|
|
1072
1072
|
>
|
|
1073
|
-
> --
|
|
1073
|
+
> --apex-calendar-box-shadow: 0px 2px 4px -1px rgba(0, 0, 0, 0.2), 0px 4px 5px 0px rgba(0, 0, 0, 0.14), 0px 1px 10px 0px rgba(0, 0, 0, 0.12);
|
|
1074
1074
|
>
|
|
1075
|
-
> --
|
|
1075
|
+
> --apex-calendar-header-active-date-view-focus-color: #FFFFFF;
|
|
1076
1076
|
>
|
|
1077
|
-
> --
|
|
1077
|
+
> --apex-calendar-header-active-date-view-focus-background-color: #FF7955;
|
|
1078
1078
|
>
|
|
1079
|
-
> --
|
|
1079
|
+
> --apex-calendar-header-active-date-view-hover-color: #FFFFFF;
|
|
1080
1080
|
>
|
|
1081
|
-
> --
|
|
1081
|
+
> --apex-calendar-header-active-date-view-hover-background-color: #FF7955;
|
|
1082
1082
|
>
|
|
1083
|
-
> --
|
|
1083
|
+
> --apex-calendar-header-chevron-hover-focus-color: #FFFFFF;
|
|
1084
1084
|
>
|
|
1085
|
-
> --
|
|
1085
|
+
> --apex-calendar-header-chevron-hover-focus-background-color: #FF7955;
|
|
1086
1086
|
>
|
|
1087
|
-
> --
|
|
1087
|
+
> --apex-calendar-header-chevron-disabled-color: #5D6068;
|
|
1088
1088
|
>
|
|
1089
|
-
> --
|
|
1089
|
+
> --apex-calendar-month-view-table-header-color: #C6C6C6;
|
|
1090
1090
|
>
|
|
1091
|
-
> --
|
|
1091
|
+
> --apex-calendar-month-view-table-header-border-bottom-color: #C6C6C6;
|
|
1092
1092
|
>
|
|
1093
|
-
> --
|
|
1093
|
+
> --apex-calendar-multi-year-view-table-header-border-bottom-color: #C6C6C6;
|
|
1094
1094
|
>
|
|
1095
|
-
> --
|
|
1095
|
+
> --apex-calendar-year-view-table-header-border-bottom-color: #C6C6C6;
|
|
1096
1096
|
>
|
|
1097
|
-
> --
|
|
1097
|
+
> --apex-calendar-body-cell-color: #0B1222;
|
|
1098
1098
|
>
|
|
1099
|
-
> --
|
|
1099
|
+
> --apex-calendar-body-cell-background-color: none;
|
|
1100
1100
|
>
|
|
1101
|
-
> --
|
|
1101
|
+
> --apex-calendar-body-cell-border: none;
|
|
1102
1102
|
>
|
|
1103
|
-
> --
|
|
1103
|
+
> --apex-calendar-body-cell-hover-color: white;
|
|
1104
1104
|
>
|
|
1105
|
-
> --
|
|
1105
|
+
> --apex-calendar-body-cell-hover-background-color: #FFD2C6;
|
|
1106
1106
|
>
|
|
1107
|
-
> --
|
|
1107
|
+
> --apex-calendar-body-today-cell-border: #FFD2C6;
|
|
1108
1108
|
>
|
|
1109
|
-
> --
|
|
1110
|
-
> --
|
|
1111
|
-
> --
|
|
1112
|
-
> --
|
|
1113
|
-
> --
|
|
1109
|
+
> --apex-calendar-body-active-cell-background-color: #f9613880;
|
|
1110
|
+
> --apex-calendar-body-cell-selected-color: #FFFFFF;
|
|
1111
|
+
> --apex-calendar-body-cell-selected-background-color: #F96138;
|
|
1112
|
+
> --apex-calendar-body-cell-in-range-background-color: #FFF2EF;
|
|
1113
|
+
> --apex-calendar-body-cell-in-range-active-background-color: #FFD2C6;
|
|
1114
1114
|
>
|
|
1115
|
-
> --
|
|
1115
|
+
> --apex-calendar-body-cell-in-preview-background-color: #F962381C;
|
|
1116
1116
|
>
|
|
1117
|
-
> --
|
|
1118
|
-
> --
|
|
1119
|
-
> --
|
|
1120
|
-
> --
|
|
1117
|
+
> --apex-calendar-body-cell-in-preview-border: 1px dashed #F96138;
|
|
1118
|
+
> --apex-calendar-body-cell-in-range-border: 1px solid #F96138;
|
|
1119
|
+
> --apex-calendar-body-cell-range-start-border: 1px sold #F96138;
|
|
1120
|
+
> --apex-calendar-body-cell-range-start-background-color: #F96138;
|
|
1121
1121
|
>
|
|
1122
|
-
> --
|
|
1123
|
-
> --
|
|
1124
|
-
> --
|
|
1122
|
+
> --apex-calendar-body-cell-range-start-color: #FFFFFFF;
|
|
1123
|
+
> --apex-calendar-body-cell-range-end-border: 1px sold #F96138;
|
|
1124
|
+
> --apex-calendar-body-cell-range-end-background-color: #F96138;
|
|
1125
1125
|
>
|
|
1126
|
-
> --
|
|
1127
|
-
> --
|
|
1128
|
-
> --
|
|
1129
|
-
> --
|
|
1130
|
-
> --
|
|
1131
|
-
> --
|
|
1132
|
-
> --
|
|
1126
|
+
> --apex-calendar-body-cell-range-end-color: #FFFFFFF;
|
|
1127
|
+
> --apex-calendar-body-cell-active-in-range-start-end-background-color: #FFD2C6;
|
|
1128
|
+
> --apex-calendar-body-cell-preview-end-border: 1px dashed #F96138;
|
|
1129
|
+
> --apex-calendar-body-cell-preview-end-background-color: #FFD2C6;
|
|
1130
|
+
> --apex-calendar-body-cell-preview-end-color: #FFFFFF;
|
|
1131
|
+
> --apex-calendar-body-cell-preview-start-border: 1px dashed #F96138;
|
|
1132
|
+
> --apex-calendar-body-cell-preview-start-background-color: #FFD2C6;
|
|
1133
1133
|
>
|
|
1134
|
-
> --
|
|
1135
|
-
> --
|
|
1136
|
-
> --
|
|
1134
|
+
> --apex-calendar-body-cell-preview-start-color: #FFFFFF;
|
|
1135
|
+
> --apex-calendar-body-cell-in-preview-range-start-border: 0px;
|
|
1136
|
+
> --apex-calendar-body-cell-in-preview-range-end-border: 0px;
|
|
1137
1137
|
>
|
|
1138
|
-
> --
|
|
1138
|
+
> --apex-calendar-body-cell-disabled-background-color: #E0DFDE;
|
|
1139
1139
|
>}
|
|
1140
1140
|
>```
|
|
1141
1141
|
|
|
@@ -1143,7 +1143,7 @@ Simple styled radio-button that can accept a formGroup and a control.
|
|
|
1143
1143
|
|
|
1144
1144
|
-----------------------------------------------------------------
|
|
1145
1145
|
|
|
1146
|
-
#
|
|
1146
|
+
# APEX Carousel Component
|
|
1147
1147
|
|
|
1148
1148
|
A dynamic, responsive carousel component designed to enhance user experience. It includes smooth scrolling, keyboard navigation, clickable navigation buttons, and a progress indicator.
|
|
1149
1149
|
|
|
@@ -1154,10 +1154,10 @@ A dynamic, responsive carousel component designed to enhance user experience. It
|
|
|
1154
1154
|
>
|
|
1155
1155
|
>```typescript
|
|
1156
1156
|
>import { Component } from '@angular/core';
|
|
1157
|
-
>import {
|
|
1157
|
+
>import { ApexCarouselComponent } from '@apexara/ng-components/carousel';
|
|
1158
1158
|
>
|
|
1159
1159
|
>@Component({
|
|
1160
|
-
> imports: [
|
|
1160
|
+
> imports: [ApexCarouselComponent],
|
|
1161
1161
|
> selector: 'app-carousel-example',
|
|
1162
1162
|
> templateUrl: './carousel-example.component.html',
|
|
1163
1163
|
> styleUrls: ['./carousel-example.component.css']
|
|
@@ -1170,18 +1170,18 @@ A dynamic, responsive carousel component designed to enhance user experience. It
|
|
|
1170
1170
|
>### `parent.component.html`
|
|
1171
1171
|
>
|
|
1172
1172
|
>```html
|
|
1173
|
-
><
|
|
1173
|
+
><apex-carousel>
|
|
1174
1174
|
> @for (let item of [1, 2, 3, 4, 5]; track $index) {
|
|
1175
1175
|
> <div>Item {{ item }}</div>
|
|
1176
1176
|
> }
|
|
1177
|
-
></
|
|
1177
|
+
></apex-carousel>```
|
|
1178
1178
|
|
|
1179
1179
|
---
|
|
1180
1180
|
|
|
1181
1181
|
### Features and Inputs
|
|
1182
1182
|
|
|
1183
1183
|
#### **Dynamic Content**
|
|
1184
|
-
Wrap any HTML or Angular components within `<
|
|
1184
|
+
Wrap any HTML or Angular components within `<apex-carousel>` to display them in the carousel.
|
|
1185
1185
|
|
|
1186
1186
|
#### **Progress Bar**
|
|
1187
1187
|
Automatically updates as the carousel scrolls.
|
|
@@ -1198,22 +1198,22 @@ The following variables allow for customization of colors, dimensions, and other
|
|
|
1198
1198
|
---
|
|
1199
1199
|
|
|
1200
1200
|
### CSS Variables
|
|
1201
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
1201
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-carousel:
|
|
1202
1202
|
>
|
|
1203
1203
|
>```css
|
|
1204
|
-
>
|
|
1204
|
+
>apex-carousel {
|
|
1205
1205
|
> /* Carousel Background */
|
|
1206
|
-
> --
|
|
1206
|
+
> --apex-carousel-background-color: transparent;
|
|
1207
1207
|
>
|
|
1208
|
-
> --
|
|
1209
|
-
> --
|
|
1208
|
+
> --apex-carousel-button-border-color: #FFFFFF;
|
|
1209
|
+
> --apex-carousel-button-border-hover-color: #FFFFFF;
|
|
1210
1210
|
>
|
|
1211
|
-
> --
|
|
1212
|
-
> --
|
|
1211
|
+
> --apex-carousel-chevron-color: #FFFFFF;
|
|
1212
|
+
> --apex-carousel-chevron-hover-color: #FFFFFF;
|
|
1213
1213
|
>
|
|
1214
1214
|
> /* Progress Bar */
|
|
1215
|
-
> --
|
|
1216
|
-
> --
|
|
1215
|
+
> --apex-carousel-scrollbar-color: #FFFFFF;
|
|
1216
|
+
> --apex-carousel-scrollbar-container-color: #020617;
|
|
1217
1217
|
>
|
|
1218
1218
|
>}
|
|
1219
1219
|
>```
|
|
@@ -1222,7 +1222,7 @@ The following variables allow for customization of colors, dimensions, and other
|
|
|
1222
1222
|
|
|
1223
1223
|
-----------------------------------------------------------------
|
|
1224
1224
|
|
|
1225
|
-
#
|
|
1225
|
+
# APEX Snackbar Service
|
|
1226
1226
|
A services that provides a way to display messages on the screen.
|
|
1227
1227
|
|
|
1228
1228
|
## Usage
|
|
@@ -1230,8 +1230,8 @@ A services that provides a way to display messages on the screen.
|
|
|
1230
1230
|
>```typescript
|
|
1231
1231
|
>
|
|
1232
1232
|
>import {
|
|
1233
|
-
>
|
|
1234
|
-
>
|
|
1233
|
+
> ApexSnackbarService,
|
|
1234
|
+
> ApexSnackbarOptions,
|
|
1235
1235
|
> horizontalPosition,
|
|
1236
1236
|
> verticalPosition }
|
|
1237
1237
|
>from '@apexara/ng-components/snackbar';
|
|
@@ -1244,14 +1244,14 @@ A services that provides a way to display messages on the screen.
|
|
|
1244
1244
|
>
|
|
1245
1245
|
> public message = 'Message to be displayed';
|
|
1246
1246
|
>
|
|
1247
|
-
> public options:
|
|
1247
|
+
> public options: ApexSnackbarOptions = {
|
|
1248
1248
|
> error: true,
|
|
1249
1249
|
> icon: 'example.svg',
|
|
1250
1250
|
> animationDuration: 20
|
|
1251
1251
|
> };
|
|
1252
1252
|
>
|
|
1253
1253
|
> // Inject to the component from which you want to execute it
|
|
1254
|
-
> constructor(public snackbarService:
|
|
1254
|
+
> constructor(public snackbarService: ApexSnackbarService) {
|
|
1255
1255
|
> // optionally setting the position
|
|
1256
1256
|
> this.snackbarService.setPosition({
|
|
1257
1257
|
> verticalPosition: verticalPosition.Bottom,
|
|
@@ -1280,10 +1280,10 @@ A services that provides a way to display messages on the screen.
|
|
|
1280
1280
|
>Message to be displayed
|
|
1281
1281
|
|
|
1282
1282
|
>#### options
|
|
1283
|
-
>Options are of type
|
|
1283
|
+
>Options are of type ApexSnackbarOptions with the following properties:
|
|
1284
1284
|
> title (optional) – string – overrides the default 'Error' or 'Success' title with a custom static header
|
|
1285
1285
|
> animation-duration - number - used for how long the snackbar should be displayed
|
|
1286
|
-
> icon (optional) - string - icon name that must be located inside assets/img/ (using
|
|
1286
|
+
> icon (optional) - string - icon name that must be located inside assets/img/ (using apex-img)
|
|
1287
1287
|
> error (optional) - boolean - used to distinguish error message from info.
|
|
1288
1288
|
> backgroundColor (optional) - string - sets the background color of the snackbar.
|
|
1289
1289
|
> placeholderTextColor (optional) - string; - sets title heading text of snackbar color.
|
|
@@ -1296,20 +1296,20 @@ A services that provides a way to display messages on the screen.
|
|
|
1296
1296
|
### CSS Variables
|
|
1297
1297
|
>
|
|
1298
1298
|
>```css
|
|
1299
|
-
>
|
|
1299
|
+
>apex-snackbar {
|
|
1300
1300
|
> /* Colors, Fills, Strokes: */
|
|
1301
|
-
> --
|
|
1302
|
-
> --
|
|
1301
|
+
> --apex-snackbar-background-color: #14BD6C;
|
|
1302
|
+
> --apex-snackbar-error-background-color: #F96138;
|
|
1303
1303
|
>
|
|
1304
|
-
> --
|
|
1305
|
-
> --
|
|
1304
|
+
> --apex-snackbar-placeholder-text-color: #FFFFFF;
|
|
1305
|
+
> --apex-snackbar-message-text-color: #FFFFFF;
|
|
1306
1306
|
>
|
|
1307
|
-
> --
|
|
1307
|
+
> --apex-snackbar-progress-color: #FFFFFF;
|
|
1308
1308
|
>
|
|
1309
1309
|
> /* Color of closing icon of the snackbar */
|
|
1310
|
-
> --
|
|
1310
|
+
> --apex-snackbar-x-icon-color: #FFFFFF;
|
|
1311
1311
|
>
|
|
1312
|
-
> --
|
|
1312
|
+
> --apex-snackbar-animation-duration: 10s;
|
|
1313
1313
|
>}
|
|
1314
1314
|
>```
|
|
1315
1315
|
|
|
@@ -1317,7 +1317,7 @@ A services that provides a way to display messages on the screen.
|
|
|
1317
1317
|
|
|
1318
1318
|
-----------------------------------------------------------------
|
|
1319
1319
|
|
|
1320
|
-
#
|
|
1320
|
+
# APEX Overlay Service
|
|
1321
1321
|
Service to create Overlays. Overlays are dynamically added pieces of floating UI, meant to be used as a low-level building block for other components. Dialogs, tooltips, menus, selects, etc. can all be built using overlays.
|
|
1322
1322
|
|
|
1323
1323
|
## Usage
|
|
@@ -1371,7 +1371,7 @@ A services that provides a way to display messages on the screen.
|
|
|
1371
1371
|
|
|
1372
1372
|
-----------------------------------------------------------------
|
|
1373
1373
|
|
|
1374
|
-
#
|
|
1374
|
+
# APEX Table Component
|
|
1375
1375
|
A simple table that can project data sorted by columns x rows providing editing, sorting and filtering
|
|
1376
1376
|
of the data.
|
|
1377
1377
|
|
|
@@ -1381,13 +1381,13 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1381
1381
|
>**`parent.component.ts`**
|
|
1382
1382
|
>```typescript
|
|
1383
1383
|
>import {
|
|
1384
|
-
>
|
|
1385
|
-
>
|
|
1386
|
-
>
|
|
1384
|
+
> ApexTableComponent,
|
|
1385
|
+
> ApexTableColumn,
|
|
1386
|
+
> ApexTableColumnType }
|
|
1387
1387
|
>from '@apexara/ng-components/table';
|
|
1388
1388
|
>
|
|
1389
1389
|
>@Component({
|
|
1390
|
-
> imports: [
|
|
1390
|
+
> imports: [ ApexTableComponent ]
|
|
1391
1391
|
>})
|
|
1392
1392
|
>
|
|
1393
1393
|
>export class TableExampleComponent {
|
|
@@ -1426,10 +1426,10 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1426
1426
|
> listName: 'third list',
|
|
1427
1427
|
> }]
|
|
1428
1428
|
>
|
|
1429
|
-
> public tableColumns:
|
|
1429
|
+
> public tableColumns: ApexTableColumn[] = [
|
|
1430
1430
|
> { label: 'Id', value: 'id', width: '70px' },
|
|
1431
1431
|
> { label: 'Name', value: 'name', width: '70px' },
|
|
1432
|
-
> { label: 'Date', value: 'date', type:
|
|
1432
|
+
> { label: 'Date', value: 'date', type: ApexTableColumnType.Date,
|
|
1433
1433
|
> dateFormat:
|
|
1434
1434
|
> {
|
|
1435
1435
|
> format: 'shortDate',
|
|
@@ -1437,14 +1437,14 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1437
1437
|
> timezone: '+0100'
|
|
1438
1438
|
> },
|
|
1439
1439
|
> width: '60px' }
|
|
1440
|
-
> { label: 'Years', value: 'years', type:
|
|
1441
|
-
> { label: 'Credits', value: 'credits', type:
|
|
1442
|
-
> { label: 'Cash', value: 'cash', type:
|
|
1440
|
+
> { label: 'Years', value: 'years', type: ApexTableColumnType.Number, width: '60px'}
|
|
1441
|
+
> { label: 'Credits', value: 'credits', type: ApexTableColumnType.Number width: '70px' },
|
|
1442
|
+
> { label: 'Cash', value: 'cash', type: ApexTableColumnType.Number width: '70px' },
|
|
1443
1443
|
> /* We can use +, -, /, * operations on the value property if it's of type NumberMath */
|
|
1444
|
-
> { label: 'Total cash', value: 'credits * 1.5 + cash', type:
|
|
1445
|
-
> { label: 'Admin', value: 'admin', type:
|
|
1444
|
+
> { label: 'Total cash', value: 'credits * 1.5 + cash', type: ApexTableColumnType.NumberMath width: '70px' },
|
|
1445
|
+
> { label: 'Admin', value: 'admin', type: ApexTableColumnType.Chip width: '70px' },
|
|
1446
1446
|
> { label: 'List name', value: 'listName', width: '70px' },
|
|
1447
|
-
> { label: 'Actions', type:
|
|
1447
|
+
> { label: 'Actions', type: ApexTableColumnType.Actions, width: '100px',
|
|
1448
1448
|
> singleActions: [
|
|
1449
1449
|
> label: 'Download',
|
|
1450
1450
|
> showOn: [
|
|
@@ -1468,33 +1468,33 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1468
1468
|
>```
|
|
1469
1469
|
>**`parent.component.html`**
|
|
1470
1470
|
>```html
|
|
1471
|
-
><
|
|
1471
|
+
><apex-table #serverSide
|
|
1472
1472
|
> [serverSide]="true"
|
|
1473
1473
|
> [data]="tableData" [columns]="tableColumns"
|
|
1474
1474
|
> [filter]="tableFilter" [pageable]="true"
|
|
1475
1475
|
> [dataLength]="tableData.length"
|
|
1476
1476
|
> [isLoading]="true/false"
|
|
1477
1477
|
> (tableChange)="tableChange($event.from, $event.to, $event.sort, $event.filter)">
|
|
1478
|
-
></
|
|
1478
|
+
></apex-table>
|
|
1479
1479
|
>
|
|
1480
|
-
><
|
|
1480
|
+
><apex-table #local
|
|
1481
1481
|
> [data]="localData" [columns]="tableColumns"
|
|
1482
1482
|
> [filter]="tableFilter" [pageable]="true">
|
|
1483
|
-
></
|
|
1483
|
+
></apex-table>
|
|
1484
1484
|
>```
|
|
1485
1485
|
|
|
1486
1486
|
### Inputs
|
|
1487
1487
|
|
|
1488
1488
|
#### Virtual Scroll Example (Local Data)
|
|
1489
1489
|
>```html
|
|
1490
|
-
><
|
|
1490
|
+
><apex-table
|
|
1491
1491
|
[data]="localData"
|
|
1492
1492
|
[columns]="tableColumns"
|
|
1493
1493
|
[filter]="tableFilter"
|
|
1494
1494
|
[pageable]="true"
|
|
1495
1495
|
[virtualScroll]="true"
|
|
1496
1496
|
[tableHeight]="600">
|
|
1497
|
-
></
|
|
1497
|
+
></apex-table>
|
|
1498
1498
|
>```
|
|
1499
1499
|
|
|
1500
1500
|
>#### virtualScroll
|
|
@@ -1513,17 +1513,17 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1513
1513
|
>The data that the table initializes.
|
|
1514
1514
|
>
|
|
1515
1515
|
|
|
1516
|
-
>#### columns -
|
|
1516
|
+
>#### columns - ApexTableColumn Interface
|
|
1517
1517
|
>The columns that will the table have and based on the columns the data will be visualized.
|
|
1518
1518
|
>
|
|
1519
|
-
>The
|
|
1519
|
+
>The ApexTableColumn interface defines the structure of each column in the APEX Table component. Each column can have various properties to customize its behavior and appearance.
|
|
1520
1520
|
>
|
|
1521
1521
|
>
|
|
1522
1522
|
>**label?: string**: The display label for the column header.
|
|
1523
1523
|
>
|
|
1524
1524
|
>**value?: string**: The key in the data object that corresponds to this column.
|
|
1525
1525
|
>
|
|
1526
|
-
>**type?:
|
|
1526
|
+
>**type?: ApexTableColumnType**: The type of data in the column, which can determine how it's rendered (e.g., date, number, chip, etc.).
|
|
1527
1527
|
>
|
|
1528
1528
|
>**width?: string**: The width of the column, defined as a CSS width value (e.g., '70px').
|
|
1529
1529
|
>
|
|
@@ -1537,16 +1537,16 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1537
1537
|
>
|
|
1538
1538
|
>**multipleActions?: Action[]**: An array of actions available for multiple rows in this column.
|
|
1539
1539
|
>
|
|
1540
|
-
>**dateFormat?:
|
|
1540
|
+
>**dateFormat?: ApexDateFormatOptions**: Formatting options for date values in the column.
|
|
1541
1541
|
>
|
|
1542
1542
|
>**chipLabel?: { [key: string]: string }**: A mapping of labels for chip display in the column.
|
|
1543
1543
|
>
|
|
1544
1544
|
>**class?: string | { [key: string]: string }**: Custom CSS classes for styling the column.
|
|
1545
1545
|
>
|
|
1546
1546
|
|
|
1547
|
-
>#### columnType -
|
|
1547
|
+
>#### columnType - ApexTableColumnType
|
|
1548
1548
|
>```typescript
|
|
1549
|
-
>export enum
|
|
1549
|
+
>export enum ApexTableColumnType {
|
|
1550
1550
|
> Text, // A standard text column
|
|
1551
1551
|
> Date, // A column for displaying dates
|
|
1552
1552
|
> Currency, // A column for displaying currencies
|
|
@@ -1658,55 +1658,55 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1658
1658
|
|
|
1659
1659
|
|
|
1660
1660
|
### CSS Variables
|
|
1661
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
1661
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-table:
|
|
1662
1662
|
>
|
|
1663
1663
|
>```css
|
|
1664
|
-
>
|
|
1664
|
+
>apex-table {
|
|
1665
1665
|
> /* Colors, Fills, Strokes: */
|
|
1666
|
-
> --
|
|
1667
|
-
> --
|
|
1668
|
-
> --
|
|
1669
|
-
> --
|
|
1670
|
-
> --
|
|
1666
|
+
> --apex-table-background-color: #FFFFFF;
|
|
1667
|
+
> --apex-table-row-bottom-border-color: #E9E9E9;
|
|
1668
|
+
> --apex-table-first-row-text-color: #5D6068;
|
|
1669
|
+
> --apex-table-arranger-hover-color: #F96138;
|
|
1670
|
+
> --apex-table-loading-bar-color: #FF7F50;
|
|
1671
1671
|
>
|
|
1672
1672
|
> /* Color of all icons on hover */
|
|
1673
|
-
> --
|
|
1674
|
-
> --
|
|
1675
|
-
> --
|
|
1673
|
+
> --apex-table-action-icon-hover-fill: #F96138;
|
|
1674
|
+
> --apex-table-action-icon-hover-stroke: #FFFFFF00;
|
|
1675
|
+
> --apex-table-action-hover-background-color: #F7F8FB;
|
|
1676
1676
|
>
|
|
1677
1677
|
> /* Color of the single icons */
|
|
1678
|
-
> --
|
|
1679
|
-
> --
|
|
1678
|
+
> --apex-table-action-icon-fill: #5D6068;
|
|
1679
|
+
> --apex-table-action-icon-stroke: #FFFFFF00;
|
|
1680
1680
|
>
|
|
1681
1681
|
> /* Secondary color of single icons */
|
|
1682
|
-
> --
|
|
1683
|
-
> --
|
|
1682
|
+
> --apex-table-action-secondary-icon-fill: #F96138;
|
|
1683
|
+
> --apex-table-action-secondary-icon-stroke: #FFFFFF00;
|
|
1684
1684
|
>
|
|
1685
|
-
> --
|
|
1686
|
-
> --
|
|
1685
|
+
> --apex-table-action-secondary-icon-hover-fill: #5D6068;
|
|
1686
|
+
> --apex-table-action-secondary-icon-hover-stroke: #FFFFFF00;
|
|
1687
1687
|
>
|
|
1688
1688
|
> /* Color of icon that opens the multiple actions */
|
|
1689
|
-
> --
|
|
1690
|
-
> --
|
|
1689
|
+
> --apex-table-action-more-icon-fill: #F96138;
|
|
1690
|
+
> --apex-table-action-more-icon-stroke: #FFFFFF00;
|
|
1691
1691
|
>
|
|
1692
1692
|
> /* Color of the icons of multiple actions */
|
|
1693
|
-
> --
|
|
1694
|
-
> --
|
|
1693
|
+
> --apex-table-dropdown-action-icon-fill: #5D6068;
|
|
1694
|
+
> --apex-table-dropdown-action-icon-stroke: #FFFFFF00;
|
|
1695
1695
|
>
|
|
1696
1696
|
> /* Background on dropdown if stacked actions are initialized */
|
|
1697
|
-
> --
|
|
1698
|
-
> --
|
|
1697
|
+
> --apex-table-more-actions-dropdown-background-color: #FFFFFF;
|
|
1698
|
+
> --apex-table-more-actions-dropdown-hover-background-color: #00000010;
|
|
1699
1699
|
>
|
|
1700
1700
|
> /* Page picker styling */
|
|
1701
|
-
> --
|
|
1702
|
-
> --
|
|
1701
|
+
> --apex-table-page-picker-text-color: #FFFFFF;
|
|
1702
|
+
> --apex-table-page-picker-background: #F96138;
|
|
1703
1703
|
>
|
|
1704
1704
|
> /* Chip columns color styling */
|
|
1705
|
-
> --
|
|
1706
|
-
> --
|
|
1705
|
+
> --apex-table-chip-color: #F96138;
|
|
1706
|
+
> --apex-table-chip-background-color: #FFF2EF;
|
|
1707
1707
|
>
|
|
1708
|
-
> --
|
|
1709
|
-
> --
|
|
1708
|
+
> --apex-table-chip-color-secondary: #0B1222;
|
|
1709
|
+
> --apex-table-chip-background-color-secondary: #E2E2E2;
|
|
1710
1710
|
>
|
|
1711
1711
|
>/* Note: When you want to setup the color of your icon
|
|
1712
1712
|
> you should experiment with both these variables or consider
|
|
@@ -1718,17 +1718,17 @@ Two types of tables are available. One with local data and local sorting & filte
|
|
|
1718
1718
|
|
|
1719
1719
|
-----------------------------------------------------------------
|
|
1720
1720
|
|
|
1721
|
-
#
|
|
1721
|
+
# APEX Textarea Component
|
|
1722
1722
|
A simple input textarea that handles formGroup control with validators.
|
|
1723
1723
|
|
|
1724
1724
|
## Usage
|
|
1725
1725
|
>**`parent.component.ts`**
|
|
1726
1726
|
>```typescript
|
|
1727
|
-
>import {
|
|
1727
|
+
>import { ApexTextAreaComponent, ApexTextAreaOptions }
|
|
1728
1728
|
>from '@apexara/ng-components';
|
|
1729
1729
|
>
|
|
1730
1730
|
>@Component({
|
|
1731
|
-
> imports: [
|
|
1731
|
+
> imports: [ ApexTextAreaComponent ]
|
|
1732
1732
|
>})
|
|
1733
1733
|
>
|
|
1734
1734
|
>export class TextAreaExample {
|
|
@@ -1753,16 +1753,16 @@ A simple input textarea that handles formGroup control with validators.
|
|
|
1753
1753
|
>**`parent.component.html`**
|
|
1754
1754
|
>```html
|
|
1755
1755
|
>
|
|
1756
|
-
> <
|
|
1756
|
+
> <apex-textarea
|
|
1757
1757
|
> class="fluid"
|
|
1758
1758
|
> [options]="textAreaOptions">
|
|
1759
|
-
> </
|
|
1759
|
+
> </apex-textarea>
|
|
1760
1760
|
>
|
|
1761
1761
|
> <!-- No form group -->
|
|
1762
|
-
><
|
|
1762
|
+
><apex-textarea
|
|
1763
1763
|
> [options]="{ label: 'Placeholder' }"
|
|
1764
1764
|
> (textAreaChange)="textAreaChange($event)">
|
|
1765
|
-
></
|
|
1765
|
+
></apex-textarea>
|
|
1766
1766
|
>
|
|
1767
1767
|
>```
|
|
1768
1768
|
>
|
|
@@ -1770,7 +1770,7 @@ A simple input textarea that handles formGroup control with validators.
|
|
|
1770
1770
|
### Inputs
|
|
1771
1771
|
|
|
1772
1772
|
>#### options
|
|
1773
|
-
>Options of type
|
|
1773
|
+
>Options of type ApexTextAreaOptions. Only label is required.
|
|
1774
1774
|
>{
|
|
1775
1775
|
> label - header label element for the current textarea
|
|
1776
1776
|
> placeholder - initial placeholder message
|
|
@@ -1786,34 +1786,34 @@ A simple input textarea that handles formGroup control with validators.
|
|
|
1786
1786
|
>Adds custom width and height (100% 100%) based on a parent component.
|
|
1787
1787
|
|
|
1788
1788
|
### CSS Variables
|
|
1789
|
-
>Here are all the available CSS variables (and their default values) you can set when using the
|
|
1789
|
+
>Here are all the available CSS variables (and their default values) you can set when using the apex-textarea:
|
|
1790
1790
|
|
|
1791
1791
|
>```css
|
|
1792
|
-
>
|
|
1792
|
+
>apex-textarea {
|
|
1793
1793
|
> /* Colors, Fills, Strokes: */
|
|
1794
|
-
> --
|
|
1794
|
+
> --apex-textarea-header-color: #0B1222;
|
|
1795
1795
|
>
|
|
1796
|
-
> --
|
|
1797
|
-
> --
|
|
1796
|
+
> --apex-textarea-text-color: #0B1222;
|
|
1797
|
+
> --apex-textarea-text-placeholder-color: #C6C6C6;
|
|
1798
1798
|
>
|
|
1799
|
-
> --
|
|
1799
|
+
> --apex-textarea-background-color: transparent;
|
|
1800
1800
|
>
|
|
1801
|
-
> --
|
|
1801
|
+
> --apex-textarea-icon-fill: #C6C6C6;
|
|
1802
1802
|
>
|
|
1803
1803
|
> /* Text area border styling */
|
|
1804
|
-
> --
|
|
1805
|
-
> --
|
|
1804
|
+
> --apex-textarea-border: 1px solid #E9E9E9;
|
|
1805
|
+
> --apex-textarea-border-radius: 4px;
|
|
1806
1806
|
>
|
|
1807
|
-
> --
|
|
1807
|
+
> --apex-textarea-border-invalid: 1px solid #F96138;
|
|
1808
1808
|
>
|
|
1809
|
-
> --
|
|
1809
|
+
> --apex-textarea-border-disabled: 1px dashed #F2F2F2;
|
|
1810
1810
|
>
|
|
1811
1811
|
> /* Text area scroll styling */
|
|
1812
|
-
> --
|
|
1813
|
-
> --
|
|
1812
|
+
> --apex-textarea-scrollbar-color: #E2E2E2bb;
|
|
1813
|
+
> --apex-textarea-scrollbar-hover-color: #E2E2E2;
|
|
1814
1814
|
>
|
|
1815
1815
|
> /* Text area's error text underneath input color */
|
|
1816
|
-
> --
|
|
1816
|
+
> --apex-textarea-footer-color: #F96138;
|
|
1817
1817
|
>
|
|
1818
1818
|
>/* Note: When you want to setup the color of your icon
|
|
1819
1819
|
> you should experiment with both these variables or consider
|
|
@@ -1825,7 +1825,7 @@ A simple input textarea that handles formGroup control with validators.
|
|
|
1825
1825
|
|
|
1826
1826
|
-----------------------------------------------------------------
|
|
1827
1827
|
|
|
1828
|
-
#
|
|
1828
|
+
# APEX Tooltip Component
|
|
1829
1829
|
Simple tooltip that pops up on hover on a given parent component implemented as a directive. Custom message can be passed and a position.
|
|
1830
1830
|
|
|
1831
1831
|
## Usage
|
|
@@ -1834,11 +1834,11 @@ place it as a directive to a component:
|
|
|
1834
1834
|
|
|
1835
1835
|
>**`parent.component.ts`**
|
|
1836
1836
|
>```typescript
|
|
1837
|
-
>import {
|
|
1837
|
+
>import { ApexTooltipDirective, TooltipPosition }
|
|
1838
1838
|
> from '@apexara/ng-components';
|
|
1839
1839
|
>
|
|
1840
1840
|
>@Component({
|
|
1841
|
-
> imports: [
|
|
1841
|
+
> imports: [ ApexTooltipDirective ]
|
|
1842
1842
|
>})
|
|
1843
1843
|
>
|
|
1844
1844
|
>export class TooltipExampleComponent {}
|
|
@@ -1849,7 +1849,7 @@ place it as a directive to a component:
|
|
|
1849
1849
|
>```html
|
|
1850
1850
|
>
|
|
1851
1851
|
><div
|
|
1852
|
-
>
|
|
1852
|
+
> apexTooltip='tooltip text'
|
|
1853
1853
|
> [tooltipPosition]="TooltipPosition.Above">
|
|
1854
1854
|
></div>
|
|
1855
1855
|
>
|