Class: Slack::BlockKit::Layout::Section

Inherits:
Object
  • Object
show all
Includes:
MultiSelectElements
Defined in:
lib/slack/block_kit/layout/section.rb,
lib/slack/block_kit/layout/section/multi_select_elements.rb

Overview

A section is one of the most flexible blocks available - it can be used as a simple text block, in combination with text fields, or side-by-side with any of the available block elements.

api.slack.com/reference/messaging/blocks#section

Defined Under Namespace

Modules: MultiSelectElements

Constant Summary collapse

TYPE = 
'section'

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from MultiSelectElements

#multi_channels_select, #multi_conversations_select, #multi_external_select, #multi_static_select, #multi_users_select

Constructor Details

#initialize(block_id: nil) {|_self| ... } ⇒ Section

Returns a new instance of Section.

Yields:

  • (_self)

Yield Parameters:



19
20
21
22
23
24
25
26
 
# File 'lib/slack/block_kit/layout/section.rb', line 19

def initialize(block_id: nil)
  @block_id = block_id
  @fields = nil
  @accessory = nil
  @text = nil

  yield(self) if block_given?
end

Instance Attribute Details

#accessory ⇒ Object

Returns the value of attribute accessory.



17
18
19
 
# File 'lib/slack/block_kit/layout/section.rb', line 17

def accessory
  @accessory
end

#fields ⇒ Object

Returns the value of attribute fields.



17
18
19
 
# File 'lib/slack/block_kit/layout/section.rb', line 17

def fields
  @fields
end

#text ⇒ Object

Returns the value of attribute text.



17
18
19
 
# File 'lib/slack/block_kit/layout/section.rb', line 17

def text
  @text
end

Instance Method Details

#accessorise(element) ⇒ Object 



181
182
183
184
185
 
# File 'lib/slack/block_kit/layout/section.rb', line 181

def accessorise(element)
  @accessory = element

  self
end

#as_json ⇒ Object 



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

def as_json(*)
  {
    type: TYPE,
    text: @text&.as_json,
    block_id: @block_id,
    fields: @fields&.map(&:as_json),
    accessory: @accessory&.as_json
  }.compact
end

#button(text:, action_id:, style: nil, emoji: nil, url: nil, value: nil) {|element| ... } ⇒ Object

Yields:

  • (element) 


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

def button(text:, action_id:, style: nil, emoji: nil, url: nil, value: nil)
  element = Element::Button.new(
    text: text,
    action_id: action_id,
    style: style,
    emoji: emoji,
    url: url,
    value: value
  )

  yield(element) if block_given?

  accessorise(element)
end

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

Yields:

  • (element) 


71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/slack/block_kit/layout/section.rb', line 71

def channel_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?

  accessorise(element)
end

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

Yields:

  • (element) 


157
158
159
160
161
162
163
164
165
 
# File 'lib/slack/block_kit/layout/section.rb', line 157

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

  yield(element) if block_given?

  accessorise(element)
end

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

Yields:

  • (element) 


84
85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/slack/block_kit/layout/section.rb', line 84

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?

  accessorise(element)
end

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

Yields:

  • (element) 


97
98
99
100
101
102
103
104
105
106
107
108
 
# File 'lib/slack/block_kit/layout/section.rb', line 97

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

  yield(element) if block_given?

  accessorise(element)
end

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

Yields:

  • (element) 


110
111
112
113
114
115
116
117
118
119
120
121
122
 
# File 'lib/slack/block_kit/layout/section.rb', line 110

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?

  accessorise(element)
end

#image(url:, alt_text:) ⇒ Object 



177
178
179
 
# File 'lib/slack/block_kit/layout/section.rb', line 177

def image(url:, alt_text:)
  accessorise(Element::Image.new(image_url: url, alt_text: alt_text))
end

#mrkdwn(text:, verbatim: nil) ⇒ Object 



50
51
52
53
54
 
# File 'lib/slack/block_kit/layout/section.rb', line 50

def mrkdwn(text:, verbatim: nil)
  @text = Composition::Mrkdwn.new(text: text, verbatim: verbatim)

  self
end

#mrkdwn_field(text:, verbatim: nil) ⇒ Object 



36
37
38
39
40
41
42
 
# File 'lib/slack/block_kit/layout/section.rb', line 36

def mrkdwn_field(text:, verbatim: nil)
  @fields ||= []

  @fields << Composition::Mrkdwn.new(text: text, verbatim: verbatim)

  self
end

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

Yields:

  • (element) 


124
125
126
127
128
129
130
 
# File 'lib/slack/block_kit/layout/section.rb', line 124

def overflow_menu(action_id:)
  element = Element::OverflowMenu.new(action_id: action_id)

  yield(element) if block_given?

  accessorise(element)
end

#plain_text(text:, emoji: nil) ⇒ Object 



44
45
46
47
48
 
# File 'lib/slack/block_kit/layout/section.rb', line 44

def plain_text(text:, emoji: nil)
  @text = Composition::PlainText.new(text: text, emoji: emoji)

  self
end

#plaintext_field(text:, emoji: nil) ⇒ Object 



28
29
30
31
32
33
34
 
# File 'lib/slack/block_kit/layout/section.rb', line 28

def plaintext_field(text:, emoji: nil)
  @fields ||= []

  @fields << Composition::PlainText.new(text: text, emoji: emoji)

  self
end

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

Yields:

  • (element) 


167
168
169
170
171
172
173
174
175
 
# File 'lib/slack/block_kit/layout/section.rb', line 167

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

  yield(element) if block_given?

  accessorise(element)
end

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

Yields:

  • (element) 


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

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?

  accessorise(element)
end

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

Yields:

  • (element) 


144
145
146
147
148
149
150
151
152
153
154
155
 
# File 'lib/slack/block_kit/layout/section.rb', line 144

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

  yield(element) if block_given?

  accessorise(element)
end