playbook_ui_docs 13.27.0 → 13.28.0.pre.alpha.PBNTR297gradientoverlay3029

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_data.jsx

@@ -9,16 +9,16 @@ const TableAlignmentShiftData = (props) => {
           marginBottom="md"
           {...props}
       >
-        <thead>
-          <tr>
-            <th>&nbsp;</th>
-            <th>{'Price'}</th>
-          </tr>
-        </thead>
-        <tbody>
-          <tr>
-            <td shift="down">{'Total'}</td>
-            <td>
+        <Table.Head>
+          <Table.Row>
+            <Table.Header>&nbsp;</Table.Header>
+            <Table.Header>{'Price'}</Table.Header>
+          </Table.Row>
+        </Table.Head>
+        <Table.Body>
+          <Table.Row>
+            <Table.Cell verticalAlign="bottom">{'Total'}</Table.Cell>
+            <Table.Cell>
               {'$12'}
               <br />
               {'$46'}
@@ -28,50 +28,51 @@ const TableAlignmentShiftData = (props) => {
               {'-------'}
               <br />
               {'$83'}
-            </td>
-          </tr>
-        </tbody>
+            </Table.Cell>
+          </Table.Row>
+        </Table.Body>
       </Table>
+
       <Table
           {...props}
       >
-        <thead>
-          <tr>
-            <th>{'Espresso Drinks'}</th>
-            <th>{'Ingredients'}</th>
-          </tr>
-        </thead>
-        <tbody>
-          <tr>
-            <td shift="up">{'Cappuccino'}</td>
-            <td>
-              {'Espresso'}
-              <br />
-              {'Steamed Milk'}
-              <br />
-              {'Milk Foam'}
-            </td>
-          </tr>
-          <tr>
-            <td shift="up">{'Macchiato'}</td>
-            <td>
-              {'Espresso'}
-              <br />
-              {'Steamed Milk'}
-            </td>
-          </tr>
-          <tr>
-            <td shift="up">{'Mocha'}</td>
-            <td>
-              {'Espresso'}
-              <br />
-              {'Hot Chocolate'}
-              <br />
-              {'Steamed Milk'}
-            </td>
-          </tr>
-        </tbody>
-      </Table>
+      <Table.Head>
+        <Table.Row>
+          <Table.Header>{'Espresso Drinks'}</Table.Header>
+          <Table.Header>{'Ingredients'}</Table.Header>
+        </Table.Row>
+      </Table.Head>
+      <Table.Body>
+        <Table.Row>
+          <Table.Cell verticalAlign="top">{'Cappuccino'} </Table.Cell>
+          <Table.Cell>
+          {'Steamed Milk'}
+          <br />
+          {'Milk Foam'}
+          </Table.Cell>
+        </Table.Row>
+        <Table.Row>
+          <Table.Cell verticalAlign="top">
+            {'Macchiato'}
+            </Table.Cell>
+            <Table.Cell verticalAlign="top">
+            {'Espresso'}
+            <br />
+            {'Steamed Milk'}
+          </Table.Cell>
+        </Table.Row>
+        <Table.Row>
+          <Table.Cell>
+            {'Mocha'}
+            </Table.Cell>
+          <Table.Cell>
+            {'Hot Chocolate'}
+            <br />
+            {'Steamed Milk'}
+          </Table.Cell>
+        </Table.Row>
+      </Table.Body>
+    </Table>
     </div>
   )
 }

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_data.md

@@ -1,2 +1,2 @@
-You can individually shift a piece of table data, or shift an entire column.
+Pass our `verticalAlign` global prop to any `table.cell` subcomponent to change the text alignment of individual cells, or apply this prop persistently to align entire columns.
 The first table shifts "Total" down, whereas the second table shifts the "Espresso Drinks" column contents up.

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_data_rails.html.erb

