Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
CoderSmallfan
uni-app
提交
a9731c85
U
uni-app
项目概览
CoderSmallfan
/
uni-app
与 Fork 源项目一致
Fork自
DCloud / uni-app
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
a9731c85
编写于
11月 23, 2019
作者:
W
wanganxp
提交者:
GitHub
11月 23, 2019
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update input.md
上级
6e42bf63
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
10 addition
and
9 deletion
+10
-9
docs/component/input.md
docs/component/input.md
+10
-9
未找到文件。
docs/component/input.md
浏览文件 @
a9731c85
...
...
@@ -14,16 +14,16 @@
|placeholder-class|String|"input-placeholder"|指定 placeholder 的样式类||
|disabled|Boolean|false|是否禁用||
|maxlength|Number|140|最大输入长度,设置为 -1 的时候不限制最大长度||
|cursor-spacing|Number|0|指定光标与键盘的距离,单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离|
5+
App、微信小程序、百度小程序、QQ小程序|
|cursor-spacing|Number|0|指定光标与键盘的距离,单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离|App、微信小程序、百度小程序、QQ小程序|
|focus|Boolean|false|获取焦点。在 H5 平台聚焦后软键盘是否跟随弹出,取决于当前浏览器本身的规范(策略)。||
|confirm-type|String|done|设置键盘右下角按钮的文字,仅在 type="text" 时生效。||
|confirm-hold|Boolean|false|点击键盘右下角按钮时是否保持键盘不收起|
5+
App、微信小程序、支付宝小程序、百度小程序、QQ小程序|
|confirm-hold|Boolean|false|点击键盘右下角按钮时是否保持键盘不收起|App、微信小程序、支付宝小程序、百度小程序、QQ小程序|
|cursor|Number||指定focus时的光标位置||
|selection-start|Number|-1|光标起始位置,自动聚集时有效,需与selection-end搭配使用||
|selection-end|Number|-1|光标结束位置,自动聚集时有效,需与selection-start搭配使用||
|adjust-position|Boolean|true|键盘弹起时,是否自动上推页面|
5+
App(softinputMode 为 adjustResize 时无效)、微信小程序、百度小程序、QQ小程序|
|adjust-position|Boolean|true|键盘弹起时,是否自动上推页面|App(softinputMode 为 adjustResize 时无效)、微信小程序、百度小程序、QQ小程序|
|@input|EventHandle||当键盘输入时,触发input事件,event.detail = {value}|差异见下方 Tips|
|@focus|EventHandle||输入框聚焦时触发,event.detail = { value, height },height 为键盘高度|仅微信小程序、
5+App(HBuilderX 2.2.3
) 、QQ小程序支持 height|
|@focus|EventHandle||输入框聚焦时触发,event.detail = { value, height },height 为键盘高度|仅微信小程序、
App(2.2.3+
) 、QQ小程序支持 height|
|@blur|EventHandle||输入框失去焦点时触发,event.detail = {value: value}||
|@confirm|EventHandle||点击完成按钮时触发,event.detail = {value: value}|
|
...
...
@@ -47,8 +47,9 @@
-
小程序平台,
`number`
类型只支持输入整型数字。微信开发者工具上体现不出效果,请使用真机预览。
-
如果需要在小程序平台输入浮点型数字,请使用
`digit`
类型。
-
input组件若不想弹出软键盘,可设置为disable
-
App平台的vue页面及 H5平台 的弹出键盘使用的是浏览器控制的键盘,丰富程度略低。可通过插件市场补足。
-
[
uni-app插件市场
](
https://ext.dcloud.net.cn/
)
有各种类型的模拟键盘,比如车牌键盘、身份证键盘,以及封装好的搜索框ui组件,可去插件市场搜索
[
键盘
](
https://ext.dcloud.net.cn/search?q=%E9%94%AE%E7%9B%98
)
。
-
App平台的vue页面及 H5平台 的弹出键盘使用的是浏览器控制的键盘,丰富程度略低。可通过插件市场找到更多类型的键盘。
-
插件市场有各种类型的模拟键盘,比如车牌键盘、身份证键盘,可去插件市场搜索
[
键盘
](
https://ext.dcloud.net.cn/search?q=%E9%94%AE%E7%9B%98
)
。
-
搜索框ui组件,可参考uni ui的search组件或封装好的页面模板。
[
详见
](
https://ext.dcloud.net.cn/search?q=search
)
-
[
uni-app插件市场
](
https://ext.dcloud.net.cn/
)
有输入文字后自动提示候选的组件,可搜索
[
autocomplete
](
https://ext.dcloud.net.cn/search?q=autocomplete
)
查看。
**confirm-type 有效值**
...
...
@@ -62,7 +63,8 @@
|go|右下角按钮为“前往”||
|done|右下角按钮为“完成”|微信、支付宝、百度小程序、App的nvue|
App平台的nvue页面,如果是uni-app编译模式,直接使用此属性设置即可生效。如果是weex编译模式,需通过weex的api设置,
[
weex相关文档参考
](
https://weex.apache.org/zh/docs/components/input.html#%E5%B1%9E%E6%80%A7
)
-
App平台的nvue页面,如果是uni-app编译模式,直接使用此属性设置即可生效。如果是weex编译模式,需通过weex的api设置,
[
weex相关文档参考
](
https://weex.apache.org/zh/docs/components/input.html#%E5%B1%9E%E6%80%A7
)
-
App平台的vue页面不支持控制键盘右下角为“发送”,涉及聊天的建议使用nvue。
#### App平台iOS端软键盘上方横条去除方案
...
...
@@ -99,10 +101,9 @@ App平台软键盘弹出有 adjustResize|adjustPan 两种模式,默认为 adju
}
```
App端开发聊天类应用时,目前推荐改为adjustResize模式。在hello uni-app的模板-聊天中有详细示例。
**注意**
-
adjustResize模式在Android App上,弹起键盘和收回键盘时,因为要重设webview窗体高度,可能会
临时性出
现灰屏或漏出下层页面内容。
-
adjustResize模式在Android App上,弹起键盘和收回键盘时,因为要重设webview窗体高度,可能会
在个别安卓机型闪
现灰屏或漏出下层页面内容。
-
小程序端在 input 聚焦期间,避免使用 css 动画。
-
H5平台只能在用户交互时修改 focus 生效。
-
如果遇到 focus 属性设置不生效的问题参考:
[
组件属性设置不生效解决办法
](
/use?id=%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录