Override constrainToScroll prop default value to false

CHANGELOG.md

@@ -4,6 +4,17 @@ Changelog is rather internal in nature. See release notes for the public overvie
 
 ## Version 3.x.x (`release-v3` branch)
 
+- [#586]
+  - **Description:** Adds a new prop `constrainToScrollParent ` to `KDropdownMenu` to allow overriding of its popover flipping behavior.
+  - **Products impact:** Bugfix
+  - **Addresses:** [#432](https://github.com/learningequality/kolibri-design-system/issues/432)
+  - **Components:** KDropdownMenu
+  - **Breaking:** no
+  - **Impacts a11y:**  no
+  - **Guidance:** Use the `constrainToScrollParent` prop to override the default popover flipping behavior of the `KDropdownMenu` component prop where necessary.
+
+[#586]: https://github.com/learningequality/kolibri-design-system/pull/586
+
 - [#552]
   - **Description:** New `KListWithOverflow` component.
   - **Products impact:** new API.
@@ -1177,4 +1188,4 @@ This was the first release of the Design System, with documentation written in a
 
 ## Version 0.1.0
 
-The design system was originally based on a set of internal Kolibri components and their use as documented in the Kolibri Style Guide, which was first introduced into the Kolibri code base [in version 0.6](https://github.com/learningequality/kolibri/tree/release-v0.6.x/kolibri/plugins/style_guide). This remained until [version 0.13](https://github.com/learningequality/kolibri/tree/release-v0.13.x/kolibri/plugins/style_guide) after which the content was migrated to the [current site](https://design-system.learningequality.org/ 'Kolibri Design System Documentation').
+The design system was originally based on a set of internal Kolibri components and their use as documented in the Kolibri Style Guide, which was first introduced into the Kolibri code base [in version 0.6](https://github.com/learningequality/kolibri/tree/release-v0.6.x/kolibri/plugins/style_guide). This remained until [version 0.13](https://github.com/learningequality/kolibri/tree/release-v0.13.x/kolibri/plugins/style_guide) after which the content was migrated to the [current site](https://design-system.learningequality.org/ 'Kolibri Design System Documentation').

lib/KDropdownMenu.vue

@@ -5,6 +5,7 @@
     :z-index="99"
     :containFocus="true"
     :dropdownPosition="position"
+    :constrainToScrollParent="constrainToScrollParent"
     @close="handleClose"
     @open="handleOpen"
   >
@@ -34,6 +35,13 @@
       UiMenu,
     },
     props: {
+      /**
+       * The dropdown menu popover flips its position to avoid overflows within the parent. Setting it to false disables the flipping behavior.
+       */
+      constrainToScrollParent: {
+        type: Boolean,
+        default: true,
+      },
       /**
        * An array of options objects, with one object per dropdown item
        */