1 Star 0 Fork 0

LS/ls-design

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
克隆/下载
zh-CN-react.md 3.89 KB
一键复制 编辑 原始数据 按行查看 历史

Checkbox


简介

增强版的 img 标签,提供多种图片填充模式,支持图片懒加载、加载中提示、加载失败提示。

安装使用

import { Checkbox } from "@ls-design/ui-react";

基础用法

export default () => {
  const [checked, setCheck] = useState(true);

  const handleChange = () => {
    setCheck(() => !checked);
  };

  return (
    <>
      <Checkbox checked={checked} onChange={handleChange}>
        Apple
      </Checkbox>
      <Checkbox checked={false}>Orange</Checkbox>
    </>
  );
};

复选框形状

复选框支持roundsquare两种形状,默认为 round

<Checkbox checked="{true}">圆形(默认)</Checkbox>
<Checkbox checked="{true}" shape="square">方形</Checkbox>

复选框大小

复选框大小支持 normalbig 两种,默认为 normal

<Checkbox checked="{true}" shape="round" size="big">默认形状-大</Checkbox>
<Checkbox checked="{true}" shape="square" size="big">方形-大</Checkbox>

复选框禁用状态

复选框支持禁用

<Checkbox checked="{true}" disabled>已选-禁用</Checkbox>
<Checkbox checked="{true}" disabled>未选-禁用</Checkbox>

复选框群组

复选框支持成组出现 由于技术限制,复选框组的值需要是一个由数组通过 join()方法组成的字符串

export default () => {
  const [groupValue, setGroupValue] = useState(["苹果", "橘子"]);

  const onGroupChange = ({ detail }) => {
    setGroupValue(() => detail.value);
  };

  return (
    <>
      <CheckboxGroup value={groupValue.join()} onChange={onGroupChange}>
        <Checkbox name="apple">苹果</Checkbox>
        <Checkbox name="warning" disabled>
          橘子
        </Checkbox>
        <Checkbox name="banana">香蕉</Checkbox>
      </CheckboxGroup>
    </>
  );
};

Props

参数 说明 类型 默认值
shape 形状,可选值为 round square string round
size 复选框大小,可选值为 normal big string normal
disabled 复选框禁用状态 boolean false
checked 复选框勾选状态 boolean false
onChange 复选框勾选状态变化时回调函数 (e: { detail: { value: string } }) => void

CheckGroup Props

参数 说明 类型 默认值
value 指定选中的选项 string -
onChange 复选框组勾选状态变化时回调函数 (e: { detail: { value: string[] } }) => void

样式变量

组件提供了以下 CSS变量,可用于自定义样式

名称 说明 默认值
--checkbox-font-size Checkbox 文字大小 12px
--checkbox-color Checkbox 文字颜色 #242729
--checkbox-label-height Checkbox 文字行高 和选择框高度一致
--checkbox-size Checkbox 复选框尺寸,优先级高于 size 属性 16px; big: 20px
--checkbox-background Checkbox 选中颜色 #0088ff
Loading...
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/LShere/ls-design.git
git@gitee.com:LShere/ls-design.git
LShere
ls-design
ls-design
master

搜索帮助