@@ -0,0 +1,54 @@
+<%= pb_rails("table") do %>
+  <%= pb_rails("table/table_head") do %>
+    <%= pb_rails("table/table_row") do %>
+      <%= pb_rails("table/table_header", props: { text: "&nbsp;" }) %>
+      <%= pb_rails("table/table_header", props: { text: "Price" }) %>
+    <% end %>
+  <% end %>
+  <%= pb_rails("table/table_body") do %>
+    <%= pb_rails("table/table_row") do %>
+      <%= pb_rails("table/table_cell", props: { text: "Total", vertical_align: "bottom" }) %>
+      <%= pb_rails("table/table_cell") do %>
+        $12<br/>
+        $46<br/>
+        $25<br/>
+        -------<br/>
+        $83
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>
+<br/>
+<%= pb_rails("table", props: { size: "sm" }) do %>
+  <%= pb_rails("table/table_head") do %>
+    <%= pb_rails("table/table_row") do %>
+      <%= pb_rails("table/table_header", props: { text: "Espresso Drinks" }) %>
+      <%= pb_rails("table/table_header", props: { text: "Ingredients" }) %>
+    <% end %>
+  <% end %>
+  <%= pb_rails("table/table_body") do %>
+    <%= pb_rails("table/table_row") do %>
+      <%= pb_rails("table/table_cell", props: { text: "Cappuccino", vertical_align: "top" }) %>
+      <%= pb_rails("table/table_cell") do %>
+        Espresso<br/>
+        Steamed Milk<br/>
+        Milk Foam
+      <% end %>
+    <% end %>
+    <%= pb_rails("table/table_row") do %>
+      <%= pb_rails("table/table_cell", props: { text: "Macchiato", vertical_align: "top" }) %>
+      <%= pb_rails("table/table_cell") do %>
+        Espresso<br/>
+        Steamed Milk
+      <% end %>
+    <% end %>
+    <%= pb_rails("table/table_row") do %>
+      <%= pb_rails("table/table_cell", props: { text: "Mocha", vertical_align: "top" }) %>
+      <%= pb_rails("table/table_cell") do %>
+        Espresso<br/>
+        Hot Chocolate<br/>
+        Steamed Milk
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_data_rails.md

@@ -0,0 +1,2 @@
+Pass our `vertical_align` global prop to any `table/table_cell` subcomponent to change the text alignment of individual cells, or apply this prop persistently to align entire columns.
+The first table shifts "Total" down, whereas the second table shifts the "Espresso Drinks" column contents up.

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_row.jsx

@@ -4,60 +4,59 @@ import Table from '../_table'
 
 const TableAlignmentShiftRow = (props) => {
   return (
-    <Table
-        {...props}
-    >
-      <thead>
-        <tr>
-          <th>{'Column 1'}</th>
-          <th>{'Column 2'}</th>
-          <th>{'Column 3'}</th>
-          <th>{'Column 4'}</th>
-          <th>{'Column 5'}</th>
-        </tr>
-      </thead>
-      <tbody>
-        <tr>
-          <td>
+    <Table {...props}>
+      <Table.Head>
+        <Table.Row>
+          <Table.Header>{'Column 1'}</Table.Header>
+          <Table.Header>{'Column 2'}</Table.Header>
+          <Table.Header>{'Column 3'}</Table.Header>
+          <Table.Header>{'Column 4'}</Table.Header>
+          <Table.Header>{'Column 5'}</Table.Header>
+        </Table.Row>
+      </Table.Head>
+      <Table.Body>
+        <Table.Row>
+          <Table.Cell>
             {'Value 1a'}
             <br />
             {'Value 1a'}
             <br />
             {'Value 1a'}
-          </td>
-          <td>{'Value 2a'}</td>
-          <td>{'Value 3a'}</td>
-          <td>{'Value 4a'}</td>
-          <td>{'Value 5a'}</td>
-        </tr>
-        <tr shift="middle">
-          <td>
+          </Table.Cell>
+          <Table.Cell>{'Value 2a'}</Table.Cell>
+          <Table.Cell>{'Value 3a'}</Table.Cell>
+          <Table.Cell>{'Value 4a'}</Table.Cell>
+          <Table.Cell>{'Value 5a'}</Table.Cell>
+        </Table.Row>
+        <Table.Row verticalAlign="middle">
+          <Table.Cell>
             {'Value 1b'}
             <br />
             {'Value 1b'}
             <br />
             {'Value 1b'}
-          </td>
-          <td>{'Value 2b'}</td>
-          <td>{'Value 3b'}</td>
-          <td>{'Value 4b'}</td>
-          <td>{'Value 5b'}</td>
-        </tr>
-        <tr shift="down">
-          <td>
+          </Table.Cell>
+          <Table.Cell>{'Value 2b'}</Table.Cell>
+          <Table.Cell>{'Value 3b'}</Table.Cell>
+          <Table.Cell>{'Value 4b'}</Table.Cell>
+          <Table.Cell>{'Value 5b'}</Table.Cell>
+        </Table.Row>
+        <Table.Row verticalAlign="bottom">
+          <Table.Cell>
             {'Value 1c'}
             <br />
             {'Value 1c'}
             <br />
             {'Value 1c'}
-          </td>
-          <td>{'Value 2c'}</td>
-          <td>{'Value 3c'}</td>
-          <td>{'Value 4c'}</td>
-          <td>{'Value 5c'}</td>
-        </tr>
-      </tbody>
+          </Table.Cell>
+          <Table.Cell>{'Value 2c'}</Table.Cell>
+          <Table.Cell>{'Value 3c'}</Table.Cell>
+          <Table.Cell>{'Value 4c'}</Table.Cell>
+          <Table.Cell>{'Value 5c'}</Table.Cell>
+        </Table.Row>
+      </Table.Body>
     </Table>
+
   )
 }
 

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_row.md

