@nanoporetech-digital/components-vue 7.9.2 → 8.0.0-alpha.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.
@@ -1,18 +1,18 @@
1
1
  {
2
2
  "nano-accordion": {
3
- "description": "Simple accordion - only one item open at a time - must be used with [details](story/components-accordion--details) elements.",
4
- "attributes": [
5
- "color"
6
- ]
3
+ "description": "Groups multiple details elements together, allowing only one to be open at a time.",
4
+ "attributes": []
7
5
  },
8
6
  "nano-alert": {
9
7
  "description": "Alerts are used to display important messages either inline, as toast notifications or as modals requiring action.",
10
8
  "attributes": [
11
9
  "closable",
12
10
  "color",
11
+ "countdown",
13
12
  "duration",
14
13
  "hoist",
15
- "open"
14
+ "open",
15
+ "theme"
16
16
  ]
17
17
  },
18
18
  "nano-algolia": {
@@ -77,13 +77,47 @@
77
77
  "playback-rate"
78
78
  ]
79
79
  },
80
+ "nano-avatar": {
81
+ "description": "Avatars are used to represent a person or object.",
82
+ "attributes": [
83
+ "initials"
84
+ ]
85
+ },
86
+ "nano-badge": {
87
+ "description": "Badges are used to draw attention and display statuses or counts.",
88
+ "attributes": [
89
+ "pulse",
90
+ "strength",
91
+ "theme"
92
+ ]
93
+ },
94
+ "nano-breadcrumb": {
95
+ "description": "Breadcrumbs are used to indicate the current page's location within a navigational hierarchy.",
96
+ "attributes": [
97
+ "breadcrumbs"
98
+ ]
99
+ },
100
+ "nano-card": {
101
+ "description": "Cards are used to display content in a compact and organized way.",
102
+ "attributes": [
103
+ "layout",
104
+ "size",
105
+ "variant"
106
+ ]
107
+ },
108
+ "nano-card-carousel": {
109
+ "description": "Showcase up to 6 pieces of content in a slide-show format.",
110
+ "attributes": [
111
+ "carousel-title"
112
+ ]
113
+ },
80
114
  "nano-checkbox": {
81
- "description": "`nano-checkbox` is used to let a user choose one or more options from a limited number of options.\nThey appear as checked when activated.\nThey can be checked by mouse, keyboard, touch or programmatically by setting the checked property.",
115
+ "description": "Checkboxes are used to let a user choose one or more values from a limited number of options.",
82
116
  "attributes": [
83
117
  "checked",
84
- "color",
85
118
  "disabled",
86
119
  "form",
120
+ "hide-label",
87
121
  "indeterminate",
88
122
  "invalid",
89
123
  "label",
@@ -95,7 +129,7 @@
95
129
  ]
96
130
  },
97
131
  "nano-checkbox-group": {
98
- "description": "`nano-checkbox-group` is an optional wrapper for all `nano-checkbox` controls.\nIt provides a convenient place to anchor a collective label and any validation issues.",
132
+ "description": "Checkbox group is an optional wrapper for all checkbox controls.\nIt provides a convenient place to anchor labels and validation messages.",
99
133
  "attributes": [
100
134
  "disabled",
101
135
  "hide-legend",
@@ -109,8 +143,55 @@
109
143
  "value"
110
144
  ]
111
145
  },
