TextField

受控文本输入组件。通过 value 传入当前值，并在 onChange 中更新状态。

import { TextField, useState } from "onescript/views"

function NameField() {
  const [name, setName] = useState("")
  return (
    <TextField
      value={name}
      onChange={setName}
      prompt="姓名"
    />
  )
}

Prop	Type	说明
`value`	`string`	当前文本值。
`onChange`	`(value: string) => void`	用户修改文本时执行。
`prompt`	`string`	值为空时显示的引导文本。
`axis`	`"horizontal" \| "vertical"`	为 `"vertical"` 时，长文本会换行，输入框随之增高。默认 `"horizontal"`。

多行输入

设置 axis="vertical"，并用 lineLimit 限制高度。传入范围时，至少占用下限行数，超过上限后滚动。

import { Modifier, TextField } from "onescript/views"

<TextField
  value={bio}
  onChange={setBio}
  prompt="介绍一下自己"
  axis="vertical"
  modifier={Modifier.lineLimit({ min: 2, max: 5 })}
/>

输入密码请用 SecureField，编辑长文本请用 TextEditor。

也支持修饰符。它可以在 App 和 Action 视图会话中交互。Widget 采用静态渲染，状态更新不会触发新一轮 Widget 渲染。

多行输入

本页目录