Elements

组件

可编辑文本 Editable

Editable:行内编辑文本。阅读时只显示文字,编辑时显示完整字段样式。部件:Root、Area、Label、Preview、Input、EditTrigger、SubmitTrigger、CancelTrigger、Control。Preview 把状态机的值渲染为文本(asChild 逃生口仍归 Ark 基础组件)。

#基础用法

editable/basic Vue React
Hello World

#属性

#Area

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#CancelTrigger

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#Control

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#EditTrigger

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#Input

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#Label

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#Preview

纯造型的部件——自身没有属性,沿用部件结构的共享样式。

#Root

属性类型默认值描述
sizeString as PropType<"sm" | "md" | "lg">"md"编辑字段使用的控件高度档位
activationModeeditable.ActivationMode"focus"预览元素的激活模式:"focus" 表示聚焦预览时进入编辑模式,"dblclick" 表示双击预览时进入编辑模式,"click" 表示点击预览时进入编辑模式
autoResizeboolean可编辑组件是否随内容自动调整尺寸
defaultEditboolean可编辑组件是否默认进入编辑模式
defaultValuestring可编辑组件的初始值;适合不需要受控值的场景
disabledboolean是否禁用可编辑组件
editboolean是否处于编辑模式
finalFocusEl() => HTMLElement | null可编辑组件关闭时接收焦点的元素
formstring底层 input 关联的表单
idstring组件内部状态机的唯一标识
idsPartial<{ root: string; area: string; label: string; preview: string; input: string; control: string; submitTrigger: string; cancelTrigger: string; editTrigger: string; }>可编辑组件各元素的 id,便于组合使用
invalidboolean输入值是否无效
maxLengthnumber可编辑组件允许输入的最大字符数
modelValuestring可编辑组件的 v-model 值
namestring可编辑组件的 name 属性,用于表单提交
placeholderstring | { edit: string; preview: string; }可编辑组件的占位文本
readOnlyboolean是否只读
requiredboolean是否必填
selectOnFocusbooleantrue输入框获得焦点时是否选中文本
submitModeeditable.SubmitMode"both"编辑模式下的提交触发方式:"enter" 表示按 Enter 提交,"blur" 表示失焦提交,"none" 表示不自动提交、需使用提交按钮,"both" 表示按 Enter 或输入框失焦时提交
translationseditable.IntlTranslations可编辑组件的国际化文案

#SubmitTrigger

纯造型的部件——自身没有属性,沿用部件结构的共享样式。