@iress-oss/ids-mcp-server 5.14.2 → 5.20.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/generated/docs/components_components-alert-docs.md +492 -0
- package/generated/docs/components_components-autocomplete-docs.md +3485 -0
- package/generated/docs/{components-autocomplete-recipes-docs.md → components_components-autocomplete-recipes-docs.md} +32 -14
- package/generated/docs/{components-badge-docs.md → components_components-badge-docs.md} +222 -30
- package/generated/docs/components_components-button-docs.md +2078 -0
- package/generated/docs/components_components-button-recipes-docs.md +37 -0
- package/generated/docs/components_components-buttongroup-docs.md +1045 -0
- package/generated/docs/components_components-card-docs.md +2276 -0
- package/generated/docs/{components-card-recipes-docs.md → components_components-card-recipes-docs.md} +131 -14
- package/generated/docs/components_components-checkbox-docs.md +1054 -0
- package/generated/docs/{components-checkboxgroup-docs.md → components_components-checkboxgroup-docs.md} +1000 -81
- package/generated/docs/{components-checkboxgroup-recipes-docs.md → components_components-checkboxgroup-recipes-docs.md} +101 -11
- package/generated/docs/{components-col-docs.md → components_components-col-docs.md} +331 -58
- package/generated/docs/components_components-combobox-docs.md +3767 -0
- package/generated/docs/{components-container-docs.md → components_components-container-docs.md} +61 -24
- package/generated/docs/{components-divider-docs.md → components_components-divider-docs.md} +83 -24
- package/generated/docs/{components-expander-docs.md → components_components-expander-docs.md} +264 -33
- package/generated/docs/{components-field-docs.md → components_components-field-docs.md} +814 -120
- package/generated/docs/components_components-filter-docs.md +4080 -0
- package/generated/docs/{components-form-docs.md → components_components-form-docs.md} +1488 -358
- package/generated/docs/{components-form-recipes-docs.md → components_components-form-recipes-docs.md} +174 -64
- package/generated/docs/components_components-hide-docs.md +293 -0
- package/generated/docs/components_components-icon-docs.md +1337 -0
- package/generated/docs/{components-inline-docs.md → components_components-inline-docs.md} +462 -42
- package/generated/docs/components_components-input-docs.md +1468 -0
- package/generated/docs/components_components-input-recipes-docs.md +367 -0
- package/generated/docs/components_components-inputcurrency-docs.md +432 -0
- package/generated/docs/{components-inputcurrency-recipes-docs.md → components_components-inputcurrency-recipes-docs.md} +110 -17
- package/generated/docs/components_components-label-docs.md +323 -0
- package/generated/docs/components_components-menu-docs.md +2345 -0
- package/generated/docs/components_components-menu-menuitem-docs.md +633 -0
- package/generated/docs/{components-modal-docs.md → components_components-modal-docs.md} +1625 -232
- package/generated/docs/components_components-navbar-docs.md +1847 -0
- package/generated/docs/{components-navbar-recipes-docs.md → components_components-navbar-recipes-docs.md} +697 -39
- package/generated/docs/{components-panel-docs.md → components_components-panel-docs.md} +754 -57
- package/generated/docs/components_components-placeholder-docs.md +92 -0
- package/generated/docs/components_components-popover-docs.md +1641 -0
- package/generated/docs/{components-popover-recipes-docs.md → components_components-popover-recipes-docs.md} +347 -17
- package/generated/docs/components_components-progress-docs.md +115 -0
- package/generated/docs/components_components-provider-docs.md +114 -0
- package/generated/docs/components_components-radio-docs.md +491 -0
- package/generated/docs/{components-radiogroup-docs.md → components_components-radiogroup-docs.md} +943 -75
- package/generated/docs/components_components-readonly-docs.md +263 -0
- package/generated/docs/components_components-richselect-docs.md +6497 -0
- package/generated/docs/{components-row-docs.md → components_components-row-docs.md} +353 -43
- package/generated/docs/{components-select-docs.md → components_components-select-docs.md} +719 -61
- package/generated/docs/components_components-skeleton-docs.md +480 -0
- package/generated/docs/{components-skeleton-recipes-docs.md → components_components-skeleton-recipes-docs.md} +50 -10
- package/generated/docs/{components-skiplink-docs.md → components_components-skiplink-docs.md} +53 -14
- package/generated/docs/components_components-slideout-docs.md +2262 -0
- package/generated/docs/components_components-slider-docs.md +1276 -0
- package/generated/docs/components_components-spinner-docs.md +82 -0
- package/generated/docs/{components-stack-docs.md → components_components-stack-docs.md} +223 -40
- package/generated/docs/components_components-table-docs.md +3651 -0
- package/generated/docs/components_components-tabset-docs.md +772 -0
- package/generated/docs/components_components-tabset-tab-docs.md +262 -0
- package/generated/docs/components_components-tag-docs.md +259 -0
- package/generated/docs/{components-text-docs.md → components_components-text-docs.md} +491 -51
- package/generated/docs/{components-toaster-docs.md → components_components-toaster-docs.md} +224 -71
- package/generated/docs/components_components-toaster-toast-docs.md +634 -0
- package/generated/docs/components_components-toggle-docs.md +461 -0
- package/generated/docs/{components-tooltip-docs.md → components_components-tooltip-docs.md} +286 -41
- package/generated/docs/{components-validationmessage-docs.md → components_components-validationmessage-docs.md} +230 -61
- package/generated/docs/components_contact-us-docs.md +12 -0
- package/generated/docs/{foundations-accessibility-docs.md → components_foundations-accessibility-docs.md} +11 -21
- package/generated/docs/{foundations-colours-docs.md → components_foundations-colour-030-colours.md} +8 -15
- package/generated/docs/{foundations-consistency-docs.md → components_foundations-consistency-docs.md} +12 -20
- package/generated/docs/{foundations-content-docs.md → components_foundations-content-docs.md} +6 -11
- package/generated/docs/components_foundations-introduction-docs.md +15 -0
- package/generated/docs/{foundations-principles-docs.md → components_foundations-principles-docs.md} +14 -24
- package/generated/docs/components_foundations-typography-docs.md +608 -0
- package/generated/docs/{foundations-user-experience-docs.md → components_foundations-user-experience-docs.md} +16 -26
- package/generated/docs/{foundations-visual-design-docs.md → components_foundations-visual-design-docs.md} +10 -17
- package/generated/docs/{frequently-asked-questions-docs.md → components_frequently-asked-questions-docs.md} +14 -23
- package/generated/docs/components_get-started-develop-docs.md +84 -0
- package/generated/docs/components_get-started-using-storybook-docs.md +55 -0
- package/generated/docs/components_introduction-docs.md +15 -0
- package/generated/docs/{patterns-loading-docs.md → components_patterns-loading-docs.md} +711 -143
- package/generated/docs/components_resources-changelog-docs.md +4 -0
- package/generated/docs/{resources-code-katas-docs.md → components_resources-code-katas-docs.md} +5 -9
- package/generated/docs/{resources-migration-guides-from-v4-to-v5-docs.md → components_resources-migration-guides-from-v4-to-v5-docs.md} +54 -239
- package/generated/docs/{versions-docs.md → components_versions-docs.md} +5 -8
- package/generated/docs/guidelines.md +484 -200
- package/generated/docs/introduction-docs.md +19 -30
- package/package.json +41 -45
- package/generated/docs/components-alert-docs.md +0 -130
- package/generated/docs/components-autocomplete-docs.md +0 -754
- package/generated/docs/components-button-docs.md +0 -362
- package/generated/docs/components-button-recipes-docs.md +0 -76
- package/generated/docs/components-buttongroup-docs.md +0 -310
- package/generated/docs/components-card-docs.md +0 -494
- package/generated/docs/components-checkbox-docs.md +0 -193
- package/generated/docs/components-combobox-docs.md +0 -1016
- package/generated/docs/components-filter-docs.md +0 -1109
- package/generated/docs/components-hide-docs.md +0 -265
- package/generated/docs/components-icon-docs.md +0 -553
- package/generated/docs/components-input-docs.md +0 -335
- package/generated/docs/components-input-recipes-docs.md +0 -140
- package/generated/docs/components-inputcurrency-docs.md +0 -157
- package/generated/docs/components-label-docs.md +0 -135
- package/generated/docs/components-menu-docs.md +0 -704
- package/generated/docs/components-menu-menuitem-docs.md +0 -193
- package/generated/docs/components-navbar-docs.md +0 -291
- package/generated/docs/components-placeholder-docs.md +0 -27
- package/generated/docs/components-popover-docs.md +0 -464
- package/generated/docs/components-progress-docs.md +0 -104
- package/generated/docs/components-radio-docs.md +0 -107
- package/generated/docs/components-readonly-docs.md +0 -89
- package/generated/docs/components-richselect-docs.md +0 -2433
- package/generated/docs/components-skeleton-docs.md +0 -214
- package/generated/docs/components-slideout-docs.md +0 -538
- package/generated/docs/components-slider-docs.md +0 -346
- package/generated/docs/components-spinner-docs.md +0 -59
- package/generated/docs/components-table-ag-grid-docs.md +0 -2666
- package/generated/docs/components-table-docs.md +0 -1305
- package/generated/docs/components-tabset-docs.md +0 -341
- package/generated/docs/components-tabset-tab-docs.md +0 -86
- package/generated/docs/components-tag-docs.md +0 -115
- package/generated/docs/components-toaster-toast-docs.md +0 -157
- package/generated/docs/components-toggle-docs.md +0 -158
- package/generated/docs/contact-us-docs.md +0 -27
- package/generated/docs/extensions-editor-docs.md +0 -288
- package/generated/docs/extensions-editor-recipes-docs.md +0 -39
- package/generated/docs/foundations-introduction-docs.md +0 -17
- package/generated/docs/foundations-typography-docs.md +0 -191
- package/generated/docs/get-started-develop-docs.md +0 -48
- package/generated/docs/get-started-using-storybook-docs.md +0 -68
- package/generated/docs/resources-changelog-docs.md +0 -6
- package/generated/docs/themes-available-themes-docs.md +0 -66
- package/generated/docs/themes-introduction-docs.md +0 -121
- package/generated/docs/themes-tokens-docs.md +0 -1200
- /package/{LICENSE.txt → LICENSE} +0 -0
|
@@ -1,191 +0,0 @@
|
|
|
1
|
-
[](#typography)Typography
|
|
2
|
-
=========================
|
|
3
|
-
|
|
4
|
-
Typography is set up as part of the theming. Typography is controlled by the `IressText` component and the `iress-u-text` utility class. They implement consistent line heights and font weights.
|
|
5
|
-
|
|
6
|
-
Typography styles are designed to be encapsulated. If you want text to pick up the Iress styling, you'll need to wrap it in an `IressText` component.
|
|
7
|
-
|
|
8
|
-
[](#body)Body
|
|
9
|
-
-------------
|
|
10
|
-
|
|
11
|
-
This is the default text variant, and is designed to be clear and easy to read.
|
|
12
|
-
|
|
13
|
-
Nobis odit nesciunt in, harum provident deleniti molestiae dolorum aliquid tempora optio accusamus dolore porro voluptatibus. Dolorum, repellat expedita.
|
|
14
|
-
|
|
15
|
-
* Voluptatem assumenda soluta!
|
|
16
|
-
* Illum et atque alias possimus maiores rem in corrupti consectetur!
|
|
17
|
-
* Dolorum, repellat expedita!
|
|
18
|
-
|
|
19
|
-
Hide code
|
|
20
|
-
|
|
21
|
-
\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
|
|
22
|
-
|
|
23
|
-
<IressText\>
|
|
24
|
-
<p\>
|
|
25
|
-
Nobis odit nesciunt in, harum provident deleniti molestiae dolorum aliquid tempora optio accusamus dolore porro voluptatibus. Dolorum, repellat expedita. </p\>
|
|
26
|
-
<ul\>
|
|
27
|
-
<li\>
|
|
28
|
-
Voluptatem assumenda soluta! </li\>
|
|
29
|
-
<li\>
|
|
30
|
-
Illum et atque alias possimus maiores rem in corrupti consectetur! </li\>
|
|
31
|
-
<li\>
|
|
32
|
-
Dolorum, repellat expedita! </li\>
|
|
33
|
-
</ul\>
|
|
34
|
-
</IressText\>
|
|
35
|
-
|
|
36
|
-
Copy
|
|
37
|
-
|
|
38
|
-
[](#headings)Headings
|
|
39
|
-
---------------------
|
|
40
|
-
|
|
41
|
-
Headings form the structure of a web page. They're designed to stand out visually, drawing a user's eye to distinct sections of the document. They can be set in a variety of sizes based on systematic font sizing with native heading scales (H1-H6).
|
|
42
|
-
|
|
43
|
-
Hello, we are a company that puts clients first.
|
|
44
|
-
================================================
|
|
45
|
-
|
|
46
|
-
Hello, we are a company that puts clients first.
|
|
47
|
-
------------------------------------------------
|
|
48
|
-
|
|
49
|
-
### Hello, we are a company that puts clients first.
|
|
50
|
-
|
|
51
|
-
#### Hello, we are a company that puts clients first.
|
|
52
|
-
|
|
53
|
-
##### Hello, we are a company that puts clients first.
|
|
54
|
-
|
|
55
|
-
An H2 styled as an H3.
|
|
56
|
-
----------------------
|
|
57
|
-
|
|
58
|
-
Hide code
|
|
59
|
-
|
|
60
|
-
\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
|
|
61
|
-
|
|
62
|
-
<IressStack gutter\="md"\>
|
|
63
|
-
<IressText element\="h1"\>
|
|
64
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
65
|
-
<IressText element\="h2"\>
|
|
66
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
67
|
-
<IressText element\="h3"\>
|
|
68
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
69
|
-
<IressText element\="h4"\>
|
|
70
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
71
|
-
<IressText element\="h5"\>
|
|
72
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
73
|
-
<IressText
|
|
74
|
-
element\="h2"
|
|
75
|
-
variant\="h3"
|
|
76
|
-
\>
|
|
77
|
-
An H2 styled as an H3. </IressText\>
|
|
78
|
-
</IressStack\>
|
|
79
|
-
|
|
80
|
-
Copy
|
|
81
|
-
|
|
82
|
-
[](#display)Display
|
|
83
|
-
-------------------
|
|
84
|
-
|
|
85
|
-
Display text is used to draw attention to specific pieces of content, like introductory text on a landing page. It has larger font sizes than the heading variants, and a lighter font weight.
|
|
86
|
-
|
|
87
|
-
Hello, we are a company that puts clients first.
|
|
88
|
-
|
|
89
|
-
Hello, we are a company that puts clients first.
|
|
90
|
-
|
|
91
|
-
Hello, we are a company that puts clients first.
|
|
92
|
-
|
|
93
|
-
Hello, we are a company that puts clients first.
|
|
94
|
-
|
|
95
|
-
Hide code
|
|
96
|
-
|
|
97
|
-
\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
|
|
98
|
-
|
|
99
|
-
<IressStack gutter\="md"\>
|
|
100
|
-
<IressText variant\="display1"\>
|
|
101
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
102
|
-
<IressText variant\="display2"\>
|
|
103
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
104
|
-
<IressText variant\="display3"\>
|
|
105
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
106
|
-
<IressText variant\="display4"\>
|
|
107
|
-
Hello, we are a company that puts clients first. </IressText\>
|
|
108
|
-
</IressStack\>
|
|
109
|
-
|
|
110
|
-
Copy
|
|
111
|
-
|
|
112
|
-
[](#lead)Lead
|
|
113
|
-
-------------
|
|
114
|
-
|
|
115
|
-
Lead text is used to introduce users to a new section, and often gives a brief summary of a section. It has a larger font size than body text, but a lighter font weight so that it doesn't clash with headings.
|
|
116
|
-
|
|
117
|
-
Nobis odit nesciunt in, harum provident deleniti molestiae dolorum aliquid tempora optio accusamus dolore porro voluptatibus. Dolorum, repellat expedita.
|
|
118
|
-
|
|
119
|
-
Hide code
|
|
120
|
-
|
|
121
|
-
\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
|
|
122
|
-
|
|
123
|
-
<IressText
|
|
124
|
-
element\="p"
|
|
125
|
-
variant\="lead"
|
|
126
|
-
\>
|
|
127
|
-
Nobis odit nesciunt in, harum provident deleniti molestiae dolorum aliquid tempora optio accusamus dolore porro voluptatibus. Dolorum, repellat expedita.
|
|
128
|
-
</IressText\>
|
|
129
|
-
|
|
130
|
-
Copy
|
|
131
|
-
|
|
132
|
-
[](#caption)Caption
|
|
133
|
-
-------------------
|
|
134
|
-
|
|
135
|
-
The caption variant is used for small text that provides additional information about a table or image. It has a smaller font size than body text, and a lighter font weight.
|
|
136
|
-
|
|
137
|
-
Example caption
|
|
138
|
-
|
|
139
|
-
Hide code
|
|
140
|
-
|
|
141
|
-
\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
|
|
142
|
-
|
|
143
|
-
<IressText element\="caption"\>
|
|
144
|
-
Example caption
|
|
145
|
-
</IressText\>
|
|
146
|
-
|
|
147
|
-
Copy
|
|
148
|
-
|
|
149
|
-
[](#other-variants)Other variants
|
|
150
|
-
---------------------------------
|
|
151
|
-
|
|
152
|
-
IDS also includes bold, italic and small text variants.
|
|
153
|
-
|
|
154
|
-
* Bold text should be used to **draw attention** to part of a sentence, or to provide a visual label for readonly text.
|
|
155
|
-
* Italic text should be used to add _emphasis_ to content, or to add stress to part of a sentence.
|
|
156
|
-
* Small text is used for side comments or for text that's secondary to the main content.
|
|
157
|
-
* Muted text is used to de-emphasise content, such as when displaying informative text that is not critical to the user experience.
|
|
158
|
-
|
|
159
|
-
Bold text
|
|
160
|
-
|
|
161
|
-
Italic text
|
|
162
|
-
|
|
163
|
-
Small text
|
|
164
|
-
|
|
165
|
-
Muted text
|
|
166
|
-
|
|
167
|
-
Hide code
|
|
168
|
-
|
|
169
|
-
\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
|
|
170
|
-
|
|
171
|
-
<IressStack gutter\="md"\>
|
|
172
|
-
<IressText variant\="bold"\>
|
|
173
|
-
Bold text </IressText\>
|
|
174
|
-
<IressText variant\="italic"\>
|
|
175
|
-
Italic text </IressText\>
|
|
176
|
-
<IressText variant\="small"\>
|
|
177
|
-
Small text </IressText\>
|
|
178
|
-
<IressText mode\="muted"\>
|
|
179
|
-
Muted text </IressText\>
|
|
180
|
-
</IressStack\>
|
|
181
|
-
|
|
182
|
-
Copy
|
|
183
|
-
|
|
184
|
-
On this page
|
|
185
|
-
|
|
186
|
-
* [Body](#body)
|
|
187
|
-
* [Headings](#headings)
|
|
188
|
-
* [Display](#display)
|
|
189
|
-
* [Lead](#lead)
|
|
190
|
-
* [Caption](#caption)
|
|
191
|
-
* [Other variants](#other-variants)
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
[](#develop)Develop
|
|
2
|
-
===================
|
|
3
|
-
|
|
4
|
-
Set up your environment to use the latest version of the Iress Design System (IDS). You can use this library to build React applications that align to IDS, and ensure a consistent and modern look and feel across all Iress products.
|
|
5
|
-
|
|
6
|
-
[](#requirements)Requirements
|
|
7
|
-
-----------------------------
|
|
8
|
-
|
|
9
|
-
* [React 17 or later](https://reactjs.org/)
|
|
10
|
-
* Access to Iress Artifactory
|
|
11
|
-
|
|
12
|
-
[](#set-up-the-component-library)Set up the component library
|
|
13
|
-
-------------------------------------------------------------
|
|
14
|
-
|
|
15
|
-
1. Install using: `yarn add @iress-oss/ids-components`
|
|
16
|
-
2. Import the styles: `import '@iress-oss/ids-components/dist/style.css'`
|
|
17
|
-
3. Import the components: `import { IressButton, IressText } from '@iress-oss/ids-components'`
|
|
18
|
-
4. Use the components: `<IressButton>Click me</IressButton>`
|
|
19
|
-
|
|
20
|
-
[](#set-up-the-theme)Set up the theme
|
|
21
|
-
-------------------------------------
|
|
22
|
-
|
|
23
|
-
The component library comes with the white label theme by default. You can add a theme by importing the theme file and including it in your application.
|
|
24
|
-
|
|
25
|
-
Microfrontends
|
|
26
|
-
--------------
|
|
27
|
-
|
|
28
|
-
If you are building a React App that is intended to be used as a microfrontend, please skip this step. Microfrontends should inherit the parent application's theme, and not define a theme itself, as it may conflict with other microfrontends in the same parent application.
|
|
29
|
-
|
|
30
|
-
1. Install using `yarn add @iress/ids-themes`
|
|
31
|
-
2. Import the component: `import { IressTheme } from '@iress/ids-themes'`
|
|
32
|
-
3. Add the component to your application: `<IressTheme name="iress-beta-theme-light" />`.
|
|
33
|
-
|
|
34
|
-
For alternative ways to import the theme, see the [Themes documentation](./?path=/docs/themes-introduction--docs).
|
|
35
|
-
|
|
36
|
-
[](#set-up-the-icons)Set up the icons
|
|
37
|
-
-------------------------------------
|
|
38
|
-
|
|
39
|
-
If you are planning to use the `<IressIcon />` component, you need to include the Font Awesome CSS in your application.
|
|
40
|
-
|
|
41
|
-
You can do this by including the Font Awesome CSS [via the Iress CDN](./?path=/docs/components-icon--docs#installation).
|
|
42
|
-
|
|
43
|
-
On this page
|
|
44
|
-
|
|
45
|
-
* [Requirements](#requirements)
|
|
46
|
-
* [Set up the component library](#set-up-the-component-library)
|
|
47
|
-
* [Set up the theme](#set-up-the-theme)
|
|
48
|
-
* [Set up the icons](#set-up-the-icons)
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
[](#using-storybook)Using Storybook
|
|
2
|
-
===================================
|
|
3
|
-
|
|
4
|
-
The IDS team uses Storybook to develop and document our components. Storybook is a development environment for UI components. It allows you to browse a component library, view the different states of each component, and interactively develop and test components. It is most likely what you are looking at right now.
|
|
5
|
-
|
|
6
|
-
Here we have just highlighted a few of our top tips on how you can use Storybook more efficiently. We have separated it by different stages of the product delivery cycle, but you can use these tips at any stage.
|
|
7
|
-
|
|
8
|
-
* * *
|
|
9
|
-
|
|
10
|
-
[](#first-time-users)First-time users
|
|
11
|
-
-------------------------------------
|
|
12
|
-
|
|
13
|
-
When you first come to the IDS Storybook, you may notice the pages look un-styled. This is the default theme of IDS. You can change the theme to the theme you normally use in your product by clicking the `brush` icon in the top left, right above this page.
|
|
14
|
-
|
|
15
|
-
You can also change to use the dark theme of Storybook itself by clicking the `moon` icon in the top left, right above this page.
|
|
16
|
-
|
|
17
|
-
These settings are saved so the next time you come back to Storybook, it will remember your preferences.
|
|
18
|
-
|
|
19
|
-
[](#scoping-work)Scoping work
|
|
20
|
-
-----------------------------
|
|
21
|
-
|
|
22
|
-
If you are scoping work, you can use Storybook to see what components are available to you. You can also see how they are used and what states they can be in. This can help you to understand what is possible and what is not.
|
|
23
|
-
|
|
24
|
-
Every IDS component has a `Docs` page and a `Guidelines` (coming soon) page. The `Docs` page will show you how to use the component and what props it accepts, helping you understand what is available, and how each property behaves to allow you to understand the final user experience of your feature.
|
|
25
|
-
|
|
26
|
-
The `Guidelines` page will show you how to use the component in a way that is consistent with other Iress applications. It covers things like accessibility, usability, and design principles, as well as which scenario to use which component and common pitfalls.
|
|
27
|
-
|
|
28
|
-
[](#design)Design
|
|
29
|
-
-----------------
|
|
30
|
-
|
|
31
|
-
When designing a new feature, you can use Storybook to see how your designs will look and behave in a real application.
|
|
32
|
-
|
|
33
|
-
`Docs` and `Guidelines` (coming soon) pages will help you understand how to use the components and what is possible, and help you align to any design decisions made previously.
|
|
34
|
-
|
|
35
|
-
`Examples` are a good way to see how variations of a component look and behave. You can see how a component looks in different states, and how it behaves with different props. If there is a variation that is not shown in the `Examples`, you can use the `Controls` tab to change the props of the component to see how it behaves with different values. You can also toggle how each component looks at different breakpoints (screen sizes/devices), how they look to users with certain eyesight conditions, and how they look in different states.
|
|
36
|
-
|
|
37
|
-
Storybook is a starting point for your designs. It is the language developers will be using as they convert your designs into live user experiences. However, not everything is covered here. It is good to discuss your designs with developers to understand what is possible and what is not.
|
|
38
|
-
|
|
39
|
-
[](#development)Development
|
|
40
|
-
---------------------------
|
|
41
|
-
|
|
42
|
-
During development, you can refer to Storybook for code examples and understand the API available to you.
|
|
43
|
-
|
|
44
|
-
If you are using Typescript, majority of the API is available in your IDE. However, Storybook provides more than just the API. It provides examples of how to use and combine the properties, as well as which components were designed to work with each other.
|
|
45
|
-
|
|
46
|
-
`Docs` covers the API of the component, and also discusses `Examples` in detail. Code examples are shown here as well.
|
|
47
|
-
|
|
48
|
-
`Examples` in the sidebar actually allow you to toggle the props in the `Controls` tab to see how combinations look and behave. The `Actions` tab will show you what events are being emitted by the component, and the `Accessibility` tab will show you whether the combination of props is accessible or not in this component. You can also toggle how each component looks at different breakpoints (screen sizes/devices), how they look to users with certain eyesight conditions, and how they look in different states.
|
|
49
|
-
|
|
50
|
-
IDS is a starting point for your application development. It provides the foundations to make your application look and behave in a consistent way to other Iress products. However, not everything is covered here. It is good to discuss with designers and other developers to understand any constraints or guidelines that are not covered by IDS.
|
|
51
|
-
|
|
52
|
-
* * *
|
|
53
|
-
|
|
54
|
-
[](#common-issues)Common issues
|
|
55
|
-
-------------------------------
|
|
56
|
-
|
|
57
|
-
### [](#i-cant-find-the-controls-actions-or-accessibility-tab)I can't find the `Controls`, `Actions` or `Accessibility` tab
|
|
58
|
-
|
|
59
|
-
These tabs are only shown in the `Examples` area of the component. Some tabs are not applicable to some components. If you click on an example and still cannot see it, you may need to toggle the orientation of the addon. You can do this by tapping the `d` key twice, or using the settings as shown in the video.
|
|
60
|
-
|
|
61
|
-
On this page
|
|
62
|
-
|
|
63
|
-
* [First-time users](#first-time-users)
|
|
64
|
-
* [Scoping work](#scoping-work)
|
|
65
|
-
* [Design](#design)
|
|
66
|
-
* [Development](#development)
|
|
67
|
-
* [Common issues](#common-issues)
|
|
68
|
-
* [I can't find the Controls, Actions or Accessibility tab](#i-cant-find-the-controls-actions-or-accessibility-tab)
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
[](#available-themes)Available themes
|
|
2
|
-
=====================================
|
|
3
|
-
|
|
4
|
-
These are the available themes you can apply to Iress products. If you are using the component library, these themes will automatically style the components to match the theme.
|
|
5
|
-
|
|
6
|
-
[](#versions)Versions
|
|
7
|
-
---------------------
|
|
8
|
-
|
|
9
|
-
Themes are no longer connected to the version of IDS you are using. Instead they will support a range of IDS versions.
|
|
10
|
-
|
|
11
|
-
| `@iress/ids-themes` | `@iress-oss/ids-components` |
|
|
12
|
-
| --- | --- |
|
|
13
|
-
| 5.x | 5.x |
|
|
14
|
-
| 4.x | 3.x - 4.x |
|
|
15
|
-
| 3.x | 3.x - 4.x |
|
|
16
|
-
|
|
17
|
-
[](#list)List
|
|
18
|
-
-------------
|
|
19
|
-
|
|
20
|
-
Version: 5.5.0-29782
|
|
21
|
-
|
|
22
|
-
* * *
|
|
23
|
-
|
|
24
|
-
5.5.0-29782Latest5.4.8-262445.4.7-261205.4.6-260525.4.5-260275.4.4-260225.4.3-259955.4.2-259585.4.1-259415.4.0-294265.3.2-290865.3.1-29028
|
|
25
|
-
|
|
26
|
-
None selected
|
|
27
|
-
|
|
28
|
-
Latest build only
|
|
29
|
-
|
|
30
|
-
* * *
|
|
31
|
-
|
|
32
|
-
### Version: 5.5.0-29782
|
|
33
|
-
|
|
34
|
-
* [css/demo-theme-1--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-1--touch.css)
|
|
35
|
-
* [css/demo-theme-1.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-1.css)
|
|
36
|
-
* [css/demo-theme-2--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-2--touch.css)
|
|
37
|
-
* [css/demo-theme-2.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-2.css)
|
|
38
|
-
* [css/demo-theme-3--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-3--touch.css)
|
|
39
|
-
* [css/demo-theme-3.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-3.css)
|
|
40
|
-
* [css/demo-theme-4--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-4--touch.css)
|
|
41
|
-
* [css/demo-theme-4.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-4.css)
|
|
42
|
-
* [css/demo-theme-5--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-5--touch.css)
|
|
43
|
-
* [css/demo-theme-5.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-5.css)
|
|
44
|
-
* [css/demo-theme-6--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-6--touch.css)
|
|
45
|
-
* [css/demo-theme-6.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-6.css)
|
|
46
|
-
* [css/hostplus-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/hostplus-theme-light--touch.css)
|
|
47
|
-
* [css/hostplus-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/hostplus-theme-light.css)
|
|
48
|
-
* [css/iress-beta-theme-dark--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-dark--touch.css)
|
|
49
|
-
* [css/iress-beta-theme-dark.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-dark.css)
|
|
50
|
-
* [css/iress-beta-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-light--touch.css)
|
|
51
|
-
* [css/iress-beta-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-light.css)
|
|
52
|
-
* [css/iress-theme-dark--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-dark--touch.css)
|
|
53
|
-
* [css/iress-theme-dark.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-dark.css)
|
|
54
|
-
* [css/iress-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-light--touch.css)
|
|
55
|
-
* [css/iress-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-light.css)
|
|
56
|
-
* [css/iress-theme-wealth--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-wealth--touch.css)
|
|
57
|
-
* [css/iress-theme-wealth.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-wealth.css)
|
|
58
|
-
|
|
59
|
-
#### Theme mappings
|
|
60
|
-
|
|
61
|
-
* [ag-theme-iress-lite.css](https://cdn-staging.iress.com/ids/5.5.0-29782/ag-theme-iress-lite.css)
|
|
62
|
-
|
|
63
|
-
On this page
|
|
64
|
-
|
|
65
|
-
* [Versions](#versions)
|
|
66
|
-
* [List](#list)
|
|
@@ -1,121 +0,0 @@
|
|
|
1
|
-
[](#themes)Themes
|
|
2
|
-
=================
|
|
3
|
-
|
|
4
|
-
The Iress Design System is designed to be white-labelled, allowing you to change the look and feel of the components to match your brand. This is done by using a theme.
|
|
5
|
-
|
|
6
|
-
* * *
|
|
7
|
-
|
|
8
|
-
Beta
|
|
9
|
-
|
|
10
|
-
New component
|
|
11
|
-
|
|
12
|
-
This component is new, please provide feedback to the IDS team if you encounter any issues.
|
|
13
|
-
|
|
14
|
-
[](#what-are-themes)What are themes?
|
|
15
|
-
------------------------------------
|
|
16
|
-
|
|
17
|
-
Themes are a collection of [design tokens](./?path=/docs/themes-tokens--docs) that are used to style the components to match a certain brand. These tokens are used to define the colours, typography, spacing, and other styles of the components.
|
|
18
|
-
|
|
19
|
-
You can see the current themes available by using the theme switcher in the top left corner of this page.
|
|
20
|
-
|
|
21
|
-
[](#using-a-theme)Using a theme
|
|
22
|
-
-------------------------------
|
|
23
|
-
|
|
24
|
-
To start using a theme in your own application, you can use the `IressTheme` component from the `@iress/ids-themes` package. This component takes the name of a theme and imports the theme CSS (via the Iress CDN) to display the components in that theme.
|
|
25
|
-
|
|
26
|
-
\[data-radix-scroll-area-viewport\] {
|
|
27
|
-
scrollbar-width: none;
|
|
28
|
-
-ms-overflow-style: none;
|
|
29
|
-
-webkit-overflow-scrolling: touch;
|
|
30
|
-
}
|
|
31
|
-
\[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
|
|
32
|
-
display: none;
|
|
33
|
-
}
|
|
34
|
-
:where(\[data-radix-scroll-area-viewport\]) {
|
|
35
|
-
display: flex;
|
|
36
|
-
flex-direction: column;
|
|
37
|
-
align-items: stretch;
|
|
38
|
-
}
|
|
39
|
-
:where(\[data-radix-scroll-area-content\]) {
|
|
40
|
-
flex-grow: 1;
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
import { IressTheme } from '@iress/ids-themes';
|
|
44
|
-
<IressTheme name\="iress-beta-theme-light" />;
|
|
45
|
-
|
|
46
|
-
Copy
|
|
47
|
-
|
|
48
|
-
If you cannot use the Iress CDN, you can also use the dynamic `IressThemeImport` component to import the theme CSS from your dependencies. It will import the theme CSS from the `@iress/ids-themes` package.
|
|
49
|
-
|
|
50
|
-
**Note:** This component dynamically injects CSS into the document, and may throw errors in your tests. Please see the [Testing](#testing) section for more information.
|
|
51
|
-
|
|
52
|
-
\[data-radix-scroll-area-viewport\] {
|
|
53
|
-
scrollbar-width: none;
|
|
54
|
-
-ms-overflow-style: none;
|
|
55
|
-
-webkit-overflow-scrolling: touch;
|
|
56
|
-
}
|
|
57
|
-
\[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
|
|
58
|
-
display: none;
|
|
59
|
-
}
|
|
60
|
-
:where(\[data-radix-scroll-area-viewport\]) {
|
|
61
|
-
display: flex;
|
|
62
|
-
flex-direction: column;
|
|
63
|
-
align-items: stretch;
|
|
64
|
-
}
|
|
65
|
-
:where(\[data-radix-scroll-area-content\]) {
|
|
66
|
-
flex-grow: 1;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
import { IressThemeImport } from '@iress/ids-themes';
|
|
70
|
-
<IressThemeImport
|
|
71
|
-
name\="iress-beta-theme-light"
|
|
72
|
-
fallback\={<IressSpinner screenReaderText\="Loading theme..." />}
|
|
73
|
-
\>
|
|
74
|
-
<App />
|
|
75
|
-
</IressThemeImport\>;
|
|
76
|
-
|
|
77
|
-
Copy
|
|
78
|
-
|
|
79
|
-
[](#testing)Testing
|
|
80
|
-
-------------------
|
|
81
|
-
|
|
82
|
-
Due to the CSS being loaded dynamically, you will need to set up your test configuration to handle the dynamic CSS loading.
|
|
83
|
-
|
|
84
|
-
### [](#vitest)Vitest
|
|
85
|
-
|
|
86
|
-
This will force the CSS from the `@iress/ids-themes` package to be loaded inline in the test environment.
|
|
87
|
-
|
|
88
|
-
\[data-radix-scroll-area-viewport\] {
|
|
89
|
-
scrollbar-width: none;
|
|
90
|
-
-ms-overflow-style: none;
|
|
91
|
-
-webkit-overflow-scrolling: touch;
|
|
92
|
-
}
|
|
93
|
-
\[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
|
|
94
|
-
display: none;
|
|
95
|
-
}
|
|
96
|
-
:where(\[data-radix-scroll-area-viewport\]) {
|
|
97
|
-
display: flex;
|
|
98
|
-
flex-direction: column;
|
|
99
|
-
align-items: stretch;
|
|
100
|
-
}
|
|
101
|
-
:where(\[data-radix-scroll-area-content\]) {
|
|
102
|
-
flex-grow: 1;
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
test: {
|
|
106
|
-
// the rest of your Vitest configuration here
|
|
107
|
-
server: {
|
|
108
|
-
deps: {
|
|
109
|
-
inline: \['@iress/ids-themes'\],
|
|
110
|
-
},
|
|
111
|
-
},
|
|
112
|
-
},
|
|
113
|
-
|
|
114
|
-
Copy
|
|
115
|
-
|
|
116
|
-
On this page
|
|
117
|
-
|
|
118
|
-
* [What are themes?](#what-are-themes)
|
|
119
|
-
* [Using a theme](#using-a-theme)
|
|
120
|
-
* [Testing](#testing)
|
|
121
|
-
* [Vitest](#vitest)
|