132 lines
No EOL
4.5 KiB
TypeScript
132 lines
No EOL
4.5 KiB
TypeScript
import * as React from 'react';
|
|
import { SxProps } from '@mui/system';
|
|
import { OverridableStringUnion } from '@mui/types';
|
|
import { Theme } from "../styles/index.js";
|
|
import { InternalStandardProps as StandardProps } from "../internal/index.js";
|
|
import { CreateSlotsAndSlotProps, SlotProps } from "../utils/types.js";
|
|
import { SwitchBaseProps } from "../internal/SwitchBase.js";
|
|
import { CheckboxClasses } from "./checkboxClasses.js";
|
|
export interface CheckboxPropsSizeOverrides {}
|
|
export interface CheckboxPropsColorOverrides {}
|
|
export interface CheckboxRootSlotPropsOverrides {}
|
|
export interface CheckboxInputSlotPropsOverrides {}
|
|
export interface CheckboxSlots {
|
|
/**
|
|
* The component that renders the root slot.
|
|
* @default SwitchBase
|
|
*/
|
|
root: React.ElementType;
|
|
/**
|
|
* The component that renders the input slot.
|
|
* @default SwitchBase's input
|
|
*/
|
|
input: React.ElementType;
|
|
}
|
|
export type CheckboxSlotsAndSlotProps = CreateSlotsAndSlotProps<CheckboxSlots, {
|
|
/**
|
|
* Props forwarded to the root slot.
|
|
* By default, the avaible props are based on the div element.
|
|
*/
|
|
root: SlotProps<React.ElementType<SwitchBaseProps>, CheckboxRootSlotPropsOverrides, CheckboxOwnerState>;
|
|
/**
|
|
* Props forwarded to the input slot.
|
|
* By default, the avaible props are based on the input element.
|
|
*/
|
|
input: SlotProps<'input', CheckboxInputSlotPropsOverrides, CheckboxOwnerState>;
|
|
}>;
|
|
export interface CheckboxProps extends StandardProps<SwitchBaseProps, 'checkedIcon' | 'color' | 'icon' | 'type' | 'slots' | 'slotProps'>, CheckboxSlotsAndSlotProps {
|
|
/**
|
|
* If `true`, the component is checked.
|
|
*/
|
|
checked?: SwitchBaseProps['checked'];
|
|
/**
|
|
* The icon to display when the component is checked.
|
|
* @default <CheckBoxIcon />
|
|
*/
|
|
checkedIcon?: React.ReactNode;
|
|
/**
|
|
* Override or extend the styles applied to the component.
|
|
*/
|
|
classes?: Partial<CheckboxClasses>;
|
|
/**
|
|
* The color of the component.
|
|
* It supports both default and custom theme colors, which can be added as shown in the
|
|
* [palette customization guide](https://mui.com/material-ui/customization/palette/#custom-colors).
|
|
* @default 'primary'
|
|
*/
|
|
color?: OverridableStringUnion<'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning' | 'default', CheckboxPropsColorOverrides>;
|
|
/**
|
|
* If `true`, the component is disabled.
|
|
* @default false
|
|
*/
|
|
disabled?: SwitchBaseProps['disabled'];
|
|
/**
|
|
* If `true`, the ripple effect is disabled.
|
|
* @default false
|
|
*/
|
|
disableRipple?: SwitchBaseProps['disableRipple'];
|
|
/**
|
|
* The icon to display when the component is unchecked.
|
|
* @default <CheckBoxOutlineBlankIcon />
|
|
*/
|
|
icon?: React.ReactNode;
|
|
/**
|
|
* The id of the `input` element.
|
|
*/
|
|
id?: SwitchBaseProps['id'];
|
|
/**
|
|
* If `true`, the component appears indeterminate.
|
|
* This does not set the native input element to indeterminate due
|
|
* to inconsistent behavior across browsers.
|
|
* However, we set a `data-indeterminate` attribute on the `input`.
|
|
* @default false
|
|
*/
|
|
indeterminate?: boolean;
|
|
/**
|
|
* The icon to display when the component is indeterminate.
|
|
* @default <IndeterminateCheckBoxIcon />
|
|
*/
|
|
indeterminateIcon?: React.ReactNode;
|
|
/**
|
|
* Callback fired when the state is changed.
|
|
*
|
|
* @param {React.ChangeEvent<HTMLInputElement>} event The event source of the callback.
|
|
* You can pull out the new checked state by accessing `event.target.checked` (boolean).
|
|
*/
|
|
onChange?: SwitchBaseProps['onChange'];
|
|
/**
|
|
* If `true`, the `input` element is required.
|
|
* @default false
|
|
*/
|
|
required?: SwitchBaseProps['required'];
|
|
/**
|
|
* The size of the component.
|
|
* `small` is equivalent to the dense checkbox styling.
|
|
* @default 'medium'
|
|
*/
|
|
size?: OverridableStringUnion<'small' | 'medium' | 'large', CheckboxPropsSizeOverrides>;
|
|
/**
|
|
* The system prop that allows defining system overrides as well as additional CSS styles.
|
|
*/
|
|
sx?: SxProps<Theme>;
|
|
/**
|
|
* The value of the component. The DOM API casts this to a string.
|
|
* The browser uses "on" as the default value.
|
|
*/
|
|
value?: SwitchBaseProps['value'];
|
|
}
|
|
export interface CheckboxOwnerState extends Omit<CheckboxProps, 'slots' | 'slotProps'> {}
|
|
|
|
/**
|
|
*
|
|
* Demos:
|
|
*
|
|
* - [Checkbox](https://mui.com/material-ui/react-checkbox/)
|
|
* - [Transfer List](https://mui.com/material-ui/react-transfer-list/)
|
|
*
|
|
* API:
|
|
*
|
|
* - [Checkbox API](https://mui.com/material-ui/api/checkbox/)
|
|
* - inherits [ButtonBase API](https://mui.com/material-ui/api/button-base/)
|
|
*/
|
|
export default function Checkbox(props: CheckboxProps): React.JSX.Element; |