{{testmodel|json}}45 |
{{example1model|json}}61 |
{{example2model|json}}99 |
{{example13model|json}}133 |
{{example14model|json}}184 |
{{example9model|json}}229 |
{{example20model|json}}261 |
{{example21model|json}}303 |
{{searchSelectAllModel|json}}339 |
{{example10model|json}}390 |
{{example12model|json}}423 |
{{example11model|json}}470 |
{{selectByGroupModel|json}}522 |
{{example5model|json}}578 |
{{example6model|json}}612 |
{{example7model|json}}653 |
{{customFilter|json}}655 |
{{example8model|json}}702 |
{{example16model|json}}738 |
{{example17model|json}}767 |
{{example18model|json}}796 |
{{example19model|json}}837 |
{{disabledModel|json}}881 |
{{selectedToTopModel|json}}919 |
{{stringModel|json}}960 |
{{transclusionModel|json}}1003 |
{{idPropertyModel|json}}1043 |
{{smartButtonTextProviderModel|json}}1083 |
List of allowed attributes, you can find more information about them in the usage examples above.
1112 |Attribute Name | 1116 |Type | 1117 |Description | 1118 |
---|---|---|
1123 | selected-model 1124 | | 1125 |Object / Array | 1126 |The object the will contain the model for the selected items in the dropdown. | 1127 |
1130 | options 1131 | | 1132 |Object / Array | 1133 |The options for the dropdown. | 1134 |
1137 | extra-settings 1138 | | 1139 |Object | 1140 |The settings for the directive, more information about these settings are available below. | 1141 |
1144 | events 1145 | | 1146 |Object | 1147 |Events callbacks, more information below. | 1148 |
1151 | translation-texts 1152 | | 1153 |Object | 1154 |Gives the ability to modify the default texts in the directive. More information below. | 1155 |
1158 | search-filter 1159 | | 1160 |String | 1161 |Uses for settings the search filter from outside the direcrtive. | 1162 |
1165 | disabled 1166 | | 1167 |Boolean | 1168 |Used for disabling the dropdown. | 1169 |
1174 | Available settings that effects the display or behavior of the directive.
1175 |
These setting are set with the "extra-settings" attribute.
1176 |
Property Name | 1181 |Type | 1182 |Default Value | 1183 |Description | 1184 |
---|---|---|---|
dynamicTitle | 1189 |Boolean | 1190 |true | 1191 |Indicates if the text of the button should change when selecting items from the list. | 1192 |
closeOnBlur | 1195 |Boolean | 1196 |true | 1197 |Indicates if the dropdown should close when clicking outside of it's scope. | 1198 |
displayProp | 1201 |String | 1202 |label | 1203 |The name of the property that contains the text for the item. | 1204 |
enableSearch | 1207 |Boolean | 1208 |false | 1209 |Indicated if to show the search input or not. | 1210 |
clearSearchOnClose | 1213 |Boolean | 1214 |false | 1215 |Indicated if to clear the search field when the dropdown has closed. | 1216 |
searchField | 1219 |String | 1220 |"$" | 1221 |Indicates on which field the search should be done | 1222 |
selectionLimit | 1225 |Number | 1226 |0 | 1227 |The max allowed selected items for the list. For more information see the examples above. | 1228 |
showCheckAll | 1231 |Boolean | 1232 |true | 1233 |Indicates if to show the "Check All" item. | 1234 |
showUncheckAll | 1237 |Boolean | 1238 |true | 1239 |Indicates if to show the "Uncheck All" item. | 1240 |
showEnableSearchButton | 1243 |Boolean | 1244 |false | 1245 |Indicates if to show the "Enable search / Disable search" item. | 1246 |
closeOnSelect | 1249 |Boolean | 1250 |false | 1251 |Indicates if to close the dropdown after checking an item on the list. | 1252 |
closeOnDeselect | 1255 |Boolean | 1256 |false | 1257 |Indicates if to close the dropdown after unchecking an item on the list. With selectionLimit = 1 setting this to true does the same as setting closeOnSelect to true. | 1258 |
buttonClasses | 1261 |String | 1262 |btn btn-default | 1263 |The CSS classes that used for setting the style of the button. | 1264 |
1267 | groupBy 1268 | | 1269 |String | 1270 |undefined | 1271 |The name of the property which you like to group by your options. See grouping example. | 1272 |
groupByTextProvider | 1275 |Function | 1276 |angular.noop | 1277 |A callback to a function that provide that name for each group when using groupBy setting. The parameter for the function will be the value of the groupBy property. | 1278 |
scrollable | 1281 |Boolean | 1282 |false | 1283 |Indicates if the dropdown is scrollable, useful if you have a lot of items. | 1284 |
scrollableHeight | 1287 |Number | 1288 |300px | 1289 |Indicates the height of the drop down if the dropdown is scrollable. | 1290 |
smartButtonMaxItems | 1293 |Number | 1294 |0 | 1295 |Manages the "Smart Button Text" feature, defines the maximum amount of items to on the button. | 1296 |
smartButtonTextConverter | 1299 |Function | 1300 |angular.noop | 1301 |Related the "Smart Button Text" feature, if a function provided - it will called with two paramters: The item's text and the original item, the return value will displayed instead of the item's display property. This feature is useful when you want to convert the displayed text into something else. | 1302 |
styleActive | 1305 |Boolean | 1306 |false | 1307 |Indicates if the list items should get a class active applied when they are selected. | 1308 |
keyboardControls | 1311 |Boolean | 1312 |false | 1313 |When activated the dropdown can be used with the keyboard instead of with the mouse. | 1314 |
template | 1317 |String | 1318 |{ {getPropertyForObject(option, settings.displayProp)} } | 1319 |Can be used to modify the appearance of an option in the list, each option is accessible as option. | 1320 |
selectByGroups | 1323 |Array | 1324 |undefined | 1325 |Values of the groupby property that you want to be selectable as group | 1326 |
1329 | checkBoxes 1330 | | 1331 |Boolean | 1332 |false | 1333 |Indicated if to show a normal dropdown with glyphicons or HTML checkboxes. | 1334 |
1337 | selectedToTop 1338 | | 1339 |Boolean | 1340 |false | 1341 |1342 | When true will put the selected options at the top of the list 1343 | | 1344 |
1347 | idProperty 1348 | | 1349 |string | 1350 |undefined | 1351 |1352 | Used to compare by property instead of by reference. 1353 | | 1354 |
Available event callbacks what the directive fires. These callbacks are set with "events" attribute.
1359 |Event Name | 1363 |Parameters | 1364 |Description | 1365 |
---|---|---|
onItemSelect | 1370 |item | 1371 |Fired when selecting an item. | 1372 |
onItemDeselect | 1375 |item | 1376 |Fired when unselecting an item. | 1377 |
onSelectAll | 1380 |1381 | | Fired when clicking select all. | 1382 |
onDeselectAll | 1385 |1386 | | Fired when clicking unselect all. | 1387 |
onInitDone | 1390 |1391 | | Fired when the directive done with the "link" phase. | 1392 |
onMaxSelectionReached | 1395 |1396 | | Fired when the user reaches the max allowed selected items. | 1397 |
onSelectionChanged | 1400 |1401 | | Fired when the selection changes. | 1402 |
Available texts that you can override if you wan't to make a translation for your website. These are set with the "translation-texts" attribute.
1407 |Property Name | 1411 |Default Value | 1412 |Description | 1413 |
---|---|---|
checkAll | 1418 |Check All | 1419 |"Check All" item's text. | 1420 |
uncheckAll | 1423 |Uncheck All | 1424 |"Uncheck All" item's text. | 1425 |
enableSearch | 1428 |Enable search | 1429 |"enable search" item's text. | 1430 |
disableSearch | 1433 |Disable search | 1434 |"disable search" item's text. | 1435 |
selectionCount | 1438 |checked | 1439 |The suffix for "X/Y" that showed when using selection limit. | 1440 |
selectionOf | 1443 |/ | 1444 |The value between the selected values and the max values when using selection limit. | 1445 |
searchPlaceholder | 1448 |Search... | 1449 |The placeholder for the search input. | 1450 |
buttonDefaultText | 1453 |Select | 1454 |The default text that used for the button when no items selected. | 1455 |
dynamicButtonTextSuffix | 1458 |checked | 1459 |The suffix for the button that used when using "dynamicText". | 1460 |
selectGroup | 1463 |Select All: | 1464 |The prefix of the group selection. | 1465 |
List of allowed attributes, you can find more information about them in the usage examples above.
5 |Attribute Name | 9 |Type | 10 |Description | 11 |
---|---|---|
16 | selected-model 17 | | 18 |Object / Array | 19 |The object the will contain the model for the selected items in the dropdown. | 20 |
23 | options 24 | | 25 |Object / Array | 26 |The options for the dropdown. | 27 |
30 | extra-settings 31 | | 32 |Object | 33 |The settings for the directive, more information about these settings are available below. | 34 |
37 | events 38 | | 39 |Object | 40 |Events callbacks, more information below. | 41 |
44 | translation-texts 45 | | 46 |Object | 47 |Gives the ability to modify the default texts in the directive. More information below. | 48 |
51 | group-by 52 | | 53 |String | 54 |The name of the property which you like to group by your options. See grouping example. | 55 |
58 | checkboxes 59 | | 60 |Boolean | 61 |Indicated if to show a normal dropdown with glyphicons or HTML checkboxes. | 62 |
65 | search-filter 66 | | 67 |String | 68 |Uses for settings the search filter from outside the direcrtive. | 69 |
72 | disabled 73 | | 74 |Boolean | 75 |Used for disabling the dropdown. | 76 |
81 | Available settings that effects the display or behavior of the directive.
82 |
These setting are set with the "extra-settings" attribute.
83 |
Property Name | 88 |Type | 89 |Default Value | 90 |Description | 91 |
---|---|---|---|
dynamicTitle | 96 |Boolean | 97 |true | 98 |Indicates if the text of the button should change when selecting items from the list. | 99 |
closeOnBlur | 102 |Boolean | 103 |true | 104 |Indicates if the dropdown should close when clicking outside of it's scope. | 105 |
displayProp | 108 |String | 109 |label | 110 |The name of the property that contains the text for the item. | 111 |
idProp | 114 |String | 115 |id | 116 |The name of the property that contains the id for the elements. | 117 |
externalIdProp | 120 |String | 121 |id | 122 |The name of the property that will use for the selected items model. | 123 |
enableSearch | 126 |Boolean | 127 |false | 128 |Indicated if to show the search input or not. | 129 |
clearSearchOnClose | 132 |Boolean | 133 |false | 134 |Indicated if to clear the search field when the dropdown has closed. | 135 |
searchField | 138 |String | 139 |"$" | 140 |Indicates on which field the search should be done | 141 |
selectionLimit | 144 |Number | 145 |0 | 146 |The max allowed selected items for the list. For more information see the examples above. | 147 |
showCheckAll | 150 |Boolean | 151 |true | 152 |Indicates if to show the "Check All" item. | 153 |
showUncheckAll | 156 |Boolean | 157 |true | 158 |Indicates if to show the "Uncheck All" item. | 159 |
showEnableSearchButton | 162 |Boolean | 163 |false | 164 |Indicates if to show the "Enable search / Disable search" item. | 165 |
closeOnSelect | 168 |Boolean | 169 |false | 170 |Indicates if to close the dropdown after checking an item on the list. | 171 |
closeOnDeselect | 174 |Boolean | 175 |false | 176 |Indicates if to close the dropdown after unchecking an item on the list. With selectionLimit = 1 setting this to true does the same as setting closeOnSelect to true. | 177 |
buttonClasses | 180 |String | 181 |btn btn-default | 182 |The CSS classes that used for setting the style of the button. | 183 |
groupByTextProvider | 186 |Function | 187 |angular.noop | 188 |A callback to a function that provide that name for each group when using group-by attribute. The parameter for the function will be the value of the group-by property. | 189 |
scrollable | 192 |Boolean | 193 |false | 194 |Indicates if the dropdown is scrollable, useful if you have a lot of items. | 195 |
scrollableHeight | 198 |Number | 199 |300px | 200 |Indicates the height of the drop down if the dropdown is scrollable. | 201 |
smartButtonMaxItems | 204 |Number | 205 |0 | 206 |Manages the "Smart Button Text" feature, defines the maximum amount of items to on the button. | 207 |
smartButtonTextConverter | 210 |Function | 211 |angular.noop | 212 |Related the "Smart Button Text" feature, if a function provided - it will called with two paramters: The item's text and the original item, the return value will displayed instead of the item's display property. This feature is useful when you want to convert the displayed text into something else. | 213 |
styleActive | 216 |Boolean | 217 |false | 218 |Indicates if the list items should get a class active applied when they are selected. | 219 |
keyboardControls | 222 |Boolean | 223 |false | 224 |When activated the dropdown can be used with the keyboard instead of with the mouse. | 225 |
template | 228 |String | 229 |{ {getPropertyForObject(option, settings.displayProp)} } | 230 |Can be used to modify the appearance of an option in the list, each option is accessible as option. | 231 |
selectByGroups | 234 |Array | 235 |undefined | 236 |Values of the groupby property that you want to be selectable as group | 237 |
Available event callbacks what the directive fires. These callbacks are set with "events" attribute.
242 |Event Name | 246 |Parameters | 247 |Description | 248 |
---|---|---|
onItemSelect | 253 |item | 254 |Fired when selecting an item. | 255 |
onItemDeselect | 258 |item | 259 |Fired when unselecting an item. | 260 |
onSelectAll | 263 |264 | | Fired when clicking select all. | 265 |
onDeselectAll | 268 |269 | | Fired when clicking unselect all. | 270 |
onInitDone | 273 |274 | | Fired when the directive done with the "link" phase. | 275 |
onMaxSelectionReached | 278 |279 | | Fired when the user reaches the max allowed selected items. | 280 |
onSelectionChanged | 283 |284 | | Fired when the selection changes. | 285 |
Available texts that you can override if you wan't to make a translation for your website. These are set with the "translation-texts" attribute.
290 |Property Name | 294 |Default Value | 295 |Description | 296 |
---|---|---|
checkAll | 301 |Check All | 302 |"Check All" item's text. | 303 |
uncheckAll | 306 |Uncheck All | 307 |"Uncheck All" item's text. | 308 |
enableSearch | 311 |Enable search | 312 |"enable search" item's text. | 313 |
disableSearch | 316 |Disable search | 317 |"disable search" item's text. | 318 |
selectionCount | 321 |checked | 322 |The suffix for "X/Y" that showed when using selection limit. | 323 |
selectionOf | 326 |/ | 327 |The value between the selected values and the max values when using selection limit. | 328 |
searchPlaceholder | 331 |Search... | 332 |The placeholder for the search input. | 333 |
buttonDefaultText | 336 |Select | 337 |The default text that used for the button when no items selected. | 338 |
dynamicButtonTextSuffix | 341 |checked | 342 |The suffix for the button that used when using "dynamicText". | 343 |
selectGroup | 346 |Select All: | 347 |The prefix of the group selection. | 348 |