Allow to disable flip behaviour on Dropdown + documentation

js/src/dropdown.js

@@ -71,12 +71,14 @@ const Dropdown = (($) => {
 
   const Default = {
     placement   : AttachmentMap.BOTTOM,
-    offset      : 0
+    offset      : 0,
+    flip        : true
   }
 
   const DefaultType = {
     placement   : 'string',
-    offset      : '(number|string)'
+    offset      : '(number|string)',
+    flip        : 'boolean'
   }
 
 
@@ -153,6 +155,9 @@ const Dropdown = (($) => {
         modifiers : {
           offset : {
             offset : context._config.offset
+          },
+          flip : {
+            enabled : context._config.flip
           }
         }
       })
@@ -201,6 +206,11 @@ const Dropdown = (($) => {
     }
 
     _getConfig(config) {
+      const elementData = $(this._element).data()
+      if (elementData.placement !== undefined) {
+        elementData.placement = AttachmentMap[elementData.placement.toUpperCase()]
+      }
+
       config = $.extend(
         {},
         this.constructor.Default,