playbook_ui_docs 13.11.1 → 13.12.0.pre.alpha.play900startratingasinput1543

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_color_options.html.erb

@@ -0,0 +1,7 @@
+<%= pb_rails("star_rating", props: { rating: 3 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, color_option: "outline" }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, color_option: "primary" }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, color_option: "subtle" }) %>

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_color_options.jsx

@@ -0,0 +1,40 @@
+import React from 'react'
+
+import StarRating from '../_star_rating'
+
+const StarRatingColorOptions = (props) => (
+  <>
+
+    <StarRating
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        colorOption='outline'
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        colorOption='primary'
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        colorOption='subtle'
+        rating={3}
+        {...props}
+    />
+
+  </>
+)
+
+export default StarRatingColorOptions

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_default.html.erb

@@ -2,12 +2,22 @@
 
 <br>
 
+<%= pb_rails("star_rating", props: { rating: 1 }) %>
+
+<br>
+
+<%= pb_rails("star_rating", props: { rating: 2}) %>
+
+<br>
+
 <%= pb_rails("star_rating", props: { rating: 3 }) %>
 
 <br>
 
-<%= pb_rails("star_rating", props: { rating: 1.5 }) %>
+<%= pb_rails("star_rating", props: { rating: 4 }) %>
 
 <br>
 
 <%= pb_rails("star_rating", props: { rating: 5 }) %>
+
+<br>

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_default.jsx

