@ni/nimble-components 7.2.3 → 7.4.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.
Files changed (101) hide show
  1. package/README.md +24 -1
  2. package/dist/all-components-bundle.js +18611 -0
  3. package/dist/all-components-bundle.js.map +1 -0
  4. package/dist/all-components-bundle.min.js +1345 -0
  5. package/dist/all-components-bundle.min.js.map +1 -0
  6. package/dist/esm/all-components.d.ts +27 -0
  7. package/dist/esm/all-components.js +28 -0
  8. package/dist/esm/all-components.js.map +1 -0
  9. package/dist/esm/breadcrumb/index.d.ts +1 -2
  10. package/dist/esm/breadcrumb/index.js +1 -1
  11. package/dist/esm/breadcrumb/index.js.map +1 -1
  12. package/dist/esm/breadcrumb-item/index.d.ts +1 -2
  13. package/dist/esm/breadcrumb-item/index.js +1 -1
  14. package/dist/esm/breadcrumb-item/index.js.map +1 -1
  15. package/dist/esm/button/index.d.ts +1 -2
  16. package/dist/esm/button/index.js +1 -1
  17. package/dist/esm/button/index.js.map +1 -1
  18. package/dist/esm/checkbox/index.d.ts +1 -2
  19. package/dist/esm/checkbox/index.js +1 -1
  20. package/dist/esm/checkbox/index.js.map +1 -1
  21. package/dist/esm/drawer/index.d.ts +1 -2
  22. package/dist/esm/drawer/index.js +1 -1
  23. package/dist/esm/drawer/index.js.map +1 -1
  24. package/dist/esm/listbox-option/index.d.ts +1 -2
  25. package/dist/esm/listbox-option/index.js +1 -1
  26. package/dist/esm/listbox-option/index.js.map +1 -1
  27. package/dist/esm/menu/index.d.ts +1 -2
  28. package/dist/esm/menu/index.js +1 -1
  29. package/dist/esm/menu/index.js.map +1 -1
  30. package/dist/esm/menu-item/index.d.ts +1 -2
  31. package/dist/esm/menu-item/index.js +1 -1
  32. package/dist/esm/menu-item/index.js.map +1 -1
  33. package/dist/esm/nimble-components/src/all-components.d.ts +27 -0
  34. package/dist/esm/nimble-components/src/breadcrumb/index.d.ts +1 -2
  35. package/dist/esm/nimble-components/src/breadcrumb-item/index.d.ts +1 -2
  36. package/dist/esm/nimble-components/src/button/index.d.ts +1 -2
  37. package/dist/esm/nimble-components/src/checkbox/index.d.ts +1 -2
  38. package/dist/esm/nimble-components/src/drawer/index.d.ts +1 -2
  39. package/dist/esm/nimble-components/src/listbox-option/index.d.ts +1 -2
  40. package/dist/esm/nimble-components/src/menu/index.d.ts +1 -2
  41. package/dist/esm/nimble-components/src/menu-item/index.d.ts +1 -2
  42. package/dist/esm/nimble-components/src/number-field/index.d.ts +1 -2
  43. package/dist/esm/nimble-components/src/select/index.d.ts +2 -4
  44. package/dist/esm/nimble-components/src/switch/index.d.ts +1 -2
  45. package/dist/esm/nimble-components/src/tab/index.d.ts +1 -2
  46. package/dist/esm/nimble-components/src/tab-panel/index.d.ts +1 -2
  47. package/dist/esm/nimble-components/src/tabs/index.d.ts +1 -2
  48. package/dist/esm/nimble-components/src/tabs-toolbar/index.d.ts +1 -2
  49. package/dist/esm/nimble-components/src/tabs-toolbar/template.d.ts +2 -1
  50. package/dist/esm/nimble-components/src/text-area/index.d.ts +1 -2
  51. package/dist/esm/nimble-components/src/text-field/index.d.ts +1 -2
  52. package/dist/esm/nimble-components/src/toggle-button/index.d.ts +1 -2
  53. package/dist/esm/nimble-components/src/toolbar/index.d.ts +11 -0
  54. package/dist/esm/nimble-components/src/toolbar/styles.d.ts +1 -0
  55. package/dist/esm/nimble-components/src/tree-item/index.d.ts +1 -2
  56. package/dist/esm/nimble-components/src/tree-view/index.d.ts +1 -2
  57. package/dist/esm/number-field/index.d.ts +1 -2
  58. package/dist/esm/number-field/index.js +1 -1
  59. package/dist/esm/number-field/index.js.map +1 -1
  60. package/dist/esm/select/index.d.ts +2 -4
  61. package/dist/esm/select/index.js +9 -19
  62. package/dist/esm/select/index.js.map +1 -1
  63. package/dist/esm/switch/index.d.ts +1 -2
  64. package/dist/esm/switch/index.js +1 -1
  65. package/dist/esm/switch/index.js.map +1 -1
  66. package/dist/esm/tab/index.d.ts +1 -2
  67. package/dist/esm/tab/index.js +1 -1
  68. package/dist/esm/tab/index.js.map +1 -1
  69. package/dist/esm/tab-panel/index.d.ts +1 -2
  70. package/dist/esm/tab-panel/index.js +1 -1
  71. package/dist/esm/tab-panel/index.js.map +1 -1
  72. package/dist/esm/tabs/index.d.ts +1 -2
  73. package/dist/esm/tabs/index.js +1 -1
  74. package/dist/esm/tabs/index.js.map +1 -1
  75. package/dist/esm/tabs-toolbar/index.d.ts +1 -2
  76. package/dist/esm/tabs-toolbar/index.js +1 -1
  77. package/dist/esm/tabs-toolbar/index.js.map +1 -1
  78. package/dist/esm/tabs-toolbar/template.d.ts +2 -1
  79. package/dist/esm/tabs-toolbar/template.js.map +1 -1
  80. package/dist/esm/text-area/index.d.ts +1 -2
  81. package/dist/esm/text-area/index.js +1 -1
  82. package/dist/esm/text-area/index.js.map +1 -1
  83. package/dist/esm/text-field/index.d.ts +1 -2
  84. package/dist/esm/text-field/index.js +1 -1
  85. package/dist/esm/text-field/index.js.map +1 -1
  86. package/dist/esm/toggle-button/index.d.ts +1 -2
  87. package/dist/esm/toggle-button/index.js +1 -1
  88. package/dist/esm/toggle-button/index.js.map +1 -1
  89. package/dist/esm/toolbar/index.d.ts +11 -0
  90. package/dist/esm/toolbar/index.js +18 -0
  91. package/dist/esm/toolbar/index.js.map +1 -0
  92. package/dist/esm/toolbar/styles.d.ts +1 -0
  93. package/dist/esm/toolbar/styles.js +28 -0
  94. package/dist/esm/toolbar/styles.js.map +1 -0
  95. package/dist/esm/tree-item/index.d.ts +1 -2
  96. package/dist/esm/tree-item/index.js +1 -1
  97. package/dist/esm/tree-item/index.js.map +1 -1
  98. package/dist/esm/tree-view/index.d.ts +1 -2
  99. package/dist/esm/tree-view/index.js +1 -1
  100. package/dist/esm/tree-view/index.js.map +1 -1
  101. package/package.json +6 -2
