playbook_ui 14.4.0.pre.rc.15 → 14.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 730a5bd0cc6468bc8e64a0c74a967bbd2299fa7a37941b62d976a94839551132
-  data.tar.gz: 939247b6328aba0133eda3efcaa5dfa5fa906ed6ae61e6ea580d2d809f98a60f
+  metadata.gz: b055334412deb6b6b304df09ff7405b6ca7b07a4bdc663cd1ce30e7651e8686d
+  data.tar.gz: 4c0e0936783ecea0c757ae724174f41b5592866dd857eed6ed08742581475949
 SHA512:
-  metadata.gz: e4b071e20b1f7469e2d51fc315d59d25301e7cb11be3ca85bc2d71a27ba61ed51c1a3711e60e77407399e60fe19c75670244f292ae974c73e1242d42a58bbcce
-  data.tar.gz: 353afbba29e23a99a09e8f4194413d4292d0fe0a5fb34d0f673363a7496a1bd87a845e5d90e6b1f8a15754c82913dd64a1a386504ef8e77ecbd263c7cf8de290
+  metadata.gz: 4403d2e0605fe7beb30750f9b2b9a78a42b43de30a4120a01dd6f207c67e63c4752f8c691f5943d6bce83a456ec668a1aeb521f4c11eb7a6174cb9ac563238b1
+  data.tar.gz: 5c3108aec55e046fefbac7318df7bb3a180988924896a498c4da87dc72e49ba7afe5bd965ecfcd2a562c6d922bc6cd083c02ced994deb046b803148f9aa6ef70

data/app/pb_kits/playbook/pb_multiple_users_stacked/_multiple_users_stacked.scss

@@ -3,8 +3,25 @@
 @import "../tokens/opacity";
 @import "../pb_avatar/avatar";
 
