Class: Slack::BlockKit::Layout::Input

Inherits:
Object
  • Object
show all
Defined in:
lib/slack/block_kit/layout/input.rb

Overview

A block that collects information from users - it can hold a plain-text input element, a checkbox element, a radio button element, a select menu element, a multi-select menu element, or a datepicker.

api.slack.com/reference/block-kit/blocks#input

Constant Summary collapse

TYPE = 
'input'

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(label:, element: nil, block_id: nil, hint: nil, optional: nil, emoji: nil, dispatch_action: nil) ⇒ Input

Returns a new instance of Input.



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/slack/block_kit/layout/input.rb', line 16

def initialize(
  label:,
  element: nil,
  block_id: nil,
  hint: nil,
  optional: nil,
  emoji: nil,
  dispatch_action: nil
)
  @label = Composition::PlainText.new(text: label, emoji: emoji) if label
  @hint = Composition::PlainText.new(text: hint, emoji: emoji) if hint
  @block_id = block_id
  @optional = optional
  @element = element
  @dispatch_action = dispatch_action
end

Instance Attribute Details

#block_id ⇒ Object

Returns the value of attribute block_id.



14
15
16
 
# File 'lib/slack/block_kit/layout/input.rb', line 14

def block_id
  @block_id
end

#element ⇒ Object

Returns the value of attribute element.



14
15
16
 
# File 'lib/slack/block_kit/layout/input.rb', line 14

def element
  @element
end

#emoji ⇒ Object

Returns the value of attribute emoji.



14
15
16
 
# File 'lib/slack/block_kit/layout/input.rb', line 14

def emoji
  @emoji
end

#hint ⇒ Object

Returns the value of attribute hint.



14
15
16
 
# File 'lib/slack/block_kit/layout/input.rb', line 14

def hint
  @hint
end

#label ⇒ Object

Returns the value of attribute label.



14
15
16
 
# File 'lib/slack/block_kit/layout/input.rb', line 14

def label
  @label
end

#optional ⇒ Object

Returns the value of attribute optional.



14
15
16
 
# File 'lib/slack/block_kit/layout/input.rb', line 14

def optional
  @optional
end

Instance Method Details

#as_json ⇒ Object 



226
227
228
229
230
231
232
233
234
235
236
 
# File 'lib/slack/block_kit/layout/input.rb', line 226

def as_json(*)
  {
    type: TYPE,
    element: @element.as_json,
    label: @label&.as_json,
    hint: @hint&.as_json,
    block_id: @block_id,
    optional: optional,
    dispatch_action: @dispatch_action
  }.compact
end

#channels_select(placeholder:, action_id:, initial: nil, emoji: nil) {|@element| ... } ⇒ Object

Yields:



60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/slack/block_kit/layout/input.rb', line 60

def channels_select(placeholder:, action_id:, initial: nil, emoji: nil)
  @element = Element::ChannelsSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    emoji: emoji
  )

  yield(@element) if block_given?

  self
end

#checkboxes(action_id:) {|@element| ... } ⇒ Object

Yields:



73
74
75
76
77
78
79
 
# File 'lib/slack/block_kit/layout/input.rb', line 73

def checkboxes(action_id:)
  @element = Element::Checkboxes.new(action_id: action_id)

  yield(@element) if block_given?

  self
end

#conversation_select(placeholder:, action_id:, initial: nil, emoji: nil) {|@element| ... } ⇒ Object

Yields:



33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/slack/block_kit/layout/input.rb', line 33

def conversation_select(placeholder:, action_id:, initial: nil, emoji: nil)
  @element = Element::ConversationsSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    emoji: emoji
  )

  yield(@element) if block_given?

  self
end

#datepicker(action_id:, placeholder: nil, initial: nil, emoji: nil) {|@element| ... } ⇒ Object

Yields:



81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/slack/block_kit/layout/input.rb', line 81

def datepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
  @element = Element::DatePicker.new(
    action_id: action_id,
    placeholder: placeholder,
    initial: initial,
    emoji: emoji
  )

  yield(@element) if block_given?

  self
end

#external_select(placeholder:, action_id:, initial: nil, min_query_length: nil, emoji: nil) {|@element| ... } ⇒ Object

Yields:



133
134
135
136
137
138
139
140
141
142
143
144
145
 