@@ -0,0 +1 @@
+Pass our `verticalAlign` global prop to any `table.row` subcomponent to change the vertical alignment of all cells within that row.

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_row_rails.html.erb

@@ -0,0 +1,53 @@
+<%= pb_rails("table") do %>
+    <%= pb_rails("table/table_head") do %>
+      <%= pb_rails("table/table_row") do %>
+        <%= pb_rails("table/table_header", props: { text: "Column 1" }) %>
+        <%= pb_rails("table/table_header", props: { text: "Column 2" }) %>
+        <%= pb_rails("table/table_header", props: { text: "Column 3" }) %>
+        <%= pb_rails("table/table_header", props: { text: "Column 4" }) %>
+        <%= pb_rails("table/table_header", props: { text: "Column 5" }) %>       
+      <% end %>
+    <% end %>
+    <%= pb_rails("table/table_body") do %>
+      <%= pb_rails("table/table_row") do %>
+        <%= pb_rails("table/table_cell") do %>
+          Value 1a
+          <br />
+          Value 1a
+          <br />
+          Value 1a
+        <% end %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 2a" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 3a" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 4a" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 5a" }) %>
+      <% end %>
+      <%= pb_rails("table/table_row", props: { vertical_align: "middle" }) do %>
+        <%= pb_rails("table/table_cell") do %>
+          Value 1b
+          <br />
+          Value 1b
+          <br />
+          Value 1b
+        <% end %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 2b" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 3b" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 4b" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 5b" }) %>
+      <% end %>
+      <%= pb_rails("table/table_row", props: { vertical_align: "bottom" }) do %>
+        <%= pb_rails("table/table_cell") do %>
+          Value 1c
+          <br />
+          Value 1c
+          <br />
+          Value 1c
+        <% end %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 2c" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 3c" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 4c" }) %>
+        <%= pb_rails("table/table_cell", props: { text: "Value 5c" }) %>
+      <% end %>
+    <% end %>
+  <% end %>
+  

data/app/pb_kits/playbook/pb_table/docs/_table_alignment_shift_row_rails.md

@@ -0,0 +1 @@
+Pass our `vertical_align` global prop to any `table/table_row` subcomponent to change the vertical alignment of all cells within that row.

data/app/pb_kits/playbook/pb_table/docs/{_table_alignment_row.html.erb → _table_outer_padding.html.erb}

@@ -1,11 +1,11 @@
-<%= pb_rails("table") do %>
+<%= pb_rails("table", props: { outer_padding: "sm", size: "sm" }) do %>
   <thead>
     <tr>
       <th>Column 1</th>
       <th>Column 2</th>
       <th>Column 3</th>
       <th>Column 4</th>
