Add support for clearing selection

build/vega-lite-schema.json

@@ -6463,6 +6463,17 @@
           ],
           "type": "string"
         },
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EventStream"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Controls clearing selections. Can be `true`, `false`, or an [EventStream](https://vega.github.io/vega/docs/event-streams/).\n\n__Default value:__ `true`, which corresponds to `dblclick` (i.e.\nuser doubleclick clears current selection).\n\nSee the [TODO: clear] documentation for more information."
+        },
         "empty": {
           "description": "By default, all data values are considered to lie within an empty selection.\nWhen set to `none`, empty selections contain no data values.",
           "enum": [
@@ -6537,6 +6548,17 @@
           ],
           "type": "string"
         },
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EventStream"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Controls clearing selections. Can be `true`, `false`, or an [EventStream](https://vega.github.io/vega/docs/event-streams/).\n\n__Default value:__ `true`, which corresponds to `dblclick` (i.e.\nuser doubleclick clears current selection).\n\nSee the [TODO: clear] documentation for more information."
+        },
         "empty": {
           "description": "By default, all data values are considered to lie within an empty selection.\nWhen set to `none`, empty selections contain no data values.",
           "enum": [
@@ -8474,6 +8496,17 @@
     "MultiSelection": {
       "additionalProperties": false,
       "properties": {
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EventStream"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Controls clearing selections. Can be `true`, `false`, or an [EventStream](https://vega.github.io/vega/docs/event-streams/).\n\n__Default value:__ `true`, which corresponds to `dblclick` (i.e.\nuser doubleclick clears current selection).\n\nSee the [TODO: clear] documentation for more information."
+        },
         "empty": {
           "description": "By default, all data values are considered to lie within an empty selection.\nWhen set to `none`, empty selections contain no data values.",
           "enum": [
@@ -8544,6 +8577,17 @@
     "MultiSelectionConfig": {
       "additionalProperties": false,
       "properties": {
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EventStream"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Controls clearing selections. Can be `true`, `false`, or an [EventStream](https://vega.github.io/vega/docs/event-streams/).\n\n__Default value:__ `true`, which corresponds to `dblclick` (i.e.\nuser doubleclick clears current selection).\n\nSee the [TODO: clear] documentation for more information."
+        },
         "empty": {
           "description": "By default, all data values are considered to lie within an empty selection.\nWhen set to `none`, empty selections contain no data values.",
           "enum": [
@@ -10287,6 +10331,17 @@
           ],
           "description": "Establish a two-way binding between a single selection and input elements\n(also known as dynamic query widgets). A binding takes the form of\nVega's [input element binding definition](https://vega.github.io/vega/docs/signals/#bind)\nor can be a mapping between projected field/encodings and binding definitions.\n\nSee the [bind transform](https://vega.github.io/vega-lite/docs/bind.html) documentation for more information."
         },
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EventStream"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Controls clearing selections. Can be `true`, `false`, or an [EventStream](https://vega.github.io/vega/docs/event-streams/).\n\n__Default value:__ `true`, which corresponds to `dblclick` (i.e.\nuser doubleclick clears current selection).\n\nSee the [TODO: clear] documentation for more information."
+        },
         "empty": {
           "description": "By default, all data values are considered to lie within an empty selection.\nWhen set to `none`, empty selections contain no data values.",
           "enum": [
@@ -10354,6 +10409,17 @@
           ],
           "description": "Establish a two-way binding between a single selection and input elements\n(also known as dynamic query widgets). A binding takes the form of\nVega's [input element binding definition](https://vega.github.io/vega/docs/signals/#bind)\nor can be a mapping between projected field/encodings and binding definitions.\n\nSee the [bind transform](https://vega.github.io/vega-lite/docs/bind.html) documentation for more information."
         },
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EventStream"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Controls clearing selections. Can be `true`, `false`, or an [EventStream](https://vega.github.io/vega/docs/event-streams/).\n\n__Default value:__ `true`, which corresponds to `dblclick` (i.e.\nuser doubleclick clears current selection).\n\nSee the [TODO: clear] documentation for more information."
+        },
         "empty": {
           "description": "By default, all data values are considered to lie within an empty selection.\nWhen set to `none`, empty selections contain no data values.",
           "enum": [

examples/compiled/brush_table.vg.json

@@ -136,6 +136,10 @@
             {
               "events": {"signal": "brush_zoom_delta"},
               "update": "clampRange(zoomLinear(brush_x, brush_zoom_anchor.x, brush_zoom_delta), 0, concat_0_width)"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "[0, 0]"
             }
           ]
         },
@@ -191,6 +195,10 @@
             {
               "events": {"signal": "brush_zoom_delta"},
               "update": "clampRange(zoomLinear(brush_y, brush_zoom_anchor.y, brush_zoom_delta), 0, concat_0_height)"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "[0, 0]"
             }
           ]
         },
@@ -221,6 +229,10 @@
                 {"signal": "brush_Horsepower || brush_Miles_per_Gallon"}
               ],
               "update": "brush_Horsepower && brush_Miles_per_Gallon ? {unit: \"concat_0\", fields: brush_tuple_fields, values: [brush_Horsepower,brush_Miles_per_Gallon]} : null"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "null"
             }
           ]
         },

