@cloud-ru/ds-segment-control

中文文档
1.0.21发布于 2026/11/11Apache-2.0TypeScriptESM + CJS近 30 天下载 7883

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}=======================================================================================================================================================================================================================================.

中文使用文档
文档目录16 节
  1. Когда
  2. Анатомия
  3. 大小( 默认) m (中文(简体) )
  4. 宽度( 默认) auto (中文(简体) )
  5. 大纲( 默认) false (中文(简体) )
  6. 分段档
  7. Установка
  8. Примеры
  9. 1. 国家
  10. 2. 国家
  11. 3. 只限图标
  12. 4. 国家
  13. 5. □ 大纲
  14. 6. 残 废
  15. 7. 受管制的化学武器使用状态
  16. 道具

分节控制

@cloud-ru/ds-segment-control -=YTET -伊甸园字幕组=- 翻译:.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪ QQ 控制了 \ 不受控制 \ , \ \ \ \ (Arrow/Home/ End {} 已禁用 ), \ , \ \ \ \ \ \ \ \ \ \ \ .

Когда

  • {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得怎样.
  • -==YTET -伊甸园字幕组=- 翻译:.
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.

Когда не нужен SegmentControl数字 :

  • Вариантов 5:
    • используйте Tabs или Select。 。 。 .
  • 说吧
    • {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 ToggleGroup。 。 。 .
  • Выбор:
    • используйте Tabs。 。 。 .

Анатомия

大小( 默认) m(中文(简体) )

校对:Soup s 编号 : m 编号 : l ——стандартные.

宽度( 默认) auto(中文(简体) )

  • auto - 。 。 。 。 .
  • full -=YTET -伊甸园字幕组=- 翻译: {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.

大纲( 默认) false(中文(简体) )

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎么样? {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.

分段档

Каждый items[i] 校对:soup

  • label ——текст.
  • icon - иконка с iconPosition: 'before' | 'after'。 。 。 .
  • counter {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 label。 。 。 .

Дополнительно:

  • QQ 仅限图标(QQ) label) (中文(简体) ).
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 disabled - клавиатурная его пропускает пропускает пропускает.

Установка

pnpm add @cloud-ru/ds-segment-control
import { SegmentControl } from '@cloud-ru/ds-segment-control'

Примеры

1. 国家

未控制 QQ 默认 Vale — — — — — — — —

import { SegmentControl } from '@cloud-ru/ds-segment-control';

export function Basic() {
  return (
    <SegmentControl
      defaultValue='overview'
      items={[
        { value: 'overview', label: 'Overview' },
        { value: 'analytics', label: 'Analytics' },
        { value: 'reports', label: 'Reports' },
      ]}
    />
  );
}

2. 国家

页:1

import { SegmentControl } from '@cloud-ru/ds-segment-control';

const items = [
  { value: 'one', label: 'One' },
  { value: 'two', label: 'Two' },
  { value: 'three', label: 'Three' },
];

export function Sizes() {
  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <SegmentControl size='s' defaultValue='one' items={items} />
      <SegmentControl size='m' defaultValue='one' items={items} />
      <SegmentControl size='l' defaultValue='one' items={items} />
    </div>
  );
}

3. 只限图标

标签 + 图标 + 图标 + 标签

import { HomeSVG, PlusSVG, SettingsSVG } from '@cloud-ru/ds-icons/interface/system';
import { SegmentControl } from '@cloud-ru/ds-segment-control';

export function WithIcons() {
  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <SegmentControl
        defaultValue='home'
        items={[
          { value: 'home', label: 'Home', icon: <HomeSVG /> },
          { value: 'settings', label: 'Settings', icon: <SettingsSVG /> },
          { value: 'add', label: 'Add', icon: <PlusSVG /> },
        ]}
      />
      <SegmentControl
        defaultValue='home'
        items={[
          { value: 'home', icon: <HomeSVG /> },
          { value: 'settings', icon: <SettingsSVG /> },
          { value: 'add', icon: <PlusSVG /> },
        ]}
      />
    </div>
  );
}

4. 国家

页面存档备份,存于互联网档案馆

import { SegmentControl } from '@cloud-ru/ds-segment-control';

export function WithCounter() {
  return (
    <SegmentControl
      defaultValue='inbox'
      items={[
        { value: 'inbox', label: 'Inbox', counter: 12 },
        { value: 'drafts', label: 'Drafts', counter: 3 },
        { value: 'archive', label: 'Archive' },
      ]}
    />
  );
}

5. □ 大纲

宽度='满' ; 大纲===

import { SegmentControl } from '@cloud-ru/ds-segment-control';

export function FullWidth() {
  return (
    <div style={{ width: 480, maxWidth: '100%' }}>
      <SegmentControl
        width='full'
        outline
        defaultValue='day'
        items={[
          { value: 'day', label: 'Day' },
          { value: 'week', label: 'Week' },
          { value: 'month', label: 'Month' },
          { value: 'year', label: 'Year' },
        ]}
      />
    </div>
  );
}

6. 残 废

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

import { SegmentControl } from '@cloud-ru/ds-segment-control';

export function DisabledSegment() {
  return (
    <SegmentControl
      defaultValue='one'
      items={[
        { value: 'one', label: 'One' },
        { value: 'two', label: 'Two', disabled: true },
        { value: 'three', label: 'Three' },
      ]}
    />
  );
}

7. 受管制的化学武器使用状态

值 + 变化 + 变化 + + 变化 + 变化

import { SegmentControl } from '@cloud-ru/ds-segment-control';
import { useState } from 'react';

export function Controlled() {
  const [view, setView] = useState<'list' | 'grid' | 'kanban'>('list');

  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <SegmentControl
        value={view}
        onChange={setView}
        items={[
          { value: 'list', label: 'List' },
          { value: 'grid', label: 'Grid' },
          { value: 'kanban', label: 'Kanban' },
        ]}
      />
      <span>Selected: {view}</span>
    </div>
  );
}

道具

片段控制方案

Prop类型默认说明
classNamestring—— 说(原始内容存档于2018-09-29). CSS-класс.
data-test-idstring—— 说
defaultValueIdType—— 说(原始内容存档于2017-10-25) (英语). ID QQQQQ (uncontrol).
itemsSegment—— 说Набор.
namestring—— 说QQ (隐藏输入QQ).
onChange((value: Value) => void)—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
outlineboolean—— 说Обводка.
size"l" | "m" | "s"mРазмер.
valueIdType—— 说值выбранного.
width"auto" | "full"autoУправление.
  • IconPosition =: "after" | "before"

部分

Prop类型默认说明
counterstring | number | undefined—— 说腾讯网.
disabledboolean | undefined—— 说Состояние.
iconstring | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined—— 说Иконка.
iconPosition"after" | "before"—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
labelstring | undefined—— 说Текстовый.
renderWrapSegment((segment: ReactNode) => ReactNode) | undefined—— 说{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}请说.
valueValue—— 说Идентификатор.
  • Size =: "l" | "m" | "s"

  • Width =: "auto" | "full"

版本与发布记录

@cloud-ru/ds-segment-control 共发布 80 个版本,首次发布于 2026/08/18;过去 12 个月发布了 80 个版本。

版本发布日期距今
1.0.21latest2026/11/11今天
1.0.21-preview-e8fe6b56.0preview2026/11/11今天
1.0.21-preview-c0e895ed.02026/11/11今天
1.0.21-preview-90b10112.02026/11/11今天
1.0.21-preview-fd7dd437.02026/11/101 天前
1.0.21-preview-9a75a2a9.02026/11/101 天前

关于 @cloud-ru/ds-segment-control 的常见问题

@cloud-ru/ds-segment-control 是什么?

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}=======================================================================================================================================================================================================================================.

如何安装 @cloud-ru/ds-segment-control?

在项目目录运行 npm install @cloud-ru/ds-segment-control,或使用 pnpm add / yarn add / bun add。

@cloud-ru/ds-segment-control 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cloud-ru/ds-segment-control 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cloud-ru/ds-segment-control 可以商用吗?

@cloud-ru/ds-segment-control 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cloud-ru/ds-segment-control 的下载量有多少?

根据 npm 官方下载统计,@cloud-ru/ds-segment-control 在 2026/10/10 – 2026/11/08 这 30 天内被下载 7,883 次,日均约 263 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cloud-ru/ds-segment-control 还在维护吗?

最新版本 1.0.21 发布于 2026/11/11(今天);至今共发布 80 个版本,其中过去 12 个月发布了 80 个;首次发布于 2026/08/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。