# File 'lib/slack/block_kit/layout/input.rb', line 133

def external_select(placeholder:, action_id:, initial: nil, min_query_length: nil, emoji: nil)
  @element = Element::ExternalSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    min_query_length: min_query_length,
    emoji: emoji
  )

  yield(@element) if block_given?

  self
end

#multi_channels_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil) {|@element| ... } ⇒ Object

Yields:



94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/slack/block_kit/layout/input.rb', line 94

def multi_channels_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
  @element = Element::MultiChannelsSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    emoji: emoji,
    max_selected_items: max_selected_items
  )

  yield(@element) if block_given?

  self
end

#multi_conversations_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil) {|@element| ... } ⇒ Object

Yields:



46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/slack/block_kit/layout/input.rb', line 46

def multi_conversations_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
  @element = Element::MultiConversationsSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    emoji: emoji,
    max_selected_items: max_selected_items
  )

  yield(@element) if block_given?

  self
end

#multi_external_select(placeholder:, action_id:, initial: nil, min_query_length: nil, emoji: nil, max_selected_items: nil) {|@element| ... } ⇒ Object

Yields:



147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/slack/block_kit/layout/input.rb', line 147

def multi_external_select(
  placeholder:,
  action_id:,
  initial: nil,
  min_query_length: nil,
  emoji: nil,
  max_selected_items: nil
)
  @element = Element::MultiExternalSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    min_query_length: min_query_length,
    emoji: emoji,
    max_selected_items: max_selected_items
  )

  yield(@element) if block_given?

  self
end

#multi_static_select(placeholder:, action_id:, emoji: nil, max_selected_items: nil) {|@element| ... } ⇒ Object

Yields:



120
121
122
123
124
125
126
127
128
129
130
131
 
# File 'lib/slack/block_kit/layout/input.rb', line 120

def multi_static_select(placeholder:, action_id:, emoji: nil, max_selected_items: nil)
  @element = Element::MultiStaticSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    emoji: emoji,
    max_selected_items: max_selected_items
  )

  yield(@element) if block_given?

  self
end

#multi_users_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil) {|@element| ... } ⇒ Object

Yields:



212
213
214
215
216
217
218
219
220
221
222
223
224
 
# File 'lib/slack/block_kit/layout/input.rb', line 212

def multi_users_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
  @element = Element::MultiUsersSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    emoji: emoji,
    max_selected_items: max_selected_items
  )

  yield(@element) if block_given?

  self
end

#plain_text_input(action_id:, placeholder: nil, emoji: nil, initial_value: nil, multiline: nil, min_length: nil, max_length: nil) ⇒ Object 



169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
 
# File 'lib/slack/block_kit/layout/input.rb', line 169

def plain_text_input(
  action_id:,
  placeholder: nil,
  emoji: nil,
  initial_value: nil,
  multiline: nil,
  min_length: nil,
  max_length: nil
)
  @element = Element::PlainTextInput.new(
    action_id: action_id,
    placeholder: placeholder,
    emoji: emoji,
    initial_value: initial_value,
    multiline: multiline,
    min_length: min_length,
    max_length: max_length
  )

  self
end

#radio_buttons(action_id:) {|@element| ... } ⇒ Object

Yields:



191
192
193
194
195
196
197
 
# File 'lib/slack/block_kit/layout/input.rb', line 191

def radio_buttons(action_id:)
  @element = Element::RadioButtons.new(action_id: action_id)

  yield(@element) if block_given?

  self
end

#static_select(placeholder:, action_id:, emoji: nil) {|@element| ... } ⇒ Object

Yields:



108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/slack/block_kit/layout/input.rb', line 108

def static_select(placeholder:, action_id:, emoji: nil)
  @element = Element::StaticSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    emoji: emoji
  )

  yield(@element) if block_given?

  self
end

#users_select(placeholder:, action_id:, initial: nil, emoji: nil) {|@element| ... } ⇒ Object

Yields:



199
200
201
202
203
204
205
206
207
208
209
210
 
# File 'lib/slack/block_kit/layout/input.rb', line 199

def users_select(placeholder:, action_id:, initial: nil, emoji: nil)
  @element = Element::UsersSelect.new(
    placeholder: placeholder,
    action_id: action_id,
    initial: initial,
    emoji: emoji
  )

  yield(@element) if block_given?

  self
end