> For the complete documentation index, see [llms.txt](https://leawinds-organization.gitbook.io/yetanotherconfiglib-jian-ti-zhong-wen-fei-guan-fang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://leawinds-organization.gitbook.io/yetanotherconfiglib-jian-ti-zhong-wen-fei-guan-fang/tu-xing-jie-mian-de-gou-jian-gui-builder/kong-zhi-qi-controllers.md).
# 控制器（Controllers）
深入了解控制器
{% hint style="danger" %}
这不是官方文档！官方文档位于 [https://docs.isxander.dev](https://docs.isxander.dev/yet-another-config-lib/)
{% endhint %}
## 内置控制器
{% hint style="warning" %}
这个关于控制器的列表还没有完成！
{% endhint %}
有许多不同的内置控制器可以让你快速设置。
BooleanController
一个可切换的控制器，根据选项的状态显示不同的文本。
```java
.controller(BooleanControllerBuilder::create)
```
* `valueFormatter`参数是一个函数，根据选项状态返回Text（可选）
* `coloured`参数是一个布尔值，根据选项状态设置`Text`为红色或绿色（可选）
要传递额外参数，你需要如下所示构建一个`BooleanController`。
```java
.controller(opt -> BooleanControllerBuilder.create(opt)
.valueFormatter(val -> val ? Component.literal("Amazing") : Component.literal("Not Amazing"))
.coloured(true))
```
TickBoxController
一个可以切换的控制器，显示一个tick box。
```java
.controller(TickBoxControllerBuilder::create)
```
这个控制器没有可选参数。
<Number>SliderController
将`` 替换为`Double`, `Float`, `Integer` 或 `Long`。
滑块控制器需要一个最小值、最大值和一个步长。
```java
.controller(opt -> FloatSliderController.create(opt)
.range(0, 10)
.step(1)
.valueFormatter(val -> Component.literal(val + " ticks"))) // 滑块也接受格式化器
```
EnumController
这个控制器使你可以在枚举常量间循环。
```java
.controller(opt -> EnumControllerBuilder.create(opt)
.enumClass(Alphabet.class))
```
枚举可以继承`NameableEnum`接口来自动命名每个常量，不需要格式化器。
```java
public interface Alphabet implements NameableEnum {
A,
B,
C;
@Override
public Component getDisplayName() {
return Component.translatable("mymod.alphabet." + name().toLowerCase());
}
}
```
或者，像往常一样将`valueFormatter`传递给控制器；
```java
.controller(opt -> EnumControllerBuilder.create(opt)
.enumClass(Alphabet.class)
.valueFormatter(v -> Component.translatable("mymod.alphabet." + v.name().toLowerCase())))
```
StringController
一个允许用户输入字符串（`String`）的输入框。这允许使用键盘突出显示文本和比选项本身长的字符串，类似于Minecraft的`EditBox`。
```java
.controller(StringControllerBuilder::create)
```
该控制器没有参数，但可以通过创建自己的控制器、实现`IStringController`来扩展其功能，更多信息请参见此处。
ColorController
一个允许用户输入十六进制RGB格式的控制器，带有预览。
```java
.controller(ColorControllerBuilder::create)
```
* `allowAlpha`参数为十六进制格式添加alpha通道，这样就变成了RGBA。
```java
.controller(opt -> ColorControllerBuilder.create(opt)
.alpha(true))
```
<Number>FieldController
将`` 替换为`Double`, `Float`, `Integer` 或 `Long`。
类似于StringController，但是强制为数值格式，单/双精度浮点数允许小数，但是长整型和整型不允许。
```java
.controller(opt -> SliderControllerBuilder.create(opt)
.min(0).max(10)
.valueFormatter(...))
```
## 创建一个自定义控制器