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) ⇒ Input

Returns a new instance of Input.



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

def initialize(
  label:,
  element: nil,
  block_id: nil,
  hint: nil,
  optional: nil,
  emoji: 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
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 



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

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

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

Yields:



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

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:



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

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:



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

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:



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

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:



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

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:



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

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:



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

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:



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

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:



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

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:



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

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 



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

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:



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

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:



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

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:



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

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