-      <th>Column 5</th>
+      <th></th>
     </tr>
   </thead>
   <tbody>
@@ -14,21 +14,21 @@
       <td>Value 2</td>
       <td>Value 3</td>
       <td>Value 4</td>
-      <td>Value 5</td>
+      <td align="right"><%= pb_rails("button", props: { text: "Action", variant: "secondary" }) %></td>
     </tr>
-    <tr align="center">
+    <tr>
       <td>Value 1</td>
       <td>Value 2</td>
       <td>Value 3</td>
       <td>Value 4</td>
-      <td>Value 5</td>
+      <td align="right"><%= pb_rails("button", props: { text: "Action", variant: "secondary" }) %></td>
     </tr>
-    <tr align="right">
+    <tr>
       <td>Value 1</td>
       <td>Value 2</td>
       <td>Value 3</td>
       <td>Value 4</td>
-      <td>Value 5</td>
+      <td align="right"><%= pb_rails("button", props: { text: "Action", variant: "secondary" }) %></td>
     </tr>
   </tbody>
 <% end %>

data/app/pb_kits/playbook/pb_table/docs/_table_outer_padding.jsx

@@ -0,0 +1,76 @@
+import React from 'react'
+
+import Table from '../_table'
+import Button from '../../pb_button/_button'
+
+const TableOuterPadding = (props) => {
+  return (
+    <Table
+        outerPadding="sm"
+        size="sm"
+        {...props}
+    >
+      <thead>
+        <tr>
+          <th>{'Column 1'}</th>
+          <th>{'Column 2'}</th>
+          <th>{'Column 3'}</th>
+          <th>{'Column 4'}</th>
+          <th>{''}</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>{'Value 1'}</td>
+          <td>{'Value 2'}</td>
+          <td>{'Value 3'}</td>
+          <td>{'Value 4'}</td>
+          <td align="right">
+            {' '}
+            <Button
+                onClick={() => alert('button clicked!')}
+                text="Action"
+                variant="secondary"
+                {...props}
+            />
+            {' '}
+          </td>
+        </tr>
+        <tr>
+          <td>{'Value 1'}</td>
+          <td>{'Value 2'}</td>
+          <td>{'Value 3'}</td>
+          <td>{'Value 4'}</td>
+          <td align="right">
+            {' '}
+            <Button
+                onClick={() => alert('button clicked!')}
+                text="Action"
+                variant="secondary"
+                {...props}
+            />
+            {' '}
+          </td>
+        </tr>
+        <tr>
+          <td>{'Value 1'}</td>
+          <td>{'Value 2'}</td>
+          <td>{'Value 3'}</td>
+          <td>{'Value 4'}</td>
+          <td align="right">
+            {' '}
+            <Button
+                onClick={() => alert('button clicked!')}
+                text="Action"
+                variant="secondary"
+                {...props}
+            />
+            {' '}
+          </td>
+        </tr>
+      </tbody>
+    </Table>
+  )
+}
+
+export default TableOuterPadding

data/app/pb_kits/playbook/pb_table/docs/_table_outer_padding.md

@@ -0,0 +1 @@
+Pass any of our spacing tokens to the `outerPadding` / `outer_padding` prop to customize a table's outer padding (both the left padding of the first column and the right padding of the last column).

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

@@ -5,10 +5,10 @@ examples:
     - table_lg: Large
     - table_sticky: Sticky Header
     - table_header: Table Header
-    - table_alignment_row: Row Alignment
-    - table_alignment_column: Column Alignment
-    - table_alignment_shift_row: Shift Row
-    - table_alignment_shift_data: Shift Column Data
+    - table_alignment_row_rails: Row Alignment
+    - table_alignment_column_rails: Cell Alignment
+    - table_alignment_shift_row_rails: Row Shift
+    - table_alignment_shift_data_rails: Cell Shift
     - table_side_highlight: Side Highlight
     - table_container: Table Container Off
     - table_disable_hover: Disable Hover
