Update bootstrap-plugin.md
Showing
1 changed file
with
165 additions
and
0 deletions
@@ -28,6 +28,8 @@ | @@ -28,6 +28,8 @@ | ||
28 | - [11、面板(panel)](#11显示一个面板插件panel) | 28 | - [11、面板(panel)](#11显示一个面板插件panel) |
29 | - [12、显示一个下拉框(select)](#12显示一个下拉框select) | 29 | - [12、显示一个下拉框(select)](#12显示一个下拉框select) |
30 | - [13、显示一个表格(table)](#13显示一个表格table) | 30 | - [13、显示一个表格(table)](#13显示一个表格table) |
31 | + - [14、显示一个带图标的文本框(textbox)](#14显示一个带图标的文本框textbox) | ||
32 | + - [15、显示一个可以验证框(validate)](#15显示一个可以验证框validate) | ||
31 | 33 | ||
32 | 34 | ||
33 | 35 | ||
@@ -1004,8 +1006,171 @@ http://git.yoho.cn/yoho30/yohobuy-crm/blob/master/web/src/main/webapp/js/bootstr | @@ -1004,8 +1006,171 @@ http://git.yoho.cn/yoho30/yohobuy-crm/blob/master/web/src/main/webapp/js/bootstr | ||
1004 | 1006 | ||
1005 | 1007 | ||
1006 | 1008 | ||
1009 | +---------- | ||
1010 | + | ||
1011 | + | ||
1012 | +## 14、显示一个带图标的文本框(textbox)## | ||
1013 | + | ||
1014 | +显示一个面板插件 | ||
1015 | + | ||
1016 | +依赖于:无 | ||
1017 | +继承于:validate | ||
1018 | + | ||
1019 | +使用举例 | ||
1020 | +```html | ||
1021 | +<input type="text" id="txt" /> | ||
1022 | +``` | ||
1023 | +```javascript | ||
1024 | + | ||
1025 | + $("#txt").textbox({ | ||
1026 | + placeholder : "请输入内容", | ||
1027 | + iconCls : "glyphicon glyphicon-glass" | ||
1028 | + }); | ||
1029 | + | ||
1030 | +``` | ||
1031 | + | ||
1032 | + | ||
1033 | +**代码地址** | ||
1034 | + | ||
1035 | +http://git.yoho.cn/yoho30/yohobuy-crm/blob/master/web/src/main/webapp/js/bootstrap-plugin/bootstrap.textbox.js | ||
1036 | + | ||
1037 | +**可供选择的私有属性(option)有:** | ||
1038 | + | ||
1039 | +| 属性名称 | 属性类型 | 可否为空 | 默认值 | 备注 | | ||
1040 | +| ---------|:--------:| --------:|-----:|------:|-----:| | ||
1041 | +|border-radius |string |是 | "5px" |输入框的圆角| | ||
1042 | +|width |string|int |是 | undefined |宽度| | ||
1043 | +|height |string|int |是 | undefined |高度| | ||
1044 | +|placeholder |string |是 | "请输入内容" |文本框提示文字| | ||
1045 | +|value |string |是 | "" |文本框内容| | ||
1046 | +|type |string |是 | "text" |文本框类型| | ||
1047 | +|editable |boolean |是 | true |是否可以编辑| | ||
1048 | +|readonly |boolean |是 | false |是否只读| | ||
1049 | +|disabled |boolean |是 | false |是否禁用| | ||
1050 | +|iconCls |string |是 | "" |文本框图标(取值见Bootstrap的Glyphicons字体图标)| | ||
1051 | +|wrap |boolean |是 | false |是否使用div包一下| | ||
1052 | + | ||
1053 | + | ||
1054 | + | ||
1055 | + | ||
1056 | +**该插件的事件继承与validate ** | ||
1057 | + | ||
1058 | + | ||
1059 | + | ||
1060 | + | ||
1061 | + | ||
1062 | + | ||
1063 | + | ||
1064 | +**该插件的方法继承与validate。并且提供的私有可供选择的方法(method):** | ||
1065 | + | ||
1066 | +| 方法名称 | 参数 | 备注 | | ||
1067 | +| ---------|:--------:| --------:| | ||
1068 | +|readonly |value |传入value值,则设置输入框状态是否只读;如果不传value值,则获取该输入框的只读状态| | ||
1069 | +|value |value |设置或获取输入框的值| | ||
1070 | + | ||
1071 | + | ||
1072 | + | ||
1073 | +---------- | ||
1074 | + | ||
1075 | + | ||
1076 | +## 15、显示一个可以验证框(validate)## | ||
1007 | 1077 | ||
1078 | +显示一个可以验证输入内容的验证框 | ||
1079 | +如果输入的内容验证失败,会有显示一个提示框 | ||
1008 | 1080 | ||
1081 | +依赖于:无 | ||
1082 | +继承于:无 | ||
1083 | + | ||
1084 | +使用举例 | ||
1085 | +```html | ||
1086 | +<input type="text" id="txt" /> | ||
1087 | +``` | ||
1088 | +```javascript | ||
1089 | + | ||
1090 | + $("#txt").validate({ | ||
1091 | + required : true, | ||
1092 | + validType : "maxlength[5]" //设置该输入框最小输入文本长度为5 | ||
1093 | + }); | ||
1094 | + | ||
1095 | +``` | ||
1096 | + | ||
1097 | + | ||
1098 | +**代码地址** | ||
1099 | + | ||
1100 | +http://git.yoho.cn/yoho30/yohobuy-crm/blob/master/web/src/main/webapp/js/bootstrap-plugin/bootstrap.validate.js | ||
1101 | + | ||
1102 | +**可供选择的私有属性(option)有:** | ||
1103 | + | ||
1104 | +| 属性名称 | 属性类型 | 可否为空 | 默认值 | 备注 | | ||
1105 | +| ---------|:--------:| --------:|-----:|------:|-----:| | ||
1106 | +|required |boolean |是 | false |是否必填项| | ||
1107 | +|validType |string|array|function |是 | "该值为必填项" |该值为空时并且required=true的提示| | ||
1108 | +|missingMessage |string |是 | "该值为必填项" |该值为空时并且required=true的提示| | ||
1109 | +|invalidMessage |string |是 | "" |验证失败时,并且验证的函数只返回false的时候显示| | ||
1110 | +|tipPosition |string |是 | "right" |提示框的位置('left','right','top','bottom')| | ||
1111 | +|validateOnBlur |boolean |是 | false |是否失去焦点时验证| | ||
1112 | + | ||
1113 | + | ||
1114 | +其中validType属性 | ||
1115 | + - string 指定一个默认或自定义的验证方法 | ||
1116 | + - array 指定多个默认或者自定义验证方法 | ||
1117 | + - function 传入验证框的内容,返回true,则验证通过,返回string,则验证不通过,并且把该string作为提示消息。该函数接受一个参数value,就是输入框的内容 | ||
1118 | + | ||
1119 | + | ||
1120 | + | ||
1121 | + | ||
1122 | + | ||
1123 | +**可供选择的私有事件(event)有:** | ||
1124 | + | ||
1125 | +| 事件名称 | 参数 | 备注 | | ||
1126 | +| ---------|:--------:| --------:| | ||
1127 | +|onBeforeShow |none |当提示框显示之前执行| | ||
1128 | +|onAfterShow |none |当提示框显示之后执行| | ||
1129 | +|onBeforeHide |none |当提示框隐藏之前执行| | ||
1130 | +|onAfterHide |none |放提示框隐藏之后执行| | ||
1131 | +|onBeforeValidate |none |当验证之前执行| | ||
1132 | +|onAfterValidate |none |当验证之后执行| | ||
1133 | + | ||
1134 | + | ||
1135 | + | ||
1136 | + | ||
1137 | + | ||
1138 | + | ||
1139 | +**该插件提供的私有可供选择的方法(method):** | ||
1140 | + | ||
1141 | +| 方法名称 | 参数 | 备注 | | ||
1142 | +| ---------|:--------:| --------:| | ||
1143 | +|validate |none |验证该输入框的内容| | ||
1144 | +|isValid |none |验证该输入框的内容,并且返回验证结果| | ||
1145 | +|enableValidation |none |开启验证功能| | ||
1146 | +|disableValidation |none |关闭验证功能| | ||
1147 | + | ||
1148 | + | ||
1149 | +**系统提供了一些常用的验证规则** | ||
1150 | + - minlength(最小长度) | ||
1151 | + - maxlength(最大长度) | ||
1152 | + - length(界与最小与最大长度之间。使用方法validType[2,5]) | ||
1153 | + - url(判断是否是url) | ||
1154 | + | ||
1155 | +你也可以自己自定义一些验证规则。 | ||
1156 | +```javascript | ||
1157 | +$.extend($.fn.validate.defaults.rules, { | ||
1158 | + isNumber : function(value, param) { | ||
1159 | + var reg = /[0-9]+/; | ||
1160 | + if (!reg.test(value)) { | ||
1161 | + return "非数字"; | ||
1162 | + } | ||
1163 | + } | ||
1164 | +}); | ||
1165 | + | ||
1166 | + | ||
1167 | +这样使用这个规则 | ||
1168 | + $("#txt").validate({ | ||
1169 | + required : true, | ||
1170 | + validType : "isNumber" | ||
1171 | + }); | ||
1172 | + | ||
1173 | +``` | ||
1009 | 1174 | ||
1010 | 1175 | ||
1011 | 1176 |
-
Please register or login to post a comment