@@ -4,12 +4,12 @@ import StarRating from '../_star_rating'
 
 const StarRatingDefault = (props) => (
   <>
-    <StarRating />
+    <StarRating {...props} />
 
     <br />
 
     <StarRating
-        rating={3}
+        rating={0.9}
         {...props}
     />
 
@@ -20,6 +20,21 @@ const StarRatingDefault = (props) => (
         {...props}
     />
 
+    <br />
+
+    <StarRating
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        rating={4.2}
+        {...props}
+    />
+
+
     <br />
 
     <StarRating

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_hide.html.erb

@@ -1 +1,6 @@
-<%= pb_rails("star_rating", props: { rating: 3.5, hide_rating: true }) %>
+<%= pb_rails("star_rating", props: { rating: 3 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, layout_option: "number" }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, layout_option: "onestar" }) %>
+</br>

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_hide.jsx

@@ -3,13 +3,30 @@ import React from 'react'
 import StarRating from '../_star_rating'
 
 const StarRatingHide = (props) => (
+  <>
 
-  <StarRating
-      hideRating
-      rating={3.5}
-      {...props}
-  />
+    <StarRating
+        rating={3}
+        {...props}
+    />
 
+    <br />
+
+    <StarRating
+        layoutOption={"number"}
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        layoutOption={"onestar"}
+        rating={3}
+        {...props}
+    />
+
+  </>
 )
 
 export default StarRatingHide

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_number_config.html.erb

@@ -0,0 +1,12 @@
+<%= pb_rails("star_rating", props: { rating: 3, denominator: 3 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, denominator: 4 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, denominator: 6 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, denominator: 7 }) %>
+</br>
+<%= pb_rails("star_rating", props: { rating: 3, denominator: 8 }) %>
+</br>

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_number_config.jsx

@@ -0,0 +1,57 @@
+import React from 'react'
+
+import StarRating from '../_star_rating'
+
+const StarRatingNumberConfig = (props) => (
+  <>
+
+    <StarRating
+        denominator={3}
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        denominator={4}
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        denominator={5}
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        denominator={6}
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        denominator={7}
+        rating={3}
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        denominator={8}
+        rating={3}
+        {...props}
+    />
+
+  </>
+)
+
+export default StarRatingNumberConfig

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_size_options.html.erb

@@ -0,0 +1,23 @@
+<%= pb_rails("star_rating", props: { rating: 3, size: "xs" }) %>
+
+<br>
+
+<%= pb_rails("star_rating", props: { rating: 3, size: "sm" }) %>
+
+<br>
+
+<%= pb_rails("star_rating", props: { rating: 3, size: "md" }) %>
+
+<br>
+
+<%= pb_rails("star_rating", props: { rating: 3, size: "lg" }) %>
+
+<br>
+
+<%= pb_rails("star_rating", props: { rating: 3, size: "lg", layout_option: "number" }) %>
+
+<br>
+
+<%= pb_rails("star_rating", props: { rating: 3, size: "lg", layout_option: "onestar" }) %>
+
+<br>

data/app/pb_kits/playbook/pb_star_rating/docs/_star_rating_size_options.jsx

@@ -0,0 +1,59 @@
+import React from 'react'
+
+import StarRating from '../_star_rating'
+
+const StarRatingSizeOptions = (props) => (
+  <>
+
+    <StarRating
+        rating={3}
+        size="xs"
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        rating={3}
+        size="sm"
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        rating={3}
+        size="md"
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        rating={3}
+        size="lg"
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        layoutOption="number"
+        rating={3}
+        size="lg"
+        {...props}
+    />
+
+    <br />
+
+    <StarRating
+        layoutOption="onestar"
+        rating={3}
+        size="lg"
+        {...props}
+    />
+
+  </>
+)
+
+export default StarRatingSizeOptions

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

@@ -1,9 +1,14 @@
 examples:
-
   rails:
-  - star_rating_default: Default
-  - star_rating_hide: Hide Rating Value
+    - star_rating_default: Default
+    - star_rating_color_options: Color Options
+    - star_rating_hide: Layout Options
+    - star_rating_number_config: Number Config
+    - star_rating_size_options: Size Options
 
   react:
-  - star_rating_default: Default
-  - star_rating_hide: Hide Rating Value
+    - star_rating_default: Default
+    - star_rating_color_options: Color Options
+    - star_rating_hide: Layout Options
+    - star_rating_number_config: Number Config
+    - star_rating_size_options: Size Options

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

@@ -1,3 +1,9 @@
 export { default as StarRatingDefault } from './_star_rating_default.jsx'
 
+export { default as StarRatingColorOptions } from './_star_rating_color_options.jsx'
+
 export { default as StarRatingHide } from './_star_rating_hide.jsx'
+
+export { default as StarRatingNumberConfig } from './_star_rating_number_config.jsx'
+
+export { default as StarRatingSizeOptions } from './_star_rating_size_options.jsx'

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

@@ -39,10 +39,10 @@
         text: "Full Name",
         colspan: 2,
         sort_menu: [
-          { item: "First Name Descending", link: "?sort=firstname_desc#table-header", active: params["sort"] == "firstname_desc", direction: "desc" },
-          { item: "First Name Ascending", link: "?sort=firstname_asc#table-header", active: params["sort"] == "firstname_asc", direction: "asc" },
-          { item: "Last Name Descending", link: "?sort=lastname_desc#table-header", active: params["sort"] == "lastname_desc", direction: "desc" },
-          { item: "Last Name Ascending", link: "?sort=lastname_asc#table-header", active: params["sort"] == "lastname_asc", direction: "asc" }
+          { item: "First Name", link: "?sort=firstname_desc#table-header", active: params["sort"] == "firstname_desc", direction: "desc" },
+          { item: "First Name", link: "?sort=firstname_asc#table-header", active: params["sort"] == "firstname_asc", direction: "asc" },
+          { item: "Last Name", link: "?sort=lastname_desc#table-header", active: params["sort"] == "lastname_desc", direction: "desc" },
+          { item: "Last Name", link: "?sort=lastname_asc#table-header", active: params["sort"] == "lastname_asc", direction: "asc" }
         ],
       }) %>
       <%= pb_rails("table/table_header", props: {

data/app/pb_kits/playbook/pb_textarea/docs/_textarea_default_swift.md

@@ -0,0 +1,27 @@
+![textarea-default](https://github.com/powerhome/playbook/assets/92755007/40eec958-63d7-4840-bf5c-f8d1e34c911a)
+
+```swift
+
+@State var defaultText = ""
+@State var placeholderText = ""
+@State var customText = "Default value text"
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  PBTextArea(
+    "Label",
+    text: $defaultText
+  )
+
+  PBTextArea(
+    "Label",
+    text: $placeholderText,
+    placeholder: "Placeholder with text"
+  )
+
+  PBTextArea(
+    "Label",
+    text: $customText
+  )
+}
+
+```

data/app/pb_kits/playbook/pb_textarea/docs/_textarea_error_swift.md

@@ -0,0 +1,11 @@
+![textarea-error](https://github.com/powerhome/playbook/assets/92755007/6d47a914-ea0b-4fbc-9f2a-6237935a3b4c)
+
+```swift
+
+PBTextArea(
+  "Label",
+  text: $errorText,
+  error: "This field has an error!"
+)
+
+```

data/app/pb_kits/playbook/pb_textarea/docs/_textarea_props_swift.md

@@ -0,0 +1,9 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **characterCount** | `CharacterCount` | Adds a character counter to the Textarea | `.noCount` | `.noCount` `.count` `.maxCharacterCount` `.maxCharacterCountBlock` `.maxCharacterCountError` |
+| **inline** | `Bool` | Changes the style of the Textarea | `false` | `true` `false` |
+| **label** | `String` | Adds a label | `nil` |  |
+| **placeholder** | `String` | Adds placeholder text | `nil` |  |
+| **text** | `String` | Sets the Textarea's text value | `Binding<String>` |  |
+| **error** | `String` | Changes the style of the Textarea | `nil` |  |

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

@@ -15,3 +15,8 @@ examples:
   - textarea_error: Textarea w/ Error
   - textarea_character_counter: Character Counter
   - textarea_inline: Inline
+
+  swift:
+  - textarea_default_swift: Default
+  - textarea_error_swift: Textarea w/ Error
+  - textarea_props_swift: ""

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_default.html.erb

@@ -1,4 +1,4 @@
-<%= pb_rails("flex", props: { gap: "md", justify: "center", wrap: true }) do %>
+<%= pb_rails("flex", props: { gap: "md", wrap: true }) do %>
   <%= pb_rails("flex/flex_item") do %>
     <span id='regular-tooltip-1'>Hover here (Top)</span>
 

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_default_react.jsx

@@ -9,12 +9,10 @@ const TooltipDefaultReact = (props) => {
    <Flex 
        flexDirection='row'
        gap='md'
-       justifyContent='center'
        wrap
    >
     <FlexItem>
       <Tooltip 
-          className={"customClassNameHere"}
           placement='top' 
           text="Whoa. I'm a Tooltip" 
           zIndex={10}

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_delay.jsx

@@ -9,7 +9,6 @@ const TooltipDelay = (props) => {
    <Flex 
        flexDirection='row'
        gap='md'
-       justifyContent='center'
        wrap
    >
     <FlexItem>

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_interaction.jsx

@@ -9,7 +9,6 @@ const TooltipInteraction = (props) => {
    <Flex 
        flexDirection='row'
        gap='md'
-       justifyContent='center'
        wrap
    >
     <FlexItem>

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_margin.jsx

@@ -7,7 +7,6 @@ const TooltipMargin = (props) => {
   return (
     <Flex 
         flexDirection='row' 
-        justifyContent='center' 
         wrap
     >
       <Tooltip

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_selectors.html.erb

@@ -1,4 +1,4 @@
-<%= pb_rails("flex", props: { horizontal: "center", orientation: "column" }) do %>
+<%= pb_rails("flex", props: { orientation: "column" }) do %>
   <%= pb_rails("flex/flex_item", props: {margin_top: "md"}) do %>
     <%= pb_rails("button", props: {classname: "tooltip-example-trigger", text: "Example 1"}) %>
   <% end %>

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip.html.erb

@@ -0,0 +1,39 @@
+
+<%= pb_rails("flex", props: { orientation: "column", gap: "md" }) do %>
+  <%= pb_rails("button", props: {text: "Toggle state", id: "toggle-tooltip-button"}) %>
+  <%= pb_rails("body") do %>
+      Tooltip is: <code id="show-tooltip-state">enabled</code>
+  <% end %>
+  <%= pb_rails("flex/flex_item") do %>
+    <span id="truncated-tooltip-1">Hover me</span>
+    <%= pb_rails("tooltip", props: {
+      trigger_element_selector: "#truncated-tooltip-1",
+      tooltip_id: "truncated-1",
+      position: "right",
+    }) do %>
+        Tooltip is enabled
+    <% end %>
+  <% end %>
+<% end %>
+
+
+<script>
+const toggleTooltipButton = document.getElementById("toggle-tooltip-button");
+const showTooltipStateText = document.getElementById("show-tooltip-state");
+
+function hideTooltipIfNotTruncated(tooltipId) {
+  const tooltipElement = document.querySelector(
+    `[data-pb-tooltip-tooltip-id="${tooltipId}"]`
+  );
+
+  tooltipElement.dataset.pbTooltipShowTooltip =
+    tooltipElement.dataset.pbTooltipShowTooltip == "false" ? "true" : "false";
+
+  showTooltipStateText.innerText = 
+    tooltipElement.dataset.pbTooltipShowTooltip == "false" ? "disabled" : "enabled";
+}
+
+toggleTooltipButton.addEventListener("click", () => {
+  hideTooltipIfNotTruncated("truncated-1");
+});
+</script>

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip.md

@@ -0,0 +1,5 @@
+You can build your own logic to control whether to show or hide the tooltip. 
+
+Click on the `Toggle state` button to change the state of the component and hover over the 'hover me' text to see it in action.
+
+Each Tooltip has a `dataset` with the `pbTooltipShowTooltip` property set to true by default. To update it, access the `pbTooltipShowTooltip` in the dataset of your tooltip element: `yourTooltip.dataset.pbTooltipShowTooltip = 'false'`

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip_react.jsx

@@ -0,0 +1,45 @@
+// @flow
+
+import React, { useState } from 'react'
+import {  Button, Body, Flex, FlexItem, Tooltip } from '../..'
+
+const TooltipShowTooltipReact = (props) => {
+  const [showTooltip, setShowTooltip] = useState(true);
+
+  return (
+   <Flex 
+       flexDirection='column'
+       gap='md'
+       wrap
+   >
+    <FlexItem>
+      <Button 
+          onClick={()=> setShowTooltip(!showTooltip)}
+          text="Toggle state"
+      />
+    </FlexItem>
+    <FlexItem>
+      <Body >
+        <p>
+          {'Tooltip is: '}
+          <code>{showTooltip ? "enabled" : "disabled"}</code>
+        </p>
+      </Body>
+    </FlexItem>
+    <FlexItem>
+      <Tooltip 
+          placement='right'
+          showTooltip={showTooltip}
+          text='Tooltip is enabled'
+          zIndex={10}
+          {...props}
+      >
+        {'Hover me.'}
+      </Tooltip>
+    </FlexItem>
+
+   </Flex>
+  )
+}
+
+export default TooltipShowTooltipReact

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip_react.md

@@ -0,0 +1,3 @@
+You can build your own logic to control whether to show the tooltip using the `showTooltip` prop. Its default value is `true`.
+
+Click on the `Toggle state` button to change the state of the component and hover over the 'hover me' text to see it in action.

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

@@ -4,6 +4,7 @@ examples:
   - tooltip_default: Default
   - tooltip_selectors: Using Common Selectors
   - tooltip_with_icon_circle: Icon Circle Tooltip
+  - tooltip_show_tooltip: Show Tooltip
 
   react:
   - tooltip_default_react: Default
@@ -11,3 +12,5 @@ examples:
   - tooltip_margin: Margin
   - tooltip_icon: Tooltip with Icon
   - tooltip_delay: Delay
+  - tooltip_show_tooltip_react: Show Tooltip
+

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

@@ -3,3 +3,4 @@ export { default as TooltipInteraction } from './_tooltip_interaction'
 export { default as TooltipMargin } from './_tooltip_margin'
 export { default as TooltipIcon } from './_tooltip_icon'
 export { default as TooltipDelay } from './_tooltip_delay'
+export { default as TooltipShowTooltipReact } from './_tooltip_show_tooltip_react'