playbook_ui 15.3.0.pre.alpha.PLAY260211779 → 15.3.0.pre.alpha.play2464flexitemcantusehtmloptions12226

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (135) hide show
  1. checksums.yaml +4 -4
  2. data/app/pb_kits/playbook/pb_advanced_table/Components/RegularTableView.tsx +2 -1
  3. data/app/pb_kits/playbook/pb_advanced_table/Hooks/useTableState.ts +4 -4
  4. data/app/pb_kits/playbook/pb_advanced_table/Utilities/RowUtils.ts +1 -1
  5. data/app/pb_kits/playbook/pb_advanced_table/_advanced_table.scss +4 -4
  6. data/app/pb_kits/playbook/pb_advanced_table/advanced_table.test.jsx +68 -5
  7. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_background_control_rails.html.erb +4 -0
  8. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_background_control_rails.md +1 -1
  9. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_border_color.md +1 -1
  10. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_border_color_rails.md +1 -1
  11. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling.jsx +3 -1
  12. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling.md +2 -0
  13. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling_column_headers.jsx +1 -1
  14. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling_rails.html.erb +1 -0
  15. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling_rails.md +2 -0
  16. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_padding_control.jsx +9 -1
  17. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_padding_control.md +1 -1
  18. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_sticky_columns_and_header.md +1 -1
  19. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_table_props_sticky_header_rails.md +1 -1
  20. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_table_props_sticky_header_react.md +1 -1
  21. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_with_custom_header_multi_header.jsx +16 -0
  22. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_with_custom_header_multi_header_rails.html.erb +104 -0
  23. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_with_custom_header_multi_header_rails.md +1 -0
  24. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_with_custom_header_rails.html.erb +1 -1
  25. data/app/pb_kits/playbook/pb_advanced_table/docs/example.yml +1 -0
  26. data/app/pb_kits/playbook/pb_advanced_table/flat_advanced_table.js +2 -2
  27. data/app/pb_kits/playbook/pb_advanced_table/index.js +7 -7
  28. data/app/pb_kits/playbook/pb_advanced_table/scss_partials/advanced_table_sticky_mixin.scss +2 -2
  29. data/app/pb_kits/playbook/pb_advanced_table/table_header.rb +90 -20
  30. data/app/pb_kits/playbook/pb_advanced_table/table_row.rb +32 -3
  31. data/app/pb_kits/playbook/pb_background/background.html.erb +10 -2
  32. data/app/pb_kits/playbook/pb_background/docs/_background_category.md +1 -1
  33. data/app/pb_kits/playbook/pb_badge/_badge.tsx +4 -1
  34. data/app/pb_kits/playbook/pb_badge/badge.test.js +13 -0
  35. data/app/pb_kits/playbook/pb_card/docs/_card_background.md +1 -1
  36. data/app/pb_kits/playbook/pb_card/docs/_card_header.md +1 -1
  37. data/app/pb_kits/playbook/pb_card/docs/_card_highlight.md +1 -1
  38. data/app/pb_kits/playbook/pb_card/docs/_card_light.md +1 -1
  39. data/app/pb_kits/playbook/pb_currency/_currency.tsx +20 -7
  40. data/app/pb_kits/playbook/pb_currency/currency.rb +35 -8
  41. data/app/pb_kits/playbook/pb_currency/currency.test.js +47 -0
  42. data/app/pb_kits/playbook/pb_currency/docs/_currency_variants.html.erb +1 -1
  43. data/app/pb_kits/playbook/pb_currency/docs/_currency_variants.jsx +1 -1
  44. data/app/pb_kits/playbook/pb_currency/docs/_currency_variants.md +1 -0
  45. data/app/pb_kits/playbook/pb_date_picker/date_picker.rb +2 -0
  46. data/app/pb_kits/playbook/pb_date_picker/date_picker_helper.ts +16 -4
  47. data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_and_dropdown_range.jsx +38 -0
  48. data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_and_dropdown_range.md +14 -0
  49. data/app/pb_kits/playbook/pb_date_picker/docs/example.yml +2 -1
  50. data/app/pb_kits/playbook/pb_date_picker/docs/index.js +2 -1
  51. data/app/pb_kits/playbook/pb_distribution_bar/docs/_distribution_bar_custom_colors.md +1 -1
  52. data/app/pb_kits/playbook/pb_dropdown/_dropdown.scss +1 -0
  53. data/app/pb_kits/playbook/pb_dropdown/_dropdown.tsx +111 -6
  54. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick.jsx +18 -0
  55. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick.md +4 -0
  56. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick_default_dates.jsx +18 -0
  57. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick_default_dates.md +1 -0
  58. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick_range_end.jsx +19 -0
  59. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick_range_end.md +1 -0
  60. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick_with_date_pickers.jsx +38 -0
  61. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_quickpick_with_date_pickers.md +14 -0
  62. data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_with_custom_active_style_options_react.md +1 -1
  63. data/app/pb_kits/playbook/pb_dropdown/docs/example.yml +5 -0
  64. data/app/pb_kits/playbook/pb_dropdown/docs/index.js +5 -1
  65. data/app/pb_kits/playbook/pb_dropdown/dropdown.test.jsx +148 -2
  66. data/app/pb_kits/playbook/pb_dropdown/quickpick/index.ts +60 -0
  67. data/app/pb_kits/playbook/pb_filter/docs/_filter_max_width.md +1 -1
  68. data/app/pb_kits/playbook/pb_fixed_confirmation_toast/docs/_fixed_confirmation_toast_auto_close.html.erb +15 -1
  69. data/app/pb_kits/playbook/pb_fixed_confirmation_toast/docs/_fixed_confirmation_toast_multi_line.html.erb +9 -8
  70. data/app/pb_kits/playbook/pb_fixed_confirmation_toast/docs/_fixed_confirmation_toast_positions.html.erb +11 -10
  71. data/app/pb_kits/playbook/pb_flex/_flex_item.tsx +12 -5
  72. data/app/pb_kits/playbook/pb_flex/docs/_flex_item_example.jsx +1 -0
  73. data/app/pb_kits/playbook/pb_form/pb_form_validation.js +44 -11
  74. data/app/pb_kits/playbook/pb_form_pill/_form_pill.tsx +1 -1
  75. data/app/pb_kits/playbook/pb_form_pill/docs/_form_pill_truncated_text_rails.md +1 -1
  76. data/app/pb_kits/playbook/pb_form_pill/docs/_form_pill_truncated_text_react.md +1 -1
  77. data/app/pb_kits/playbook/pb_icon/docs/_icon_color.md +1 -1
  78. data/app/pb_kits/playbook/pb_icon_circle/docs/_icon_circle_color.md +1 -1
  79. data/app/pb_kits/playbook/pb_icon_stat_value/docs/_icon_stat_value_color.html.erb +7 -14
  80. data/app/pb_kits/playbook/pb_icon_stat_value/docs/_icon_stat_value_color.jsx +6 -15
  81. data/app/pb_kits/playbook/pb_layout/docs/_layout_collection.md +1 -1
  82. data/app/pb_kits/playbook/pb_nav/docs/_collapsible_nav_item_spacing.md +1 -1
  83. data/app/pb_kits/playbook/pb_nav/docs/_nav_with_spacing_control.md +1 -1
  84. data/app/pb_kits/playbook/pb_overlay/docs/_overlay_layout.md +1 -1
  85. data/app/pb_kits/playbook/pb_phone_number_input/_phone_number_input.tsx +110 -17
  86. data/app/pb_kits/playbook/pb_pill/docs/_description.md +1 -1
  87. data/app/pb_kits/playbook/pb_popover/_popover.tsx +69 -34
  88. data/app/pb_kits/playbook/pb_popover/docs/_popover_append_to.jsx +68 -0
  89. data/app/pb_kits/playbook/pb_popover/docs/_popover_append_to_react.md +1 -0
  90. data/app/pb_kits/playbook/pb_popover/docs/example.yml +1 -0
  91. data/app/pb_kits/playbook/pb_popover/docs/index.js +1 -0
  92. data/app/pb_kits/playbook/pb_popover/popover.test.js +80 -0
  93. data/app/pb_kits/playbook/pb_rich_text_editor/docs/_description.md +1 -1
  94. data/app/pb_kits/playbook/pb_section_separator/docs/_description.md +1 -1
  95. data/app/pb_kits/playbook/pb_selectable_card/_selectable_card.scss +29 -0
  96. data/app/pb_kits/playbook/pb_skeleton_loading/docs/_skeleton_loading_border_radius_rails.md +1 -1
  97. data/app/pb_kits/playbook/pb_skeleton_loading/docs/_skeleton_loading_border_radius_react.md +1 -1
  98. data/app/pb_kits/playbook/pb_skeleton_loading/docs/_skeleton_loading_layout.md +1 -1
  99. data/app/pb_kits/playbook/pb_table/docs/_table_side_highlight.md +1 -1
  100. data/app/pb_kits/playbook/pb_table/docs/_table_sm.md +1 -1
  101. data/app/pb_kits/playbook/pb_table/docs/_table_with_dynamic_collapsible.html.erb +63 -0
  102. data/app/pb_kits/playbook/pb_table/docs/_table_with_dynamic_collapsible.jsx +89 -0
  103. data/app/pb_kits/playbook/pb_table/docs/_table_with_dynamic_collapsible_rails.md +4 -0
  104. data/app/pb_kits/playbook/pb_table/docs/_table_with_dynamic_collapsible_react.md +3 -0
  105. data/app/pb_kits/playbook/pb_table/docs/example.yml +2 -0
  106. data/app/pb_kits/playbook/pb_table/docs/index.js +1 -0
  107. data/app/pb_kits/playbook/pb_text_input/text_input.rb +2 -2
  108. data/app/pb_kits/playbook/pb_typeahead/_typeahead.scss +7 -0
  109. data/app/pb_kits/playbook/pb_typeahead/_typeahead.test.jsx +105 -1
  110. data/app/pb_kits/playbook/pb_typeahead/_typeahead.tsx +23 -9
  111. data/app/pb_kits/playbook/pb_typeahead/components/MultiValue.tsx +33 -1
  112. data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_custom_options.html.erb +64 -0
  113. data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_custom_options.jsx +70 -0
  114. data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_custom_options.md +1 -0
  115. data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_default_options.html.erb +67 -1
  116. data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_default_value.jsx +68 -6
  117. data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_truncated_text.md +1 -1
  118. data/app/pb_kits/playbook/pb_typeahead/docs/example.yml +2 -0
  119. data/app/pb_kits/playbook/pb_typeahead/docs/index.js +2 -1
  120. data/dist/chunks/{_line_graph-h5H-imfn.js → _line_graph-oRTpJgi9.js} +1 -1
  121. data/dist/chunks/_typeahead-CDf2C2se.js +6 -0
  122. data/dist/chunks/_weekday_stacked-BPxUGfCf.js +37 -0
  123. data/dist/chunks/{lib-CGxXTQ75.js → lib-BXBHAZMY.js} +1 -1
  124. data/dist/chunks/pb_form_validation-BNfSnIUF.js +1 -0
  125. data/dist/chunks/vendor.js +1 -1
  126. data/dist/playbook-doc.js +2 -2
  127. data/dist/playbook-rails-react-bindings.js +1 -1
  128. data/dist/playbook-rails.js +1 -1
  129. data/dist/playbook.css +1 -1
  130. data/lib/playbook/version.rb +1 -1
  131. metadata +31 -8
  132. data/dist/chunks/_typeahead-U8AjZIIW.js +0 -6
  133. data/dist/chunks/_weekday_stacked-DHXLQcpy.js +0 -37
  134. data/dist/chunks/pb_form_validation-DebqlUKZ.js +0 -1
  135. /data/app/pb_kits/playbook/pb_popover/docs/{_popover_append_to.md → _popover_append_to_rails.md} +0 -0
