Skip to content

Dropdown Menu

Show design guidelines

HTML React Angular
Dropdown Item Dropdown Item Dropdown Item Dropdown Item
<certara-dropdown button-label="Drop Down">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
</certara-dropdown>
import { CertaraDropdown, CertaraDropdownItem } from '@certara/certara-ui-react';
<CertaraDropdown button-label="Drop Down">
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
</CertaraDropdown>
// In your module (e.g., app.module.ts)
import { CertaraUiAngularModule } from '@certara/certara-ui-angular';
@NgModule({
imports: [CertaraUiAngularModule]
})
// In your template:
<certara-dropdown button-label="Drop Down">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
</certara-dropdown>
HTML React Angular
Dropdown Item Dropdown Item Dropdown Item Dropdown Item
<certara-dropdown button-label="Color" button-color="brand">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
</certara-dropdown>
import { CertaraDropdown, CertaraDropdownItem } from '@certara/certara-ui-react';
<CertaraDropdown button-label="Color" button-color="brand">
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
</CertaraDropdown>
// In your module (e.g., app.module.ts)
import { CertaraUiAngularModule } from '@certara/certara-ui-angular';
@NgModule({
imports: [CertaraUiAngularModule]
})
// In your template:
<certara-dropdown button-label="Color" button-color="brand">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
</certara-dropdown>
HTML React Angular
Dropdown Item Dropdown Item Dropdown Item Dropdown Item
<certara-dropdown placement="bottom-start" button-label="Actions">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
</certara-dropdown>
import { CertaraDropdown, CertaraDropdownItem } from '@certara/certara-ui-react';
<CertaraDropdown placement="bottom-start" button-label="Actions">
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
</CertaraDropdown>
// In your module (e.g., app.module.ts)
import { CertaraUiAngularModule } from '@certara/certara-ui-angular';
@NgModule({
imports: [CertaraUiAngularModule]
})
// In your template:
<certara-dropdown placement="bottom-start" button-label="Actions">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
</certara-dropdown>

<certara-dropdown> can be nested within itself using the nested attribute.

HTML React Angular
Dropdown Item Dropdown Item Dropdown Item Dropdown Item Nested Item Nested Item
<certara-dropdown button-label="With nested options">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown button-label="Nested options" nested>
<certara-dropdown-item>Nested Item</certara-dropdown-item>
<certara-dropdown-item>Nested Item</certara-dropdown-item>
</certara-dropdown>
</certara-dropdown>
import { CertaraDropdown, CertaraDropdownItem } from '@certara/certara-ui-react';
<CertaraDropdown button-label="With nested options">
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdownItem>Dropdown Item</CertaraDropdownItem>
<CertaraDropdown button-label="Nested options" nested>
<CertaraDropdownItem>Nested Item</CertaraDropdownItem>
<CertaraDropdownItem>Nested Item</CertaraDropdownItem>
</CertaraDropdown>
</CertaraDropdown>
// In your module (e.g., app.module.ts)
import { CertaraUiAngularModule } from '@certara/certara-ui-angular';
@NgModule({
imports: [CertaraUiAngularModule]
})
// In your template:
<certara-dropdown button-label="With nested options">
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown-item>Dropdown Item</certara-dropdown-item>
<certara-dropdown button-label="Nested options" nested>
<certara-dropdown-item>Nested Item</certara-dropdown-item>
<certara-dropdown-item>Nested Item</certara-dropdown-item>
</certara-dropdown>
</certara-dropdown>

buttonColor

Attributebutton-color
Type"brand" | "danger" | "inverse" | "neutral" | "secondary" | "success"
Default'secondary'
Requiredfalse
DescriptionSupports any color available in <certara-button>

buttonLabel

Attributebutton-label
Typestring
Defaultundefined
Requiredfalse
Description

buttonSize

Attributebutton-size
Type"lg" | "md" | "sm"
Default'md'
Requiredfalse
DescriptionSupports any size available in <certara-button>

buttonTabindex

Attributebutton-tabindex
Typenumber
Defaultundefined
Requiredfalse
DescriptionSet custom tabindex for the dropdown opener button

buttonVariant

Attributebutton-variant
Type"default" | "icon" | "link" | "outline" | "reset"
Default'default'
Requiredfalse
DescriptionSupports any variant available in <certara-button>

disabled