146
+ "nano-collapsible-comparison": {
147
+ "description": "Collapsible comparison allows users to compare two short lists of titles which can be expanded to reveal more detail about each item.",
148
+ "attributes": [
149
+ "open"
150
+ ]
151
+ },
152
+ "nano-content-links": {
153
+ "description": "Content links are used to group multiple links together.",
154
+ "attributes": []
155
+ },
156
+ "nano-cta": {
157
+ "description": "CTAs (Call To Actions) invite the user to take action.\nThey are used to highlight important content and interactions and are often used in conjunction with other components like cards, modals, and forms.",
158
+ "attributes": [
159
+ "group",
160
+ "icon",
161
+ "loading",
162
+ "secondary",
163
+ "size",
164
+ "theme"
165
+ ]
166
+ },
167
+ "nano-data-table": {
168
+ "description": "Enables the search, filter and sort of tabular data.",
169
+ "attributes": [
170
+ "applied-filters",
171
+ "blocks-length",
172
+ "caption",
173
+ "columns",
174
+ "custom-filter-fn",
175
+ "custom-renderer",
176
+ "custom-sort-fn",
177
+ "default-sort",
178
+ "foot-render",
179
+ "head-render",
180
+ "loading",
181
+ "per-block",
182
+ "placeholder-size",
183
+ "row-render",
184
+ "rows",
185
+ "scrollable",
186
+ "search-term",
187
+ "show-caption",
188
+ "show-footer",
189
+ "show-paginate-spinner",
190
+ "virtual-total-items"
191
+ ]
192
+ },
112
193
  "nano-datalist": {
113
- "description": "`nano-datalist` a visually consistent and more flexible replacement for a native\n[datalist](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist). Can be nested within a `nano-input`\nor linked to any input control via the `input` prop. Is used internally within `nano-select`.\nOptions can be defined declaratively by nesting `<nano-option>` elements or imperatively using the `options` prop",
194
+ "description": "Represents a permissible or recommended list of options available to choose from within other controls.",
114
195
  "attributes": [
115
196
  "active-options",
116
197
  "disable-filter",
@@ -124,10 +205,10 @@
124
205
  ]
125
206
  },
126
207
  "nano-date-input": {
127
- "description": "The date-input component combines `nano-dropdown`, `nano-input` and `nano-date-picker` components to make a fully featured date form field. It has specific options for localisation, date formatting and validation.",
208
+ "description": "The date-input component combines `nano-dropdown`, `nano-input` and `nano-date-picker` components to make a fully featured date form field.\nIt has specific options for localisation, date formatting and validation.",
128
209
  "attributes": [
129
210
  "autofocus",
130
- "clear-input",
211
+ "clearable",
131
212
  "close-after-picked",
132
213
  "color",
133
214
  "date-order",
@@ -161,9 +242,8 @@
161
242
  ]
162
243
  },
163
244
  "nano-date-picker": {
164
- "description": "A highly performant, small and accessible date-picker.\nCustomised from [Duet date-picker](https://duetds.github.io/date-picker/).",
245
+ "description": "Enables the selection of a date from a calendar view.",
165
246
  "attributes": [
166
- "color",
167
247
  "first-day-of-week",
168
248
  "is-date-disabled",
169
249
  "is-modal",
@@ -174,14 +254,12 @@
174
254
  ]
175
255
  },
176
256
  "nano-details": {
177
- "description": "A simple element used to hide or reveal more content with slide effect. Can be used independently or nested within a [accordion](/story/nano-components-accordion--accordion) element to add 'one item open at a time' support.",
257
+ "description": "Details show a brief summary and on interaction expand to show additional content.",
178
258
  "attributes": [
179
259
  "disabled",
180
- "icon-rotation",
181
260
  "label",
182
- "no-handle",
183
261
  "open",
184
- "use-cache-height"
262
+ "size"
185
263
  ]
186
264
  },
187
265
  "nano-dialog": {
@@ -189,7 +267,6 @@
189
267
  "attributes": [
190
268
  "hoist",
191
269
  "label",
192
- "no-footer",
193
270
  "no-header",
194
271
  "no-user-dismiss",
195
272
  "open",
@@ -208,12 +285,13 @@
208
285
  "no-user-dismiss",
209
286
  "open",
210
287
  "placement",
288
+ "resizable",
211
289
  "store-id",
212
290
  "store-method"
213
291
  ]
214
292
  },
215
293
  "nano-dropdown": {
216
- "description": "Dropdowns show additional content in a panel.\nDesigned to work well with nano-menu components to provide a list of options (`nano-nav-items` / `nano-option`).",
294
+ "description": "Dropdowns expose additional content that “drops down” in a panel.",
217
295
  "attributes": [
218
296
  "auto-open",
219
297
  "close-on-select",
@@ -228,7 +306,7 @@
228
306
  ]
229
307
  },
