微信小程序输入框

小程序的输入框主要有单行输入框 input 和多行输入框 textarea,这两个控件虽然看着比较简单,但使用时很容易踩到坑,导致出现各种问题,比如输入时光标跳转等等,这篇文章主要介绍怎么避免这些问题。

input 和 textarea 比较常用的属性有 placeholder、placeholder-class、bindinput、bindblur 、value、name 等等。
placeholder 是指未输入时显示的提示文案,placeholder-class 则是 placeholder 的样式,可在 wxss 里面定义。
bindinput 是输入时的回调方法,bindblur 是输入完成后失去焦点时的回调方法,但是 textarea 的 bindblur 方法有坑,后面会讲。
value 是输入框里面的文案,主要是在输入框有初始值的时候使用,也往往是引起上述问题的原因。
name 属性主要用于表单提交时,后面会讲。

这里以输入单行标题和多行内容为例子进行说明。

1、在新建的情况下,输入框仅仅是用于输入,没有初始值,则不需要为其设置 value 属性,不会产生任何问题。
方案一:
在 js 的 data 里面定义一个字符串字段作为输入的内容,在输入时的回调方法 bindinput 中改变 data 里面对应的字段,然后在点击按钮提交的时候使用该字符串作为输入的内容。这里之所以不使用 bindblur 方法是因为 textarea 的坑,后面会讲。

wxml文件:
<view>
  <input type="text" placeholder="请输入标题" placeholder-class="placeholder" bindinput="inputTitle" />
  <textarea placeholder="请输入内容" placeholder-class="placeholder" bindinput="inputContent" />
  <button bindtap="save">保存</button>
</view>

js文件:
Page({
  data: {
    title: '',
    content: ''
  },
  inputTitle: function (e) {
    this.setData({
      title: e.detail.value
    })
  },
  inputContent: function (e) {
    this.setData({
      content: e.detail.value
    })
  },
  save: function (e) {
    var title = this.data.title;
    var content = this.data.content;
    // 提交请求
    ...
  }
})

方案二:
采用表单提交的方式,不需要在 data 中定义字段,也无需绑定 bindinput 或 bindblur 方法,只需要在输入框中定义 name 属性,然后在表单提交的方法里面使用 e.detail.value.xxx 获取输入框的内容,其中 xxx 就是 name 对应的字符串。

wxml文件:
<form report-submit="true" bindsubmit="save">
  <input type="text" placeholder="请输入标题" placeholder-class="placeholder" name="title" />
  <textarea placeholder="请输入内容" placeholder-class="placeholder" name="content" />
  <button class="button" form-type="submit">保存</button>
</form>

js文件:
Page({
  data: {
  },
  save: function (e) {
    var title = e.detail.value.title.trim();
    var content = e.detail.value.content.trim();
    // 提交请求
    ...
  }
})

2、在修改编辑的情况下, 输入框里面有初始文案,则需要将 value 设置为 data 里面对应的字段,此时如果继续用 bindinput 修改 data 里面对应的字段,则由于每次修改时数据会更新到输入框,导致光标会跳转到最后。

wxml文件:
<view>
  <input type="text" placeholder="请输入标题" placeholder-class="placeholder" bindinput="inputTitle" value="{{title}}" />
  <textarea placeholder="请输入内容" placeholder-class="placeholder" bindinput="inputContent" value="{{content}}" />
  <button bindtap="save">保存</button>
</view>

js文件:
Page({
  data: {
    title: '',
    content: ''
  },
  onLoad: function (opt) {
    // 设置初始值
    this.setData({
      title: opt.title,
      content: opt.content
    })
  },
  inputTitle: function (e) {
    this.setData({
      title: e.detail.value
    })
  },
  inputContent: function (e) {
    this.setData({
      content: e.detail.value
    })
  },
  save: function (e) {
    var title = this.data.title;
    var content = this.data.content;
    // 提交请求
    ...
  }
})

方案1:
将 bindinput 改为 bindblur,即在输入框失去焦点时才改变 data 里面对应的字段。然而当输入完直接点击按钮时,textarea 控件的 bindblur 并不会先执行,导致需要再次点击按钮才能获取 textarea 中的真实数据。或者先点击其他区域使 textarea 的 bindblur 执行完成后,再点击按钮提交。而 input 控件则不会有这个问题,因此这种方案只有在单行输入的情况下才能使用。

wxml文件:
<view>
  <input type="text" placeholder="请输入标题" placeholder-class="placeholder" bindblur="blurTitle" value="{{title}}" />
  <textarea placeholder="请输入内容" placeholder-class="placeholder" bindblur="blurContent" value="{{content}}" />
  <button bindtap="save">保存</button>
</view>

js文件:
Page({
  data: {
    title: '',
    content: ''
  },
  onLoad: function (opt) {
    // 设置初始值
    this.setData({
      title: opt.title,
      content: opt.content
    })
  },
  blurTitle: function (e) {
    this.setData({
      title: e.detail.value
    })
  },
  blurContent: function (e) {
    this.setData({
      content: e.detail.value
    })
  },
  save: function (e) {
    var title = this.data.title;
    var content = this.data.content;
    // 提交请求
    ...
  }
})

方案2:
在 data 中为每个输入框增加一个对应的初始值字段,将 value 设置成该字段,其他的不变。这种方案能很好的解决问题,代价也不大。

wxml文件:
<view>
  <input type="text" placeholder="请输入标题" placeholder-class="placeholder" bindinput="inputTitle" value="{{titleOrigin}}" />
  <textarea placeholder="请输入内容" placeholder-class="placeholder" bindinput="inputContent" value="{{contentOrigin}}" />
  <button bindtap="save">保存</button>
</view>