examples/compiled/circle_bubble_health_income.vg.json

@@ -39,7 +39,8 @@
         {
           "events": {"signal": "view_zoom_delta"},
           "update": "zoomLog(domain(\"x\"), view_zoom_anchor.x, view_zoom_delta)"
-        }
+        },
+        {"events": [{"source": "scope", "type": "dblclick"}], "update": "null"}
       ]
     },
     {
@@ -52,7 +53,8 @@
         {
           "events": {"signal": "view_zoom_delta"},
           "update": "zoomLinear(domain(\"y\"), view_zoom_anchor.y, view_zoom_delta)"
-        }
+        },
+        {"events": [{"source": "scope", "type": "dblclick"}], "update": "null"}
       ]
     },
     {

examples/compiled/concat_bar_layer_circle.vg.json

@@ -280,6 +280,10 @@
               "events": [{"source": "scope", "type": "click"}],
               "update": "datum && item().mark.marktype !== 'group' ? {unit: \"concat_1\", fields: pts_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"Major_Genre\"]]} : null",
               "force": true
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "null"
             }
           ]
         },

examples/compiled/concat_hover.vg.json

@@ -65,6 +65,10 @@
               "events": [{"source": "scope", "type": "mouseover"}],
               "update": "datum && item().mark.marktype !== 'group' ? {unit: \"concat_0\", fields: hover_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"_vgsid_\"]]} : null",
               "force": true
+            },
+            {
+              "events": [{"source": "scope", "type": "mouseout"}],
+              "update": "null"
             }
           ]
         },
@@ -170,6 +174,10 @@
               "events": [{"source": "scope", "type": "mouseover"}],
               "update": "datum && item().mark.marktype !== 'group' ? {unit: \"concat_1\", fields: hover_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"_vgsid_\"]]} : null",
               "force": true
+            },
+            {
+              "events": [{"source": "scope", "type": "mouseout"}],
+              "update": "null"
             }
           ]
         },

examples/compiled/concat_hover_filter.vg.json

@@ -92,6 +92,10 @@
               "events": [{"source": "scope", "type": "mouseover"}],
               "update": "datum && item().mark.marktype !== 'group' ? {unit: \"concat_0_layer_0\", fields: hover_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"_vgsid_\"]]} : null",
               "force": true
+            },
+            {
+              "events": [{"source": "scope", "type": "mouseout"}],
+              "update": "null"
             }
           ]
         },
@@ -208,6 +212,10 @@
               "events": [{"source": "scope", "type": "mouseover"}],
               "update": "datum && item().mark.marktype !== 'group' ? {unit: \"concat_1_layer_0\", fields: hover_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"_vgsid_\"]]} : null",
               "force": true
+            },
+            {
+              "events": [{"source": "scope", "type": "mouseout"}],
+              "update": "null"
             }
           ]
         },

examples/compiled/interactive_area_brush.vg.json

@@ -105,6 +105,10 @@
         {
           "events": {"signal": "brush_zoom_delta"},
           "update": "clampRange(zoomLinear(brush_x, brush_zoom_anchor.x, brush_zoom_delta), 0, width)"
+        },
+        {
+          "events": [{"source": "scope", "type": "dblclick"}],
+          "update": "[0, 0]"
         }
       ]
     },