230
308
  "nano-field-validator": {
231
- "description": "A toolbox for `nano-...` form fields and form validation.\n- Easy to add validation across field dependencies - e.g. \"When Field1 contains '123' Field2 must contain '456'\"\n- Easy access to whole form and individual field validity states\n- Easy access to form data payload\n= Access to 2-way, data bound reactive store\n- Scroll to invalid field on submit",
309
+ "description": "A toolbox to expose a form's data model and validation state",
232
310
  "attributes": [
233
311
  "dirty",
234
312
  "extra-field-selector",
@@ -265,35 +343,27 @@
265
343
  "value"
266
344
  ]
267
345
  },
346
+ "nano-footer": {
347
+ "description": "The footer is used to provide navigation, copyright info and links to social media platforms.",
348
+ "attributes": []
349
+ },
268
350
  "nano-global-nav": {
269
- "description": "Nanopore digital global navigation and search bar.\nIncorporates MyAccount / SSO states (messages / cart / user name etc).\nIncorporates Algolia search.",
351
+ "description": "The Global nav component standardises navigation within and across web applications.",
270
352
  "attributes": [
271
- "active-my-account-sections",
272
353
  "cart-count",
273
354
  "cart-url",
274
- "env",
275
- "get-my-account-data",
355
+ "contact-url",
356
+ "login-url",
276
357
  "logo-url",
358
+ "logout-url",
277
359
  "msg-count",
278
360
  "msg-url",
279
361
  "my-account-data",
362
+ "my-account-url",
280
363
  "my-account-user",
281
- "search-api-key",
282
- "search-app-id",
283
- "search-indeces",
284
364
  "search-index",
285
365
  "search-value",
286
- "show-logo",
287
- "show-search",
288
- "sso-data-url",
289
- "sso-redirect"
290
- ]
291
- },
292
- "nano-global-nav-user-profile": {
293
- "description": "Nanopore digital global navigation user profile.",
294
- "attributes": [
295
- "my-account-user",
296
- "user-profile-url"
366
+ "session-redirect"
297
367
  ]
298
368
  },
299
369
  "nano-global-search-results": {
@@ -301,7 +371,7 @@
301
371
  "attributes": []
302
372
  },
303
373
  "nano-grid": {
304
- "description": "A lightweight, context-aware CSS grid implementation.\n\n- Define multiple grids templates at different breakpoints\n- Uses `@container` queries to select the correct grid depending on the current dimensions\n- Use `grid-states=\"...\"` on direct descendants for `column` / `row` - `start` / `end`\n- SSR optimised",
374
+ "description": "A context-aware CSS grid implementation.",
305
375
  "attributes": [
306
376
  "l-cols",
307
377
  "l-size",
@@ -335,7 +405,7 @@
335
405
  ]
336
406
  },
337
407
  "nano-icon": {
338
- "description": "An SVG loader / helper. Comes bundled with all fontawesome pro icons by default but can use any custom SVG (with an correct path).\nLazily loads SVG for each icon, so will only request the icons that you're using and that are visible.",
408
+ "description": "An SVG loader / helper. Comes bundled with font-awesome pro icons & ONT pictogram and device icons.\nLazily loads SVG as icons become visible.",
339
409
  "attributes": [
340
410
  "aria-label",
341
411
  "color",
@@ -349,7 +419,7 @@
349
419
  ]
350
420
  },
351
421
  "nano-icon-button": {
352
- "description": "Icons buttons are simple, icon-only buttons that can be used for actions and in toolbars.",
422
+ "description": "Simple icon-only buttons designed to be used for actions and in toolbars.",
353
423
  "attributes": [
354
424
  "disabled",
355
425
  "form",
@@ -365,6 +435,13 @@
365
435
  "value"
366
436
  ]
367
437
  },
