roymondchen 873a51fc87 docs: 升级 VitePress 至 v2 alpha,类型引用改为源码片段同步
- 升级 vitepress 到 ^2.0.0-alpha.17
- vite.optimizeDeps.rolldownOptions.transform.define 迁移至 vite.define 以适配 v2 API
- 同步升级 vitest/rolldown/vue/vite 等周边依赖
- 文档中类型链接统一改为 <<< 片段引用源码 region,避免 commit hash 链接失效
- packages/{core,editor,form-schema,schema,stage} 相关类型加 // #region 锚点
- 移除已废弃的 docs/guide/advanced/tmagic-ui.md 及侧栏入口

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-18 11:47:03 +08:00

5.2 KiB
Raw Blame History

Input 输入框

通过鼠标或键盘输入字符

基础用法

<template #source>

Input输入框的type为'text', 是type的默认值所以可以不配置

禁用状态

<template #source>

通过 disabled 属性指定是否禁用 input 组件

复合型输入框

后置内容

<template #source>

可以通过配置append来增加一个后置内容。

<template #source>

可以通过配置append来增加一个后置按钮。

过滤内容

<template #source>

设置filter为'number',可以将值转换成数值,也可以配置一个函数来自由转换。

去掉首尾空格

<template #source>

设置trim为true',可以去掉首尾空格。

显示详情

<template #source>

通过配置 tooltip在输入时显示提示内容。

Input Attributes

参数 说明 类型 可选值 默认值
name 绑定值 string
text 表单标签 string
placeholder 输入框占位文本 string
disabled 是否禁用 boolean / FilterFunction false
clearable 是否可清空 boolean true
tooltip 输入时显示内容 string / ToolTipConfigType
trim 是否去掉首尾空格 boolean false
filter 过滤值 string / Function number -
prepend 前置内容 string -
append 后置内容 string / Object -
onChange 值变化时触发的函数 OnChangeHandler -

::: details 查看 FilterFunction / OnChangeHandler / ToolTipConfigType 及关联类型定义 <<< @/../packages/form-schema/src/base.ts#FilterFunction{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandler{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandlerData{ts}

<<< @/../packages/form-schema/src/base.ts#ChangeRecord{ts}

<<< @/../packages/form-schema/src/base.ts#FormValue{ts}

<<< @/../packages/form-schema/src/base.ts#ToolTipConfigType{ts} :::

配置类型

::: details 查看 TextConfig 配置类型定义 <<< @/../packages/form-schema/src/base.ts#TextConfig{ts}

<<< @/../packages/form-schema/src/base.ts#FormItem{ts}

<<< @/../packages/form-schema/src/base.ts#Input{ts}

:::

append Attributes

参数 说明 类型 可选值 默认值
type 内容类型 string button
text 文本内容 string
handler 点击操作 Function -