@xplortech/apollo-core 2.4.3 → 2.5.0
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/.typings/apollo-components.html-data.json +1011 -3481
- package/build/style.css +7 -7
- package/dist/apollo-core/apollo-core.css +1 -1
- package/dist/apollo-core/apollo-core.esm.js +1 -1
- package/dist/apollo-core/{p-8c1f73ea.entry.js → p-0e1877a2.entry.js} +1 -1
- package/dist/apollo-core/{p-94209785.entry.js → p-1c2e4034.entry.js} +1 -1
- package/dist/apollo-core/p-77f0fd4a.entry.js +1 -0
- package/dist/apollo-core/p-7c22b842.entry.js +1 -0
- package/dist/apollo-core/p-7d245bf0.entry.js +1 -0
- package/dist/apollo-core/{p-b1f4604d.entry.js → p-f4c2626d.entry.js} +1 -1
- package/dist/cjs/xpl-avatar_41.cjs.entry.js +11724 -1158
- package/dist/cjs/xpl-dynamic-table-cell.cjs.entry.js +2 -2
- package/dist/cjs/xpl-dynamic-table-row.cjs.entry.js +2 -2
- package/dist/cjs/xpl-dynamic-table.cjs.entry.js +1 -1
- package/dist/cjs/xpl-grid-item.cjs.entry.js +1 -1
- package/dist/cjs/xpl-grid.cjs.entry.js +1 -1
- package/dist/collection/collection-manifest.json +1 -1
- package/dist/collection/components/xpl-data-card/xpl-data-card.js +11 -25
- package/dist/collection/components/xpl-divider/xpl-divider.js +1 -1
- package/dist/collection/components/xpl-dropdown/dropdown.stories.js +4 -0
- package/dist/collection/components/xpl-dropdown/xpl-dropdown-group/xpl-dropdown-group.js +1 -1
- package/dist/collection/components/xpl-dropdown/xpl-dropdown-heading/xpl-dropdown-heading.js +1 -1
- package/dist/collection/components/xpl-dropdown/xpl-dropdown-option/xpl-dropdown-option.js +2 -2
- package/dist/collection/components/xpl-dropdown/xpl-dropdown.js +2 -2
- package/dist/collection/components/xpl-dynamic-table/dynamic-table.stories.js +4 -0
- package/dist/collection/components/xpl-dynamic-table/xpl-dynamic-table.js +1 -1
- package/dist/collection/components/xpl-dynamic-table-cell/xpl-dynamic-table-cell.js +2 -2
- package/dist/collection/components/xpl-dynamic-table-row/xpl-dynamic-table-row.js +2 -2
- package/dist/collection/components/xpl-grid/xpl-grid.js +1 -1
- package/dist/collection/components/xpl-grid-item/xpl-grid-item.js +1 -1
- package/dist/collection/components/xpl-header-accordion/header-accordion.stories.js +4 -0
- package/dist/collection/components/xpl-header-accordion/xpl-header-accordion.js +1 -1
- package/dist/collection/components/xpl-icon/icon-types.js +1 -0
- package/dist/collection/components/xpl-icon/icons.stories.js +47 -12
- package/dist/collection/components/xpl-icon/xpl-icon.js +13 -15
- package/dist/collection/components/xpl-input/input.stories.js +4 -0
- package/dist/collection/components/xpl-input/xpl-input-color/xpl-input-color.js +3 -3
- package/dist/collection/components/xpl-list/list.stories.js +4 -0
- package/dist/collection/components/xpl-progress/progress.stories.js +4 -0
- package/dist/collection/components/xpl-radio/radio.stories.js +4 -0
- package/dist/collection/components/xpl-select/select.stories.js +4 -0
- package/dist/collection/components/xpl-select/xpl-select.js +10 -16
- package/dist/collection/components/xpl-skeleton/skeleton.stories.js +4 -0
- package/dist/collection/components/xpl-slideout/slideout.stories.js +6 -0
- package/dist/collection/components/xpl-table/table.stories.js +4 -0
- package/dist/collection/components/xpl-table-header/table-header.stories.js +4 -0
- package/dist/collection/components/xpl-table-header-cell/table-header-cell.stories.js +4 -0
- package/dist/collection/components/xpl-table-header-cell/xpl-table-header-cell.js +5 -15
- package/dist/collection/components/xpl-tabs/tabs.stories.js +4 -0
- package/dist/collection/components/xpl-toast/toast.stories.js +4 -0
- package/dist/collection/components/xpl-toggle/toggle.stories.js +4 -0
- package/dist/collection/components/xpl-tooltip/tooltip.stories.js +4 -0
- package/dist/components/xpl-data-card.js +1 -1
- package/dist/components/xpl-divider2.js +1 -1
- package/dist/components/xpl-dropdown-group2.js +1 -1
- package/dist/components/xpl-dropdown-heading2.js +1 -1
- package/dist/components/xpl-dropdown-option2.js +1 -1
- package/dist/components/xpl-dropdown2.js +1 -1
- package/dist/components/xpl-dynamic-table-cell.js +1 -1
- package/dist/components/xpl-dynamic-table-row.js +1 -1
- package/dist/components/xpl-dynamic-table.js +1 -1
- package/dist/components/xpl-grid-item.js +1 -1
- package/dist/components/xpl-grid.js +1 -1
- package/dist/components/xpl-header-accordion.js +1 -1
- package/dist/components/xpl-icon2.js +1 -6
- package/dist/components/xpl-input2.js +1 -1
- package/dist/components/xpl-select2.js +1 -1
- package/dist/docs/xpl-accordion/readme.md +62 -0
- package/dist/docs/xpl-application-shell/readme.md +33 -0
- package/dist/docs/xpl-avatar/readme.md +35 -0
- package/dist/docs/xpl-backdrop/readme.md +34 -0
- package/dist/docs/xpl-badge/readme.md +29 -0
- package/dist/docs/xpl-breadcrumbs/xpl-breadcrumb-item/readme.md +19 -0
- package/dist/docs/xpl-breadcrumbs/xpl-breadcrumbs/readme.md +22 -0
- package/dist/docs/xpl-button/readme.md +44 -0
- package/dist/docs/xpl-button-row/readme.md +41 -0
- package/dist/docs/xpl-calendar/readme.md +48 -0
- package/dist/docs/xpl-checkbox/readme.md +47 -0
- package/dist/docs/xpl-choicelist/readme.md +43 -0
- package/dist/docs/xpl-content-area/readme.md +17 -0
- package/dist/docs/xpl-dashboard/readme.md +10 -0
- package/dist/docs/xpl-data-card/readme.md +54 -0
- package/dist/docs/xpl-divider/readme.md +30 -0
- package/dist/docs/xpl-dropdown/readme.md +80 -0
- package/dist/docs/xpl-dropdown/xpl-dropdown-group/readme.md +39 -0
- package/dist/docs/xpl-dropdown/xpl-dropdown-heading/readme.md +30 -0
- package/dist/docs/xpl-dropdown/xpl-dropdown-option/readme.md +36 -0
- package/dist/docs/xpl-dynamic-table/readme.md +19 -0
- package/dist/docs/xpl-dynamic-table-cell/readme.md +18 -0
- package/dist/docs/xpl-dynamic-table-row/readme.md +19 -0
- package/dist/docs/xpl-grid/readme.md +10 -0
- package/dist/docs/xpl-grid-item/readme.md +20 -0
- package/dist/docs/xpl-header-accordion/readme.md +39 -0
- package/dist/docs/xpl-icon/readme.md +80 -0
- package/dist/docs/xpl-input/readme.md +90 -0
- package/dist/docs/xpl-input/xpl-input-color/readme.md +61 -0
- package/dist/docs/xpl-input/xpl-input-date/readme.md +56 -0
- package/dist/docs/xpl-input/xpl-input-file/readme.md +79 -0
- package/dist/docs/xpl-input/xpl-input-time/readme.md +69 -0
- package/dist/docs/xpl-large-card/readme.md +40 -0
- package/dist/docs/xpl-list/readme.md +34 -0
- package/dist/docs/xpl-main-nav/readme.md +28 -0
- package/dist/docs/xpl-modal/readme.md +55 -0
- package/dist/docs/xpl-nav-item/readme.md +24 -0
- package/dist/docs/xpl-pagination/readme.md +52 -0
- package/dist/docs/xpl-popover/readme.md +48 -0
- package/dist/docs/xpl-progress/readme.md +22 -0
- package/dist/docs/xpl-radio/readme.md +43 -0
- package/dist/docs/xpl-secondary-nav/readme.md +10 -0
- package/dist/docs/xpl-select/readme.md +88 -0
- package/dist/docs/xpl-skeleton/readme.md +31 -0
- package/dist/docs/xpl-slideout/readme.md +46 -0
- package/dist/docs/xpl-tab/readme.md +25 -0
- package/dist/docs/xpl-tab-panel/readme.md +18 -0
- package/dist/docs/xpl-table/readme.md +46 -0
- package/dist/docs/xpl-table-header/readme.md +13 -0
- package/dist/docs/xpl-table-header-cell/readme.md +47 -0
- package/dist/docs/xpl-tabs/readme.md +54 -0
- package/dist/docs/xpl-tag/readme.md +30 -0
- package/dist/docs/xpl-toast/readme.md +42 -0
- package/dist/docs/xpl-toggle/readme.md +23 -0
- package/dist/docs/xpl-toolbar/readme.md +18 -0
- package/dist/docs/xpl-tooltip/readme.md +35 -0
- package/dist/docs/xpl-utility-bar/readme.md +55 -0
- package/dist/esm/xpl-avatar_41.entry.js +11724 -1158
- package/dist/esm/xpl-dynamic-table-cell.entry.js +2 -2
- package/dist/esm/xpl-dynamic-table-row.entry.js +2 -2
- package/dist/esm/xpl-dynamic-table.entry.js +1 -1
- package/dist/esm/xpl-grid-item.entry.js +1 -1
- package/dist/esm/xpl-grid.entry.js +1 -1
- package/dist/types/components/xpl-data-card/xpl-data-card.d.ts +2 -3
- package/dist/types/components/xpl-dynamic-table/dynamic-table.stories.d.ts +4 -0
- package/dist/types/components/xpl-header-accordion/header-accordion.stories.d.ts +4 -0
- package/dist/types/components/xpl-icon/icon-types.d.ts +2 -0
- package/dist/types/components/xpl-icon/xpl-icon.d.ts +1 -3
- package/dist/types/components/xpl-input/input.stories.d.ts +4 -0
- package/dist/types/components/xpl-list/list.stories.d.ts +4 -0
- package/dist/types/components/xpl-progress/progress.stories.d.ts +4 -0
- package/dist/types/components/xpl-radio/radio.stories.d.ts +4 -0
- package/dist/types/components/xpl-select/select.stories.d.ts +4 -0
- package/dist/types/components/xpl-select/xpl-select.d.ts +1 -3
- package/dist/types/components/xpl-slideout/slideout.stories.d.ts +6 -0
- package/dist/types/components/xpl-table/table.stories.d.ts +4 -0
- package/dist/types/components/xpl-table-header/table-header.stories.d.ts +4 -0
- package/dist/types/components/xpl-table-header-cell/table-header-cell.stories.d.ts +4 -0
- package/dist/types/components/xpl-table-header-cell/xpl-table-header-cell.d.ts +1 -2
- package/dist/types/components/xpl-tabs/tabs.stories.d.ts +4 -0
- package/dist/types/components/xpl-toast/toast.stories.d.ts +4 -0
- package/dist/types/components/xpl-toggle/toggle.stories.d.ts +4 -0
- package/dist/types/components/xpl-tooltip/tooltip.stories.d.ts +4 -0
- package/dist/types/components.d.ts +24 -28
- package/package.json +7 -4
- package/dist/apollo-core/p-31461db7.entry.js +0 -1
- package/dist/apollo-core/p-5c0236db.entry.js +0 -6
- package/dist/apollo-core/p-7f8e5cd0.entry.js +0 -1
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# xpl-input
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| --------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ----------- |
|
|
12
|
+
| `_id` | `_id` | Because `id` is a reserved HTMLElement attribute, we prefix it with an underscore here so that it doesn't get automatically applied to the outer container. Applies to all input types. | `string` | `undefined` |
|
|
13
|
+
| `accept` | `accept` | The accepted file types for the file input. Corresponds to the `accept` attribute on the input element. Example: 'image/*' for all image types, '.pdf' for PDF files, etc. Applies to file inputs. | `string` | `''` |
|
|
14
|
+
| `allowCustomOption` | `allow-custom-option` | For time inputs, whether to allow custom option in the input even if not available in the dropdown. Example: A step of 30 minutes will allow 15:03, 15:37, etc. Applies to time inputs. | `boolean` | `false` |
|
|
15
|
+
| `autocomplete` | `autocomplete` | Hint for form autofill feature Applies to text, password, number. | `string` | `undefined` |
|
|
16
|
+
| `dateFormat` | `date-format` | The date format to use for the datepicker input. This is used by flatpickr to format the date. Default is 'Y-m-d' (e.g., 2023-10-01). See https://flatpickr.js.org/formatting/ for more details. Applies to date inputs. | `string` | `'Y-m-d'` |
|
|
17
|
+
| `description` | `description` | Optional text that appears below the input label. Applies to all input types. | `string` | `undefined` |
|
|
18
|
+
| `disabled` | `disabled` | Whether the field is disabled Applies to all input types. | `boolean` | `undefined` |
|
|
19
|
+
| `error` | `error` | If an empty string (attribute present with no value), will display visually as an error. If a string is included, will display visually as an error and include the value as an error message. Applies to all input types. | `string` | `undefined` |
|
|
20
|
+
| `hideAcceptText` | `hide-accept-text` | Hides the "Accept" text that indicates the accepted file types This is useful for cases where you want to hide the "Accept" text. Applies to file inputs. | `boolean` | `false` |
|
|
21
|
+
| `hideEyeDropper` | `hide-eye-dropper` | Hide eye dropper Applies to color inputs. | `boolean` | `undefined` |
|
|
22
|
+
| `hideFileNames` | `hide-file-names` | Hides the file names in the file upload component This is useful for cases where you want to hide the file names after selection. Applies to file inputs. | `boolean` | `false` |
|
|
23
|
+
| `hideTriggerOnSelect` | `hide-trigger-on-select` | Hides the trigger element when a file is selected. This is useful for cases where you want to hide the trigger after a file is selected. Applies to file inputs. | `boolean` | `false` |
|
|
24
|
+
| `label` | `label` | Label text for the field Applies to all input types. | `string` | `undefined` |
|
|
25
|
+
| `max` | `max` | Maximum value for the input. Applies to number, time, and date inputs. If the input is a time input, the value must be in 24 hour format, ex: 18:25 for 6:25 PM | `number \| string` | `undefined` |
|
|
26
|
+
| `maxCharacterCount` | `max-character-count` | For multiline inputs, a max. character count will display along with the current character count, and will automatically render as an error if the character count exceeds the max. This is only applicable if `multiline` is `true`. | `number` | `undefined` |
|
|
27
|
+
| `min` | `min` | The minimum value for the input. Applies to number, time, and date inputs. If the input is a time input, the value must be in 24 hour format, ex: 05:25 for 5:25 AM | `number \| string` | `undefined` |
|
|
28
|
+
| `mode` | `mode` | For datepicker inputs, whether to allow only a single date or a range of dates. (Multiple non-consecutive dates planned to be supported in the future.) Applies to date inputs. | `"range" \| "single"` | `'single'` |
|
|
29
|
+
| `multiline` | `multiline` | Whether to render as a singleline text input or as a multiline textarea. (If `true`, `pre` and `post` values will be ignored, if present.) Applies to text inputs. | `boolean` | `false` |
|
|
30
|
+
| `multiple` | `multiple` | Whether the user can select multiple files at once. Corresponds to the `multiple` attribute on the input element. Applies to file inputs. | `boolean` | `false` |
|
|
31
|
+
| `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. Applies to all input types. | `string` | `undefined` |
|
|
32
|
+
| `placeholder` | `placeholder` | Placeholder text that appears when the field has no value Applies to text, password, number, and date inputs. | `string` | `undefined` |
|
|
33
|
+
| `post` | `post` | A string (recommended max 3 characters) that gets shown visually to the left of (before) the input. Applies to text, password, number, and date inputs. Note: This will be ignored if `multiline` is `true`. | `string` | `undefined` |
|
|
34
|
+
| `pre` | `pre` | A string (recommended max 8 characters) that gets shown visually to the right of (after) the input. Applies to text, password, number, and date inputs. Note: This will be ignored if `multiline` is `true`. | `string` | `undefined` |
|
|
35
|
+
| `readonly` | `readonly` | Whether the input is editable Applies to text, password, number, and date inputs. | `boolean` | `undefined` |
|
|
36
|
+
| `required` | `required` | Whether the input is required Applies to all input types. | `boolean` | `undefined` |
|
|
37
|
+
| `step` | `step` | The granularity that the value in a `number` input must adhere to when incrementing or decrementing. The default stepping value for number inputs is 1 Applies to number and time inputs. | `number` | `undefined` |
|
|
38
|
+
| `timeFormat` | `time-format` | The time format to display for the input. Applies to time inputs. If 12h is selected, the value will be displayed in 12 hour format, ex: 05:25 PM for 17:25 If 24h is selected, the value will be displayed in 24 hour format, ex: 17:25 for 17:25 | `"12h" \| "24h"` | `'24h'` |
|
|
39
|
+
| `type` | `type` | The type of form control | `"color" \| "date" \| "file" \| "number" \| "password" \| "text" \| "time"` | `'text'` |
|
|
40
|
+
| `value` | `value` | Including a `value` will pre-populate the input with the given string. Applies to text, password, number, and date inputs. | `string` | `undefined` |
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
## Events
|
|
44
|
+
|
|
45
|
+
| Event | Description | Type |
|
|
46
|
+
| ------------- | ---------------------------------------------------------------------------------- | ------------------------- |
|
|
47
|
+
| `blurEvent` | The event handler for the blur event | `CustomEvent<FocusEvent>` |
|
|
48
|
+
| `focusEvent` | The event handler for the focus event | `CustomEvent<FocusEvent>` |
|
|
49
|
+
| `inputEvent` | Event that emits the current value of the input Applies to text like inputs only. | `CustomEvent<string>` |
|
|
50
|
+
| `valueChange` | Event that emits the current value of the input | `CustomEvent<string>` |
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
## Dependencies
|
|
54
|
+
|
|
55
|
+
### Used by
|
|
56
|
+
|
|
57
|
+
- [xpl-input-color](xpl-input-color)
|
|
58
|
+
- [xpl-input-time](xpl-input-time)
|
|
59
|
+
|
|
60
|
+
### Depends on
|
|
61
|
+
|
|
62
|
+
- [xpl-input-file](xpl-input-file)
|
|
63
|
+
- [xpl-input-color](xpl-input-color)
|
|
64
|
+
- [xpl-input-date](xpl-input-date)
|
|
65
|
+
- [xpl-input-time](xpl-input-time)
|
|
66
|
+
- [xpl-icon](../xpl-icon)
|
|
67
|
+
|
|
68
|
+
### Graph
|
|
69
|
+
```mermaid
|
|
70
|
+
graph TD;
|
|
71
|
+
xpl-input --> xpl-input-file
|
|
72
|
+
xpl-input --> xpl-input-color
|
|
73
|
+
xpl-input --> xpl-input-date
|
|
74
|
+
xpl-input --> xpl-input-time
|
|
75
|
+
xpl-input --> xpl-icon
|
|
76
|
+
xpl-input-file --> xpl-icon
|
|
77
|
+
xpl-input-color --> xpl-input
|
|
78
|
+
xpl-input-date --> xpl-icon
|
|
79
|
+
xpl-input-time --> xpl-input
|
|
80
|
+
xpl-dropdown --> xpl-dropdown-group
|
|
81
|
+
xpl-dropdown --> xpl-dropdown-option
|
|
82
|
+
xpl-dropdown-group --> xpl-dropdown-group
|
|
83
|
+
xpl-dropdown-group --> xpl-dropdown-option
|
|
84
|
+
xpl-dropdown-group --> xpl-dropdown-heading
|
|
85
|
+
style xpl-input fill:#f9f,stroke:#333,stroke-width:4px
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
----------------------------------------------
|
|
89
|
+
|
|
90
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# xpl-input-color
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| ---------------- | ------------------ | ----------------------------------------------------------------------------- | --------- | ---------------- |
|
|
12
|
+
| `disabled` | `disabled` | Indicates whether the color picker is disabled. | `boolean` | `undefined` |
|
|
13
|
+
| `hideEyeDropper` | `hide-eye-dropper` | Hide eye dropper | `boolean` | `undefined` |
|
|
14
|
+
| `placeholder` | `placeholder` | Placeholder text for the color input. This is used when no color is selected. | `string` | `'Select color'` |
|
|
15
|
+
| `required` | `required` | Indicates whether the color picker is required. | `boolean` | `undefined` |
|
|
16
|
+
| `value` | `value` | The color value of the picker. | `string` | `undefined` |
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
## Events
|
|
20
|
+
|
|
21
|
+
| Event | Description | Type |
|
|
22
|
+
| ---------------------- | ----------------------------------------------------------- | --------------------- |
|
|
23
|
+
| `hasErrorStateChanged` | Event that is emitted when the hasErrorState state changes. | `CustomEvent<string>` |
|
|
24
|
+
| `inputChange` | Event that is emitted when the color value changes. | `CustomEvent<string>` |
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Dependencies
|
|
28
|
+
|
|
29
|
+
### Used by
|
|
30
|
+
|
|
31
|
+
- [xpl-input](..)
|
|
32
|
+
|
|
33
|
+
### Depends on
|
|
34
|
+
|
|
35
|
+
- [xpl-popover](../../xpl-popover)
|
|
36
|
+
- [xpl-icon](../../xpl-icon)
|
|
37
|
+
- [xpl-input](..)
|
|
38
|
+
|
|
39
|
+
### Graph
|
|
40
|
+
```mermaid
|
|
41
|
+
graph TD;
|
|
42
|
+
xpl-input-color --> xpl-popover
|
|
43
|
+
xpl-input-color --> xpl-icon
|
|
44
|
+
xpl-input-color --> xpl-input
|
|
45
|
+
xpl-input --> xpl-input-color
|
|
46
|
+
xpl-input-file --> xpl-icon
|
|
47
|
+
xpl-input-date --> xpl-icon
|
|
48
|
+
xpl-input-time --> xpl-input
|
|
49
|
+
xpl-input-time --> xpl-icon
|
|
50
|
+
xpl-input-time --> xpl-dropdown
|
|
51
|
+
xpl-dropdown --> xpl-dropdown-group
|
|
52
|
+
xpl-dropdown --> xpl-dropdown-option
|
|
53
|
+
xpl-dropdown-group --> xpl-dropdown-group
|
|
54
|
+
xpl-dropdown-group --> xpl-dropdown-option
|
|
55
|
+
xpl-dropdown-group --> xpl-dropdown-heading
|
|
56
|
+
style xpl-input-color fill:#f9f,stroke:#333,stroke-width:4px
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
----------------------------------------------
|
|
60
|
+
|
|
61
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# xpl-input-date
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| ------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------- |
|
|
12
|
+
| `dateFormat` | `date-format` | The date format to use for the datepicker input. This is used by flatpickr to format the date. Default is 'Y-m-d' (e.g., 2023-10-01). See https://flatpickr.js.org/formatting/ for more details. | `string` | `'Y-m-d'` |
|
|
13
|
+
| `disabled` | `disabled` | Whether the field is disabled | `boolean` | `undefined` |
|
|
14
|
+
| `inputId` | `input-id` | The `inputId` is used to associate the input with a label. | `string` | `undefined` |
|
|
15
|
+
| `max` | `max` | Maximum value for the input. | `number \| string` | `undefined` |
|
|
16
|
+
| `min` | `min` | The minimum value for the input. | `number \| string` | `undefined` |
|
|
17
|
+
| `mode` | `mode` | For datepicker inputs, whether to allow only a single date or a range of dates. (Multiple non-consecutive dates planned to be supported in the future.) | `"range" \| "single"` | `'single'` |
|
|
18
|
+
| `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. Applies to all input types. | `string` | `undefined` |
|
|
19
|
+
| `placeholder` | `placeholder` | Placeholder text that appears when the field has no value Applies to text, password, number, and date inputs. | `string` | `undefined` |
|
|
20
|
+
| `post` | `post` | A string (recommended max 3 characters) that gets shown visually to the left of (before) the input. | `string` | `undefined` |
|
|
21
|
+
| `pre` | `pre` | A string (recommended max 8 characters) that gets shown visually to the right of (after) the input. | `string` | `undefined` |
|
|
22
|
+
| `readonly` | `readonly` | Whether the input is editable | `boolean` | `undefined` |
|
|
23
|
+
| `required` | `required` | Whether the input is required | `boolean` | `undefined` |
|
|
24
|
+
| `value` | `value` | Including a `value` will pre-populate the input with the given string. | `string` | `undefined` |
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Events
|
|
28
|
+
|
|
29
|
+
| Event | Description | Type |
|
|
30
|
+
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
|
|
31
|
+
| `hasErrorStateChanged` | Event that is emitted when the hasErrorState state changes. | `CustomEvent<string>` |
|
|
32
|
+
| `rangeSelected` | Event that emits the selected date range when the mode is 'range'. The emitted value is an object with `start` and `end` properties. | `CustomEvent<{ start: Date; end: Date; }>` |
|
|
33
|
+
| `valueChange` | Event that emits the current value of the input | `CustomEvent<string>` |
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
## Dependencies
|
|
37
|
+
|
|
38
|
+
### Used by
|
|
39
|
+
|
|
40
|
+
- [xpl-input](..)
|
|
41
|
+
|
|
42
|
+
### Depends on
|
|
43
|
+
|
|
44
|
+
- [xpl-icon](../../xpl-icon)
|
|
45
|
+
|
|
46
|
+
### Graph
|
|
47
|
+
```mermaid
|
|
48
|
+
graph TD;
|
|
49
|
+
xpl-input-date --> xpl-icon
|
|
50
|
+
xpl-input --> xpl-input-date
|
|
51
|
+
style xpl-input-date fill:#f9f,stroke:#333,stroke-width:4px
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
----------------------------------------------
|
|
55
|
+
|
|
56
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# xpl-file-upload
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
`xpl-input-file` is a component that allows users to upload files.
|
|
11
|
+
|
|
12
|
+
## Properties
|
|
13
|
+
|
|
14
|
+
| Property | Attribute | Description | Type | Default |
|
|
15
|
+
| --------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- |
|
|
16
|
+
| `_id` | `_id` | Because `id` is a reserved HTMLElement attribute, we prefix it with an underscore here so that it doesn't get automatically applied to the outer container. | `string` | `undefined` |
|
|
17
|
+
| `accept` | `accept` | The accepted file types for the file input. Corresponds to the `accept` attribute on the input element. Example: 'image/*' for all image types, '.pdf' for PDF files, etc. | `string` | `''` |
|
|
18
|
+
| `disabled` | `disabled` | Whether the field is disabled | `boolean` | `undefined` |
|
|
19
|
+
| `hideAcceptText` | `hide-accept-text` | Hides the "Accept" text that indicates the accepted file types | `boolean` | `false` |
|
|
20
|
+
| `hideFileNames` | `hide-file-names` | Hides the file names in the file upload component | `boolean` | `false` |
|
|
21
|
+
| `hideTriggerOnSelect` | `hide-trigger-on-select` | Hides the trigger element when a file is selected. | `boolean` | `false` |
|
|
22
|
+
| `multiple` | `multiple` | Whether the user can select multiple files at once. Corresponds to the `multiple` attribute on the input element. | `boolean` | `false` |
|
|
23
|
+
| `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. | `string` | `undefined` |
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
## Events
|
|
27
|
+
|
|
28
|
+
| Event | Description | Type |
|
|
29
|
+
| ------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------- |
|
|
30
|
+
| `inputChange` | Event emitted when a file is selected. The event detail contains the FileList object. | `CustomEvent<{ type: string; value: File[]; }>` |
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
## Methods
|
|
34
|
+
|
|
35
|
+
### `removeFileByIndex(fileIndex: number) => Promise<void>`
|
|
36
|
+
|
|
37
|
+
Removes a file from the selected files by its index.
|
|
38
|
+
|
|
39
|
+
#### Parameters
|
|
40
|
+
|
|
41
|
+
| Name | Type | Description |
|
|
42
|
+
| ----------- | -------- | -------------------------------- |
|
|
43
|
+
| `fileIndex` | `number` | The index of the file to remove. |
|
|
44
|
+
|
|
45
|
+
#### Returns
|
|
46
|
+
|
|
47
|
+
Type: `Promise<void>`
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
## Slots
|
|
53
|
+
|
|
54
|
+
| Slot | Description |
|
|
55
|
+
| ----------- | ----------------------------------------------------------------- |
|
|
56
|
+
| `"trigger"` | The element that, when clicked, will open the file select dialog. |
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
## Dependencies
|
|
60
|
+
|
|
61
|
+
### Used by
|
|
62
|
+
|
|
63
|
+
- [xpl-input](..)
|
|
64
|
+
|
|
65
|
+
### Depends on
|
|
66
|
+
|
|
67
|
+
- [xpl-icon](../../xpl-icon)
|
|
68
|
+
|
|
69
|
+
### Graph
|
|
70
|
+
```mermaid
|
|
71
|
+
graph TD;
|
|
72
|
+
xpl-input-file --> xpl-icon
|
|
73
|
+
xpl-input --> xpl-input-file
|
|
74
|
+
style xpl-input-file fill:#f9f,stroke:#333,stroke-width:4px
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
----------------------------------------------
|
|
78
|
+
|
|
79
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# xpl-input-time
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| ------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------- |
|
|
12
|
+
| `allowCustomOption` | `allow-custom-option` | For time inputs, whether to allow custom option in the input even if not available in the dropdown. Example: A step of 30 minutes will allow 15:03, 15:37, etc. Applies to time inputs. | `boolean` | `false` |
|
|
13
|
+
| `disabled` | `disabled` | Whether the field is disabled | `boolean` | `undefined` |
|
|
14
|
+
| `inputId` | `input-id` | The `inputId` is used to associate the input with a label. | `string` | `undefined` |
|
|
15
|
+
| `max` | `max` | Maximum value for the input. | `number \| string` | `'23:59'` |
|
|
16
|
+
| `min` | `min` | The minimum value for the input. | `number \| string` | `'00:00'` |
|
|
17
|
+
| `mode` | `mode` | Whether the input is a single time or a range of times. Currently, only single time is supported. | `"range" \| "single"` | `'single'` |
|
|
18
|
+
| `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. Applies to all input types. | `string` | `undefined` |
|
|
19
|
+
| `placeholder` | `placeholder` | Placeholder text that appears when the field has no value Applies to text, password, number, and date inputs. | `string` | `undefined` |
|
|
20
|
+
| `readonly` | `readonly` | Whether the input is editable | `boolean` | `undefined` |
|
|
21
|
+
| `required` | `required` | Whether the input is required | `boolean` | `undefined` |
|
|
22
|
+
| `step` | `step` | Time increment for dropdown options | `number` | `30` |
|
|
23
|
+
| `timeFormat` | `time-format` | The time format to display for the input. | `"12h" \| "24h"` | `'24h'` |
|
|
24
|
+
| `value` | `value` | Including a `value` will pre-populate the input with the given string. Must be in 24 hour format, ex: 15:25 for 3:25 PM | `string` | `undefined` |
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Events
|
|
28
|
+
|
|
29
|
+
| Event | Description | Type |
|
|
30
|
+
| ---------------------- | ----------------------------------------------------------- | --------------------- |
|
|
31
|
+
| `hasErrorStateChanged` | Event that is emitted when the hasErrorState state changes. | `CustomEvent<string>` |
|
|
32
|
+
| `valueChange` | Event that emits the current value of the input | `CustomEvent<string>` |
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
## Dependencies
|
|
36
|
+
|
|
37
|
+
### Used by
|
|
38
|
+
|
|
39
|
+
- [xpl-input](..)
|
|
40
|
+
|
|
41
|
+
### Depends on
|
|
42
|
+
|
|
43
|
+
- [xpl-input](..)
|
|
44
|
+
- [xpl-icon](../../xpl-icon)
|
|
45
|
+
- [xpl-dropdown](../../xpl-dropdown)
|
|
46
|
+
|
|
47
|
+
### Graph
|
|
48
|
+
```mermaid
|
|
49
|
+
graph TD;
|
|
50
|
+
xpl-input-time --> xpl-input
|
|
51
|
+
xpl-input-time --> xpl-icon
|
|
52
|
+
xpl-input-time --> xpl-dropdown
|
|
53
|
+
xpl-input --> xpl-input-time
|
|
54
|
+
xpl-input-file --> xpl-icon
|
|
55
|
+
xpl-input-color --> xpl-popover
|
|
56
|
+
xpl-input-color --> xpl-icon
|
|
57
|
+
xpl-input-color --> xpl-input
|
|
58
|
+
xpl-input-date --> xpl-icon
|
|
59
|
+
xpl-dropdown --> xpl-dropdown-group
|
|
60
|
+
xpl-dropdown --> xpl-dropdown-option
|
|
61
|
+
xpl-dropdown-group --> xpl-dropdown-group
|
|
62
|
+
xpl-dropdown-group --> xpl-dropdown-option
|
|
63
|
+
xpl-dropdown-group --> xpl-dropdown-heading
|
|
64
|
+
style xpl-input-time fill:#f9f,stroke:#333,stroke-width:4px
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
----------------------------------------------
|
|
68
|
+
|
|
69
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# xpl-large-card
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| ------------- | ------------- | --------------------------------- | --------- | ----------- |
|
|
12
|
+
| `description` | `description` | Description of the Card | `string` | `undefined` |
|
|
13
|
+
| `link` | `link` | Whether the card is a link or not | `boolean` | `undefined` |
|
|
14
|
+
| `name` | `name` | Name of the Card | `string` | `undefined` |
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
## Slots
|
|
18
|
+
|
|
19
|
+
| Slot | Description |
|
|
20
|
+
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
21
|
+
| `"graph-content"` | Content that is shown on the right-side of the card. Generally used for supplemental data visualizations for the data-card |
|
|
22
|
+
| `"title"` | The title for the card. This slot should be used as a replacement for the name field. Used to define a title and tooltip for the data-card |
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
### Depends on
|
|
28
|
+
|
|
29
|
+
- [xpl-icon](../xpl-icon)
|
|
30
|
+
|
|
31
|
+
### Graph
|
|
32
|
+
```mermaid
|
|
33
|
+
graph TD;
|
|
34
|
+
xpl-large-card --> xpl-icon
|
|
35
|
+
style xpl-large-card fill:#f9f,stroke:#333,stroke-width:4px
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
----------------------------------------------
|
|
39
|
+
|
|
40
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# xpl-list
|
|
2
|
+
|
|
3
|
+
A list item is a card with interactive states. List items allow users to select items from a list of items and view more information or make edits.
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------- |
|
|
12
|
+
| `items` | -- | `items` should be an array of objects with the following signature: { avatar?: string; // The URL of the avatar, or the placeholder initials (ex. "SPD"). avatars?: string[]; // The URLs of multiple avatars to be displayed in a group on the right. badges?: string[] \| { // An array of strings or badge-like objects to be displayed as badges dot?: boolean; // in a group on the right. See <xpl-badge> for more details. text: string; variant?: string; }[]; href?: string; // A URL, if this list item is meant to link somewhere. title: string; // The text to be displayed for the list item. metadata?: string[] \| { // An array of strings or strings with icons (reference the allowed icon: string; // Apollo icons) to be displayed as metadata below the title. text: string; }[]; subtext?: string; // Subtext to be displayed on the right. } - Note that you should *only use one of* `avatars`, `badges`, or `subtext`, to avoid cluttering the right-hand side of the list item. | `ListItem[]` | `[]` |
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
## Dependencies
|
|
16
|
+
|
|
17
|
+
### Depends on
|
|
18
|
+
|
|
19
|
+
- [xpl-avatar](../xpl-avatar)
|
|
20
|
+
- [xpl-icon](../xpl-icon)
|
|
21
|
+
- [xpl-badge](../xpl-badge)
|
|
22
|
+
|
|
23
|
+
### Graph
|
|
24
|
+
```mermaid
|
|
25
|
+
graph TD;
|
|
26
|
+
xpl-list --> xpl-avatar
|
|
27
|
+
xpl-list --> xpl-icon
|
|
28
|
+
xpl-list --> xpl-badge
|
|
29
|
+
style xpl-list fill:#f9f,stroke:#333,stroke-width:4px
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
----------------------------------------------
|
|
33
|
+
|
|
34
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# xpl-main-nav
|
|
2
|
+
|
|
3
|
+
The Main Nav component contains is split in 3 areas. The top area is where the branding goes. It's divided into 2 slots `logo` and `brand-name`.
|
|
4
|
+
The middle area is where the main navigation links go. It's a `<nav>` tag with a slot named `navigation`, where a `<ul slot="navigation">` with `<xpl-nav-items>` should be rendered.
|
|
5
|
+
|
|
6
|
+
The bottom area is fixed to the bottom and should be used for actions. To render content within this area use the slot `footer` with a `<ul slot="footer">` tag.
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
<!-- Auto Generated Below -->
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
## Properties
|
|
13
|
+
|
|
14
|
+
| Property | Attribute | Description | Type | Default |
|
|
15
|
+
| -------- | --------- | ----------- | --------------------------- | ----------- |
|
|
16
|
+
| `width` | `width` | | `"default" \| "md" \| "sm"` | `'default'` |
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
## Events
|
|
20
|
+
|
|
21
|
+
| Event | Description | Type |
|
|
22
|
+
| ---------- | ----------- | --------------------- |
|
|
23
|
+
| `navWidth` | | `CustomEvent<string>` |
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
----------------------------------------------
|
|
27
|
+
|
|
28
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# xpl-modal
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| --------- | --------- | -------------------------------- | -------------------------------- | ----------- |
|
|
12
|
+
| `isOpen` | `is-open` | Whether the modal is open. | `boolean` | `false` |
|
|
13
|
+
| `size` | `size` | The size of the modal. | `"large" \| "medium" \| "small"` | `'medium'` |
|
|
14
|
+
| `variant` | `variant` | The visual variant of the modal. | `"default" \| "warning"` | `'default'` |
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
## Events
|
|
18
|
+
|
|
19
|
+
| Event | Description | Type |
|
|
20
|
+
| ------------- | --------------------------------- | ------------------- |
|
|
21
|
+
| `modalClosed` | Emitted when the modal is closed. | `CustomEvent<void>` |
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
## Slots
|
|
25
|
+
|
|
26
|
+
| Slot | Description |
|
|
27
|
+
| ------------- | ---------------------------------- |
|
|
28
|
+
| `"body"` | The body of the modal. |
|
|
29
|
+
| `"primary"` | The primary button of the modal. |
|
|
30
|
+
| `"secondary"` | The secondary button of the modal. |
|
|
31
|
+
| `"subtitle"` | The subtitle of the modal. |
|
|
32
|
+
| `"tertiary"` | The tertiary button of the modal. |
|
|
33
|
+
| `"title"` | The title of the modal. |
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
## Dependencies
|
|
37
|
+
|
|
38
|
+
### Depends on
|
|
39
|
+
|
|
40
|
+
- [xpl-backdrop](../xpl-backdrop)
|
|
41
|
+
- [xpl-icon](../xpl-icon)
|
|
42
|
+
- [xpl-button](../xpl-button)
|
|
43
|
+
|
|
44
|
+
### Graph
|
|
45
|
+
```mermaid
|
|
46
|
+
graph TD;
|
|
47
|
+
xpl-modal --> xpl-backdrop
|
|
48
|
+
xpl-modal --> xpl-icon
|
|
49
|
+
xpl-modal --> xpl-button
|
|
50
|
+
style xpl-modal fill:#f9f,stroke:#333,stroke-width:4px
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
----------------------------------------------
|
|
54
|
+
|
|
55
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# xpl-nav-item
|
|
2
|
+
|
|
3
|
+
This component should be used within sections of the `<xpl-main-nav>`. This component yields a slot named `link`, where a `<a>` tag should be used. Within the `<a>` tag, there are two slots, one named `icon`, where any svg can be placed. An an unnamed slot, where the link text should be placed.
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| ------------ | ------------- | ----------- | --------- | ------- |
|
|
12
|
+
| `navControl` | `nav-control` | | `boolean` | `false` |
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
## Events
|
|
16
|
+
|
|
17
|
+
| Event | Description | Type |
|
|
18
|
+
| --------- | ----------- | ---------------------- |
|
|
19
|
+
| `navOpen` | | `CustomEvent<boolean>` |
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
----------------------------------------------
|
|
23
|
+
|
|
24
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# xpl-pagination
|
|
2
|
+
|
|
3
|
+
> **Note:** This component is in beta. Use with caution and expect updates before the full release.
|
|
4
|
+
|
|
5
|
+
<!-- Auto Generated Below -->
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Properties
|
|
9
|
+
|
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
|
11
|
+
| --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------- | --------- | -------------------- |
|
|
12
|
+
| `currentPage` | `current-page` | The current active page (1-based). Marked as mutable so we can update from inside this component. | `number` | `1` |
|
|
13
|
+
| `rowsPerPageOptions` | `rows-per-page-options` | The rows-per-page options offered in the dropdown. | `string` | `'10,25,50,100,150'` |
|
|
14
|
+
| `selectedRowsPerPage` | `selected-rows-per-page` | The currently selected rows-per-page. | `number` | `10` |
|
|
15
|
+
| `totalPages` | `total-pages` | Total number of pages. | `number` | `1` |
|
|
16
|
+
| `withPageControl` | `with-page-control` | Whether to allow go to page navigation. | `boolean` | `false` |
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
## Events
|
|
20
|
+
|
|
21
|
+
| Event | Description | Type |
|
|
22
|
+
| ------------------- | ------------------------------------------- | --------------------- |
|
|
23
|
+
| `pageChange` | Emitted whenever the current page changes. | `CustomEvent<number>` |
|
|
24
|
+
| `rowsPerPageChange` | Emitted whenever the rows-per-page changes. | `CustomEvent<number>` |
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Dependencies
|
|
28
|
+
|
|
29
|
+
### Depends on
|
|
30
|
+
|
|
31
|
+
- [xpl-select](../xpl-select)
|
|
32
|
+
- [xpl-icon](../xpl-icon)
|
|
33
|
+
|
|
34
|
+
### Graph
|
|
35
|
+
```mermaid
|
|
36
|
+
graph TD;
|
|
37
|
+
xpl-pagination --> xpl-select
|
|
38
|
+
xpl-pagination --> xpl-icon
|
|
39
|
+
xpl-select --> xpl-tag
|
|
40
|
+
xpl-select --> xpl-icon
|
|
41
|
+
xpl-select --> xpl-dropdown
|
|
42
|
+
xpl-dropdown --> xpl-dropdown-group
|
|
43
|
+
xpl-dropdown --> xpl-dropdown-option
|
|
44
|
+
xpl-dropdown-group --> xpl-dropdown-group
|
|
45
|
+
xpl-dropdown-group --> xpl-dropdown-option
|
|
46
|
+
xpl-dropdown-group --> xpl-dropdown-heading
|
|
47
|
+
style xpl-pagination fill:#f9f,stroke:#333,stroke-width:4px
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
----------------------------------------------
|
|
51
|
+
|
|
52
|
+
*Built with [StencilJS](https://stenciljs.com/)*
|