438
+ "nano-icon-item": {
439
+ "description": "Icon Items are a standard way of displaying a Pictogram or Device Icon with some concise text.",
440
+ "attributes": [
441
+ "layout",
442
+ "size"
443
+ ]
444
+ },
368
445
  "nano-img": {
369
446
  "description": "Img with benefits. Lazy loading. Simple `srcSet` solution for both `<img>` and `background-image` varieties.",
370
447
  "attributes": [
@@ -376,24 +453,34 @@
376
453
  "src-set"
377
454
  ]
378
455
  },
456
+ "nano-in-page-nav": {
457
+ "description": "\\\nIn-page navigation allows users to quickly find different sections on a page.",
458
+ "attributes": [
459
+ "breakpoint",
460
+ "sticky-headers"
461
+ ]
462
+ },
379
463
  "nano-input": {
380
- "description": "The input component is a wrapper to the HTML input element with custom styling and additional functionality. It accepts most of the same properties as the HTML [input](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input).\n\nIt is meant for text type inputs only, such as \"text\", \"password\", \"email\", \"number\", \"search\", \"tel\", and \"url\". It supports all standard text input events including keyup, keydown, keypress, and more.\nThe default styling reference comes from the [ONT styleguide](https://nanoporetech.zeroheight.com/styleguide/s/31282/p/230c74-text-input--textarea/b/942ee4)",
464
+ "description": "Inputs collect text data from the user.",
381
465
  "attributes": [
382
466
  "accept",
467
+ "always-show-placeholder",
383
468
  "autocapitalise",
384
469
  "autocomplete",
385
470
  "autocorrect",
386
471
  "autofocus",
387
- "clear-input",
388
472
  "clear-on-edit",
389
- "color",
473
+ "clearable",
474
+ "close-after-picked",
390
475
  "debounce",
391
476
  "disabled",
392
477
  "float-label",
393
478
  "form",
394
479
  "hide-label",
480
+ "initial-picker-date",
395
481
  "inputmode",
396
482
  "invalid",
483
+ "is-date-disabled",
397
484
  "label",
398
485
  "max",
399
486
  "maxlength",
@@ -402,6 +489,7 @@
402
489
  "multiple",
403
490
  "name",
404
491
  "pattern",
492
+ "picker-options",
405
493
  "placeholder",
406
494
  "readonly",
407
495
  "required",
@@ -409,25 +497,41 @@
409
497
  "rows",
410
498
  "show-char-count",
411
499
  "show-inline-error",
500
+ "show-picker",
412
501
  "size",
413
502
  "spellcheck",
414
503
  "step",
415
504
  "type",
416
505
  "validate-on",
417
506
  "validity-message",
418
- "value"
507
+ "value",
508
+ "value-as-date",
509
+ "value-as-number"
419
510
  ]
420
511
  },
421
512
  "nano-intersection-observe": {
422
- "description": "A thin, declarative interface to the IntersectionObserver API.",
513
+ "description": "A thin, declarative interface to the [IntersectionObserver API](https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver).",
423
514
  "attributes": [
424
515
  "root",
425
516
  "root-margin",
426
517
  "threshold"
427
518
  ]
428
519
  },
520
+ "nano-masked-overflow": {
521
+ "description": "`masked-overflow` provides a responsive overflow container for any set of elements that might not fit on smaller screens or containers: it accepts any children,\nautomatically scrolls to the active item on load, and masks additional content using subtle fade effects, plus scroll buttons to cue users that there’s more content off-screen.",
522
+ "attributes": [
523
+ "active-handler",
524
+ "hide-scrollbars",
525
+ "inactive-handler",
526
+ "is-active-handler",
527
+ "label",
528
+ "orientation",
529
+ "scroll-controls",
530
+ "show-indicator"
531
+ ]
532
+ },
429
533
  "nano-menu": {
430
- "description": "Menu element. Commonly wrapped by `nano-dropdown` with `nano-option` and `nano-nav-item` elements nested.\nManages focus state / active.",
534
+ "description": "Menus provide a list of options for the user to choose from.",
431
535
  "attributes": [
432
536
  "has-focus",
433
537
  "label",
@@ -453,15 +557,14 @@
453
557
  ]
454
558
  },
