Input 输入框

优质
小牛编辑
123浏览
2023-12-01

通过鼠标或键盘输入字符

基础用法

<!--当设置 value 初始值属性后,会覆盖 placeholder-->
<!--你可以通过 [(model)] 进行双向绑定-->
<el-input [model]="input" placeholder="请输入内容"></el-input>

禁用状态

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

<el-input placeholder="请输入内容"
  [model]="input1"
  [elDisabled]="true">
</el-input>

带 icon 的输入框

带有图标标记输入类型

通过 icon 属性在 input 组件尾部增加显示图标

<!--你可以使用 (icon-click)=Function 来得到图标点击的事件-->
<el-input placeholder="请选择日期"
  icon="search"
  [model]="input2">
</el-input>

文本域

用于输入多行文本信息,通过将 type 属性的值指定为 textarea。

文本域高度可通过 rows 属性控制

<el-input type="textarea"
  [rows]="2"
  placeholder="请输入内容"
  [model]="textarea">
</el-input>

可自适应文本高度的文本域

通过设置 autosize 属性可以使得文本域的高度能够根据文本内容自动进行调整,并且 autosize 还可以设定为一个对象,指定最小行数和最大行数

<el-input type="textarea"
  autosize
  placeholder="固定高度文本域"
  [model]="textarea2">
</el-input>
<div style="margin: 20px 0;"></div>
<el-input type="textarea"
  [autosize]="{ minRows: 2, maxRows: 4}"
  placeholder="自动调整高度 { minRows: 2, maxRows: 4 }"
  [model]="textarea3">
</el-input>

复合型输入框

可前置或后置元素,一般为标签或按钮

<div>
  <el-input placeholder="请输入内容" [model]="input3">
    <ng-template #prepend>
      <span>Http://</span>
    </ng-template>
  </el-input>
</div>
<div style="margin-top: 15px;">
  <el-input placeholder="请输入内容" [model]="input4">
    <ng-template #append>
      <span>.com</span>
    </ng-template>
  </el-input>
</div>

尺寸

可通过 size 属性指定输入框的尺寸, 除了默认的大小外,还提供了 large、small 和 mini 三种尺寸

<div class="demo-input-size">
  <el-input size="large" placeholder="请输入内容" [model]="input6">
  </el-input>
  
  <el-input placeholder="请输入内容" [model]="input7">
  </el-input>
  
  <el-input size="small" placeholder="请输入内容" [model]="input8">
  </el-input>
  
  <el-input size="mini" placeholder="请输入内容" [model]="input9">
  </el-input>
  
</div>

Input Attributes

参数说明类型可选值默认值
type类型stringtext/textareatext
model绑定值string, number
maxlength最大输入长度number
minlength最小输入长度number
placeholder输入框占位文本string
native-type输入框原生属性,如 'password'stringtext
elDisabled禁用boolean
size输入框尺寸,只在 type=text 时有效stringlarge, small, mini
icon输入框尾部图标 参考 Iconstring
icon-class输入框尾部图标的额外样式,这些 CSS 类名会被追加到图标上string
icon-mouseenter输入框尾部图标 mouseenter 事件EventEmitter
icon-mouseleave输入框尾部图标 mouseleave 事件EventEmitter
icon-mousedown输入框尾部图标 mousedown 事件EventEmitter
icon-mouseup输入框尾部图标 mouseup 事件EventEmitter
rows输入框行数,只对 type=textarea 有效number2
autosize自适应内容高度,只对 type=textarea 有效{ minRows: number, maxRows: number }
auto-complete原生属性,自动补全,只在 type=text 时有效stringon, offoff
readonly原生属性,是否只读boolean
resize控制是否能被用户缩放,只对 type=textarea 有效stringnone, both, horizontal, vertical
autofocus原生属性,自动获取焦点booleantrue, false
icon-click点击 Input 内的图标的钩子函数expression
#prepend前置自定义元素ng-template
#append后置自定义元素ng-template