Label
标签用于为表单控件提供可见名称。下方预览由 pingo 引擎实时渲染,并跟随站点主题切换明暗。
用法
import { createElement } from "@dopejs/pingo";
import { Input, Label } from "@dopejs/pingo-ui";
root.render(
createElement("container", {
style: { flexDirection: "column" },
children: [
createElement(Label, { children: "邮箱" }),
createElement("container", { height: 8 }),
createElement(Input, { semanticLabel: "邮箱", width: 320 }),
],
}),
);
pingo 没有 gap 属性,标签与控件之间的间距用一个固定尺寸的容器实现。
示例
语义名称
控件关联在 pingo 中尚不存在,因此标签与控件的关联靠约定:给控件传入与标签一致的 semanticLabel,让屏幕阅读器能读出同样的名称。
Props
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
children |
string |
— | 标签文本(必填) |
className |
string |
— | 追加在组件类名之后 |
semanticLabel |
string |
— | 覆盖无障碍名称;缺省使用标签文本 |
无障碍
pingo 尚无 label–control 关联机制,Label 只是带样式的文本。请始终在对应控件上设置 semanticLabel,保证无障碍名称不依赖视觉邻近关系。