Check that allowClear is used with placeholder

The `allowClear` option may not work as intended if a placeholder
is not used. This is becaise the placeholder holds the value that
the `<select>` should be reset to when the `x` is hit.

An error is now properly raised in the console when Select2 detects
that the `allowClear` option is used without the `placeholder`
option.

This closes https://github.com/select2/select2/issues/3016.

dist/js/select2.amd.full.js

@@ -1142,6 +1142,15 @@ define('select2/selection/allowClear',[
 
     decorated.call(this, container, $container);
 
+    if (self.placeholder == null) {
+      if (console && console.error) {
+        console.error(
+          'Select2: The `allowClear` option should be used in combination ' +
+          'with the `placeholder` option.'
+        );
+      }
+    }
+
     this.$selection.on('mousedown', '.select2-selection__clear',
       function (evt) {
         // Ignore the event if it is disabled
@@ -3796,6 +3805,7 @@ define('select2/defaults',[
           options.selectionAdapter,
           Placeholder
         );
+      }
 
       if (options.allowClear) {
         options.selectionAdapter = Utils.Decorate(
@@ -3803,7 +3813,6 @@ define('select2/defaults',[
           AllowClear
         );
       }
-      }
 
       if (options.multiple) {
         options.selectionAdapter = Utils.Decorate(

dist/js/select2.amd.js

@@ -1142,6 +1142,15 @@ define('select2/selection/allowClear',[
 
     decorated.call(this, container, $container);
 
+    if (self.placeholder == null) {
+      if (console && console.error) {
+        console.error(
+          'Select2: The `allowClear` option should be used in combination ' +
+          'with the `placeholder` option.'
+        );
+      }
+    }
+
     this.$selection.on('mousedown', '.select2-selection__clear',
       function (evt) {
         // Ignore the event if it is disabled
@@ -3796,6 +3805,7 @@ define('select2/defaults',[
           options.selectionAdapter,
           Placeholder
         );
+      }
 
       if (options.allowClear) {
         options.selectionAdapter = Utils.Decorate(
@@ -3803,7 +3813,6 @@ define('select2/defaults',[
           AllowClear
         );
       }
-      }
 
       if (options.multiple) {
         options.selectionAdapter = Utils.Decorate(

dist/js/select2.full.js

@@ -1580,6 +1580,15 @@ define('select2/selection/allowClear',[
 
     decorated.call(this, container, $container);
 
+    if (self.placeholder == null) {
+      if (console && console.error) {
+        console.error(
+          'Select2: The `allowClear` option should be used in combination ' +
+          'with the `placeholder` option.'
+        );
+      }
+    }
+
     this.$selection.on('mousedown', '.select2-selection__clear',
       function (evt) {
         // Ignore the event if it is disabled
@@ -4234,6 +4243,7 @@ define('select2/defaults',[
           options.selectionAdapter,
           Placeholder
         );
+      }
 
       if (options.allowClear) {
         options.selectionAdapter = Utils.Decorate(
@@ -4241,7 +4251,6 @@ define('select2/defaults',[
           AllowClear
         );
       }
-      }
 
       if (options.multiple) {
         options.selectionAdapter = Utils.Decorate(

dist/js/select2.js

@@ -1580,6 +1580,15 @@ define('select2/selection/allowClear',[
 
     decorated.call(this, container, $container);
 
+    if (self.placeholder == null) {
+      if (console && console.error) {
+        console.error(
+          'Select2: The `allowClear` option should be used in combination ' +
+          'with the `placeholder` option.'
+        );
+      }
+    }
+
     this.$selection.on('mousedown', '.select2-selection__clear',
       function (evt) {
         // Ignore the event if it is disabled
@@ -4234,6 +4243,7 @@ define('select2/defaults',[
           options.selectionAdapter,
           Placeholder
         );
+      }
 
       if (options.allowClear) {
         options.selectionAdapter = Utils.Decorate(
@@ -4241,7 +4251,6 @@ define('select2/defaults',[
           AllowClear
         );
       }
-      }
 
       if (options.multiple) {
         options.selectionAdapter = Utils.Decorate(

src/js/select2/defaults.js

@@ -172,6 +172,7 @@ define([
           options.selectionAdapter,
           Placeholder
         );
+      }
 
       if (options.allowClear) {
         options.selectionAdapter = Utils.Decorate(
@@ -179,7 +180,6 @@ define([
           AllowClear
         );
       }
-      }
 
       if (options.multiple) {
         options.selectionAdapter = Utils.Decorate(

src/js/select2/selection/allowClear.js

@@ -8,6 +8,15 @@ define([
 
     decorated.call(this, container, $container);
 
+    if (self.placeholder == null) {
+      if (console && console.error) {
+        console.error(
+          'Select2: The `allowClear` option should be used in combination ' +
+          'with the `placeholder` option.'
+        );
+      }
+    }
+
     this.$selection.on('mousedown', '.select2-selection__clear',
       function (evt) {
         // Ignore the event if it is disabled