playbook_ui 6.4.2 → 6.6.1

data/app/pb_kits/playbook/pb_date_picker/_date_picker.scss

@@ -0,0 +1,33 @@
+@import "../pb_caption/caption_mixin";
+@import "../pb_textarea/textarea_mixin";
+@import "../tokens/colors";
+@import "./sass_partials/flatpickr_styles";
+
+[class^=pb_date_picker_kit] {
+  .input_wrapper {
+    margin-bottom: $space_sm;
+    position: relative;
+    @import "./sass_partials/calendar_input_icon";
+    @import "./sass_partials/day_styles";
+    @import "./sass_partials/header_styles";
+    @import "./sass_partials/overrides";
+
+    .flatpickr-wrapper {
+      display: block;
+      .text_input.flatpickr-input {
+        text-overflow: ellipsis;
+        padding-right: $space_xl + 10 !important;
+      }
+      // Calendar Shadow and Border
+      .flatpickr-calendar {
+        box-shadow: $shadow_deeper;
+        border: 1px solid $border_light;
+      }
+      // Hide Caret
+      .flatpickr-calendar:before,
+      .flatpickr-calendar:after {
+        content: none;
+      }
+    }
+  }
+}

data/app/pb_kits/playbook/pb_date_picker/date_picker.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Playbook
+  module PbDatePicker
+    class DatePicker
+      include Playbook::Props
+
+      partial "pb_date_picker/date_picker"
+
+      prop :allow_input, type: Playbook::Props::Boolean,
+                         default: false
+      prop :dark, type: Playbook::Props::Boolean,
+                  default: false
+      prop :default_date, type: Playbook::Props::String,
+                          default: ""
+      prop :disable_date, type: Playbook::Props::Array,
+                          default: []
+      prop :disable_input, type: Playbook::Props::Boolean,
+                           default: false
+      prop :disable_range, type: Playbook::Props::Array,
+                           default: []
+      prop :disable_weekdays, type: Playbook::Props::Array,
+                              default: []
+      prop :error, type: Playbook::Props::String
+      prop :format, type: Playbook::Props::String,
+                    default: "m/d/Y"
+      prop :hide_icon, type: Playbook::Props::Boolean,
+                       default: false
+      prop :hide_label, type: Playbook::Props::Boolean,
+                        default: false
+      prop :label, type: Playbook::Props::String,
+                   default: "Date Picker"
+      prop :input_aria, type: Playbook::Props::Hash,
+                        default: {}
+      prop :input_data, type: Playbook::Props::Hash,
+                        default: {}
+      prop :max_date, type: Playbook::Props::String
+      prop :min_date, type: Playbook::Props::String
+      prop :name, type: Playbook::Props::String
+      prop :mode, type: Playbook::Props::String,
+                  default: "single"
+      prop :picker_id, type: Playbook::Props::String,
+                       required: true
+      prop :placeholder, type: Playbook::Props::String
+      prop :required, type: Playbook::Props::Boolean,
+                      default: false
+      prop :type, type: Playbook::Props::String
+      prop :year_range, type: Playbook::Props::Array,
+                        default: [1900, 2100]
+
+      def classname
+        generate_classname("pb_date_picker_kit")
+      end
+
+      def date_picker_config
+        {
+          allowInput: allow_input,
+          defaultDate: default_date,
+          disableDate: disable_date,
+          disableRange: disable_range,
+          disableWeekdays: disable_weekdays,
+          format: format,
+          hideIcon: hide_icon,
+          maxDate: max_date,
+          minDate: min_date,
+          mode: mode,
+          pickerId: picker_id,
+          yearRange: year_range,
+        }.to_json.html_safe
+      end
+
+      def error_class
+        error ? " error" : ""
+      end
+
+      def icon_wrapper_class
+        class_string = "cal_icon_wrapper"
+        class_string += " dark" if dark
+        class_string += " no_label_shift" if hide_label
+        class_string += error_class
+        class_string
+      end
+    end
+  end
+end

data/app/pb_kits/playbook/pb_date_picker/date_picker_helper.js