455
559
  "nano-nav-item": {
456
- "description": "Nav items to be used with the various nav items.\n[Globla-Nav](/story/compounds-global-nav)\n[Menu-Drawer](/story/components-menu-drawer)\n[Dropdown](/story/components-dropdown)",
560
+ "description": "Nav items provide options or links for the user to pick from a menu or navigation bar.",
457
561
  "attributes": [
562
+ "checkbox",
458
563
  "close-on-blur",
459
564
  "disabled",
460
565
  "href",
461
566
  "notification",
462
567
  "open",
463
- "secondary-active-width",
464
- "secondary-fallback",
465
568
  "selected",
466
569
  "target"
467
570
  ]
@@ -471,23 +574,14 @@
471
574
  "attributes": [
472
575
  "disabled",
473
576
  "filter-meta",
577
+ "href",
474
578
  "label",
475
579
  "selected",
476
580
  "value"
477
581
  ]
478
582
  },
479
- "nano-overflow-nav": {
480
- "description": "Primarily used to display navigational items that may not fit on smaller screens.\n\n- Accepts any collection of elements\n- Gives visual cues of 'more' with auto display fade effect and scroll buttons\n- Auto scrolls to the active item onload",
481
- "attributes": [
482
- "active-handler",
483
- "in-active-handler",
484
- "is-active-handler",
485
- "orientation",
486
- "scroll-controls"
487
- ]
488
- },
489
583
  "nano-progress-bar": {
490
- "description": "Used to show the status of an ongoing operation.",
584
+ "description": "Shows the status of an ongoing operation.",
491
585
  "attributes": [
492
586
  "indeterminate",
493
587
  "show-percent",
@@ -495,7 +589,7 @@
495
589
  ]
496
590
  },
497
591
  "nano-range": {
498
- "description": "The Range slider lets users select from a range of values by moving\nthe slider knob. It can accept dual knobs, but by default one knob controls the value of the range.\n\nLabels can be placed on either side of the range by adding the\n`slot=\"start\"` or `slot=\"end\"` to the element.",
592
+ "description": "Ranges allow the user to select a value within a given range using a slider.",
499
593
  "attributes": [
500
594
  "color",
501
595
  "debounce",
@@ -525,19 +619,18 @@
525
619
  ]
526
620
  },
527
621
  "nano-resize-observe": {
528
- "description": "A Resize-Observer utility component.\nTakes a string list of sizes and optional class-names.\nAdds class-names and fires `nanoResizeStateChange` events when the component reaches those sizes.\nAdditionally, can fire events when content no-longer fits within the element.",
622
+ "description": "A thin, declarative interface to the [ResizeObserver API](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).",
529
623
  "attributes": [
530
624
  "notify-content-fit",
531
625
  "states"
532
626
  ]
533
627
  },
534
628
  "nano-select": {
535
- "description": "The select component is a wrapper to the HTML select element with custom styling and additional functionality.\nIt accepts most of the same properties as the HTML [select](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).\nIt's multi selection functionality is vastly improved from the native solution. It allows for the control of\nvalue order through drag and drop or changing the insertion point with arrow keys. It also can allow for user defined values.",
629
+ "description": "Selects allow users to choose items from a menu of options.",
536
630
  "attributes": [
537
631
  "allow-custom-values",
538
632
  "autofocus",
539
- "clear-select",
540
- "color",
633
+ "clearable",
541
634
  "debounce",
542
635
  "disabled",
543
636
  "drop-down-config",
@@ -565,7 +658,7 @@
565
658
  ]
566
659
  },
567
660
  "nano-skeleton": {
568
- "description": "Skeletons are used to show where content will eventually be drawn.\nSimple containers for scaffolding layouts that mimic what users will see when content has finished loading.\nPrevents large areas of empty space during asynchronous operations.",
661
+ "description": "Skeletons are used to show where content will eventually be drawn.",
569
662
  "attributes": [
570
663
  "animated"
571
664
  ]
@@ -577,7 +670,7 @@
577
670
  ]
