TagField

自 2.2.1

TagField 是一个 NBT 标签输入框。它封装了一个 TextField，并为 NBT 文本提供了语法高亮显示（字符串为绿色、数字为金色、布尔值为紫色、括号为水色、分隔符为灰色、键为紫色）。无效输入将以错误颜色显示。

该字段的值为 Tag（任何 NBT 类型）。TagField 继承自 BindableUIElement<Tag>。

INFO

在 UIElement 中记录的所有内容（布局、样式、事件、数据绑定等）同样适用于此处。

---

用法

var tagField = new TagField();
tagField.setCompoundTagOnly(); // 仅接受 CompoundTag
tagField.setTagResponder(tag -> System.out.println("Tag: " + tag));
parent.addChild(tagField);

// 设置初始值
tagField.setValue(new CompoundTag(), false);

tagField({
    onTagChanged { tag -> println("Tag: $tag") }
}) {
    api { setCompoundTagOnly() }
}

let field = new TagField();
field.setCompoundTagOnly();
field.setTagResponder(tag => { /* use tag */ });
parent.addChild(field);

---

内部结构

字段	CSS 类	描述
textField	.__tag-field_text-field__	带有语法高亮格式化器的底层 TextField。

---

值绑定

TagField 继承自 BindableUIElement<Tag>：

tagField.bind(DataBindingBuilder.create(
    () -> config.getNbt(),
    tag -> config.setNbt(tag)
).build());

更多详情请参见 数据绑定。

---

字段

名称	类型	访问权限	描述
textField	TextField	public final	带有 NBT 语法高亮的内部文本输入框。
value	Tag	private（getter）	当前的 NBT 值（为空时为 EndTag.INSTANCE）。

---

方法

方法	返回	描述
setValue(Tag, boolean)	TagField	设置 NBT 值；第二个参数控制是否发出通知。
setTagValidator(Predicate<Tag>)	TagField	设置自定义验证器。无效输入将以错误颜色显示。
setTagResponder(Consumer<Tag>)	TagField	注册一个监听器，在每次有效更改时调用。
setCompoundTagOnly()	TagField	仅接受 CompoundTag。
setListOnly()	TagField	仅接受 ListTag。
setAny()	TagField	接受任何 NBT 标签类型（默认）。