Select Box
Check Select Box
체크박스 형태로 여러 옵션을 선택할 수 있는 드롭다운 컴포넌트입니다. 다중 선택이 가능한 필터나 설정에서 사용됩니다.
import { VStack } from "@seed-design/react";
import { CheckSelectBox, CheckSelectBoxGroup } from "seed-design/ui/select-box";
export default function CheckSelectBoxPreview() {
return (
<CheckSelectBoxGroup>
<VStack gap="spacingY.componentDefault">
<CheckSelectBox label="Apple" defaultChecked />
<CheckSelectBox
label="Melon"
description="Elit cupidatat dolore fugiat enim veniam culpa."
/>
<CheckSelectBox label="Mango" />
</VStack>
</CheckSelectBoxGroup>
);
}Installation
npx @seed-design/cli@latest add ui:select-boxProps
CheckSelectBoxGroup
Prop
Type
CheckSelectBox
Prop
Type
Examples
React Hook Form
import { HStack, VStack } from "@seed-design/react";
import { useCallback, type FormEvent } from "react";
import { useController, useForm, type Control } from "react-hook-form";
import { ActionButton } from "seed-design/ui/action-button";
import { CheckSelectBox, CheckSelectBoxGroup } from "seed-design/ui/select-box";
const POSSIBLE_FRUIT_VALUES = ["apple", "melon", "mango"] as const;
type FormValues = Record<(typeof POSSIBLE_FRUIT_VALUES)[number], boolean>;
export default function CheckSelectBoxReactHookForm() {
const { handleSubmit, reset, setValue, control } = useForm<FormValues>({
defaultValues: {
apple: false,
melon: true,
mango: false,
},
});
const onValid = useCallback((data: FormValues) => {
window.alert(JSON.stringify(data, null, 2));
}, []);
const onReset = useCallback(
(event: FormEvent) => {
event.preventDefault();
reset();
},
[reset],
);
return (
<VStack gap="x3" width="full" as="form" onSubmit={handleSubmit(onValid)} onReset={onReset}>
<CheckSelectBoxGroup>
<VStack gap="spacingY.componentDefault">
{POSSIBLE_FRUIT_VALUES.map((name) => (
<CheckSelectBoxItem key={name} name={name} control={control} />
))}
</VStack>
</CheckSelectBoxGroup>
<HStack gap="x2">
<ActionButton type="reset" variant="neutralWeak">
초기화
</ActionButton>
<ActionButton type="button" variant="neutralWeak" onClick={() => setValue("mango", true)}>
mango 선택
</ActionButton>
<ActionButton type="submit" variant="neutralSolid" flexGrow={1}>
제출
</ActionButton>
</HStack>
</VStack>
);
}
interface CheckSelectBoxItemProps {
name: keyof FormValues;
control: Control<FormValues>;
}
function CheckSelectBoxItem({ name, control }: CheckSelectBoxItemProps) {
const {
field: { value, ...restProps },
fieldState: { invalid },
} = useController({ name, control });
return (
<CheckSelectBox
key={name}
label={name}
checked={value}
inputProps={restProps}
invalid={invalid}
/>
);
}Customizing Label
import { Badge, Box, Flex, VStack } from "@seed-design/react";
import { CheckSelectBox, CheckSelectBoxGroup } from "seed-design/ui/select-box";
export default function CheckSelectBoxCustomizingLabel() {
return (
<CheckSelectBoxGroup>
<VStack gap="spacingY.componentDefault">
<CheckSelectBox label="Apple" defaultChecked />
<CheckSelectBox
label={
<Flex gap="x1_5" alignItems="center">
<Box>Melon</Box>
<Badge tone="brand" variant="solid">
New
</Badge>
</Flex>
}
description="Elit cupidatat dolore fugiat enim veniam culpa."
/>
<CheckSelectBox
label="Mango"
description="Aliqua ad aute eiusmod eiusmod nulla adipisicing proident ullamco in."
/>
</VStack>
</CheckSelectBoxGroup>
);
}Listening to Value Changes
onCheckedChange를 사용하여 체크박스의 선택 상태 변경을 감지할 수 있습니다.
이벤트를 활용해야 하는 경우 inputProps를 통해 내부 <input> 요소에 직접 이벤트 핸들러를 추가할 수 있습니다.
import { VStack, Text } from "@seed-design/react";
import { CheckSelectBox, CheckSelectBoxGroup } from "seed-design/ui/select-box";
import { useState } from "react";
export default function CheckSelectBoxValueChanges() {
const [count, setCount] = useState(0);
const [lastValue, setLastValue] = useState<boolean | null>(null);
return (
<VStack gap="x4" align="center" width="full">
<CheckSelectBoxGroup>
<VStack gap="spacingY.componentDefault">
<CheckSelectBox
label="Apple"
onCheckedChange={(checked) => {
setCount((prev) => prev + 1);
setLastValue(checked);
}}
/>
</VStack>
</CheckSelectBoxGroup>
<Text>
onCheckedChange called: {count} times, last value: {`${lastValue ?? "-"}`}
</Text>
</VStack>
);
}Last updated on