+@mixin avatar-size($size) {
+  height: $size;
+  width: $size;
+  .avatar_wrapper {
+    width: $size;
+    height: $size;
+  }
+}
+
+@mixin position($position) {
+  position: absolute;
+  @each $pos, $val in $position {
+    #{$pos}: $val;
+  }
+}
+
 [class^=pb_multiple_users_stacked_kit] {
   $container_size: map-get($avatar-sizes, "xs");
+  $bubble_container_size: map-get($avatar-sizes, "sm");
   $overlap: -15px;
   $border_size: 1px;
   $stacked_size: 18px;
@@ -17,34 +34,24 @@
   flex-shrink: 0;
   flex-grow: 0;
   [class^=pb_avatar_kit].pb_multiple_users_stacked_item {
-    height: $stacked_size;
-    width: $stacked_size;
-      &.dark {
-        .avatar_wrapper {
-          border: $pb_multiple_users_border_size solid $bg_dark;
-        }
-      }
+    @include avatar-size($stacked_size);
+    &.dark {
       .avatar_wrapper {
-        border: $border_size solid $white;
-        height: $stacked_size;
-        width: $stacked_size;
-        img {
-          z-index: 0;
-        }
+        border: $border_size solid $bg_dark;
       }
     }
-  &[class*=_single] .pb_multiple_users_stacked_item {
-    width: $container_size;
-    height: $container_size;
     .avatar_wrapper {
-      width: $container_size;
-      height: $container_size;
+      border: $border_size solid $white;
+      img {
+        z-index: 0;
+      }
     }
   }
+  &[class*=_single] .pb_multiple_users_stacked_item {
+    @include avatar-size($container_size);
+  }
   [class^=pb_avatar_kit].second_item, [class^=pb_badge_kit].second_item {
-    position: absolute;
-    bottom: 0;
-    right: 0;
+    @include position((bottom: 0, right: 0));
     z-index: 2;
     background: tint($primary, 90%);
     border-radius: $border_rad_mega;
@@ -63,4 +70,73 @@
     font-size: 0;
     color: transparent;
   }
+
+  &[class*=_bubble] {
+    @include avatar-size($bubble_container_size);
+    background-color: $bg_light;
+    border-radius: 50%;
+
+    &.dark {
+      background-color: $card_dark;
+    }
+    
+    [class^=pb_avatar_kit].pb_multiple_users_stacked_item {
+      &.dark {
+        .avatar_wrapper {
+          border: $border_size solid $border_dark;
+        }
+      }
+    }
+
+    [class^=pb_avatar_kit] {
+      &.first_item {
+        @include position((top: 4px, left: 3px));
+        @include avatar-size(20px);
+
+        &.triple_bubble {
+          @include position((top: 4px, left: 4px));
+          @include avatar-size(16px);
+        }
+
+        &.quadruple_bubble {
+          @include position((top: 5px, left: 3px));
+          @include avatar-size(16px);
+        }
+      }
+
+      &.second_item {
+        @include position((bottom: 5px, right: 4px));
+        @include avatar-size(12px);
+
+        &.triple_bubble {
+          @include position((top: 13px, right: 2px));
+        }
+
+        &.quadruple_bubble {
+          @include position((bottom: 9px, right: 4px));
+        }
+      }
+
+      &.third_item {
+        @include position((bottom: 3px, left: 11px));
+        @include avatar-size(10px);
+
+        &.quadruple_bubble {
+          @include position((bottom: 3px, left: 9px));
+        }
+      }
+
+      &.fourth_item {
+        @include position((top: 5px, right: 6px));
+        @include avatar-size(8px);
+      }
+    }
+  }
+
+  &[class*=_single_bubble] {
+    [class^=pb_avatar_kit].first_item {
+      @include position((top: 0, left: 0));
+      @include avatar-size($bubble_container_size);
+    }
+  }
 }

data/app/pb_kits/playbook/pb_multiple_users_stacked/_multiple_users_stacked.test.js

@@ -58,4 +58,170 @@ test('should pass aria prop', () => {
     render(<MultipleUsersStackedDefault />)
     const kit = screen.getByTestId(testId)
     expect(kit).toHaveAttribute('aria-label', testId)
+})
+
+const MultipleUsersStackedSingleBubble = () => {
+    return (
+        <MultipleUsersStacked
+            aria={{ label: testId }}
+            className={className}
+            data={{ testid: testId }}
+            users={[
+                {
+                    name: "user1",
+                    imageUrl: "imageUser1",
+                    imageAlt: "nameUser1",
+                }
+            ]}
+            variant="bubble"
+        />
+    )
+}
+
+test('should have a single bubble', () => {
+    render(<MultipleUsersStackedSingleBubble />)
+    const kit = screen.getByTestId(testId)
+    expect(kit).toHaveClass("pb_multiple_users_stacked_kit_single_bubble")
+
+    const firstItem = kit.querySelector('.first_item');
+    expect(firstItem).toBeInTheDocument();
+})
+
+const MultipleUsersStackedDoubleBubble = () => {
+    return (
+        <MultipleUsersStacked
+            aria={{ label: testId }}
+            className={className}
+            data={{ testid: testId }}
+            users={[
+                {
+                    name: "user1",
+                    imageUrl: "imageUser1",
+                    imageAlt: "nameUser1",
+                },
+                {
+                    name: "user2",
+                    imageUrl: "imageUser2",
+                    imageAlt: "nameUser2",
+                },
+            ]}
+            variant="bubble"
+        />
+    )
+}
+
+test('should have a double bubble', () => {
+    render(<MultipleUsersStackedDoubleBubble />)
+    const kit = screen.getByTestId(testId)
+    expect(kit).toHaveClass("pb_multiple_users_stacked_kit_bubble")
+
+    const firstItem = kit.querySelector('.first_item');
+    expect(firstItem).toBeInTheDocument();
+
+    const secondItem = kit.querySelector('.second_item');
+    expect(secondItem).toBeInTheDocument();
+})
+
+const MultipleUsersStackedTripleBubble = () => {
+    return (
+        <MultipleUsersStacked
+            aria={{ label: testId }}
+            className={className}
+            data={{ testid: testId }}
+            users={[
+                {
+                    name: "user1",
+                    imageUrl: "imageUser1",
+                    imageAlt: "nameUser1",
+                },
+                {
+                    name: "user2",
+                    imageUrl: "imageUser2",
+                    imageAlt: "nameUser2",
+                },
+                {
+                    name: "user3",
+                    imageUrl: "imageUser3",
+                    imageAlt: "nameUser3",
+                },
+            ]}
+            variant="bubble"
+        />
+    )
+}
+
+test('should have a triple bubble', () => {
+    render(<MultipleUsersStackedTripleBubble />)
+    const kit = screen.getByTestId(testId)
+    expect(kit).toHaveClass("pb_multiple_users_stacked_kit_bubble")
+
+    const firstItem = kit.querySelector('.first_item');
+    expect(firstItem).toBeInTheDocument();
+    expect(firstItem).toHaveClass("triple_bubble")
+
+    const secondItem = kit.querySelector('.second_item');
+    expect(secondItem).toBeInTheDocument();
+    expect(secondItem).toHaveClass("triple_bubble")
+
+    const thirdItem = kit.querySelector('.third_item');
+    expect(thirdItem).toBeInTheDocument();
+})
+
+const MultipleUsersStackedQuadrupleBubble = () => {
+    return (
+        <MultipleUsersStacked
+            aria={{ label: testId }}
+            className={className}
+            data={{ testid: testId }}
+            users={[
+                {
+                    name: "user1",
+                    imageUrl: "imageUser1",
+                    imageAlt: "nameUser1",
+                },
+                {
+                    name: "user2",
+                    imageUrl: "imageUser2",
+                    imageAlt: "nameUser2",
+                },
+                {
+                    name: "user3",
+                    imageUrl: "imageUser3",
+                    imageAlt: "nameUser3",
+                },
+                {
+                    name: "user4",
+                    imageUrl: "imageUser4",
+                    imageAlt: "nameUser4",
+                },
+                {
+                    name: "user5",
+                    imageUrl: "imageUser5",
+                    imageAlt: "nameUser5",
+                },
+            ]}
+            variant="bubble"
+        />
+    )
+}
+
+test('should have a quadruple bubble', () => {
+    render(<MultipleUsersStackedQuadrupleBubble />)
+    const kit = screen.getByTestId(testId)
+    expect(kit).toHaveClass("pb_multiple_users_stacked_kit_bubble")
+
+    const firstItem = kit.querySelector('.first_item');
+    expect(firstItem).toBeInTheDocument();
+    expect(firstItem).toHaveClass("quadruple_bubble")
+
+    const secondItem = kit.querySelector('.second_item');
+    expect(secondItem).toBeInTheDocument();
+    expect(secondItem).toHaveClass("quadruple_bubble")
+
+    const thirdItem = kit.querySelector('.third_item');
+    expect(thirdItem).toBeInTheDocument();
+    expect(thirdItem).toHaveClass("quadruple_bubble")
+
+    const fourthItem = kit.querySelector('.fourth_item');
+    expect(fourthItem).toBeInTheDocument();
 })

data/app/pb_kits/playbook/pb_multiple_users_stacked/_multiple_users_stacked.tsx

@@ -15,6 +15,7 @@ type MultipleUsersStackedProps = {
   htmlOptions?: {[key: string]: string | number | boolean | (() => void)},
   id?: string,
   users: Array<{ [key: string]: string }>,
+  variant: "default" | "bubble",
 }
 
 const MultipleUsersStacked = (props: MultipleUsersStackedProps) => {
@@ -26,10 +27,14 @@ const MultipleUsersStacked = (props: MultipleUsersStackedProps) => {
     htmlOptions = {},
     id,
     users,
+    variant = "default",
   } = props
 
   const moreThanTwo = users.length > 2
   const onlyOne = users.length == 1
+  const isBubble = variant === "bubble"
+  const tripleBubble = isBubble && users.length === 3
+  const quadrupleBubble = isBubble && users.length > 3
   const displayCount = () => {
     return moreThanTwo ? 1 : users.length
   }
@@ -38,29 +43,61 @@ const MultipleUsersStacked = (props: MultipleUsersStackedProps) => {
   const htmlProps = buildHtmlProps(htmlOptions)
   const classes = classnames(buildCss(
     'pb_multiple_users_stacked_kit',
-    { single: onlyOne }), globalProps(props), className)
+    { single: onlyOne, bubble: isBubble }), globalProps(props), className)
 
   const firstUser = () => {
     return users.slice(0, 1).map((userObject, index) => {
       return (
         <Avatar
             {...userObject}
-            className="pb_multiple_users_stacked_item"
+            className={`pb_multiple_users_stacked_item first_item${tripleBubble ? " triple_bubble" : ""}${quadrupleBubble ? " quadruple_bubble" : ""}`}
             dark={dark}
             key={index}
-            size="xs"
+            size={isBubble ? "sm" : "xs"}
         />
       )
     })
   }
 
   const secondUser = () => {
-    if (moreThanTwo === false) {
+    if (!moreThanTwo || (isBubble && users.length > 1)) {
       return users.slice(1, 2).map((userObject, index) => {
         return (
           <Avatar
               {...userObject}
-              className="pb_multiple_users_stacked_item second_item"
+              className={`pb_multiple_users_stacked_item second_item${tripleBubble ? " triple_bubble" : ""}${quadrupleBubble ? " quadruple_bubble" : ""}`}
+              dark={dark}
+              key={index}
+              size="xs"
+          />
+        )
+      })
+    }
+  }
+
+  const thirdUser = () => {
+    if (isBubble && users.length > 2) {
+      return users.slice(2, 3).map((userObject, index) => {
+        return (
+          <Avatar
+              {...userObject}
+              className={`pb_multiple_users_stacked_item third_item${quadrupleBubble ? " quadruple_bubble" : ""}`}
+              dark={dark}
+              key={index}
+              size="xs"
+          />
+        )
+      })
+    }
+  }
+
+  const fourthUser = () => {
+    if (isBubble && users.length > 3) {
+      return users.slice(3, 4).map((userObject, index) => {
+        return (
+          <Avatar
+              {...userObject}
+              className="pb_multiple_users_stacked_item fourth_item"
               dark={dark}
               key={index}
               size="xs"
@@ -71,7 +108,7 @@ const MultipleUsersStacked = (props: MultipleUsersStackedProps) => {
   }
 
   const plusUsers = () => {
-    if (moreThanTwo === true) {
+    if (moreThanTwo && !isBubble) {
       return (
         <Badge
             className="pb_multiple_users_stacked_item second_item"
@@ -94,6 +131,8 @@ const MultipleUsersStacked = (props: MultipleUsersStackedProps) => {
     >
       {firstUser()}
       {secondUser()}
+      {thirdUser()}
+      {fourthUser()}
       {plusUsers()}
     </div>
   )

data/app/pb_kits/playbook/pb_multiple_users_stacked/docs/_multiple_users_stacked_bubble.html.erb

@@ -0,0 +1,73 @@
+<%= pb_rails("multiple_users_stacked", props: {
+  variant: "bubble",
+  users: [
+    {
+      name: "Patrick Welch",
+      image_url: "https://randomuser.me/api/portraits/men/9.jpg",
+    }
+  ]
+}) %>
+
+<br/><br/>
+
+<%= pb_rails("multiple_users_stacked", props: {
+  variant: "bubble",
+  users: [
+    {
+      name: "Patrick Welch",
+      image_url: "https://randomuser.me/api/portraits/men/9.jpg",
+    },
+    {
+      name: "Lucille Sanchez",
+      image_url: "https://randomuser.me/api/portraits/women/6.jpg",
+    }
+  ]
+}) %>
+
+<br/><br/>
+
+<%= pb_rails("multiple_users_stacked", props: {
+  variant: "bubble",
+  users: [
+    {
+      name: "Patrick Welch",
+      image_url: "https://randomuser.me/api/portraits/men/9.jpg",
+    },
+    {
+      name: "Lucille Sanchez",
+      image_url: "https://randomuser.me/api/portraits/women/6.jpg",
+    },
+    {
+      name: "Beverly Reyes",
+      image_url: "https://randomuser.me/api/portraits/women/74.jpg",
+    },
+  ]
+}) %>
+
+<br/><br/>
+
+<%= pb_rails("multiple_users_stacked", props: {
+  variant: "bubble",
+  users: [
+    {
+      name: "Patrick Welch",
+      image_url: "https://randomuser.me/api/portraits/men/9.jpg",
+    },
+    {
+      name: "Lucille Sanchez",
+      image_url: "https://randomuser.me/api/portraits/women/6.jpg",
+    },
+    {
+      name: "Beverly Reyes",
+      image_url: "https://randomuser.me/api/portraits/women/74.jpg",
+    },
+    {
+      name: "Keith Craig",
+      image_url: "https://randomuser.me/api/portraits/men/40.jpg",
+    },
+    {
+      name: "Alicia Cooper",
+      image_url: "https://randomuser.me/api/portraits/women/46.jpg",
+    }
+  ]
+}) %>

data/app/pb_kits/playbook/pb_multiple_users_stacked/docs/_multiple_users_stacked_bubble.jsx

@@ -0,0 +1,86 @@
+import React from 'react'
+
+import MultipleUsersStacked from '../_multiple_users_stacked'
+
+const MultipleUsersStackedBubble = (props) => {
+  return (
+    <div>
+      <MultipleUsersStacked
+          users={[
+        {
+          name: 'Patrick Welch',
+          imageUrl: 'https://randomuser.me/api/portraits/men/9.jpg',
+        },
+      ]}
+          variant="bubble"
+          {...props}
+      />
+      <br />
+      <br />
+      <MultipleUsersStacked
+          users={[
+        {
+          name: 'Patrick Welch',
+          imageUrl: 'https://randomuser.me/api/portraits/men/9.jpg',
+        },
+        {
+          name: 'Lucille Sanchez',
+          imageUrl: 'https://randomuser.me/api/portraits/women/6.jpg',
+        },
+      ]}
+          variant="bubble"
+          {...props}
+      />
+      <br />
+      <br />
+      <MultipleUsersStacked
+          users={[
+        {
+          name: 'Patrick Welch',
+          imageUrl: 'https://randomuser.me/api/portraits/men/9.jpg',
+        },
+        {
+          name: 'Lucille Sanchez',
+          imageUrl: 'https://randomuser.me/api/portraits/women/6.jpg',
+        },
+        {
+          name: 'Beverly Reyes',
+          imageUrl: 'https://randomuser.me/api/portraits/women/74.jpg',
+        },
+      ]}
+          variant="bubble"
+          {...props}
+      />
+      <br />
+      <br />
+      <MultipleUsersStacked
+          users={[
+        {
+          name: 'Patrick Welch',
+          imageUrl: 'https://randomuser.me/api/portraits/men/9.jpg',
+        },
+        {
+          name: 'Lucille Sanchez',
+          imageUrl: 'https://randomuser.me/api/portraits/women/6.jpg',
+        },
+        {
+          name: 'Beverly Reyes',
+          imageUrl: 'https://randomuser.me/api/portraits/women/74.jpg',
+        },
+        {
+          name: 'Keith Craig',
+          imageUrl: 'https://randomuser.me/api/portraits/men/40.jpg',
+        },
+        {
+          name: 'Alicia Cooper',
+          imageUrl: 'https://randomuser.me/api/portraits/women/46.jpg',
+        },
+      ]}
+          variant="bubble"
+          {...props}
+      />
+    </div>
+  )
+}
+
+export default MultipleUsersStackedBubble

data/app/pb_kits/playbook/pb_multiple_users_stacked/docs/example.yml

@@ -2,10 +2,12 @@ examples:
 
   rails:
   - multiple_users_stacked_default: Default
+  - multiple_users_stacked_bubble: Bubble
 
 
   react:
   - multiple_users_stacked_default: Default
+  - multiple_users_stacked_bubble: Bubble
 
   swift: 
   - multiple_users_stacked_default_swift: Default

data/app/pb_kits/playbook/pb_multiple_users_stacked/docs/index.js

@@ -1 +1,2 @@
 export { default as MultipleUsersStackedDefault } from './_multiple_users_stacked_default.jsx'
+export { default as MultipleUsersStackedBubble } from './_multiple_users_stacked_bubble.jsx'

data/app/pb_kits/playbook/pb_multiple_users_stacked/multiple_users_stacked.html.erb

@@ -1,14 +1,18 @@
 <%= pb_content_tag do %>
-  <%= pb_rails("avatar", props: object.users[0].merge({size: "xs", classname: "pb_multiple_users_stacked_item", dark: object.dark}) ) %>
+  <%= pb_rails("avatar", props: object.users[0].merge({size: object.bubble ? "sm" : "xs", classname: "pb_multiple_users_stacked_item first_item#{object.triple_bubble ? " triple_bubble" : ""}#{object.quadruple_bubble ? " quadruple_bubble" : ""}", dark: object.dark}) ) %>
 
   <% unless object.only_one %>
-    <% if object.more_than_two %>
+    <% if object.more_than_two && !object.bubble %>
       <%= pb_rails("badge", props: {
         dark: object.dark,
         text: "+#{object.users.count - object.display_count}",
         variant: "primary",
         rounded: true,
         classname: "pb_multiple_users_stacked_item second_item" }) %>
+    <% elsif object.bubble %>
+      <% object.users.slice(1,3).each_with_index do |item, idx| %>
+        <%= pb_rails("avatar", props: item.merge({size: "xs", classname: "pb_multiple_users_stacked_item #{idx == 0 ? "second_item#{object.triple_bubble ? " triple_bubble" : ""}#{object.quadruple_bubble ? " quadruple_bubble" : ""}" : idx == 1 ? "third_item#{object.quadruple_bubble ? " quadruple_bubble" : ""}" : "fourth_item"}", dark: object.dark}) ) %>
+      <% end %>
     <% else %>
       <%= pb_rails("avatar", props: object.users[1].merge({size: "xs", classname: "pb_multiple_users_stacked_item second_item", dark: object.dark}) ) %>
     <% end %>

data/app/pb_kits/playbook/pb_multiple_users_stacked/multiple_users_stacked.rb

@@ -5,6 +5,10 @@ module Playbook
     class MultipleUsersStacked < Playbook::KitBase
       prop :users, type: Playbook::Props::HashArray, required: true
 
+      prop :variant, type: Playbook::Props::Enum,
+                     values: %w[default bubble],
+                     default: "default"
+
       def more_than_two
         users.count > 2
       end
@@ -17,8 +21,20 @@ module Playbook
         more_than_two ? 1 : users.count
       end
 
+      def bubble
+        variant == "bubble"
+      end
+
+      def triple_bubble
+        bubble && users.count === 3
+      end
+
+      def quadruple_bubble
+        bubble && users.count > 3
+      end
+
       def classname
-        generate_classname("pb_multiple_users_stacked_kit", single_class)
+        generate_classname("pb_multiple_users_stacked_kit", single_class, bubble_class)
       end
 
     private
@@ -26,6 +42,10 @@ module Playbook
       def single_class
         only_one ? "single" : nil
       end
+
+      def bubble_class
+        bubble ? "bubble" : nil
+      end
     end
   end
 end