Class: Views::Docs::Combobox

Inherits:
Base
  • Object
show all
Defined in:
lib/ruby_ui/combobox/combobox_docs.rb

Constant Summary collapse

@@code_example =
nil

Instance Method Summary collapse

Methods inherited from Base

#Alert, #AlertDescription, #AlertTitle, #Heading, #InlineCode, #InlineLink, #Text, #component_files, #docs_accordion_path, #docs_alert_dialog_path, #docs_alert_path, #docs_aspect_ratio_path, #docs_avatar_path, #docs_badge_path, #docs_installation_path, #docs_separator_path, #docs_sheet_path

Instance Method Details

#view_templateObject



6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
# File 'lib/ruby_ui/combobox/combobox_docs.rb', line 6

def view_template
  component = "Combobox"
  div(class: "max-w-2xl mx-auto w-full py-10 space-y-10") do
    render Docs::Header.new(title: component, description: "Autocomplete input and command palette with a list of suggestions.")

    Heading(level: 2) { "Usage" }

    render Docs::VisualCodeExample.new(title: "Single option", context: self) do
      <<~RUBY
        div class: "w-96" do
          Combobox do
            ComboboxTrigger placeholder: "Pick value"

            ComboboxPopover do
              ComboboxSearchInput(placeholder: "Pick value or type anything")

              ComboboxList do
                ComboboxEmptyState { "No result" }

                ComboboxListGroup(label: "Fruits") do
                  ComboboxItem do
                    ComboboxRadio(name: "food", value: "apple")
                    span { "Apple" }
                  end

                  ComboboxItem do
                    ComboboxRadio(name: "food", value: "banana")
                    span { "Banana" }
                  end
                end

                ComboboxListGroup(label: "Vegetable") do
                  ComboboxItem do
                    ComboboxRadio(name: "food", value: "brocoli")
                    span { "Broccoli" }
                  end

                  ComboboxItem do
                    ComboboxRadio(name: "food", value: "carrot")
                    span { "Carrot" }
                  end
                end

                ComboboxListGroup(label: "Others") do
                  ComboboxItem do
                    ComboboxRadio(name: "food", value: "chocolate")
                    span { "Chocolate" }
                  end

                  ComboboxItem do
                    ComboboxRadio(name: "food", value: "milk")
                    span { "Milk" }
                  end
                end
              end
            end
          end
        end
      RUBY
    end

    render Docs::VisualCodeExample.new(title: "Multiple options", context: self) do
      <<~RUBY
        div class: "w-96" do
          Combobox term: "things" do
            ComboboxTrigger placeholder: "Pick value"

            ComboboxPopover do
              ComboboxSearchInput(placeholder: "Pick value or type anything")

              ComboboxList do
                ComboboxEmptyState { "No result" }

                ComboboxItem(class: "mt-3") do
                  ComboboxToggleAllCheckbox(name: "all", value: "all")
                  span { "Select all" }
                end

                ComboboxListGroup label: "Fruits" do
                  ComboboxItem do
                    ComboboxCheckbox(name: "food", value: "apple")
                    span { "Apple" }
                  end

                  ComboboxItem do
                    ComboboxCheckbox(name: "food", value: "banana")
                    span { "Banana" }
                  end
                end

                ComboboxListGroup label: "Vegetable" do
                  ComboboxItem do
                    ComboboxCheckbox(name: "food", value: "brocoli")
                    span { "Broccoli" }
                  end

                  ComboboxItem do
                    ComboboxCheckbox(name: "food", value: "carrot")
                    span { "Carrot" }
                  end
                end

                ComboboxListGroup label: "Others" do
                  ComboboxItem do
                    ComboboxCheckbox(name: "food", value: "chocolate")
                    span { "Chocolate" }
                  end

                  ComboboxItem do
                    ComboboxCheckbox(name: "food", value: "milk")
                    span { "Milk" }
                  end
                end
              end
            end
          end
        end
      RUBY
    end

    render Docs::VisualCodeExample.new(title: "Disabled", context: self) do
      <<~RUBY
        div(class: "w-96") do
          Combobox do
            ComboboxTrigger(disabled: true, placeholder: "Pick value")
          end
        end
      RUBY
    end

    render Docs::VisualCodeExample.new(title: "Aria Disabled", context: self) do
      <<~RUBY
        div(class: "w-96") do
          Combobox do
            ComboboxTrigger(aria: {disabled: "true"}, placeholder: "Pick value")
          end
        end
      RUBY
    end

    render Components::ComponentSetup::Tabs.new(component_name: "Combobox")

    render Docs::ComponentsTable.new(component_files("Combobox"))
  end
end