Struct slack_blocks::compose::opt_group::OptGroup

pub struct OptGroup<'a, T = AnyText, U = NoUrl> { /* fields omitted */ }

Option Group

slack api docs 🔗

Provides a way to group options in a select menu 🔗 or multi-select menu 🔗.

Implementations

impl<'a> OptGroup<'a>

pub fn builder() -> OptGroupBuilderInit<'a>

Build a new option group composition object

Examples

see example for OptGroupBuilder

pub fn from_label_and_opts<T, U>(
    label: impl Into<Plain>,
    options: impl IntoIterator<Item = Opt<'a, T, U>>
) -> OptGroup<'a, T, U>

👎 Deprecated since 0.15.0:

Use OptGroup::builder instead

Construct an Option Group from a label and collection of options in the group

Arguments

• label - A plain_text only text object 🔗 that defines the label shown above this group of options. Maximum length for the text in this field is 75 characters.
• opts - An array of option objects 🔗 that belong to this specific group. Maximum of 100 items.

Example

use slack_blocks::blocks::Block;
use slack_blocks::blocks::section::Section;
use slack_blocks::blocks::Actions;
use slack_blocks::text::{Mrkdwn};
use slack_blocks::compose::{OptGroup, Opt};

let prompt = "Choose your favorite city from each state!";

let blocks: Vec<Block> = vec![
    Section::from_text(Mrkdwn::from(prompt)).into(),
    // TODO: insert option group once block elements are in place
    Actions::from_action_elements(vec![]).into(),
];

let groups: Vec<OptGroup<_>> = vec![
    OptGroup::from_label_and_opts(
        "Arizona",
        vec![
            Opt::from_mrkdwn_and_value("Phoenix", "az_phx"),
            // etc...
        ]
    ),
    OptGroup::from_label_and_opts(
        "California",
        vec![
            Opt::from_mrkdwn_and_value("San Diego", "ca_sd"),
            // etc...
        ]
    ),
];

impl<'a, T, U> OptGroup<'a, T, U>

pub fn validate(&self) -> Result<(), ValidationErrors>

Validate that this Option Group object agrees with Slack’s model requirements

Errors

• If from_label_and_opts was called with label longer than 75 chars
• If from_label_and_opts was called with more than 100 options

Example

use std::iter::repeat;

use slack_blocks::compose::{Opt, OptGroup};

let long_string: String = repeat(' ').take(76).collect();

let opt = Opt::from_mrkdwn_and_value("San Diego", "ca_sd");
let grp = OptGroup::from_label_and_opts(long_string, vec![opt]);

assert_eq!(true, matches!(grp.validate(), Err(_)));

Trait Implementations

impl<'a, T: Clone, U: Clone> Clone for OptGroup<'a, T, U>

fn clone(&self) -> OptGroup<'a, T, U>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, T: Debug, U: Debug> Debug for OptGroup<'a, T, U>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de, 'a, T, U> Deserialize<'de> for OptGroup<'a, T, U> where
    T: Deserialize<'de>,
    U: Deserialize<'de>, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<'a, T, U> From<OptGroup<'a, T, U>> for OptOrOptGroup<'a, T, U>

fn from(src: OptGroup<'a, T, U>) -> Self

Performs the conversion.

impl<'a, T: Hash, U: Hash> Hash for OptGroup<'a, T, U>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<'a, T: PartialEq, U: PartialEq> PartialEq<OptGroup<'a, T, U>> for OptGroup<'a, T, U>

fn eq(&self, other: &OptGroup<'a, T, U>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &OptGroup<'a, T, U>) -> bool

This method tests for !=.

impl<'a, T, U> Serialize for OptGroup<'a, T, U> where
    T: Serialize,
    U: Serialize, 

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl<'a, T, U> Validate for OptGroup<'a, T, U>

fn validate(&self) -> Result<(), ValidationErrors>

impl<'a, T, U> StructuralPartialEq for OptGroup<'a, T, U>