跳到主要内容

数量

规格​

标签值
版本1.0.0（更新于 2026-11-11）
开发者Labii Inc.
类型列
支持配置是
支持只读视图是
支持编辑视图是
支持表单视图是
支持默认值是
支持导入是
允许多个是

概述​

数量小插件在同一列中记录数值及其单位，例如体积、质量或浓度。用户输入数值并从下拉列表中选择单位，因此无需在数字列旁另建单位列。

单位按量纲分组，例如体积或质量。每列使用一个量纲，并可限定为实验室常用的单位。由于每个单位都有换算比例，该小插件可以用最易读的单位显示数值，例如将 1500 µL 显示为 1.5 mL。单位只在同一量纲内换算，体积不会被换算为质量。

使用场景​

  1. 使用此小插件以 µL、mL 或 L 记录样品体积。
  2. 使用此小插件以 ng/µL 或 mg/mL 记录 DNA 或蛋白样品的浓度。
  3. 使用此小插件以 nM、µM 或 mM 记录试剂的摩尔浓度。
  4. 使用此小插件配合自定义单位记录 cells 或 million cells 等计数。

配置​

为使小插件正常运行，请选择量纲。其他选项均为可选。

  • 量纲 - 数量的类型。单位只能在同一量纲内换算。默认为体积。
    • 体积 - nL、µL、mL、L
    • 质量 - pg、ng、µg、mg、g、kg
    • 质量浓度 - pg/mL、ng/mL、ng/µL、µg/mL、µg/µL、mg/mL、g/L
    • 摩尔浓度 - pM、nM、µM、mM、M
    • 百分比 - %
    • 计数 - EA（个）、PR（对，2）、DZ（打，12）、GR（罗，144）
    • 自定义 - 自定义单位中列出的单位。
  • 单位 - 用户可选择的单位。留空则允许该量纲的所有单位。不属于该量纲的单位会被忽略。
  • 默认单位 - 默认选中的单位。留空则使用第一个单位。
  • 自动换算 - 以最易读的单位显示数值，例如将 1500 µL 显示为 1.5 mL。存储的数值和单位不会改变。
  • 自定义单位 - 量纲为自定义时必填。请按从小到大的顺序列出单位。
    • 单位 - 单位代码，例如 cells 或 vials。
    • 比例 - 相对于基本单位（比例为 1）的比例。
  • Constraints - 设置可输入数值的范围。范围检查的是所选单位下输入的数值。
    • Constraints (minimum) - 可输入的最小值。
    • Constraints (maximum) - 可输入的最大值。
  • Format - 可以设置显示数值的格式，详情请参阅 https://refreshless.com/wnumb/
    • Format (decimals) - 结果中包含的小数位数，最多 7 位。
    • Format (mark) - 小数分隔符。如果 thousand 尚未设置为“.”，则默认为“.”。
    • Format (thousand) - 大数的分隔符。例如，使用空格可将数字格式化为 1 000 000。
    • Format (prefix) - 添加到数字前的字符串。
    • Format (suffix) - 添加到数字后的字符串。
信息

单位始终显示在数值之后，无需将其设置为 Format (suffix)。

示例​

以下是样品体积列的配置：允许 µL 和 mL，默认选中 mL，拒绝负值，并以最易读的单位显示保留 2 位小数的数值。

{
    "dimension": "volume",
    "units": ["µL", "mL"],
    "default_unit": "mL",
    "should_auto_scale": true,
    "constraints": {
        "min": 0
    },
    "format": {
        "decimals": 2
    }
}

以下是使用自定义单位的细胞计数列配置。

{
    "dimension": "custom",
    "conversions": [
        {"unit": "cells", "factor": 1},
        {"unit": "million cells", "factor": 1000000}
    ]
}

视图​

以下是该小插件在不同视图中的界面。

只读视图​

只读视图显示数值及其单位，例如 12.50 mL。启用自动换算后，数值以最易读的单位显示。在下例中，存储的数值 30000 µL 显示为 30 mL。

列数量小插件只读视图

编辑视图​

编辑视图用于修改值，包含两个字段：

  • 数值 - 数字。
  • 单位 - 列允许的单位下拉列表。

点击 修改JSON 可改为以 JSON 文本编辑数据。

列数量小插件编辑视图

表单视图​

表单视图是添加表单中用于在创建新记录时收集值的字段。

表单视图与编辑视图相同。

数据​

Labii 中的每个小插件都以独特方式存储数据；请参阅以下说明了解此小插件的数据存储方式。

数据格式​

包含数值和单位代码的 JSON 数据。单位代码按原样存储，不会被翻译。

{
    "value": 12.5,
    "unit": "mL"
}

默认值​

列中的默认值字段可用于指定创建记录时的默认值。

默认值应为包含上述键的 JSON 文本。

{"value": 1, "unit": "mL"}

导入值​

导入值是 Excel 表格中用于导入 Labii 的值。

导入值应为包含上述键的 JSON 文本。

{"value": 12.5, "unit": "mL"}

编辑此页
最后由 Yonggan Wu 于 更新