@@ -26,7 +26,7 @@ examples:
     - table_striped: Striped Table
     - table_with_subcomponents_rails: Table with Sub Components (Table Elements)
     - table_with_subcomponents_as_divs: Table with Sub Components (Divs)
-
+    - table_outer_padding: Outer Padding
 
   react:
     - table_sm: Small
@@ -34,9 +34,9 @@ examples:
     - table_lg: Large
     - table_sticky: Sticky Header
     - table_alignment_row: Row Alignment
-    - table_alignment_column: Column Alignment
-    - table_alignment_shift_row: Shift Row
-    - table_alignment_shift_data: Shift Column Data
+    - table_alignment_column: Cell Alignment
+    - table_alignment_shift_row: Row Shift
+    - table_alignment_shift_data: Cell Shift
     - table_side_highlight: Side Highlight
     - table_container: Table Container Off
     - table_disable_hover: Disable Hover
@@ -54,4 +54,4 @@ examples:
     - table_striped: Striped Table
     - table_with_subcomponents: Table with Sub Components (Table Elements)
     - table_with_subcomponents_as_divs: Table with Sub Components (Divs)
-
+    - table_outer_padding: Outer Padding

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

@@ -24,3 +24,4 @@ export { default as TableStriped } from './_table_striped.jsx'
 export { default as TableDiv } from './_table_div.jsx'
 export { default as TableWithSubcomponents } from './_table_with_subcomponents.jsx'
 export { default as TableWithSubcomponentsAsDivs } from './_table_with_subcomponents_as_divs.jsx'
+export { default as TableOuterPadding } from './_table_outer_padding.jsx'

data/dist/app/components/playbook/pb_docs/kit_example.html.erb

@@ -23,11 +23,11 @@
         <ul>
           <% hide_button = type == "rails" ? 'flex' : 'none' %>
             <li>
-            <%= pb_rails("button", props: { id:"copy-html-#{example_key}", icon: "copy", text: "Copy HTML", variant: "link", size: "sm", display: hide_button }) %>
+            <%= pb_rails("button", props: { id:"copy-html-#{example_key}", icon: "copy", text: "Copy HTML", classname: dark ? "dark" : "", variant: "link", size: "sm", display: hide_button }) %>
             </li>
           <li>
-            <%= pb_rails("button", props: { icon: "code", id:"toggle-open-opened", text: "Close Code", variant: "link", size: "sm", display: "none" }) %>
-            <%= pb_rails("button", props: { icon: "code", id:"toggle-open-closed", text: "Show Code", variant: "link", size: "sm" }) %>
+            <%= pb_rails("button", props: { icon: "code", id:"toggle-open-opened", classname: dark ? "dark" : "", text: "Close Code", variant: "link", size: "sm", display: "none" }) %>
+            <%= pb_rails("button", props: { icon: "code", id:"toggle-open-closed", classname: dark ? "dark" : "", text: "Show Code", variant: "link", size: "sm" }) %>
           </li>
         </ul>
       </div>

data/dist/menu.yml

@@ -255,9 +255,9 @@ kits:
         description: Playbook's date picker is built using flatpickr, a vanilla js library. Common date picker use cases and features have been adapted into simple prop based configuration detailed in the docs below.
         status: "stable"
       - name: dropdown
-        platforms: *react_only
+        platforms: *web
         description: ""
-        status: "beta"
+        status: "stable"
       - name: "multi_level_select"
         platforms: *web
         description: The MultiLevelSelect kit renders a multi leveled select dropdown based on data from the user. 
@@ -352,6 +352,12 @@ kits:
         platforms: *web
         description: 
         status: "stable"
+      - name: "overlay"
+        platforms: *react_only
+      - name: "draggable"
+        platforms: *react_only
+        description:
+        status: "beta"
   - name: message_text_patterns
     description: 
     components:
@@ -463,5 +469,4 @@ kits:
         status: "stable"
       - name: "user"
         platforms: *web
-        description: This kit was created for having a systematic way of displaying users with avatar, titles, name and territory. This is a versatile kit with features than can be added to display more info.
-        status: "stable"
+        description: This kit was created for having a systematic way of displaying users with avatar, titles, name and territory. This is a versatile kit with features than can be added to display more info.