Attributedisabled
Typeboolean
Defaultfalse
Requiredfalse
DescriptionWill disable the dropdown opener button
Attributemenu-offset
Typenumber
Default4
Requiredfalse
DescriptionSeparation from the opener to the menu (depends on orientation)

nested

Attributenested
Typeboolean
Defaultfalse
Requiredfalse
DescriptionSpecify that a nested dropdown can act as a submenu item of a containing dropdown

placement

Attributeplacement
Type"bottom-end" | "bottom-start" | "left-start" | "right-end" | "right-start" | "top-end" | "top-start"
Default'bottom-start'
Requiredfalse
DescriptionThese options will suggest a starting point for the menu position, but
<certara-dropdown> will automatically position itself within the viewport
to avoid appearing offscreen

position

Attributeposition
Type"absolute" | "fixed"
Default'absolute'
Requiredfalse
DescriptionThis can be set to fixed if the dropdown menu is clipped by a bounding parent element

showOpenerCaret

Attributeshow-opener-caret
Typeboolean
Defaulttrue
Requiredfalse
DescriptionIf set to false, the dropdown opener will not show a caret icon
NameDescriptionBubbles
certaraDropdownClosetrue
certaraDropdownOpentrue
NameDescription
Main slot is reserved for <certara-dropdown-*> elements, but it does accept all children
button-labelCan be used for custom label content, including icons
HTML React Angular
Dropdown item
packages/certara-ui/src/components/dropdown/dropdown-item/dropdown-item.tsx
<certara-dropdown button-label="Dropdown">
<certara-dropdown-item>Dropdown item</certara-dropdown-item>
</certara-dropdown>
packages/certara-ui/src/components/dropdown/dropdown-item/dropdown-item.tsx
import { CertaraDropdown, CertaraDropdownItem } from '@certara/certara-ui-react';
<CertaraDropdown button-label="Dropdown">
<CertaraDropdownItem>Dropdown item</CertaraDropdownItem>
</CertaraDropdown>
packages/certara-ui/src/components/dropdown/dropdown-item/dropdown-item.tsx
// In your module (e.g., app.module.ts)
import { CertaraUiAngularModule } from '@certara/certara-ui-angular';
@NgModule({
imports: [CertaraUiAngularModule]
})
// In your template:
<certara-dropdown button-label="Dropdown">
<certara-dropdown-item>Dropdown item</certara-dropdown-item>
</certara-dropdown>

active

Attributeactive
Typeboolean
Defaultfalse
Requiredfalse
DescriptionWhether the dropdown item is in an active state

description

Attributedescription
Typestring
Defaultundefined
Requiredfalse
DescriptionAdditional descriptive text that shows below the label

hideMenuOnClick

Attributehide-menu-on-click
Typeboolean
Defaulttrue
Requiredfalse
DescriptionThe default behavior of the dropdown menu will close when this item is clicked

href

Attributehref
Typestring
Defaultundefined
Requiredfalse
Descriptioncertara-dropdown-item renders as a <button> element by default, unless given an href

target

Attributetarget
Type"_blank" | "_parent" | "_self" | "_top" | "_unfencedTop"
Defaultundefined
Requiredfalse
DescriptionTarget to be used in tandem with href if necessary
NameDescriptionBubbles
certaraClickStandard event emitted when the dropdown item is clickedtrue
certaraDropdownItemClickInternal event emitted when the dropdown item is clicked, used by certara-dropdowntrue
NameDescription
Default dropdown-item content
descriptionSlot for descriptive text
right-contentRight-aligned content area for buttons and additional actions

The <certara-dropdown-checkbox> uses all props from <certara-checkbox> with the exception of layout

checked

Attributechecked
Typeboolean
Defaultfalse
Requiredfalse
Description

description

Attributedescription
Typestring
Defaultundefined
Requiredfalse
DescriptionAdditional descriptive text that shows below the label

disabled

Attributedisabled
Typeboolean
Defaultfalse
Requiredfalse
Description

indeterminate

Attributeindeterminate
Typeboolean
Defaultfalse
Requiredfalse
Description

name

Attributename
Typestring
Defaultthis.inputId
Requiredfalse
Description

size

Attributesize
Type"md" | "sm"
Default'md'
Requiredfalse
Description

value

Attributevalue
Typeany
Default'on'
Requiredfalse
Description
NameDescriptionBubbles
certaraBlurtrue
certaraChangetrue
certaraFocustrue
NameDescription
Default dropdown-item-checkbox content
descriptionSlot for descriptive text