@dhasdk/simple-ui 1.0.21 → 1.0.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -7
- package/index.css +1 -1
- package/index.js +13 -13
- package/index.mjs +944 -928
- package/lib/SideBarNav.d.ts +3 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1669,15 +1669,18 @@ Full list of props below
|
|
|
1669
1669
|
| appName | string | No | undefined | The application name to dispilay |
|
|
1670
1670
|
| children | ReactNode | Yes | undefined | This prop takes in any children and displays them between the horizontal rule and the list of menu items. It is intended for to allow developers to add a Search component. See usage example above. |
|
|
1671
1671
|
| className | string | Yes | (1) below | a group of alternate css classes that can be specified by the developer and applied to the outer **`div`** element. |
|
|
1672
|
-
|
|
|
1673
|
-
|
|
|
1672
|
+
| classNameBackgroundShadow | string | Yes | **`absolute inset-0 bg-black/70 z-10`** | a group of alternate css classes that can be specified by the developer and applied to the outer **`div`** element. |
|
|
1673
|
+
| classNameBackButton | string | Yes | **`-mt-8 w-full relative hover:cursor-pointer`** | alternative CSS classes that are applied to the **`button`** (container) that contains the back arrow image and 'Back' text.|
|
|
1674
1674
|
| classNameImage | string | Yes | (2) below | a group of alternate classes that can be specified for the logo image, and applied to the **`img`** element |
|
|
1675
|
-
| classNameImageContainer | string | Yes |
|
|
1676
|
-
| customButton | boolean | Yes | false | When present (or true) this sets the SideBarNav to respond to the custom event handler **`toggleSideBarNav`**. This allows the developer to utilize their own button that simply executes the above custom event handler to toggle the SideBarNav open & closed state. |
|
|
1677
|
-
| menu | boolean | Yes | false | when **`true`**, the default in-component hamburger menu is displayed and used to display or hide the SideBarNav |
|
|
1675
|
+
| classNameImageContainer | string | Yes | **`w-16 h-16 mx-auto`** | a group of alternate classes that can be specified for the logo image's container, and applied to the **`img`** element |
|
|
1678
1676
|
| classNameMenu | string | Yes | empty string | alternate css classes to apply to the element that makes up the hamburger menu |
|
|
1679
1677
|
| classNameMenuContainer | string | Yes | (3) below | alternate css classes to apply to the **`button`** element that wraps up the hamburger menu |
|
|
1680
1678
|
| classNameMenuItem | string | Yes | 'pb-4' | allows the user to add alternate classes via **`twMerge`** to individual menu items |
|
|
1679
|
+
| backgroundShadow | boolean | Yes | false | When true (or present) this sets a background shadow that covers the page with the SideBarNav on top when activated. See also **`classNameBackgroundShadow`** to apply custom styling. |
|
|
1680
|
+
| clickOutsideCloses | boolean | Yes | **`false`** | clicking or tapping elsewhere on the application will close the SideBarNav |
|
|
1681
|
+
| customButton | boolean | Yes | false | When present (or true) this sets the SideBarNav to respond to the custom event handler **`toggleSideBarNav`**. This allows the developer to utilize their own button that simply executes the above custom event handler to toggle the SideBarNav open & closed state. |
|
|
1682
|
+
| image | string | No | undefined | string path to the application logo to display |
|
|
1683
|
+
| menu | boolean | Yes | false | when **`true`**, the default in-component hamburger menu is displayed and used to display or hide the SideBarNav |
|
|
1681
1684
|
| menuItems | ListItemProps[] | No | undefined, see (4) below | The menu items to display |
|
|
1682
1685
|
| right | boolean | Yes | false | when true right-aligns the text inside the sidebarNav |
|
|
1683
1686
|
| version | string | No | undefined | The version number to display |
|
|
@@ -1688,9 +1691,9 @@ Full list of props below
|
|
|
1688
1691
|
- w/o menu **`relative w-56 h-screen flex flex-col px-4 pb-4 pt-10 bg-white overflow-y-auto`**
|
|
1689
1692
|
- w/ menu, include also **`fixed z-20 right-0 top-0 translate-x-full transition-transform duration-300`**
|
|
1690
1693
|
|
|
1691
|
-
|
|
1694
|
+
1. Default classes applied to **`img`** - **`border border-[#bbbabc] w-16 h-16 bg-[#eeeeef] ring-1`**
|
|
1692
1695
|
|
|
1693
|
-
|
|
1696
|
+
2. Default classes applied to **`button`** - **`size-8 mb-4`**
|
|
1694
1697
|
|
|
1695
1698
|
|
|
1696
1699
|
### Example Usage
|