Authored by huangping

Update bootstrap-plugin.md

@@ -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&#124;int |是 | undefined |宽度|
  1043 +|height |string&#124;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&#124;array&#124;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