@@ -133,7 +137,8 @@
         {
           "events": [{"signal": "brush_yearmonth_date"}],
           "update": "brush_yearmonth_date ? {unit: \"layer_0\", fields: brush_tuple_fields, values: [brush_yearmonth_date]} : null"
-        }
+        },
+        {"events": [{"source": "scope", "type": "dblclick"}], "update": "null"}
       ]
     },
     {

examples/compiled/interactive_bar_select_highlight.vg.json

@@ -56,7 +56,8 @@
           "events": [{"source": "scope", "type": "mouseover"}],
           "update": "datum && item().mark.marktype !== 'group' ? {unit: \"\", fields: highlight_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"_vgsid_\"]]} : null",
           "force": true
-        }
+        },
+        {"events": [{"source": "scope", "type": "mouseout"}], "update": "null"}
       ]
     },
     {
@@ -74,7 +75,8 @@
           "events": [{"source": "scope", "type": "click"}],
           "update": "datum && item().mark.marktype !== 'group' ? {unit: \"\", fields: select_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"_vgsid_\"]]} : null",
           "force": true
-        }
+        },
+        {"events": [{"source": "scope", "type": "dblclick"}], "update": "null"}
       ]
     },
     {
@@ -88,7 +90,8 @@
         {
           "events": [{"source": "scope", "type": "click"}],
           "update": "event.shiftKey"
-        }
+        },
+        {"events": [{"source": "scope", "type": "dblclick"}], "update": "null"}
       ]
     },
     {

examples/compiled/interactive_brush.vg.json

@@ -72,6 +72,10 @@
         {
           "events": {"signal": "brush_zoom_delta"},
           "update": "clampRange(zoomLinear(brush_x, brush_zoom_anchor.x, brush_zoom_delta), 0, width)"
+        },
+        {
+          "events": [{"source": "scope", "type": "dblclick"}],
+          "update": "[0, 0]"
         }
       ]
     },
@@ -128,6 +132,10 @@
         {
           "events": {"signal": "brush_zoom_delta"},
           "update": "clampRange(zoomLinear(brush_y, brush_zoom_anchor.y, brush_zoom_delta), 0, height)"
+        },
+        {
+          "events": [{"source": "scope", "type": "dblclick"}],
+          "update": "[0, 0]"
         }
       ]
     },
@@ -158,7 +166,8 @@
         {
           "events": [{"signal": "brush_Horsepower || brush_Miles_per_Gallon"}],
           "update": "brush_Horsepower && brush_Miles_per_Gallon ? {unit: \"\", fields: brush_tuple_fields, values: [brush_Horsepower,brush_Miles_per_Gallon]} : null"
-        }
+        },
+        {"events": [{"source": "scope", "type": "dblclick"}], "update": "null"}
       ]
     },
     {

examples/compiled/interactive_concat_layer.vg.json

@@ -286,6 +286,10 @@
               "events": [{"source": "scope", "type": "click"}],
               "update": "datum && item().mark.marktype !== 'group' ? {unit: \"concat_1\", fields: pts_tuple_fields, values: [(item().isVoronoi ? datum.datum : datum)[\"Major_Genre\"]]} : null",
               "force": true
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "null"
             }
           ]
         },

examples/compiled/interactive_dashboard_europe_pop.vg.json

@@ -409,6 +409,10 @@
             {
               "events": {"signal": "brush_zoom_delta"},
               "update": "clampRange(zoomLinear(brush_y, brush_zoom_anchor.y, brush_zoom_delta), 0, concat_0_height)"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "[0, 0]"
             }
           ]
         },
@@ -437,6 +441,10 @@
             {
               "events": [{"signal": "brush_Country"}],
               "update": "brush_Country ? {unit: \"concat_0\", fields: brush_tuple_fields, values: [brush_Country]} : null"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "null"
             }
           ]
         },
@@ -719,6 +727,10 @@
             {
               "events": {"signal": "brush_zoom_delta"},
               "update": "clampRange(zoomLinear(brush_y, brush_zoom_anchor.y, brush_zoom_delta), 0, concat_1_height)"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "[0, 0]"
             }
           ]
         },
@@ -747,6 +759,10 @@
             {
               "events": [{"signal": "brush_Country"}],
               "update": "brush_Country ? {unit: \"concat_1\", fields: brush_tuple_fields, values: [brush_Country]} : null"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "null"
             }
           ]
         },
@@ -1032,6 +1048,10 @@
             {
               "events": {"signal": "brush_zoom_delta"},
               "update": "clampRange(zoomLinear(brush_x, brush_zoom_anchor.x, brush_zoom_delta), 0, concat_2_width)"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "[0, 0]"
             }
           ]
         },
@@ -1087,6 +1107,10 @@
             {
               "events": {"signal": "brush_zoom_delta"},
               "update": "clampRange(zoomLinear(brush_y, brush_zoom_anchor.y, brush_zoom_delta), 0, concat_2_height)"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "[0, 0]"
             }
           ]
         },
@@ -1119,6 +1143,10 @@
                 }
               ],
               "update": "brush_Population_ages_65_and_above_of_total && brush_Population_ages_15_64_of_total ? {unit: \"concat_2\", fields: brush_tuple_fields, values: [brush_Population_ages_65_and_above_of_total,brush_Population_ages_15_64_of_total]} : null"
+            },
+            {
+              "events": [{"source": "scope", "type": "dblclick"}],
+              "update": "null"
             }
           ]
         },