@esri/calcite-components
Version:
Web Components for Esri's Calcite Design System.
1,599 lines • 234 kB
TypeScript
/* eslint-disable */
/* tslint:disable */
/**
* This is an autogenerated file created by the Stencil compiler.
* It contains typing information for all components that exist in this project.
*/
import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
import { AccordionAppearance } from "./components/calcite-accordion/interfaces";
import { Alignment, Appearance, Columns, FlipContext, Layout, Position, Scale, Status, Width } from "./components/interfaces";
import { Placement } from "@popperjs/core";
import { OverlayPositioning, PopperPlacement } from "./utils/popper";
import { AlertDuration, StatusColor } from "./components/calcite-alert/interfaces";
import { HeadingLevel } from "./components/functional/CalciteHeading";
import { BlockSectionToggleDisplay } from "./components/calcite-block-section/interfaces";
import { ButtonAlignment, ButtonAppearance, ButtonColor, DropdownIconType } from "./components/calcite-button/interfaces";
import { ChipColor } from "./components/calcite-chip/interfaces";
import { ColorAppearance, ColorValue, InternalColor } from "./components/calcite-color-picker/interfaces";
import { Format } from "./components/calcite-color-picker/utils";
import { ComboboxChildElement, ComboboxSelectionMode } from "./components/calcite-combobox/interfaces";
import { DateRangeChange } from "./components/calcite-date-picker/interfaces";
import { DateLocaleData } from "./components/calcite-date-picker/utils";
import { DropdownPlacement, ItemKeyboardEvent } from "./components/calcite-dropdown/interfaces";
import { SelectionMode } from "./components/calcite-dropdown-group/interfaces";
import { DataSeries } from "./components/calcite-graph/interfaces";
import { InputPlacement } from "./components/calcite-input/interfaces";
import { InputMessageType } from "./components/calcite-input-message/interfaces";
import { HourDisplayFormat, Time, TimeFocusId } from "./utils/time";
import { FocusRequest } from "./components/calcite-label/interfaces";
import { ModalBackgroundColor } from "./components/calcite-modal/interfaces";
import { CalcitePaginationDetail } from "./components/calcite-pagination/calcite-pagination";
import { ListFocusId } from "./components/calcite-pick-list/shared-list-logic";
import { ICON_TYPES } from "./components/calcite-pick-list/resources";
import { RadioAppearance } from "./components/calcite-radio-group/interfaces";
import { TabID, TabLayout, TabPosition } from "./components/calcite-tabs/interfaces";
import { TabChangeEventDetail } from "./components/calcite-tab/interfaces";
import { TileSelectType } from "./components/calcite-tile-select/interfaces";
import { TileSelectGroupLayout } from "./components/calcite-tile-select-group/interfaces";
import { TreeSelectDetail, TreeSelectionMode } from "./components/calcite-tree/interfaces";
import { TreeItemSelectDetail } from "./components/calcite-tree-item/interfaces";
export namespace Components {
interface CalciteAccordion {
/**
* specify the appearance - default (containing border), or minimal (no containing border), defaults to default
*/
"appearance": AccordionAppearance;
/**
* specify the placement of the icon in the header, defaults to end
*/
"iconPosition": Position;
/**
* specify the type of the icon in the header, defaults to chevron
*/
"iconType": "chevron" | "caret" | "plus-minus";
/**
* specify the scale of accordion, defaults to m
*/
"scale": Scale;
/**
* specify the selection mode - multi (allow any number of open items), single (allow one open item), or single-persist (allow and require one open item), defaults to multi
*/
"selectionMode": "multi" | "single" | "single-persist";
}
interface CalciteAccordionItem {
"active": boolean;
/**
* optionally pass an icon to display - accepts Calcite UI icon names
*/
"icon"?: string;
/**
* pass a title for the accordion item
*/
"itemSubtitle"?: string;
/**
* pass a title for the accordion item
*/
"itemTitle"?: string;
}
interface CalciteAction {
/**
* Indicates whether the action is highlighted.
*/
"active": boolean;
/**
* Indicates the alignment when text-enabled is false.
*/
"alignment"?: Alignment;
/**
* Specify the appearance style of the action, defaults to solid.
*/
"appearance": Appearance;
/**
* Compact mode is used internally by components to reduce side padding, e.g. calcite-block-section.
*/
"compact": boolean;
/**
* When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
*/
"disabled": boolean;
/**
* The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
*/
"icon"?: string;
/**
* Indicates unread changes.
*/
"indicator": boolean;
/**
* string to override English loading text
*/
"intlLoading"?: string;
/**
* The label of the action. If no label is provided, the label inherits what's provided for the `text` prop.
*/
"label"?: string;
/**
* When true, content is waiting to be loaded. This state shows a busy indicator.
*/
"loading": boolean;
/**
* Specifies the size of the action.
*/
"scale": Scale;
"setFocus": () => Promise<void>;
/**
* Text that accompanies the action icon.
*/
"text": string;
/**
* Indicates whether the text is displayed.
*/
"textEnabled": boolean;
}
interface CalciteActionBar {
/**
* When set to true, the expand-toggling behavior will be disabled.
*/
"expandDisabled": boolean;
/**
* Indicates whether widget is expanded.
*/
"expanded": boolean;
/**
* Updates the label of the collapse icon when the component is expanded.
*/
"intlCollapse"?: string;
/**
* Updates the label of the expand icon when the component is not expanded.
*/
"intlExpand"?: string;
/**
* Disables automatically overflowing actions that won't fit into menus.
*/
"overflowActionsDisabled"?: boolean;
/**
* Arranges the component depending on the elements 'dir' property.
*/
"position": Position;
"setFocus": (focusId?: "expand-toggle") => Promise<void>;
}
interface CalciteActionGroup {
/**
* Indicates number of columns.
*/
"columns"?: Columns;
/**
* Indicates whether widget is expanded.
*/
"expanded": boolean;
/**
* Text string for the actions menu.
*/
"intlMore"?: string;
/**
* Indicates the horizontal, vertical, or grid layout of the component.
*/
"layout": Layout;
/**
* Opens the action menu.
*/
"menuOpen": boolean;
}
interface CalciteActionMenu {
/**
* Indicates whether widget is expanded.
*/
"expanded": boolean;
/**
* Defines the available placements that can be used when a flip occurs.
*/
"flipPlacements"?: Placement[];
/**
* Text string for the actions menu.
*/
"label": string;
/**
* Opens the action menu.
*/
"open": boolean;
/**
* Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
*/
"overlayPositioning": OverlayPositioning;
/**
* Determines where the component will be positioned relative to the referenceElement.
*/
"placement": PopperPlacement;
/**
* Specifies the size of the action.
*/
"scale": Scale;
"setFocus": () => Promise<void>;
}
interface CalciteActionPad {
/**
* When set to true, the expand-toggling behavior will be disabled.
*/
"expandDisabled": boolean;
/**
* Indicates whether widget is expanded.
*/
"expanded": boolean;
/**
* Updates the label of the collapse icon when the component is expanded.
*/
"intlCollapse"?: string;
/**
* Updates the label of the expand icon when the component is not expanded.
*/
"intlExpand"?: string;
/**
* Indicates the horizontal or vertical layout of the component.
*/
"layout": Layout;
/**
* Arranges the component depending on the elements 'dir' property.
*/
"position": Position;
"setFocus": (focusId?: "expand-toggle") => Promise<void>;
}
interface CalciteAlert {
/**
* Is the alert currently active or not
*/
"active": boolean;
/**
* Close the alert automatically (recommended for passive, non-blocking alerts)
*/
"autoDismiss": boolean;
/**
* Duration of autoDismiss (only used with `autoDismiss`)
*/
"autoDismissDuration": AlertDuration;
/**
* Color for the alert (will apply to top border and icon)
*/
"color": StatusColor;
/**
* when used as a boolean set to true, show a default recommended icon. You can also pass a calcite-ui-icon name to this prop to display a requested icon
*/
"icon": string | boolean;
/**
* string to override English close text
*/
"intlClose": string;
/**
* Accessible name for the component
*/
"label": string;
/**
* specify the scale of the button, defaults to m
*/
"scale": Scale;
/**
* focus either the slotted link or the close button
*/
"setFocus": () => Promise<void>;
}
interface CalciteAvatar {
/**
* full name of the user
*/
"fullName": string;
/**
* specify the scale of the avatar, defaults to m
*/
"scale": Scale;
/**
* src to an image (remember to add a token if the user is private)
*/
"thumbnail": string;
/**
* unique id for user
*/
"userId": string;
/**
* user name
*/
"username": string;
}
interface CalciteBlock {
/**
* When true, this block will be collapsible.
*/
"collapsible": boolean;
/**
* When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
*/
"disabled": boolean;
/**
* When true, displays a drag handle in the header.
*/
"dragHandle": boolean;
/**
* Block heading.
*/
"heading": string;
/**
* Number at which section headings should start for this component.
*/
"headingLevel": HeadingLevel;
/**
* Tooltip used for the toggle when expanded.
*/
"intlCollapse"?: string;
/**
* Tooltip used for the toggle when collapsed.
*/
"intlExpand"?: string;
/**
* string to override English loading text
*/
"intlLoading"?: string;
/**
* When true, content is waiting to be loaded. This state shows a busy indicator.
*/
"loading": boolean;
/**
* When true, the block's content will be displayed.
*/
"open": boolean;
/**
* Block status. Updates or adds icon to show related icon and color.
*/
"status"?: Status;
/**
* Block summary.
*/
"summary": string;
}
interface CalciteBlockSection {
/**
* Tooltip used for the toggle when expanded.
*/
"intlCollapse"?: string;
/**
* Tooltip used for the toggle when collapsed.
*/
"intlExpand"?: string;
/**
* When true, the block's section content will be displayed.
*/
"open": boolean;
/**
* BlockSection status. Adds indicator to show valid or invalid status.
*/
"status"?: Status;
/**
* Text displayed in the button.
*/
"text": string;
/**
* This property determines the look of the section toggle. If the value is "switch", a toggle-switch will be displayed. If the value is "button", a clickable header is displayed.
* @todo revisit doc
*/
"toggleDisplay": BlockSectionToggleDisplay;
}
interface CalciteButton {
/**
* optionally specify alignment of button elements.
*/
"alignment"?: ButtonAlignment;
/**
* specify the appearance style of the button, defaults to solid.
*/
"appearance": ButtonAppearance;
/**
* specify the color of the button, defaults to blue
*/
"color": ButtonColor;
/**
* is the button disabled
*/
"disabled"?: boolean;
/**
* optionally pass a href - used to determine if the component should render as a button or an anchor
*/
"href"?: string;
/**
* optionally pass an icon to display at the end of a button - accepts calcite ui icon names
*/
"iconEnd"?: string;
/**
* flip the icon(s) in rtl
*/
"iconFlipRtl"?: FlipContext;
/**
* optionally pass an icon to display at the start of a button - accepts calcite ui icon names
*/
"iconStart"?: string;
/**
* string to override English loading text
*/
"intlLoading"?: string;
/**
* Applies to the aria-label attribute on the button or hyperlink
*/
"label"?: string;
/**
* optionally add a calcite-loader component to the button, disabling interaction.
*/
"loading"?: boolean;
/**
* The name attribute to apply to the button
*/
"name"?: string;
/**
* The rel attribute to apply to the hyperlink
*/
"rel"?: string;
/**
* optionally add a round style to the button
*/
"round"?: boolean;
/**
* specify the scale of the button, defaults to m
*/
"scale": Scale;
"setFocus": () => Promise<void>;
/**
* is the button a child of a calcite-split-button
*/
"splitChild"?: "primary" | "secondary" | false;
/**
* The target attribute to apply to the hyperlink
*/
"target"?: string;
/**
* The type attribute to apply to the button
*/
"type"?: string;
/**
* specify the width of the button, defaults to auto
*/
"width": Width;
}
interface CalciteCard {
/**
* string to override English deselect text for checkbox when selectable is true
*/
"intlDeselect": string;
/**
* string to override English loading text
*/
"intlLoading"?: string;
/**
* string to override English select text for checkbox when selectable is true
*/
"intlSelect": string;
/**
* When true, the cards content is waiting to be loaded. This state shows a busy indicator.
*/
"loading": boolean;
/**
* Indicates whether the card is selectable.
*/
"selectable": boolean;
/**
* Indicates whether the card is selected.
*/
"selected": boolean;
}
interface CalciteCheckbox {
/**
* The checked state of the checkbox.
*/
"checked"?: boolean;
/**
* True if the checkbox is disabled
*/
"disabled"?: boolean;
/**
* The id attribute of the checkbox. When omitted, a globally unique identifier is used.
*/
"guid": string;
/**
* The hovered state of the checkbox.
* @private
*/
"hovered": boolean;
/**
* True if the checkbox is initially indeterminate, which is independent from its checked state https://css-tricks.com/indeterminate-checkboxes/
*/
"indeterminate"?: boolean;
/**
* The label of the checkbox input
*/
"label"?: string;
/**
* The name of the checkbox input
*/
"name"?: string;
/**
* specify the scale of the checkbox, defaults to m
*/
"scale": Scale;
"setFocus": () => Promise<void>;
/**
* The value of the checkbox input
*/
"value"?: any;
}
interface CalciteChip {
/**
* specify the appearance style of the button, defaults to solid.
*/
"appearance": Extract<"solid" | "clear", Appearance>;
/**
* specify the color of the button, defaults to blue
*/
"color": ChipColor;
/**
* Aria label for the "x" button
*/
"dismissLabel"?: string;
/**
* Optionally show a button the user can click to dismiss the chip
*/
"dismissible"?: boolean;
/**
* optionally pass an icon to display - accepts Calcite UI icon names
*/
"icon"?: string;
/**
* flip the icon in rtl
*/
"iconFlipRtl"?: boolean;
/**
* specify the scale of the chip, defaults to m
*/
"scale": Scale;
"setFocus": () => Promise<void>;
"value": any;
}
interface CalciteColorPicker {
/**
* When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component. When true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.
*/
"allowEmpty": boolean;
/**
* specify the appearance - default (containing border), or minimal (no containing border)
*/
"appearance": ColorAppearance;
/**
* Internal prop for advanced use-cases.
*/
"color": InternalColor | null;
/**
* The format of the value property. When "auto", the format will be inferred from `value` when set.
*/
"format": Format;
/**
* When true, hides the RGB/HSV channel inputs
*/
"hideChannels": boolean;
/**
* When true, hides the hex input
*/
"hideHex": boolean;
/**
* When true, hides the saved colors section
*/
"hideSaved": boolean;
/**
* Label used for the blue channel
*/
"intlB": string;
/**
* Label used for the blue channel description
*/
"intlBlue": string;
/**
* Label used for the delete color button.
*/
"intlDeleteColor": string;
/**
* Label used for the green channel
*/
"intlG": string;
/**
* Label used for the green channel description
*/
"intlGreen": string;
/**
* Label used for the hue channel
*/
"intlH": string;
/**
* Label used for the hex input
*/
"intlHex": string;
/**
* Label used for the HSV mode
*/
"intlHsv": string;
/**
* Label used for the hue channel description
*/
"intlHue": string;
/**
* Label used for the hex input when there is no color selected.
*/
"intlNoColor": string;
/**
* Label used for the red channel
*/
"intlR": string;
/**
* Label used for the red channel description
*/
"intlRed": string;
/**
* Label used for the RGB mode
*/
"intlRgb": string;
/**
* Label used for the saturation channel
*/
"intlS": string;
/**
* Label used for the saturation channel description
*/
"intlSaturation": string;
/**
* Label used for the save color button.
*/
"intlSaveColor": string;
/**
* Label used for the saved colors section
*/
"intlSaved": string;
/**
* Label used for the value channel
*/
"intlV": string;
/**
* Label used for the
*/
"intlValue": string;
/**
* The scale of the color picker.
*/
"scale": Scale;
/**
* Sets focus on the component.
*/
"setFocus": () => Promise<void>;
/**
* Storage ID for colors.
*/
"storageId": string;
/**
* The color value. This value can be either a {@link https://developer.mozilla.org/en-US/docs/Web/CSS/color|CSS string} a RGB, HSL or HSV object. The type will be preserved as the color is updated.
*/
"value": ColorValue | null;
}
interface CalciteColorPickerHexInput {
/**
* When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component. When true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.
*/
"allowEmpty": boolean;
/**
* Label used for the hex input.
*/
"intlHex": string;
/**
* Label used for the hex input when there is no color selected.
*/
"intlNoColor": string;
/**
* The component's scale.
*/
"scale": Scale;
/**
* Sets focus on the component.
*/
"setFocus": () => Promise<void>;
/**
* The hex value.
*/
"value": string;
}
interface CalciteColorPickerSwatch {
/**
* Used to display whether the swatch is active or not.
*/
"active": boolean;
/**
* The color value.
* @see https ://developer.mozilla.org/en-US/docs/Web/CSS/color_value
*/
"color": string;
/**
* The component scale.
*/
"scale": Scale;
}
interface CalciteCombobox {
/**
* Open and close combobox
*/
"active": boolean;
/**
* Allow entry of custom values which are not in the original set of items
*/
"allowCustomValues": boolean;
/**
* Disable combobox input
*/
"disabled": boolean;
/**
* Aria label for combobox (required)
*/
"label": string;
/**
* Specify the maximum number of combobox items (including nested children) to display before showing the scroller
*/
"maxItems": number;
/**
* Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
*/
"overlayPositioning": OverlayPositioning;
/**
* Placeholder text for input
*/
"placeholder"?: string;
"reposition": () => Promise<void>;
/**
* Specify the scale of the combobox, defaults to m
*/
"scale": Scale;
/**
* specify the selection mode - multi: allow any number of selected items (default) - single: only one selection) - ancestors: like multi, but show ancestors of selected items as selected, only deepest children shown in chips
*/
"selectionMode": ComboboxSelectionMode;
"setFocus": () => Promise<void>;
}
interface CalciteComboboxItem {
/**
* True when item is highlighted either from keyboard or mouse hover
*/
"active": boolean;
/**
* Parent and grandparent combobox items, this is set internally for use from combobox
*/
"ancestors": ComboboxChildElement[];
/**
* Don't filter this item based on the search text
*/
"constant": boolean;
/**
* When true, the item cannot be clicked and is visually muted.
*/
"disabled": boolean;
/**
* Unique identifier, used for accessibility
*/
"guid": string;
/**
* Custom icon to display both in combobox chips and next to combobox item text
*/
"icon"?: string;
/**
* Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
*/
"selected": boolean;
/**
* The main label for this item.
*/
"textLabel": string;
/**
* Used to toggle the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
*/
"toggleSelected": (coerce?: boolean) => Promise<void>;
/**
* The item's associated value
*/
"value": any;
}
interface CalciteComboboxItemGroup {
/**
* Parent and grandparent combobox items, this is set internally for use from combobox
*/
"ancestors": ComboboxChildElement[];
/**
* Title of the group
*/
"label": string;
}
interface CalciteDatePicker {
/**
* Active range
*/
"activeRange"?: "start" | "end";
/**
* Selected end date
*/
"end"?: string;
/**
* Selected end date as full date object
*/
"endAsDate"?: Date;
/**
* Number at which section headings should start for this component.
*/
"headingLevel": HeadingLevel;
/**
* Localized string for "next month" (used for aria label)
*/
"intlNextMonth"?: string;
/**
* Localized string for "previous month" (used for aria label)
*/
"intlPrevMonth"?: string;
/**
* BCP 47 language tag for desired language and country format
*/
"locale"?: string;
/**
* Latest allowed date ("yyyy-mm-dd")
*/
"max"?: string;
/**
* Latest allowed date as full date object
*/
"maxAsDate"?: Date;
/**
* Earliest allowed date ("yyyy-mm-dd")
*/
"min"?: string;
/**
* Earliest allowed date as full date object
*/
"minAsDate"?: Date;
/**
* Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
*/
"proximitySelectionDisabled"?: boolean;
/**
* Range mode activation
*/
"range"?: boolean;
/**
* specify the scale of the date picker
*/
"scale": "s" | "m" | "l";
/**
* Selected start date
*/
"start"?: string;
/**
* Selected start date as full date object
*/
"startAsDate"?: Date;
/**
* Selected date
*/
"value"?: string;
/**
* Selected date as full date object
*/
"valueAsDate"?: Date;
}
interface CalciteDatePickerDay {
/**
* Date is actively in focus for keyboard navigation
*/
"active": boolean;
/**
* Date is in the current month.
*/
"currentMonth": boolean;
/**
* Day of the month to be shown.
*/
"day": number;
/**
* Date is outside of range and can't be selected
*/
"disabled": boolean;
/**
* Date is the end of date range
*/
"endOfRange": boolean;
/**
* Date is currently highlighted as part of the range
*/
"highlighted": boolean;
/**
* CLDR data for current locale
*/
"localeData": DateLocaleData;
/**
* Showing date range
*/
"range": boolean;
"rangeHover": boolean;
/**
* specify the scale of the date picker
*/
"scale": Scale;
/**
* Date is the current selected date of the picker
*/
"selected": boolean;
/**
* Date is the start of date range
*/
"startOfRange": boolean;
/**
* Date value for the day.
*/
"value": Date;
}
interface CalciteDatePickerMonth {
/**
* Date currently active.
*/
"activeDate": Date;
/**
* End date currently active
*/
"endDate"?: Date;
"hoverRange": any;
/**
* CLDR locale data for current locale
*/
"localeData": DateLocaleData;
/**
* Maximum date of the calendar above which is disabled.
*/
"max": Date;
/**
* Minimum date of the calendar below which is disabled.
*/
"min": Date;
/**
* specify the scale of the date picker
*/
"scale": Scale;
/**
* Already selected date.
*/
"selectedDate": Date;
/**
* Start date currently active.
*/
"startDate"?: Date;
}
interface CalciteDatePickerMonthHeader {
/**
* Focused date with indicator (will become selected date if user proceeds)
*/
"activeDate": Date;
/**
* Number at which section headings should start for this component.
*/
"headingLevel": HeadingLevel;
/**
* Localized string for next month.
*/
"intlNextMonth": string;
/**
* Localized string for previous month.
*/
"intlPrevMonth": string;
/**
* User's language and region as BCP 47 formatted string.
*/
"locale": string;
/**
* CLDR locale data for translated calendar info
*/
"localeData": DateLocaleData;
/**
* Maximum date of the calendar above which is disabled.
*/
"max": Date;
/**
* Minimum date of the calendar below which is disabled.
*/
"min": Date;
/**
* specify the scale of the date picker
*/
"scale": Scale;
/**
* Already selected date.
*/
"selectedDate": Date;
}
interface CalciteDropdown {
"active": boolean;
/**
* allow the dropdown to remain open after a selection is made if the selection-mode of the selected item's containing group is "none", the dropdown will always close
*/
"disableCloseOnSelect": boolean;
/**
* is the dropdown disabled
*/
"disabled"?: boolean;
/**
* specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 - this value does not include groupTitles passed to calcite-dropdown-group
*/
"maxItems": number;
/**
* Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
*/
"overlayPositioning": OverlayPositioning;
/**
* Determines where the dropdown will be positioned relative to the button.
*/
"placement": DropdownPlacement;
"reposition": () => Promise<void>;
/**
* specify the scale of dropdown, defaults to m
*/
"scale": Scale;
/**
* **read-only** The currently selected items
* @readonly
*/
"selectedItems": HTMLCalciteDropdownItemElement[];
/**
* specify whether the dropdown is opened by hover or click of a trigger element
*/
"type": "hover" | "click";
/**
* specify the width of dropdown, defaults to m
*/
"width": Scale;
}
interface CalciteDropdownGroup {
/**
* optionally set a group title for display
*/
"groupTitle"?: string;
/**
* Specifies the size of the action.
*/
"scale": Scale;
/**
* specify the selection mode - multi (allow any number of (or no) active items), single (allow and require one active item), none (no active items), defaults to single
*/
"selectionMode": SelectionMode;
}
interface CalciteDropdownItem {
"active": boolean;
/**
* optionally pass a href - used to determine if the component should render as anchor
*/
"href"?: string;
/**
* optionally pass an icon to display at the end of an item - accepts calcite ui icon names
*/
"iconEnd"?: string;
/**
* flip the icon(s) in rtl
*/
"iconFlipRtl"?: FlipContext;
/**
* optionally pass an icon to display at the start of an item - accepts calcite ui icon names
*/
"iconStart"?: string;
/**
* Focuses the selected item.
*/
"setFocus": () => Promise<void>;
}
interface CalciteFab {
/**
* Used to set the button's appearance. Default is outline.
*/
"appearance": Extract<"solid" | "outline", Appearance>;
/**
* Used to set the button's color. Default is light.
*/
"color": ButtonColor;
/**
* When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
*/
"disabled": boolean;
/**
* The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
*/
"icon"?: string;
/**
* Label of the FAB, exposed on hover when textEnabled is false. If no label is provided, the label inherits what's provided for the `text` prop.
*/
"label"?: string;
/**
* When true, content is waiting to be loaded. This state shows a busy indicator.
*/
"loading": boolean;
/**
* Specifies the size of the fab.
*/
"scale": Scale;
"setFocus": () => Promise<void>;
/**
* Text that accompanies the FAB icon.
*/
"text"?: string;
/**
* Indicates whether the text is displayed.
*/
"textEnabled": boolean;
}
interface CalciteFilter {
/**
* The input data. The filter uses this as the starting point, and returns items that contain the string entered in the input, using a partial match and recursive search.
*/
"data": object[];
/**
* When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
*/
"disabled": boolean;
/**
* A text label that will appear on the clear button.
*/
"intlClear"?: string;
/**
* A text label that will appear next to the input field.
*/
"intlLabel"?: string;
/**
* Placeholder text for the input element's placeholder attribute
*/
"placeholder"?: string;
/**
* Focuses the filter input.
*/
"setFocus": () => Promise<void>;
}
interface CalciteFlow {
/**
* Removes the currently active `calcite-panel`.
*/
"back": () => Promise<HTMLCalcitePanelElement>;
}
interface CalciteGraph {
/**
* Array of tuples describing a single data point ([x, y]) These data points should be sorted by x-axis value
*/
"data": DataSeries;
/**
* Width of graph in pixels
*/
"height": number;
/**
* End of highlight color if highlighting range
*/
"highlightMax": number;
/**
* Start of highlight color if highlighting range
*/
"highlightMin": number;
/**
* Width of graph in pixels
*/
"width": number;
}
interface CalciteHandle {
"activated": boolean;
"setFocus": () => Promise<void>;
/**
* Value for the button title attribute
*/
"textTitle": string;
}
interface CalciteIcon {
/**
* When true, the icon will be flipped when the element direction is 'rtl'.
*/
"flipRtl": boolean;
/**
* The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
*/
"icon": string;
/**
* Icon scale.
*/
"scale": Scale;
/**
* The icon label. It is recommended to set this value if your icon is semantic.
*/
"textLabel": string;
}
interface CalciteInlineEditable {
/**
* when controls, specify a callback to be executed prior to disabling editing. when provided, loading state will be handled automatically.
*/
"afterConfirm"?: () => Promise<void>;
/**
* specify whether save/cancel controls should be displayed when editingEnabled is true, defaults to false
*/
"controls": boolean;
/**
* specify whether editing can be enabled
*/
"disabled": boolean;
/**
* specify whether the wrapped input element is editable, defaults to false
*/
"editingEnabled": boolean;
/**
* specify text to be user for the cancel editing button's aria-label, defaults to `Cancel`
*/
"intlCancelEditing": string;
/**
* specify text to be user for the confirm changes button's aria-label, defaults to `Save`
*/
"intlConfirmChanges": string;
/**
* specify text to be user for the enable editing button's aria-label, defaults to `Click to edit`
*/
"intlEnableEditing": string;
/**
* specify whether the confirm button should display a loading state, defaults to false
*/
"loading": boolean;
/**
* specify the scale of the inline-editable component, defaults to the scale of the wrapped calcite-input or the scale of the closest wrapping component with a set scale
*/
"scale"?: Scale;
}
interface CalciteInput {
/**
* specify the alignment of the value of the input
*/
"alignment": Position;
/**
* should the input autofocus
*/
"autofocus": boolean;
/**
* optionally display a clear button that displays when field has a value shows by default for search, time, date will not display for type="textarea"
*/
"clearable"?: boolean;
/**
* is the input disabled
*/
"disabled"?: boolean;
/**
* for number values, displays the locale's group separator
*/
"groupSeparator": boolean;
/**
* when used as a boolean set to true, show a default recommended icon for certain input types (tel, password, email, date, time, search). You can also pass a calcite-ui-icon name to this prop to display a requested icon for any input type
*/
"icon": string | boolean;
/**
* flip the icon in rtl
*/
"iconFlipRtl"?: boolean;
/**
* specify if the input is in loading state
*/
"loading": boolean;
/**
* BCP 47 language tag for desired language and country format
*/
"locale"?: string;
/**
* Toggles locale formatting for numbers.
*/
"localeFormat": boolean;
/**
* input max
*/
"max"?: number;
/**
* Maximum length of the input value
*/
"maxLength"?: number;
/**
* Maximum length of text input.
* @deprecated use maxLength instead
*/
"maxlength"?: number;
/**
* input min
*/
"min"?: number;
/**
* Minimum length of the text input
*/
"minLength"?: number;
/**
* The name of the input
*/
"name"?: string;
/**
* specify the placement of the number buttons
*/
"numberButtonType"?: InputPlacement;
/**
* explicitly whitelist placeholder attribute
*/
"placeholder": string;
/**
* optionally add prefix
*/
"prefixText"?: string;
/**
* is the input required
*/
"required": boolean;
/**
* specify the scale of the input, defaults to m
*/
"scale": Scale;
/**
* focus the rendered child element
*/
"setFocus": () => Promise<void>;
/**
* specify the status of the input field, determines message and icons
*/
"status": Status;
/**
* input step
*/
"step"?: number | "any";
/**
* optionally add suffix *
*/
"suffixText"?: string;
/**
* specify the input type Note that the following types add type-specific icons by default: `date`, `email`, `password`, `search`, `tel`, `time`
*/
"type": | "color"
| "date"
| "datetime-local"
| "email"
| "file"
| "image"
| "month"
| "number"
| "password"
| "search"
| "tel"
| "text"
| "textarea"
| "time"
| "url"
| "week";
/**
* input value
*/
"value"?: string;
}
interface CalciteInputDatePicker {
/**
* Expand or collapse when calendar does not have input
*/
"active": boolean;
/**
* Selected end date
*/
"end"?: string;
/**
* Selected end date as full date object
*/
"endAsDate"?: Date;
/**
* Number at which section headings should start for this component.
*/
"headingLevel": HeadingLevel;
/**
* Localized string for "next month" (used for aria label)
*/
"intlNextMonth"?: string;
/**
* Localized string for "previous month" (used for aria label)
*/
"intlPrevMonth"?: string;
/**
* Layout
*/
"layout": "horizontal" | "vertical";
/**
* BCP 47 language tag for desired language and country format
*/
"locale"?: string;
/**
* Latest allowed date ("yyyy-mm-dd")
*/
"max"?: string;
/**
* Latest allowed date as full date object
*/
"maxAsDate"?: Date;
/**
* Earliest allowed date ("yyyy-mm-dd")
*/
"min"?: string;
/**
* Earliest allowed date as full date object
*/
"minAsDate"?: Date;
/**
* Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
*/
"overlayPositioning": OverlayPositioning;
/**
* Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
*/
"proximitySelectionDisabled"?: boolean;
/**
* Range mode activation
*/
"range"?: boolean;
"reposition": () => Promise<void>;
/**
* specify the scale of the date picker
*/
"scale": "s" | "m" | "l";
/**
* Selected start date
*/
"start"?: string;
/**
* Selected start date as full date object
*/
"startAsDate"?: Date;
/**
* Selected date
*/
"value"?: string;
/**
* Selected date as full date object
*/
"valueAsDate"?: Date;
}
interface CalciteInputMessage {
"active": boolean;
/**
* when used as a boolean set to true, show a default icon based on status. You can also pass a calcite-ui-icon name to this prop to display a custom icon
*/
"icon": boolean | string;
/**
* specify the scale of the input, defaults to m
*/
"scale": Scale;
/**
* specify the status of the input field, determines message and icons
*/
"status": Status;
/**
* specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
*/
"type": InputMessageType;
}
interface CalciteInputTimePicker {
/**
* The active state of the time input
*/
"active"?: boolean;
/**
* The disabled state of the time input
*/
"disabled"?: boolean;
/**
* Format of the hour value (12-hour or 24-hour) (this will be replaced by locale eventually)
*/
"hourDisplayFormat": HourDisplayFormat;
/**
* aria-label for the hour input
*/
"intlHour"?: string;
/**
* aria-label for the hour down button
*/
"intlHourDown"?: string;
/**
* aria-label for the hour up button
*/
"intlHourUp"?: string;
/**
* aria-label for the meridiem (am/pm) input
*/
"intlMeridiem"?: string;
/**
* aria-label for the meridiem (am/pm) down button
*/
"intlMeridiemDown"?: string;
/**
* aria-label for the meridiem (am/pm) up button
*/
"intlMeridiemUp"?: string;
/**
* aria-label for the minute input
*/
"intlMinute"?: string;
/**
* aria-label for the minute down button
*/
"intlMinuteDown"?: string;
/**
* aria-label for the minute up button
*/
"intlMinuteUp"?: string;
/**
* aria-label for the second input
*/
"intlSecond"?: string;
/**
* aria-label for the second down button
*/
"intlSecondDown"?: string;
/**
* aria-label for the second up button
*/
"intlSecondUp"?: string;
/**
* The name of the time input
*/
"name"?: string;
/**
* The scale (size) of the time input
*/
"scale": Scale;
"setFocus": () => Promise<void>;
/**
* number that specifies the granularity that the value must adhere to
*/
"step": number;
/**
* The selected time
*/
"value": string;
}
interface CalciteLabel {
/**
* specify the text alignment of the label
*/
"alignment": Alignment;
/**
* eliminates any space around the label
*/
"disableSpacing"?: boolean;
/**
* is the label disabled
*/
"disabled"?: boolean;
/**
* The id of the input associated with the label
*/
"for": string;
/**
* is the wrapped element positioned inline with the label slotted text
*/
"layout": "inline" | "inline-space-between" | "default";
/**
* specify the scale of the input, defaults to m
*/
"scale": Scale;
/**
* specify the status of the label and any child input / input messages
*/
"status": Status;
}
interface CalciteLink {
/**
* is the link disabled
*/
"disabled"?: boolean;
/**
* optionally pass a href - used to determine if the component should render as a link or an anchor
*/
"href"?: string;
/**
* optionally pass an icon to display at the end of a button - accepts calcite ui icon names
*/
"iconEnd"?: string;
/**
* flip the icon(s) in rtl
*/
"iconFlipRtl"?: FlipCont