# 输入：复选框 > Observable 框架文档：输入：复选框来源： API · 来源 · 复选框输入允许用户选择任何给定的值集。（有关单项选择，请参阅 [radio]() 输入。）建议使用复选框而不是当可供选择的值数量很少（例如七个或更少）时，[select]() 输入，因为所有选择都将预先可见，从而提高可用性。对于零个或一个选项，请参阅 [toggle]() 输入。复选框的初始值默认为空数组。您可以通过指定 _value_ 选项来覆盖它，该选项也应该是一个数组（或可迭代）。 const color = view(Inputs.checkbox(["红色", "绿色", "蓝色"], {标签: "颜色"})); 颜色复选框的值不必是字符串：它们可以是任何内容。指定_format_函数来控制如何将这些值呈现给读者。常量团队 = [ {名称：“湖人队”，地点：“加利福尼亚州洛杉矶”}， {名称：“勇士队”，地点：“加利福尼亚州旧金山”}， {名称：“凯尔特人队”，地点：“马萨诸塞州波士顿”}， {名称：“篮网队”，地点：“纽约州纽约市”}， {名称：“猛龙队”，位置：“安大略省多伦多”}， ]; const watch = view(Inputs.checkbox(teams, {label: "Watching", format: (x) => x.name})); 观看可以通过将 _disabled_ 选项设置为 true 来禁用复选框。或者，可以通过传递要禁用的值数组来禁用特定选项。 const 元音 = view(Inputs.checkbox([..."AEIOUY"], {标签: "元音", 禁用: ["Y"]})); 元音 _format_ 函数与 _label_ 一样，可以返回文本字符串或 HTML 元素。如果需要，这允许对复选框的外观进行广泛的控制。常量颜色2 = 视图( Inputs.checkbox(["红色", "绿色", "蓝色"], { 值：[“红色”]，标签：html`颜色`，格式：(x) => html`<跨度样式= 文本转换：大写；边框底部：实心 2px ${x}；下边距：-2px； ">${x}` }) ）；颜色2 如果复选框的数据被指定为地图，则值将是地图的值，而键将是显示的选项。（可以通过传递 _keyof_ 和 _valueof_ 函数选项来自定义此行为。）下面，显示的尺寸被命名，但值是相应的液体盎司数。常量大小=视图（输入.checkbox( 新地图([ [“短”，8]， [“高”，12]， [“格兰德”，16]， [“通风”，20] ]), {值：[12]，标签：“尺寸”} ））；尺寸由于 _format_ 函数从数据中传递元素，因此它可以访问相应 Map 条目中的键和值。常量大小2 = 视图( 输入.checkbox( 新地图([ [“短”，8]， [“高”，12]， [“格兰德”，16]， [“通风”，20] ]), {值：[12]，标签：“尺寸”，格式：([名称，值]) => `${名称} (${值} 盎司)`} ））；尺寸2 将映射传递给复选框与 [d3.group]() 结合使用特别有用。例如，给定奥林匹克运动员的样本“olympians”数据集，我们可以使用 d3.group 按金牌数量对它们进行分组，然后通过复选框来选择所选数量的运动员。请注意，复选框的值将是一个数组的数组，因为 d3.group 返回一个从键到数组的 Map；如果需要，可以使用 [_array_.flat]() 合并这些数组。 const goldAthletes = 视图( 输入.checkbox( d3.group(奥林匹亚选手, (d) => d.gold), {label: "金牌数", sort: "降序", key: [4, 5]} ））； goldAthletes.flat() 如果指定了 _sort_ 和 _unique_ 选项，则将分别对复选框的键进行排序并丢弃重复的键。 const bases = view(Inputs.checkbox("GATTACA", {sort: true, unique: true})); 基地 ## 选项 **输入.复选框（_数据_，_选项_）** 可用的复选框输入选项有： * _label_ \- 标签；字符串或 HTML 元素 * _sort_ \- true、_ascending_、_descending_ 或用于对键进行排序的比较器；默认为 false * _unique_ \- true 只显示唯一键；默认为 false * _locale_ \- 当前语言环境；默认为英语 * _format_ \- 格式化函数；默认为 [formatLocaleAuto]() 由 _keyof_ 组成 * _keyof_ \- 返回 _data_ 中给定元素的键的函数 * _valueof_ \- 返回 _data_ 中给定元素值的函数 * _value_ \- 初始值，一个数组；默认为空数组（不选择） * _disabled_ \- 输入是否被禁用，或者禁用的值；默认为 false

可观察框架输入复选框

包含技能