578
671
  },
579
672
  "nano-slides": {
580
- "description": "The Slides component is a multi-section container. Each section can be swiped or dragged between.\nIt contains any number of Slide components.\n\nUses [Flickity](https://flickity.metafizzy.co/) under the hood.",
673
+ "description": "A toolbox for creating carousel or slide-show widgets, allowing users to navigate through a collection of items one at a time.",
581
674
  "attributes": [
582
675
  "animation",
583
676
  "autoplay",
@@ -590,7 +683,7 @@
590
683
  ]
591
684
  },
592
685
  "nano-sortable": {
593
- "description": "An accessible and flexible re-order / sort utility component.\n\n- Drag and drop via mouse, touch or keyboard\n- Live announcements for screen readers\n- Works with or without an explicit handle (although with is preferable)",
686
+ "description": "An accessible and flexible sort and re-order utility.",
594
687
  "attributes": [
595
688
  "animation-enabled",
596
689
  "animation-timing",
@@ -648,7 +741,7 @@
648
741
  ]
649
742
  },
650
743
  "nano-tab": {
651
- "description": "",
744
+ "description": "Tabs are used inside [tab groups](/components/tab-group) to represent and activate [tab content](tab-content).",
652
745
  "attributes": [
653
746
  "active",
654
747
  "closable",
@@ -657,46 +750,37 @@
657
750
  ]
658
751
  },
659
752
  "nano-tab-content": {
660
- "description": "",
753
+ "description": "Used inside [tab groups](/components/tab-group) to display content.",
661
754
  "attributes": [
662
755
  "active",
663
756
  "name"
664
757
  ]
665
758
  },
666
759
  "nano-tab-group": {
667
- "description": "A traditional tab implementation. It nests `nano-tab` and `nano-tab-content` sub-components.\n\nTabs can be stacked vertically or horizontally (which presents different styling variations) using the `placement` attribute.\nHorizontal tabs that don't fit will overflow and scroll appropriately.\nTab-content can also be swiped to change tabs.",
760
+ "description": "Tab groups organize content into a container that shows one section at a time.",
668
761
  "attributes": [
669
- "color",
670
762
  "disable-swipe",
763
+ "equal-tab-size",
671
764
  "no-scroll-controls",
672
765
  "placement",
766
+ "size",
673
767
  "store-id",
674
768
  "store-method"
675
769
  ]
676
770
  },
677
771
  "nano-table": {
678
- "description": "A performant, accessible and semantic (uses real html `<table />`, `<tr />` etc) table and data-grid solution.\n\n- Built-in search\n- Built-in column filter\n- Built-in column sort\n- Easily swap in API / async based search / filter & sort\n- Pin headers, footers, rows, columns\n- Add custom rendering at every level\n- Add custom properties at every level",
772
+ "description": "Displays tabular data in rows and columns.",
679
773
  "attributes": [
680
- "applied-filters",
681
- "blocks-length",
682
- "caption",
683
- "columns",
684
- "custom-filter-fn",
685
- "custom-renderer",
686
- "custom-sort-fn",
687
- "default-sort",
688
- "foot-render",
689
- "head-render",
690
- "loading",
691
- "per-block",
692
- "placeholder-size",
693
- "row-render",
694
- "rows",
695
- "search-term",
696
- "show-caption",
697
- "show-footer",
698
- "type",
699
- "virtual-total-items"
774
+ "compact",
775
+ "hide-caption",
776
+ "scrollable"
777
+ ]
778
+ },
779
+ "nano-tag": {
780
+ "description": "Tags provide a quick visual clue about the content, and help to organise and group content based on shared attributes.",
781
+ "attributes": [
782
+ "closable",
783
+ "size"
700
784
  ]
701
785
  },
702
786
  "nano-tooltip": {