playbook_ui 6.4.0 → 6.5.2

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_allow_input.html.erb

@@ -0,0 +1,4 @@
+<%= pb_rails("date_picker", props: {
+  allow_input: true,
+  picker_id: "date-picker-read-only"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_allow_input.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import { DatePicker } from '../..'
+
+const DatePickerAllowInput = () => (
+  <div>
+    <DatePicker
+        allowInput
+        pickerId="date-picker-read-only"
+    />
+  </div>
+)
+
+export default DatePickerAllowInput

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_allow_input.md

@@ -0,0 +1 @@
+By default the date picker input can only be modified by picking a date on the calendar.  This prop allows your users to manually type in the date.

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_dark.html.erb

@@ -0,0 +1,4 @@
+<%= pb_rails("date_picker", props: { 
+  dark: true,
+  picker_id: "date-picker-dark"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_dark.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerDark = () => (
+  <div>
+    <DatePicker
+        dark
+        pickerId="date-picker-dark"
+    />
+  </div>
+)
+
+export default DatePickerDark

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_default.html.erb

@@ -0,0 +1 @@
+<%= pb_rails("date_picker", props: { picker_id: "date-picker-default" }) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_default.jsx

@@ -0,0 +1,12 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerDefault = () => (
+  <div>
+    <DatePicker
+        pickerId="date-picker-default"
+    />
+  </div>
+)
+
+export default DatePickerDefault

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_default_date.html.erb

@@ -0,0 +1,24 @@
+<%= pb_rails("date_picker", props: {
+  default_date: "07/31/2020",
+  label: "Default Date String",
+  picker_id: "date-picker-default-date1"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: (Date.today + 2).httpdate,
+  label: "Default Date Dynamic",
+  picker_id: "date-picker-default-date2"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: [(Date.today).httpdate, (Date.today + 7).httpdate],
+  label: "Default Date Range",
+  mode: "range",
+  picker_id: "date-picker-default-date3"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: "blank",
+  label: "Blank",
+  picker_id: "date-picker-default-date4"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_default_date.jsx

@@ -0,0 +1,30 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerDefaultDate = () => (
+  <div>
+    <DatePicker
+        defaultDate="07/31/2020"
+        label="Default Date String"
+        pickerId="date-picker-default-date1"
+    />
+    <DatePicker
+        defaultDate={new Date().fp_incr(1)}
+        label="Default Date Dynamic"
+        pickerId="date-picker-default-date2"
+    />
+    <DatePicker
+        defaultDate={[new Date(), new Date().fp_incr(6)]}
+        label="Default Date Range"
+        mode="range"
+        pickerId="date-picker-default-date3"
+    />
+    <DatePicker
+        defaultDate="blank"
+        label="Blank"
+        pickerId="date-picker-default-date4"
+    />
+  </div>
+)
+
+export default DatePickerDefaultDate

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_disabled.html.erb

@@ -0,0 +1,43 @@
+<%= pb_rails("date_picker", props: {
+  disable_date: [(Date.today + 1).httpdate],
+  label: "Disable Single Date",
+  picker_id: "single-disabled-date"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  disable_date: [(Date.today + 1).httpdate, (Date.today + 3).httpdate],
+  label: "Disable Multiple Dates",
+  picker_id: "multiple-disabled-dates"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  disable_range: [
+          {
+            from: (Date.today + 1).httpdate,
+            to: (Date.today + 7).httpdate,
+          },
+        ],
+  label: "Disable Single Range",
+  picker_id: "single-date-range"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  disable_range: [
+          {
+            from: (Date.today + 1).httpdate,
+            to: (Date.today + 3).httpdate,
+          },
+          {
+            from: (Date.today + 7).httpdate,
+            to: (Date.today + 14).httpdate,
+          },
+        ],
+  label: "Disable Multiple Ranges",
+  picker_id: "multiple-date-ranges"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  disable_weekdays: ['Sunday', 'Saturday'],
+  label: "Disable Specific Weekdays",
+  picker_id: "disabled-weekdays"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_disabled.jsx

@@ -0,0 +1,48 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerDisabled = () => (
+  <div>
+    <DatePicker
+        disableDate={[new Date().fp_incr(1)]}
+        label="Disable Single Date"
+        pickerId="single-disabled-date"
+    />
+    <DatePicker
+        disableDate={[new Date().fp_incr(1), new Date().fp_incr(3)]}
+        label="Disable Multiple Dates"
+        pickerId="multiple-disabled-dates"
+    />
+    <DatePicker
+        disableRange={[
+          {
+            from: new Date().fp_incr(1),
+            to: new Date().fp_incr(7),
+          },
+        ]}
+        label="Disable Single Range"
+        pickerId="single-date-range"
+    />
+    <DatePicker
+        disableRange={[
+          {
+            from: new Date().fp_incr(1),
+            to: new Date().fp_incr(3),
+          },
+          {
+            from: new Date().fp_incr(7),
+            to: new Date().fp_incr(14),
+          },
+        ]}
+        label="Disable Multiple Ranges"
+        pickerId="multiple-date-ranges"
+    />
+    <DatePicker
+        disableWeekdays={['Sunday', 'Saturday']}
+        label="Disable Specific Weekdays"
+        pickerId="disabled-weekdays"
+    />
+  </div>
+)
+
+export default DatePickerDisabled

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_error.html.erb

@@ -0,0 +1,4 @@
+<%= pb_rails("date_picker", props: { 
+  error: "Invalid date. Please pick a valid date.",
+  picker_id: "date-picker-error"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_error.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerError = () => (
+  <div>
+    <DatePicker
+        error="Invalid date. Please pick a valid date."
+        pickerId="date-picker-error"
+    />
+  </div>
+)
+
+export default DatePickerError

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_format.html.erb

@@ -0,0 +1,19 @@
+<%= pb_rails("date_picker", props: {
+  format: "m-d-Y",
+  picker_id: "date-picker-format1"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  format: "m/d/y",
+  picker_id: "date-picker-format2"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  format: "n-j-y",
+  picker_id: "date-picker-format3"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  format: "Y-d-m",
+  picker_id: "date-picker-format4"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_format.jsx

@@ -0,0 +1,25 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerFormat = () => (
+  <div>
+    <DatePicker
+        format="m-d-Y"
+        pickerId="date-picker-format1"
+    />
+    <DatePicker
+        format="m/d/y"
+        pickerId="date-picker-format2"
+    />
+    <DatePicker
+        format="n-j-y"
+        pickerId="date-picker-format3"
+    />
+    <DatePicker
+        format="Y-d-m"
+        pickerId="date-picker-format4"
+    />
+  </div>
+)
+
+export default DatePickerFormat

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_format.md

@@ -0,0 +1 @@
+A full list of formatting tokens, i.e. `"m/d/Y"` can be found [here](https://flatpickr.js.org/formatting/).

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hide_icon.html.erb

@@ -0,0 +1,4 @@
+<%= pb_rails("date_picker", props: { 
+  hide_icon: true, 
+  picker_id: "date-picker-hide-icon" 
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hide_icon.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerHideIcon = () => (
+  <div>
+    <DatePicker
+        hideIcon
+        pickerId="date-picker-hide-icon"
+    />
+  </div>
+)
+
+export default DatePickerHideIcon

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hooks.html.erb

@@ -0,0 +1,37 @@
+<%= pb_rails("date_picker", props: {
+  label: "onChange",
+  picker_id: "date-picker-hooks-onchange"
+}) %>
+
+<%= javascript_tag do %>
+  window.addEventListener("DOMContentLoaded", () => {
+    <%# Access flatpickr instance with picker id and assign it a variable %>
+    const fp = document.querySelector("#date-picker-hooks-onchange")._flatpickr
+
+    <%# Define Hook %>
+    const changeHook = () => {
+      alert('date changed')
+    }
+    <%# Push one or more hooks to onChange config array %>
+    fp.config.onChange.push(changeHook)
+  })
+<% end %>
+
+<%= pb_rails("date_picker", props: {
+  label: "onOpen",
+  picker_id: "date-picker-hooks-onopen"
+}) %>
+
+<%= javascript_tag do %>
+  window.addEventListener("DOMContentLoaded", () => {
+    <%# Access flatpickr instance with picker id and assign it a variable %>
+    const fp = document.querySelector("#date-picker-hooks-onopen")._flatpickr
+
+    <%# Define Hook %>
+    const openHook = () => {
+      alert('calendar opened')
+    }
+    <%# Push one or more hooks to onOpen config array %>
+    fp.config.onOpen.push(openHook)
+  })
+<% end %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hooks.jsx

@@ -0,0 +1,37 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerHooks = () => {
+  // Define hooks
+  const changeHook = () => {
+    alert('date changed')
+  }
+  const openHook = () => {
+    alert('calendar opened')
+  }
+
+  // Access flatpickr instances with picker ids and assign them variables
+  window.addEventListener('DOMContentLoaded', () => {
+    const fpChange = document.querySelector('#date-picker-hooks-onchange')._flatpickr
+    const fpOpen = document.querySelector('#date-picker-hooks-onopen')._flatpickr
+
+    // Push one or more hooks to flatpickr instance's Event config arrays
+    fpChange.config.onChange.push(changeHook)
+    fpOpen.config.onOpen.push(openHook)
+  })
+
+  return (
+    <div>
+      <DatePicker
+          label="onChange"
+          pickerId="date-picker-hooks-onchange"
+      />
+      <DatePicker
+          label="onOpen"
+          pickerId="date-picker-hooks-onopen"
+      />
+    </div>
+  )
+}
+
+export default DatePickerHooks

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hooks.md

@@ -0,0 +1 @@
+You can find a full list of flatpickr events and hooks in their [documentation](https://flatpickr.js.org/events/).

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_input.html.erb

@@ -0,0 +1,26 @@
+<%= pb_rails("date_picker", props: {
+  input_aria: { label: "input-field" },
+  input_data: { key: "value", key2: "value2" },
+  name: "date-field",
+  picker_id: "date-picker-input1",
+  type: "date"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: "blank",
+  picker_id: "date-picker-input2",
+  placeholder: "Select Date",
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: "blank",
+  disable_input: true,
+  picker_id: "date-picker-input3",
+  placeholder: "Disabled Input"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  dark: true,
+  hide_label: true,
+  picker_id: "date-picker-input4"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_input.jsx

@@ -0,0 +1,32 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerInput = () => (
+  <div>
+    <DatePicker
+        inputAria={{ label: 'input-field' }}
+        inputData={{ key: 'value', key2: 'value2' }}
+        name="date-field"
+        pickerId="date-picker-input1"
+        type="date"
+    />
+    <DatePicker
+        defaultDate="blank"
+        pickerId="date-picker-input2"
+        placeholder="Select Date"
+    />
+    <DatePicker
+        defaultDate="blank"
+        disableInput
+        pickerId="date-picker-input3"
+        placeholder="Disabled Input"
+    />
+    <DatePicker
+        dark
+        hideLabel
+        pickerId="date-picker-input4"
+    />
+  </div>
+)
+
+export default DatePickerInput

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_input.md

@@ -0,0 +1,3 @@
+The date picker is built with the text input kit.  Text input props you pass to the date picker kit will be forwarded to the input, with a few exceptions.  The `value` attribute is automatically handled and bound to whatever date string is contained by the input field.  You cannot pass a custom value prop.  `id` props passed to the date picker kit will be assigned to it's parent/wrapper div.  The `pickerId` prop is passed directly to the input and is required to instatiate the date picker.
+
+You must use `inputAria` or `input_aria` and `inputData` or `input_data` props if you wish to pass data or aria attributes to the text input kit.  If you use `data` or `aria` props they will be passed to the date picker kit itself instead.  Also be aware the default behavior of text input aria and data props is to pass those props to attributes on the wrapping div not on the input itself.