ivt/dist/combobox/index.d.ts

Ivt Components Library

import * as react_jsx_runtime from 'react/jsx-runtime';

interface ComboboxItem {
    value: string;
    label: string;
}
interface ComboboxProps {
    /**
     * A lista de itens a serem exibidos no combobox.
     * Cada item deve ter 'value' e 'label'.
     */
    items: ComboboxItem[];
    /**
     * O valor atualmente selecionado no combobox.
     */
    value: string;
    /**
     * Função de callback para quando um item é selecionado.
     * Recebe o novo valor selecionado.
     */
    onValueChange: (newValue: string) => void;
    /**
     * Placeholder para o botão do combobox quando nenhum item está selecionado.
     * @default "Select item..."
     */
    placeholder?: string;
    /**
     * Placeholder para o campo de busca dentro do combobox.
     * @default "Search item..."
     */
    searchPlaceholder?: string;
    /**
     * Mensagem exibida quando nenhum item é encontrado na busca.
     * @default "No item found."
     */
    emptyMessage?: string;
    /**
     * Largura do combobox (e do popover).
     * @default "w-[200px]"
     */
    widthClassName?: string;
    /**
     * Classes CSS adicionais para o combobox principal.
     */
    className?: string;
    /**
     * Título do grupo de comandos.
     */
    groupHeading?: string;
    /**
   *
    Ativa ou desativa a normalização da busca, removendo acentos e caracteres especiais.
    Quando **true** (padrão), a busca ignora diferenças de acentuação — útil para buscas mais flexíveis.
    Quando **false**, a busca será literal, sensível a acentuação.
   */
    normalizeSearch?: boolean;
    /**
     * Desabilita a interação com o combobox.
     */
    disabled?: boolean;
    /**
     * ID do combobox.
     */
    id?: string;
    /**
     * Se o combobox deve ter um botão de limpar seleção.
     */
    clearable?: boolean;
}
declare function Combobox({ id, items, value, onValueChange, placeholder, searchPlaceholder, emptyMessage, widthClassName, className, groupHeading, normalizeSearch, disabled, clearable, }: ComboboxProps): react_jsx_runtime.JSX.Element;

export { Combobox };