@@ -55,7 +55,6 @@ const formatToGlobalCountryName = (countryName: string) => {
55
55
 
56
56
  const formatAllCountries = () => {
57
57
  const countryData = intlTelInput.getCountryData()
58
-
59
58
  for (let i = 0; i < countryData.length; i++) {
60
59
  const country = countryData[i]
61
60
  country.name = formatToGlobalCountryName(country.name)
@@ -110,18 +109,54 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
110
109
 
111
110
  const inputRef = useRef<HTMLInputElement | null>(null)
112
111
  const itiRef = useRef<any>(null);
112
+ const wrapperRef = useRef<HTMLDivElement | null>(null);
113
113
  const [inputValue, setInputValue] = useState(value)
114
114
  const [error, setError] = useState(props.error || "")
115
115
  const [dropDownIsOpen, setDropDownIsOpen] = useState(false)
116
116
  const [selectedData, setSelectedData] = useState()
117
117
  const [hasTyped, setHasTyped] = useState(false)
118
+ const [formSubmitted, setFormSubmitted] = useState(false)
119
+ const [hasStartedValidating, setHasStartedValidating] = useState(false)
120
+
121
+ // Only sync initial error from props, not continuous updates
122
+ // Once validation starts, internal validation takes over
123
+ useEffect(() => {
124
+ if (props.error && !hasStartedValidating) {
125
+ setError(props.error)
126
+ // If there's an initial error from props, mark as submitted so it shows
127
+ if (props.error) {
128
+ setFormSubmitted(true)
129
+ }
130
+ }
131
+ }, [props.error, hasStartedValidating])
132
+
133
+ // Function to update validation state on the wrapper element
134
+ // Only applies when input is required
135
+ const updateValidationState = (hasError: boolean) => {
136
+ if (wrapperRef.current && required) {
137
+ if (hasError) {
138
+ wrapperRef.current.setAttribute('data-pb-phone-validation-error', 'true')
139
+ } else {
140
+ wrapperRef.current.removeAttribute('data-pb-phone-validation-error')
141
+ }
142
+ }
143
+ }
144
+
145
+ // Determine which error to display
146
+ // Show internal errors on blur (hasTyped) or on form submission (formSubmitted)
147
+ const shouldShowInternalError = (hasTyped || formSubmitted) && required && error
148
+ const displayError = shouldShowInternalError ? error : ""
118
149
 
119
150
  useEffect(() => {
120
- if ((error ?? '').length > 0) {
151
+ const hasError = (error ?? '').length > 0
152
+ if (hasError) {
121
153
  onValidate(false)
122
154
  } else {
123
155
  onValidate(true)
124
156
  }
157
+
158
+ // Update validation state whenever error changes
159
+ updateValidationState(hasError)
125
160
  }, [error, onValidate])
126
161
 
127
162
  const unformatNumber = (formattedNumber: any) => {
@@ -137,6 +172,7 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
137
172
 
138
173
  const validateTooLongNumber = (itiInit: any) => {
139
174
  if (!itiInit) return
175
+
140
176
  if (itiInit.getValidationError() === ValidationError.TooLong) {
141
177
  return showFormattedError('too long')
142
178
  } else {
@@ -146,13 +182,11 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
146
182
 
147
183
  const validateTooShortNumber = (itiInit: any) => {
148
184
  if (!itiInit) return
149
-
150
185
  // If field is empty, don't show "too short" error
151
186
  if (!inputValue || inputValue.trim() === '') {
152
187
  setError('')
153
188
  return false
154
189
  }
155
-
156
190
  if (itiInit.getValidationError() === ValidationError.TooShort) {
157
191
  return showFormattedError('too short')
158
192
  } else {
@@ -172,7 +206,7 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
172
206
  }
173
207
 
174
208
  const validateUnhandledError = (itiInit: any) => {
175
- if (!itiInit) return
209
+ if (!required || !itiInit) return
176
210
  if (itiInit.getValidationError() === ValidationError.SomethingWentWrong) {
177
211
  if (inputValue.length === 1) {
178
212
  return showFormattedError('too short')
@@ -184,7 +218,6 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
184
218
  }
185
219
  }
186
220
  }
187
-
188
221
  const validateMissingAreaCode = (itiInit: any) => {
189
222
  if (!itiInit) return
190
223
  if (itiInit.getValidationError() === ValidationError.MissingAreaCode) {
@@ -201,8 +234,9 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
201
234
  }
202
235
  }
203
236
 
237
+ // Validation for required empty fields
204
238
  const validateRequiredField = () => {
205
- if (!inputValue || inputValue.trim() === '') {
239
+ if (required && (!inputValue || inputValue.trim() === '')) {
206
240
  setError('Missing phone number')
207
241
  return true
208
242
  }
@@ -210,14 +244,24 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
210
244
  }
211
245
 
212
246
  const validateErrors = () => {
213
- // If field is empty, show error message
247
+ // Signal validation has started, so prop errors won't override internal validation
248
+ if (!hasStartedValidating) {
249
+ setHasStartedValidating(true)
250
+ }
251
+
252
+ // If field is empty, only show required field error if applicable
214
253
  if (!inputValue || inputValue.trim() === '') {
215
254
  if (validateRequiredField()) return
255
+ // Clear any existing errors if field is empty and not required
256
+ if (!required) {
257
+ setError('')
258
+ }
216
259
  return
217
260
  }
218
261
 
219
- if (!hasTyped && !error) return
262
+ if (!hasTyped && !error) return
220
263
 
264
+ // Run validation checks
221
265
  if (itiRef.current) isValid(itiRef.current.isValidNumber())
222
266
  if (validateOnlyNumbers(itiRef.current)) return
223
267
  if (validateTooLongNumber(itiRef.current)) return
@@ -227,6 +271,29 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
227
271
  if (validateRepeatCountryCode(itiRef.current)) return
228
272
  }
229
273
 
274
+ // Add listener for form validation to track when validation should be shown
275
+ useEffect(() => {
276
+ const handleInvalid = (event: Event) => {
277
+ const target = event.target as HTMLInputElement
278
+ const phoneNumberContainer = target.closest('.pb_phone_number_input')
279
+
280
+ if (phoneNumberContainer && phoneNumberContainer === wrapperRef.current) {
281
+ const invalidInputName = target.name || target.getAttribute('name')
282
+ if (invalidInputName === name) {
283
+ setFormSubmitted(true)
284
+ // Trigger validation when form is submitted
285
+ validateErrors()
286
+ }
287
+ }
288
+ }
289
+
290
+ document.addEventListener('invalid', handleInvalid, true)
291
+
292
+ return () => {
293
+ document.removeEventListener('invalid', handleInvalid, true)
294
+ }
295
+ }, [name, inputValue])
296
+
230
297
  /*
231
298
  useImperativeHandle exposes the kit's input element to a parent component via a ref.
232
299
  See the Playbook docs for use cases.
@@ -238,6 +305,12 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
238
305
  setInputValue("")
239
306
  setError("")
240
307
  setHasTyped(false)
308
+ setFormSubmitted(false)
309
+ setHasStartedValidating(false)
310
+ // Only clear validation state if field was required
311
+ if (required) {
312
+ updateValidationState(false)
313
+ }
241
314
  },
242
315
  inputNode() {
243
316
  return inputRef.current
@@ -247,6 +320,12 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
247
320
  // Run validation and return error message or true
248
321
  const isEmpty = !inputValue || inputValue.trim() === ''
249
322
 
323
+ if (required && isEmpty) {
324
+ setError('Missing phone number')
325
+ setFormSubmitted(true)
326
+ return 'Missing phone number'
327
+ }
328
+
250
329
  if (isEmpty) {
251
330
  // Show missing phone number error
252
331
  const errorMessage = 'Missing phone number'
@@ -266,6 +345,7 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
266
345
  const countryName = itiRef.current.getSelectedCountryData().name
267
346
  const errorMessage = `Invalid ${countryName} phone number (repeat country code)`
268
347
  setError(errorMessage)
348
+ setFormSubmitted(true)
269
349
  setHasTyped(true)
270
350
  return errorMessage
271
351
  }
@@ -275,6 +355,7 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
275
355
  const countryName = itiRef.current.getSelectedCountryData().name
276
356
  const errorMessage = `Invalid ${countryName} phone number (enter numbers only)`
277
357
  setError(errorMessage)
358
+ setFormSubmitted(true)
278
359
  setHasTyped(true)
279
360
  return errorMessage
280
361
  }
@@ -295,7 +376,9 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
295
376
  errorMessage = `Invalid ${countryName} phone number`
296
377
  }
297
378
 
379
+ // Set the error state so the validation attribute gets added
298
380
  setError(errorMessage)
381
+ setFormSubmitted(true)
299
382
  setHasTyped(true)
300
383
 
301
384
  return errorMessage
@@ -314,11 +397,16 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
314
397
 
315
398
  const handleOnChange = (evt: React.ChangeEvent<HTMLInputElement>) => {
316
399
  if (!hasTyped) setHasTyped(true)
317
-
318
400
  setInputValue(evt.target.value)
319
401
 
402
+ // Reset form submitted state when user types
403
+ if (formSubmitted) {
404
+ setFormSubmitted(false)
405
+ }
406
+
320
407
  let phoneNumberData
321
408
 
409
+ // Handle formatAsYouType with input event
322
410
  if (formatAsYouType) {
323
411
  const formattedPhoneNumberData = getCurrentSelectedData(itiRef.current, evt.target.value)
324
412
  phoneNumberData = {...formattedPhoneNumberData, number: unformatNumber(formattedPhoneNumberData.number)}
@@ -329,12 +417,15 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
329
417
  setSelectedData(phoneNumberData)
330
418
  onChange(phoneNumberData)
331
419
  isValid(itiRef.current.isValidNumber())
420
+
421
+ // Trigger validation after onChange for React Hook Form
422
+ // This ensures validation state is up-to-date
423
+ setTimeout(() => validateErrors(), 0)
332
424
  }
333
425
 
334
426
  // Separating Concerns as React Docs Recommend
335
427
  // This also Fixes things for our react_component rendering on the Rails Side
336
428
  useEffect(formatAllCountries, [])
337
-
338
429
  // If an initial country is not specified, the "globe" icon will show
339
430
  // Always set a country
340
431
  const fallbackCountry =
@@ -375,9 +466,9 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
375
466
  inputRef.current.addEventListener("open:countrydropdown", () => setDropDownIsOpen(true))
376
467
  inputRef.current.addEventListener("close:countrydropdown", () => setDropDownIsOpen(false))
377
468
 
378
- // Handle formatAsYouType with input event
379
- if (formatAsYouType) {
380
- inputRef.current.addEventListener("input", (evt: Event) => {
469
+ // Handle formatAsYouType with input event
470
+ if (formatAsYouType) {
471
+ inputRef.current.addEventListener("input", (evt: Event) => {
381
472
  const target = evt.target as HTMLInputElement
382
473
  const formattedValue = target.value
383
474
 
@@ -396,13 +487,12 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
396
487
  }
397
488
  }
398
489
  }, [])
399
-
400
490
  let textInputProps: {[key: string]: any} = {
401
491
  className: dropDownIsOpen ? 'dropdown_open' : '',
402
492
  dark,
403
493
  "data-phone-number": JSON.stringify(selectedData),
404
494
  disabled,
405
- error: hasTyped ? error : props.error,
495
+ error: hasTyped ? error : props.error || displayError,
406
496
  type: 'tel',
407
497
  id,
408
498
  label,
@@ -412,7 +502,10 @@ const PhoneNumberInput = (props: PhoneNumberInputProps, ref?: React.Ref<unknown>
412
502
  value: inputValue
413
503
  }
414
504
 
415
- let wrapperProps: Record<string, unknown> = { className: classes }
505
+ let wrapperProps: Record<string, unknown> = {
506
+ className: classes,
507
+ ref: wrapperRef
508
+ }
416
509
 
417
510
  if (!isEmpty(aria)) textInputProps = {...textInputProps, ...ariaProps}
418
511
  if (!isEmpty(data)) wrapperProps = {...wrapperProps, ...dataProps}
@@ -1 +1 @@
1
- A pill uses both a keyword and a specific color to categorize an item. Each pill directly corresponds to a data color <a href="https://playbook.powerapp.cloud/visual_guidelines/colors" target="_blank">here</a>.
1
+ A pill uses both a keyword and a specific color to categorize an item. Each pill directly corresponds to a data color <a href="https://playbook.powerapp.cloud/global_props/colors" target="_blank">here</a>.
@@ -1,5 +1,5 @@
1
1
  /* eslint-disable react/no-multi-comp */
2
- import React, { useEffect, useState } from "react";
2
+ import React, { useEffect, useRef, useState } from "react";
3
3
  import ReactDOM from "react-dom";
4
4
  import {
5
5
  Popper,
@@ -24,6 +24,7 @@ import { uniqueId } from '../utilities/object';
24
24
  type ModifiedGlobalProps = Omit<GlobalProps, 'minWidth' | 'maxHeight' | 'minHeight'>
25
25
 
26
26
  type PbPopoverProps = {
27
+ appendTo?: string;
27
28
  aria?: { [key: string]: string };
28
29
  className?: string;
29
30
  closeOnClick?: "outside" | "inside" | "any";
@@ -62,6 +63,25 @@ const popoverModifiers = ({
62
63
  return offset ? modifiers.concat([POPOVER_MODIFIERS.offset]) : modifiers;
63
64
  };
64
65
 
66
+ const getAppendTarget = (
67
+ appendTo: string | undefined,
68
+ targetId: string
69
+ ): HTMLElement => {
70
+ if (!appendTo || appendTo === "body") return document.body;
71
+
72
+ if (appendTo === "parent") {
73
+ const referenceWrapper = document.querySelector(`#reference-${targetId}`);
74
+ if (referenceWrapper?.parentElement) {
75
+ return referenceWrapper.parentElement;
76
+ }
77
+ }
78
+
79
+ const selectorMatch = document.querySelector(appendTo);
80
+ if (selectorMatch instanceof HTMLElement) return selectorMatch;
81
+
82
+ return document.body;
83
+ };
84
+
65
85
  const Popover = (props: PbPopoverProps) => {
66
86
  const {
67
87
  aria = {},
@@ -89,7 +109,7 @@ const Popover = (props: PbPopoverProps) => {
89
109
  const popoverSpacing =
90
110
  filteredGlobalProps.includes("dark") || !filteredGlobalProps
91
111
  ? "p_sm"
92
- : filteredGlobalProps
112
+ : filteredGlobalProps
93
113
  const overflowHandling = maxHeight || maxWidth ? "overflow_handling" : "";
94
114
  const zIndexStyle = zIndex ? { zIndex: zIndex } : {};
95
115
  const widthHeightStyles = () => {
@@ -113,7 +133,7 @@ const Popover = (props: PbPopoverProps) => {
113
133
 
114
134
  return (
115
135
  <Popper
116
- modifiers={popoverModifiers({ modifiers, offset })}
136
+ modifiers={popoverModifiers({ modifiers, offset: offset || false })}
117
137
  placement={placement}
118
138
  referenceElement={referenceElement}
119
139
  >
@@ -154,6 +174,7 @@ const Popover = (props: PbPopoverProps) => {
154
174
  const PbReactPopover = (props: PbPopoverProps): React.ReactElement => {
155
175
  const [targetId] = useState(uniqueId('id-'))
156
176
  const {
177
+ appendTo,
157
178
  className,
158
179
  children,
159
180
  modifiers = [],
@@ -170,42 +191,56 @@ const PbReactPopover = (props: PbPopoverProps): React.ReactElement => {
170
191
  minHeight,
171
192
  minWidth,
172
193
  width,
194
+ closeOnClick,
195
+ shouldClosePopover = noop,
173
196
  } = props;
174
197
 
198
+ // Store latest callback in a ref to avoid re-runs
199
+ const shouldClosePopoverRef = useRef(shouldClosePopover);
200
+
201
+ // Update ref on change
175
202
  useEffect(() => {
176
- const { closeOnClick, shouldClosePopover = noop } = props;
203
+ shouldClosePopoverRef.current = shouldClosePopover;
204
+ }, [shouldClosePopover]);
177
205
 
206
+ useEffect(() => {
178
207
  if (!closeOnClick) return;
179
208
 
180
- document.body.addEventListener(
181
- "click",
182
- (e: MouseEvent) => {
183
- const target = e.target as HTMLElement
209
+ // Function to handle popover event listener and targetId.
210
+ // Ensure that whenever the component is conditionally rendered
211
+ // that the old listener is removed and the new listener is
212
+ // updated with the targetId.
213
+ const handleClick = (e: MouseEvent) => {
214
+ const target = e.target as HTMLElement
184
215
 
185
- const targetIsPopover =
186
- target.closest("#" + targetId) !== null;
187
- const targetIsReference =
188
- target.closest("#reference-" + targetId) !== null;
216
+ const targetIsPopover =
217
+ target.closest("#" + targetId) !== null;
218
+ const targetIsReference =
219
+ target.closest("#reference-" + targetId) !== null;
189
220
 
190
- const shouldClose = () => {
191
- setTimeout(() => shouldClosePopover(true), 0);
192
- }
221
+ const shouldClose = () => {
222
+ setTimeout(() => shouldClosePopoverRef.current(true), 0);
223
+ }
193
224
 
194
- switch (closeOnClick) {
195
- case "outside":
196
- if (!targetIsPopover && !targetIsReference) shouldClose();
197
- break;
198
- case "inside":
199
- if (targetIsPopover) shouldClose();
200
- break;
201
- case "any":
202
- if (targetIsPopover || !targetIsPopover && !targetIsReference) shouldClose();
203
- break;
204
- }
205
- },
206
- { capture: true }
207
- );
208
- }, []);
225
+ switch (closeOnClick) {
226
+ case "outside":
227
+ if (!targetIsPopover && !targetIsReference) shouldClose();
228
+ break;
229
+ case "inside":
230
+ if (targetIsPopover) shouldClose();
231
+ break;
232
+ case "any":
233
+ if (targetIsPopover || !targetIsPopover && !targetIsReference) shouldClose();
234
+ break;
235
+ }
236
+ };
237
+
238
+ document.body.addEventListener("click", handleClick, { capture: true });
239
+
240
+ return () => {
241
+ document.body.removeEventListener("click", handleClick, { capture: true });
242
+ };
243
+ }, [targetId, closeOnClick]);
209
244
 
210
245
  const popoverComponent = (
211
246
  <Popover
@@ -246,10 +281,10 @@ const PbReactPopover = (props: PbPopoverProps): React.ReactElement => {
246
281
  {show &&
247
282
  (usePortal ? (
248
283
  <>
249
- {ReactDOM.createPortal(
250
- popoverComponent,
251
- document.querySelector(portal)
252
- )}
284
+ {ReactDOM.createPortal(
285
+ popoverComponent,
286
+ getAppendTarget(appendTo, targetId)
287
+ )}
253
288
  </>
254
289
  ) : (
255
290
  { popoverComponent }
@@ -0,0 +1,68 @@
1
+ import React, { useState } from "react";
2
+ import { PbReactPopover, CircleIconButton, Body, Flex } from "playbook-ui";
3
+
4
+ const PopoverAppendTo = (props) => {
5
+ const [showParentPopover, setShowParentPopover] = useState(false);
6
+ const [showSelectorPopover, setShowSelectorPopover] = useState(false);
7
+
8
+ const parentPopoverReference = (
9
+ <CircleIconButton
10
+ icon="info"
11
+ onClick={() => setShowParentPopover(!showParentPopover)}
12
+ variant="secondary"
13
+ />
14
+ );
15
+
16
+ const selectorPopoverReference = (
17
+ <CircleIconButton
18
+ icon="info"
19
+ onClick={() => setShowSelectorPopover(!showSelectorPopover)}
20
+ variant="secondary"
21
+ />
22
+ );
23
+
24
+ return (
25
+ <>
26
+ <Flex
27
+ marginBottom="md"
28
+ orientation="row"
29
+ vertical="center"
30
+ {...props}
31
+ >
32
+ <Body text="Click info for more details" />
33
+ &nbsp;
34
+ <PbReactPopover
35
+ appendTo="parent"
36
+ offset
37
+ placement="top"
38
+ reference={parentPopoverReference}
39
+ show={showParentPopover}
40
+ {...props}
41
+ >
42
+ {'I\'m a popover. I have been appended to my parent element.'}
43
+ </PbReactPopover>
44
+ </Flex>
45
+
46
+ <Flex
47
+ orientation="row"
48
+ vertical="center"
49
+ {...props}
50
+ >
51
+ <Body text="Click info for more details" />
52
+ &nbsp;
53
+ <PbReactPopover
54
+ appendTo=".kit-show-wrapper"
55
+ offset
56
+ placement="top"
57
+ reference={selectorPopoverReference}
58
+ show={showSelectorPopover}
59
+ {...props}
60
+ >
61
+ {'I\'m a popover. I have been appended to the .kit-show-wrapper.'}
62
+ </PbReactPopover>
63
+ </Flex>
64
+ </>
65
+ );
66
+ };
67
+
68
+ export default PopoverAppendTo;
@@ -0,0 +1 @@
1
+ By default, the popover tooltip attaches to the `<body>`. To attach it elsewhere, use the `appendTo` prop. Set it to `"parent"` to place the tooltip inside its parent element, or pass any CSS selector (`#id` or `.class`) to specify a custom container.
@@ -15,3 +15,4 @@ examples:
15
15
  - popover_z_index: Set Z-Index
16
16
  - popover_scroll_height: Scroll and Height Settings
17
17
  - popover_actionable_content: With Actionable Content
18
+ - popover_append_to: Append To
@@ -4,3 +4,4 @@ export { default as PopoverClose } from './_popover_close.jsx'
4
4
  export { default as PopoverZIndex } from './_popover_z_index.jsx'
5
5
  export { default as PopoverScrollHeight } from './_popover_scroll_height.jsx'
6
6
  export { default as PopoverActionableContent } from './_popover_actionable_content.jsx'
7
+ export { default as PopoverAppendTo } from './_popover_append_to.jsx'
@@ -159,6 +159,62 @@ const PopoverTestClicktoClose3 = () => {
159
159
  )
160
160
  };
161
161
 
162
+ //Test Popover with appendTo="parent"
163
+ const PopoverTestAppendToParent = () => {
164
+ const [mockState, setMockState] = React.useState(false)
165
+ const togglePopover = () => {
166
+ setMockState(!mockState)
167
+ }
168
+
169
+ const popoverReference = (
170
+ <Button onClick={togglePopover}
171
+ text="Click Me"
172
+ />
173
+ );
174
+ return (
175
+ <div data-testid="parent-container"
176
+ id="parent-container"
177
+ >
178
+ <PbReactPopover
179
+ appendTo="parent"
180
+ offset
181
+ reference={popoverReference}
182
+ show={mockState}
183
+ >
184
+ {"Appended to parent"}
185
+ </PbReactPopover>
186
+ </div>
187
+ )
188
+ };
189
+
190
+ //Test Popover with appendTo CSS selector
191
+ const PopoverTestAppendToSelector = () => {
192
+ const [mockState, setMockState] = React.useState(false)
193
+ const togglePopover = () => {
194
+ setMockState(!mockState)
195
+ }
196
+
197
+ const popoverReference = (
198
+ <Button onClick={togglePopover}
199
+ text="Click Me"
200
+ />
201
+ );
202
+ return (
203
+ <div data-testid="custom-container"
204
+ id="custom-container"
205
+ >
206
+ <PbReactPopover
207
+ appendTo="#custom-container"
208
+ offset
209
+ reference={popoverReference}
210
+ show={mockState}
211
+ >
212
+ {"Appended to custom container"}
213
+ </PbReactPopover>
214
+ </div>
215
+ )
216
+ };
217
+
162
218
 
163
219
  test("renders Popover", () => {
164
220
  render(<PopoverTest data={{ testid: testId}}/>)
@@ -217,4 +273,28 @@ const PopoverTestClicktoClose3 = () => {
217
273
  fireEvent.click(btn);
218
274
 
219
275
  expect(kit).not.toBeInTheDocument;
276
+ });
277
+
278
+ test("renders Popover with appendTo parent", () => {
279
+ render(<PopoverTestAppendToParent data={{ testid: testId}}/>)
280
+ const btn = screen.getByText(/click me/i)
281
+ fireEvent.click(btn);
282
+ const kit = screen.getByText("Appended to parent");
283
+ expect(kit).toBeInTheDocument();
284
+
285
+ // Check that the popover is rendered inside the parent container
286
+ const parentContainer = screen.getByTestId("parent-container");
287
+ expect(parentContainer).toContainElement(kit);
288
+ });
289
+
290
+ test("renders Popover with appendTo CSS selector", () => {
291
+ render(<PopoverTestAppendToSelector data={{ testid: testId}}/>)
292
+ const btn = screen.getByText(/click me/i)
293
+ fireEvent.click(btn);
294
+ const kit = screen.getByText("Appended to custom container");
295
+ expect(kit).toBeInTheDocument();
296
+
297
+ // Check that the popover is rendered inside the custom container
298
+ const customContainer = screen.getByTestId("custom-container");
299
+ expect(customContainer).toContainElement(kit);
220
300
  });
@@ -1 +1 @@
1
- NOTE: All editors have a default max-width of "md". Use our [Max Width global prop](https://playbook.powerapp.cloud/visual_guidelines/max_width) to override this default, as necessary.
1
+ NOTE: All editors have a default max-width of "md". Use our [Max Width global prop](https://playbook.powerapp.cloud/global_props/max_width) to override this default, as necessary.
@@ -1,3 +1,3 @@
1
1
  Section separator is a divider line that compartmentalizes content, typically used on cards or white backgrounds.
2
2
 
3
- To ensure that the section separator is properly rendered, please be sure to use our global `width` prop to set width to 100%. [See here](https://playbook.powerapp.cloud/visual_guidelines/width) for more information on the global width prop.
3
+ To ensure that the section separator is properly rendered, please be sure to use our global `width` prop to set width to 100%. [See here](https://playbook.powerapp.cloud/global_props/width) for more information on the global width prop.
@@ -216,4 +216,33 @@ $pb_selectable_paddings: (
216
216
  background: $error;
217
217
  }
218
218
  }
219
+ }
220
+
221
+ .pb_selectable_card_kit_disabled,
222
+ .pb_selectable_card_kit_checked_disabled {
223
+ >label {
224
+ cursor: not-allowed;
225
+
226
+ @media (hover:hover) {
227
+ &:hover {
228
+ box-shadow: none !important;
229
+ }
230
+ }
231
+ }
232
+ }
233
+
234
+ .pb_selectable_card_kit_disabled>label {
235
+ border-color: $border_light !important;
236
+
237
+ .dark & {
238
+ border-color: $border_dark !important;
239
+ }
240
+ }
241
+
242
+ .pb_selectable_card_kit_checked_disabled>label {
243
+ border-color: $primary !important;
244
+
245
+ .dark & {
246
+ border-color: $primary_action_dark !important;
247
+ }
219
248
  }
@@ -1 +1 @@
1
- The `border_radius` prop accepts all of our [BorderRadius](https://playbook.powerapp.cloud/visual_guidelines/border_radius) tokens, with `sm` as default.
1
+ The `border_radius` prop accepts all of our [BorderRadius](https://playbook.powerapp.cloud/global_props/border_radius) tokens, with `sm` as default.