thaw/demo_markdown/docs/menu/mod.md

# Menu 

```rust demo
//let message = use_message();

//let on_select = move |key: String| {
//    match key.as_str() {
//        "facebook" => message.create( "Facebook".into(), MessageVariant::Success, Default::default(),),
//        "twitter" =>  message.create( "Twitter".into(), MessageVariant::Warning, Default::default(),),
//        _ => ()
//    }
//};

let on_select = move |key| println!("{}", key);

view! {
    <Space>
        <Menu on_select trigger_type=MenuTriggerType::Hover>
            <MenuTrigger slot>
                <Button>"Hover"</Button>
            </MenuTrigger>
            <MenuItem key="facebook" icon=icondata::AiFacebookOutlined label="Facebook"></MenuItem>
            <MenuItem key="twitter" disabled=true icon=icondata::AiTwitterOutlined label="Twitter"></MenuItem>
        </Menu>

        <Menu on_select>
            <MenuTrigger slot>
                <Button>"Click"</Button>
            </MenuTrigger>
            <MenuItem key="facebook" icon=icondata::AiFacebookOutlined label="Facebook"></MenuItem>
            <MenuItem key="twitter" icon=icondata::AiTwitterOutlined label="Twitter"></MenuItem>
            <MenuItem key="no_icon" disabled=true label="Mastodon"></MenuItem>
        </Menu>
    </Space>
}
```

### Placement

```rust demo
use leptos_meta::Style;

let on_select = move |key| println!("{}", key);

view! {
    <Style>
        ".demo-menu .thaw-button { width: 100% } .demo-menu .thaw-menu-trigger { display: block }"
    </Style>
    <Grid x_gap=8 y_gap=8 cols=3 class="demo-menu">
        <GridItem>
            <Menu on_select placement=MenuPlacement::TopStart>
                <MenuTrigger slot>
                    <Button>"Top Start"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::Top>
                <MenuTrigger slot>
                    <Button>"Top"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::TopEnd>
                <MenuTrigger slot>
                    <Button>"Top End"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::LeftStart>
                <MenuTrigger slot>
                    <Button>"Left Start"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem offset=1>
            <Menu on_select placement=MenuPlacement::RightStart>
                <MenuTrigger slot>
                    <Button>"Right Start"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::Left>
                <MenuTrigger slot>
                    <Button>"Left"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem offset=1>
            <Menu on_select placement=MenuPlacement::Right>
                <MenuTrigger slot>
                    <Button>"Right"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::LeftEnd>
                <MenuTrigger slot>
                    <Button>"Left End"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem offset=1>
            <Menu on_select placement=MenuPlacement::RightEnd>
                <MenuTrigger slot>
                    <Button>"Right End"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::BottomStart>
                <MenuTrigger slot>
                    <Button>"Bottom Start"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::Bottom>
                <MenuTrigger slot>
                    <Button>"Bottom"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
        <GridItem>
            <Menu on_select placement=MenuPlacement::BottomEnd>
                <MenuTrigger slot>
                    <Button>"Bottom End"</Button>
                </MenuTrigger>
                "Content"
            </Menu>
        </GridItem>
    </Grid>
}
```

### Menu Props

| Name         | Type                                | Default                      | Description                                 |
| ------------ | ----------------------------------- | ---------------------------- | ------------------------------------------- |
| class        | `OptionalProp<MaybeSignal<String>>` | `Default::default()`         | Addtional classes for the menu element. |
| on_select    | `Callback<String>`                  |                              | Called when item is selected.               |
| trigger_type | `MenuTriggerType`               | `MenuTriggerType::Click` | Action that displays the menu.          |
| placement    | `MenuPlacement`                 | `MenuPlacement::Bottom`  | Menu placement.                         | 
| children     | `Children`                          |                              | The content inside menu.                |

### MenuItem Props

| Name     | Type                                         | Default              | Description                                      |
| -------- | -------------------------------------------- | -------------------- | ------------------------------------------------ |
| class    | `OptionalProp<MaybeSignal<String>>`          | `Default::default()` | Addtional classes for the menu item element. |
| key      | `MaybeSignal<String>`                        | `Default::default()` | The key of the menu item.                    |
| label    | `MaybeSignal<String>`                        | `Default::default()` | The label of the menu item.                  |
| icon     | `OptionalMaybeSignal<icondata_core::Icon>`   | `None`               | The icon of the menu item.                   |
| disabled | `MaybeSignal<bool>`                          | `false`              | Whether the menu item is disabled.           |


### Menu Slots

| Name            | Default | Description                                      |
| --------------- | ------- | ------------------------------------------------ |
| MenuTrigger | `None`  | The element or component that triggers menu. |

### MenuTriger Props

| Name         | Type                                | Default                      | Description                                         |
| ------------ | ----------------------------------- | ---------------------------- | --------------------------------------------------  |
| class        | `OptionalProp<MaybeSignal<String>>` | `Default::default()`         | Addtional classes for the menu trigger element. |
| children     | `Children`                          |                              | The content inside menu trigger.                |