@@ -0,0 +1,165 @@
+import flatpickr from 'flatpickr'
+
+const datePickerHelper = (config) => {
+  const {
+    allowInput,
+    defaultDate,
+    disableDate,
+    disableRange,
+    disableWeekdays,
+    format,
+    maxDate,
+    minDate,
+    mode,
+    pickerId,
+    yearRange,
+  } = config
+
+  // ===========================================================
+  // |                   Hook Definitions                      |
+  // ===========================================================
+
+  const defaultDateGetter = () => {
+    if (defaultDate !== '') {
+      if (defaultDate === 'blank') {
+        return ''
+      } else {
+        return defaultDate
+      }
+    }
+    if (mode === 'single' && defaultDate === '') {
+      return new Date()
+    } else if (mode === 'range' && defaultDate === '') {
+      const today = new Date()
+      const tomorrow = new Date(today)
+      tomorrow.setDate(tomorrow.getDate() + 1)
+      return [today, tomorrow]
+    }
+  }
+  const disabledParser = () => {
+    if (disableDate && disableDate.length > 0) {
+      return disableDate
+    } else if (disableRange && disableRange.length > 0) {
+      return disableRange
+    } else {
+      return []
+    }
+  }
+  const calendarResizer = () => {
+    const cal = document.querySelector(`#cal-${pickerId}.open`)
+    const parentInput = cal.parentElement
+    if (cal.getBoundingClientRect().right > window.innerWidth) {
+      parentInput.style.display = 'flex'
+      parentInput.style.justifyContent = 'center'
+    }
+    if (cal.offsetWidth <= parentInput.offsetWidth) {
+      parentInput.style.display = ''
+      parentInput.style.justifyContent = ''
+    }
+  }
+
+  // ===========================================================
+  // |             Flatpickr initializer w/ config             |
+  // ===========================================================
+
+  flatpickr(`#${pickerId}`, {
+    disableMobile: true,
+    dateFormat: format,
+    defaultDate: defaultDateGetter(),
+    disable: disableWeekdays && disableWeekdays.length > 0 ? [
+      (date) => {
+        const weekdayObj = {
+          Sunday: 0,
+          Monday: 1,
+          Tuesday: 2,
+          Wednesday: 3,
+          Thursday: 4,
+          Friday: 5,
+          Saturday: 6,
+        }
+        return (
+          date.getDay() === weekdayObj[disableWeekdays[0]] ||
+          date.getDay() === weekdayObj[disableWeekdays[1]] ||
+          date.getDay() === weekdayObj[disableWeekdays[2]] ||
+          date.getDay() === weekdayObj[disableWeekdays[3]] ||
+          date.getDay() === weekdayObj[disableWeekdays[4]] ||
+          date.getDay() === weekdayObj[disableWeekdays[5]] ||
+          date.getDay() === weekdayObj[disableWeekdays[6]]
+        )
+      },
+    ] : disabledParser(),
+    maxDate: maxDate,
+    minDate: minDate,
+    mode: mode,
+    nextArrow: '<i class="far fa-angle-right"></i>',
+    onOpen: [() => {
+      calendarResizer()
+      window.addEventListener('resize', calendarResizer)
+    }],
+    onClose: [() => {
+      window.removeEventListener('resize', calendarResizer)
+    }],
+    onYearChange: [],
+    prevArrow: '<i class="far fa-angle-left"></i>',
+    static: true,
+  })
+
+  // ===========================================================
+  //                 Additional JS Functionality               |
+  // ===========================================================
+
+  // Assign dynamically sourced flatpickr instance to variable
+  const picker = document.querySelector(`#${pickerId}`)._flatpickr
+  picker.innerContainer.parentElement.id = `cal-${pickerId}`
+
+  // replace year selector with dropdown
+  picker.yearElements[0].parentElement.innerHTML = `<select class="numInput cur-year" type="number" tabIndex="-1" aria-label="Year" id="year-${pickerId}"></select>`
+
+  // create html option tags for desired years
+  let years = ''
+  for (let year = yearRange[1]; year >= yearRange[0]; year--) {
+    years += `<option value="${year}">${year}</option>`
+  }
+
+  // variablize each dropdown selecttor
+  const dropdown = document.querySelector(`#year-${pickerId}`)
+
+  // inject year options into dropdown and assign it the flatpickr's current year value
+  dropdown.innerHTML = years
+  dropdown.value = picker.currentYear
+
+  // whenever a new year is selected from dropdown update flatpickr's current year value
+  dropdown.addEventListener('input', (e) => {
+    picker.changeYear(Number(e.target.value))
+  })
+
+  // two way binding
+  const yearChangeHook = () => {
+    dropdown.value = picker.currentYear
+  }
+  picker.config.onYearChange.push(yearChangeHook)
+
+  // Adding dropdown icons to year and month selects
+  picker.monthElements[0].insertAdjacentHTML('afterend', '<i class="far fa-angle-down month-dropdown-icon"></i>')
+  dropdown.insertAdjacentHTML('afterend', '<i class="far fa-angle-down year-dropdown-icon" id="test-id"></i>')
+
+  // Set input value attribute on page load
+  picker.input.setAttribute('value', picker.input.value)
+  // logic for updating value when typing
+  document.querySelector(`#${pickerId}`).addEventListener('input', (e) => {
+    picker.input.setAttribute('value', e.target.value)
+    const variant = picker.config.mode
+    if (variant === 'single' && e.target.value.split('').length === 10) {
+      picker.setDate(e.target.value)
+      dropdown.value = picker.currentYear
+    } else if (variant === 'range' && e.target.value.split('').length === 24) {
+      picker.setDate(e.target.value)
+      dropdown.value = picker.currentYear
+    }
+  })
+  if (allowInput){
+    picker.input.removeAttribute('readonly')
+  }
+}
+
+export default datePickerHelper

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"
+}) %>