package/README.md CHANGED
@@ -17,7 +17,7 @@ If you are using one of the following frameworks see associated wrapper document
17
17
  1. Angular: See the [nimble-angular](/angular-workspace/projects/ni/nimble-angular) documentation.
18
18
  2. Blazor WebAssembly or Blazor Server: See the [nimble-blazor](/packages/nimble-blazor) documentation.
19
19
 
20
- ### Using `nimble-components` in a Webpack Application
20
+ ### Using in a Webpack Application
21
21
 
22
22
  If you have an existing application that incorporates a module bundler like [Webpack](https://webpack.js.org/) but doesn't include one of the above frameworks, you can use `@ni/nimble-components` directly. Exact instructions will depend on your application, but here are some common steps:
23
23
 
@@ -26,6 +26,29 @@ If you have an existing application that incorporates a module bundler like [Web
26
26
  3. Add the HTML for the component to your page. You can see sample code for each component in the [Nimble Storybook](https://ni.github.io/nimble/storybook/) by going to the **Docs** tab for the component and clicking **Show code**. For example: `<nimble-succeeded-icon></nimble-succeeded-icon>`.
27
27
  4. Nimble components are [standard web components (custom elements)](https://developer.mozilla.org/en-US/docs/Web/Web_Components) so you can configure them via normal DOM APIs like attributes, properties, events, and methods. The [Storybook documentation](https://ni.github.io/nimble/storybook/) for each component describes its custom API.
28
28
 
29
+ ### Prototyping in a static webpage
30
+
31
+ If you have a static webpage without a bundler, you can use `@ni/nimble-components` by including one of the bundled distribution files. For example:
32
+
33
+ ```html
34
+ <html>
35
+ <head>
36
+ <script src="https://unpkg.com/@ni/nimble-components/dist/all-components-bundle.js"></script>
37
+ </head>
38
+ <body>
39
+ <nimble-theme-provider theme="light">
40
+ <nimble-button>Hello</nimble-button>
41
+ </nimble-theme-provider>
42
+ </body>
43
+ </html>
44
+ ```
45
+
46
+ Alternatively, to use the minified bundle: `https://unpkg.com/@ni/nimble-components/dist/all-components-bundle.min.js`. To specify a specific version see the instructions on [unpkg.com](https://unpkg.com/).
47
+
48
+ Note: Production applications **must not** rely on the `unpkg.com` service. The service is a useful tool for prototyping or reporting issues.
49
+
50
+ Note: It is recommended that production applications use build tooling to create optimized builds using only required components instead of importing all components via the `all-components-bundle` files.
51
+
29
52
  ## Theming
30
53
 
31
54
  This package contains a theming system which enables changing the appearance of controls based on user preferences or application designs.