From a8698d4fdcbd7a1e5e2d2bea3085ca1d51285092 Mon Sep 17 00:00:00 2001
From: Paul Bob <69730720+Paul-Bob@users.noreply.github.com>
Date: Mon, 29 Jul 2024 14:20:59 +0300
Subject: [PATCH] Options for select (#263)

* options for select

* bold

* drop internal invert

* version req
---
 docs/3.0/dynamic-filters.md | 45 +++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/3.0/dynamic-filters.md b/docs/3.0/dynamic-filters.md
index 11679520..8b87d03a 100644
--- a/docs/3.0/dynamic-filters.md
+++ b/docs/3.0/dynamic-filters.md
@@ -497,3 +497,48 @@ dynamic_filter :first_name,
   suggestions: -> { ["Avo", "Cado", params[:extra_suggestion]] }
 ```
 </Option>
+
+<Option name="`options`">
+<VersionReq version="3.10.10" />
+
+Customize the options **for select type filters**. **This is available only for select type filters** and determines the options visible in the select dropdown.
+
+##### Default value
+
+Fetched from field if bond to a field or `[]`
+
+#### Possible values
+
+An array or hash where the key-value pairs represent the options.
+
+- If a hash is provided, the key is the option label and the value is the option value.
+- If an array is provided, the array elements are used as both the option value and the option label.
+
+##### Usage examples
+###### Array
+```ruby{3}
+dynamic_filter :version,
+  type: :select,
+  options: ["Label 1", "Label 2"]
+```
+
+###### Hash (with invert)
+```ruby{3-6}
+dynamic_filter :version,
+  type: :select,
+  options: {
+    value_1: "Label 1",
+    value_2: "Label 2"
+  }.invert
+```
+
+###### Hash (without invert)
+```ruby{3-6}
+dynamic_filter :version,
+  type: :select,
+  options: {
+    "Label 1" => :value_1,
+    "Label 2" => :value_2
+  }
+```
+</Option>