js文件:
Page({
  data: {
    titleOrigin: '',
    title: '',
    contentOrigin: '',
    content: ''
  },
  onLoad: function (opt) {
    // 设置初始值
    this.setData({
      titleOrigin: opt.title,
      contentOrigin: opt.content
    })
  },
  inputTitle: function (e) {
    this.setData({
      title: e.detail.value
    })
  },
  inputContent: function (e) {
    this.setData({
      content: e.detail.value
    })
  },
  save: function (e) {
    var title = this.data.title;
    var content = this.data.content;
    // 提交请求
    ...
  }
})

方案3:
采用表单提交的方法,跟之前一样,不需要绑定 bindinput 或者 bindblur 等回调方法,只需要在输入框里面加上 name 属性。

wxml文件:
<form report-submit="true" bindsubmit="save">
  <input type="text" placeholder="请输入标题" placeholder-class="placeholder" name="title" value="{{title}}" />
  <textarea placeholder="请输入内容" placeholder-class="placeholder" name="content" value="{{content}}" />
  <button class="button" form-type="submit">保存</button>
</form>

js文件:
Page({
  data: {
    title: '',
    content: ''
  },
  onLoad: function (opt) {
    // 设置初始值
    this.setData({
      title: opt.title,
      content: opt.content
    })
  },
  save: function (e) {
    var title = e.detail.value.title.trim();
    var content = e.detail.value.content.trim();
    // 提交请求
    ...
  }
})

一般来说,如果表单提交的方法不被占用的话,推荐使用表单提交的方法,否则,如果表单提交的方法需要用在别的地方(比如之前的文章《微信小程序消息重复推送》里面提到的postFormId)的话,则可以使用增加初始值字段的方法。

最后,一般输入框后面会加一个清空的图标,在有内容时显示,以下是基本的实现。

wxml文件:
<form report-submit="true" bindsubmit="save">
  <view class="info">
    <view class="info-item first title">
      <view class="label">标题</view>
      <input type="text" placeholder="请输入标题" placeholder-class="placeholder" bindinput="inputTitle" name="title" value="{{title}}" />
      <icon class="clear" type="clear" size="15" wx:if="{{!titleEmpty}}" catchtap="clearTitle" />
    </view>
    <view class="info-item content">
      <view class="label">内容</view>
      <textarea placeholder="请输入内容" placeholder-class="placeholder" bindinput="inputContent" name="content" value="{{content}}" maxlength="-1" auto-height="true" />
      <icon class="clear" type="clear" size="15" wx:if="{{!contentEmpty}}" catchtap="clearContent" />
    </view>
  </view>
  <button class="button" form-type="submit">保存</button>
</form>
js文件:
Page({
  data: {
    title: '',
    content: '',
    titleEmpty: true,
    contentEmpty: true
  },
  onLoad: function (opt) {
    // 设置初始值
    this.setData({
      title: opt.title,
      content: opt.content
    })
    this.setData({
      titleEmpty: util.isTextEmpty(this.data.title),
      contentEmpty: util.isTextEmpty(this.data.content)
    })
  },
  inputTitle: function (e) {
    this.setData({
      titleEmpty: e.detail.value.length == 0
    })
  },
  clearTitle: function () {
    this.setData({
      title: '',
      titleEmpty: true
    })
  },
  inputContent: function (e) {
    this.setData({
      contentEmpty: e.detail.value.length == 0
    })
  },
  clearContent: function () {
    this.setData({
      content: '',
      contentEmpty: true
    })
  },
  save: function (e) {
    var title = e.detail.value.title.trim();
    var content = e.detail.value.content.trim();
    this.setData({
      title: title,
      content: content
    })
    // 提交请求
    ...
  }
})
wxss文件:
.info {
  background-color: #fff;
}

.info-item {
  height: 88rpx;
  display: flex;
  display: -webkit-flex;
  flex-direction: row;
  align-items: center;
  justify-content: space-between;
  padding: 0 30rpx;
  border-top: 1rpx solid #e5e5e5;
  color: #000;
  font-size: 32rpx;
}

.info-item.first {
  border: 0;
}

.content {
  height: auto;
  align-items: flex-start;
}

.label {
  flex-shrink: 0;
}

.title .label {
  width: 182rpx;
}

.content .label {
  width: 170rpx;
  padding-top: 20rpx;
}

input {
  flex-grow: 1;
}

textarea {
  flex-grow: 1;
  min-height: 150rpx;
  margin: 10rpx 70rpx 0 0;
}

.placeholder {
  color: #9a9a9a;
}

.clear {
  flex-shrink: 0;
  padding: 20rpx;
}

.button {
  margin-top: 20rpx;
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343

推荐阅读更多精彩内容

  • React中没有类似Angular那样的双向数据绑定,在做一些表单复杂的后台类页面时,监听、赋值、传递、校验时编码...
    tedyuen777阅读 9,851评论 1 23
  • 表单基础知识 在HTML中,表单是由 元素来表示的,而在JS中,表单对应的则是HTMLFormElement类型。...
    oWSQo阅读 902评论 0 1
  • 本人做php的,最近发现JS真的是博大精深啊,比PHP难.在HTML中,表单是由form元素来表示的,但是在jav...
    linfree阅读 2,133评论 3 17
  • 什么是FORM表单: 表单是用来提交资料、意见,规范流程执行过程的格式。表单在网页中主要负责数据采集功能。一个表单...
    PYFang阅读 1,117评论 0 0
  • 吻起您嘴唇的血 舔注红透了的肉体 不必剥削您的全部 这夜色的温柔 在清屋里 方桌上 用一盏古老的罩灯展开 侵占 有...
    蓝少阅读 131评论 0 1