channels_select_menu: Public Channels List Select Menu Element

View source: R/block_elements.R

channels_select_menuR Documentation

Public Channels List Select Menu Element

Description

This multi-select menu will populate its options with a list of public channels visible to the current user in the active workspace. A select menu, just as with a standard HTML <select> tag, creates a drop down menu with a list of options for a user to choose. The select menu also includes type-ahead functionality, where a user can type a part or all of an option string to filter the list. To use interactive components, you will need to make some changes to prepare your app. Read our guide to enabling interactivity. Works with block types: Section Actions Input

Usage

channels_select_menu(
  placeholder,
  action_id,
  initial_channel = NULL,
  confirm = NULL
)

Arguments

placeholder

A plain_text only text_object that defines the placeholder text shown on the menu. Maximum length for the text in this field is 150 characters.

action_id

An identifier for the action triggered when a menu option is selected. You can use this when you receive an interaction payload to identify the source of the action. Should be unique among all other action_ids in the containing block. Maximum length for this field is 255 characters.

initial_channel

The ID of any valid public channel to be pre-selected when the menu loads.

confirm

A confirm_object that defines an optional confirmation dialog that appears before the select choices are submitted.

response_url_enabled

This field only works with menus in input_blocks in modals. When set to true, the view_submission payload from the menu's parent view will contain a response_url. This response_url can be used for message responses. The target channel for the message will be determined by the value of this select menu.

See Also

https://api.slack.com/reference/block-kit/block-elements#channel_select

Other Elements: button_element(), channels_multi_select_menu(), checkbox_element(), conversations_multi_select_menu(), conversations_select_menu(), datepicker_element(), external_multi_select_menu(), external_select_menu(), image_element(), overflow_menu_element(), plain_text_input_element(), radio_button_group_element(), static_multi_select_menu(), static_select_menu(), timepicker_element(), users_multi_select_menu(), users_select_menu()


samterfa/slackme documentation built on April 11, 2022, 3:29 a.m.