Textbox

English Version | 中文版

文本框 (TextBox)

luatex-cn 提供了强大的竖排文本框功能，支持网格对齐、自动分栏以及特定样式的填充。

基础文本框

\文本框 (\TextBox) 用于创建一个独立的竖排文本区域。

使用方法

\文本框[参数列表]{文本内容}

常用参数

参数	说明	默认值
height / 高度	文本框的高度（以网格数为单位）。设为 0 则自动延长。	0
n-cols / 列数	强制分栏的列数。	0 (不分栏)
border / 边框	是否显示边框框线。	false
background-color	背景颜色。	无
distribute	是否均匀分布内容（仅限特定模式）。	false
floating	是否为浮动文本框（需配合 x, y 坐标）。	false

自动延长与压缩

• 自然延长：如果不指定 height（或设为 0），文本框会根据内容长度自然向下延伸。
• 字体压缩（扁字）：如果指定了固定 height 但内容过多，系统会自动垂直压缩字体（扁字）以确保内容完全放入框内（v0.1.5 新增）。

填充文本框

\填充文本框 (\FillTextBox) 是 \TextBox 的一个变体，默认启用填充对齐模式，常用于需要充满特定区域的场景。

\填充文本框[height=10]{内容}

等同于 \TextBox[height=10, box-align=fill]{内容}。

浮动批注 (Floating Box)

通过设置 floating=true，可以将文本框放置在页面的绝对坐标位置，常用于制作批注。

\文本框[
  floating=true,
  x=2cm, y=3cm,
  height=5,
  width=2em,
  border=true
]{这是浮动批注}

也可以直接使用简化的 \批注 命令 (\PiZhu)。

---

👉 下一步：查看 功能详解。