Commit | Line | Data |
---|---|---|
685acae4 | 1 | /// crmUi: Sundry UI helpers |
2 | (function (angular, $, _) { | |
3 | ||
f8601d61 TO |
4 | var uidCount = 0; |
5 | ||
685acae4 | 6 | angular.module('crmUi', []) |
030dce01 | 7 | |
0cbed02c | 8 | // example <div crm-ui-accordion crm-title="ts('My Title')" crm-collapsed="true">...content...</div> |
e4f46be0 | 9 | // WISHLIST: crmCollapsed should support two-way/continuous binding |
030dce01 TO |
10 | .directive('crmUiAccordion', function() { |
11 | return { | |
12 | scope: { | |
207819ec | 13 | crmUiAccordion: '=' |
030dce01 | 14 | }, |
207819ec | 15 | template: '<div ng-class="cssClasses"><div class="crm-accordion-header">{{crmUiAccordion.title}} <a crm-ui-help="help" ng-if="help"></a></div><div class="crm-accordion-body" ng-transclude></div></div>', |
030dce01 | 16 | transclude: true, |
0cbed02c TO |
17 | link: function (scope, element, attrs) { |
18 | scope.cssClasses = { | |
207819ec CW |
19 | 'crm-accordion-wrapper': true, |
20 | collapsed: scope.crmUiAccordion.collapsed | |
0cbed02c | 21 | }; |
207819ec CW |
22 | scope.help = null; |
23 | scope.$watch('crmUiAccordion', function(crmUiAccordion) { | |
24 | if (crmUiAccordion && crmUiAccordion.help) { | |
25 | scope.help = crmUiAccordion.help.clone({}, { | |
26 | title: crmUiAccordion.title | |
27 | }); | |
28 | } | |
29 | }); | |
0cbed02c | 30 | } |
030dce01 TO |
31 | }; |
32 | }) | |
33 | ||
69a65adc TO |
34 | // Examples: |
35 | // crmUiAlert({text: 'My text', title: 'My title', type: 'error'}); | |
36 | // crmUiAlert({template: '<a ng-click="ok()">Hello</a>', scope: $scope.$new()}); | |
37 | // var h = crmUiAlert({templateUrl: '~/crmFoo/alert.html', scope: $scope.$new()}); | |
38 | // ... h.close(); ... | |
39 | .service('crmUiAlert', function($compile, $rootScope, $templateRequest, $q) { | |
40 | var count = 0; | |
41 | return function crmUiAlert(params) { | |
42 | var id = 'crmUiAlert_' + (++count); | |
43 | var tpl = null; | |
44 | if (params.templateUrl) { | |
45 | tpl = $templateRequest(params.templateUrl); | |
46 | } | |
47 | else if (params.template) { | |
48 | tpl = params.template; | |
49 | } | |
50 | if (tpl) { | |
51 | params.text = '<div id="' + id + '"></div>'; // temporary stub | |
52 | } | |
53 | var result = CRM.alert(params.text, params.title, params.type, params.options); | |
54 | if (tpl) { | |
55 | $q.when(tpl, function(html) { | |
56 | var scope = params.scope || $rootScope.$new(); | |
57 | var linker = $compile(html); | |
58 | $('#' + id).append($(linker(scope))); | |
59 | }); | |
60 | } | |
61 | return result; | |
62 | }; | |
63 | }) | |
64 | ||
a42344f4 CW |
65 | // Simple wrapper around $.crmDatepicker. |
66 | // example with no time input: <input crm-ui-datepicker="{time: false}" ng-model="myobj.datefield"/> | |
70e7470f | 67 | // example with custom date format: <input crm-ui-datepicker="{date: 'm/d/y'}" ng-model="myobj.datefield"/> |
a42344f4 | 68 | .directive('crmUiDatepicker', function () { |
510d515d TO |
69 | return { |
70 | restrict: 'AE', | |
2f31bc16 | 71 | require: 'ngModel', |
510d515d | 72 | scope: { |
a42344f4 | 73 | crmUiDatepicker: '=' |
510d515d | 74 | }, |
2f31bc16 | 75 | link: function (scope, element, attrs, ngModel) { |
ac5009c1 CW |
76 | ngModel.$render = function () { |
77 | element.val(ngModel.$viewValue).change(); | |
78 | }; | |
79 | ||
a42344f4 CW |
80 | element |
81 | .crmDatepicker(scope.crmUiDatepicker) | |
82 | .on('change', function() { | |
ac5009c1 | 83 | var requiredLength = 19; |
a42344f4 CW |
84 | if (scope.crmUiDatepicker && scope.crmUiDatepicker.time === false) { |
85 | requiredLength = 10; | |
86 | } | |
87 | if (scope.crmUiDatepicker && scope.crmUiDatepicker.date === false) { | |
ac5009c1 | 88 | requiredLength = 8; |
a42344f4 CW |
89 | } |
90 | ngModel.$setValidity('incompleteDateTime', !($(this).val().length && $(this).val().length !== requiredLength)); | |
510d515d | 91 | }); |
510d515d TO |
92 | } |
93 | }; | |
94 | }) | |
95 | ||
c4c69e7b TO |
96 | // Display debug information (if available) |
97 | // For richer DX, checkout Batarang/ng-inspector (Chrome/Safari), or AngScope/ng-inspect (Firefox). | |
98 | // example: <div crm-ui-debug="myobject" /> | |
99 | .directive('crmUiDebug', function ($location) { | |
100 | return { | |
101 | restrict: 'AE', | |
102 | scope: { | |
103 | crmUiDebug: '@' | |
104 | }, | |
105 | template: function() { | |
106 | var args = $location.search(); | |
916f65c0 | 107 | return (args && args.angularDebug) ? '<div crm-ui-accordion=\'{title: ts("Debug (%1)", {1: crmUiDebug}), collapsed: true}\'><pre>{{data|json}}</pre></div>' : ''; |
c4c69e7b TO |
108 | }, |
109 | link: function(scope, element, attrs) { | |
110 | var args = $location.search(); | |
111 | if (args && args.angularDebug) { | |
112 | scope.ts = CRM.ts(null); | |
113 | scope.$parent.$watch(attrs.crmUiDebug, function(data) { | |
114 | scope.data = data; | |
115 | }); | |
116 | } | |
117 | } | |
118 | }; | |
119 | }) | |
120 | ||
489c2674 | 121 | // Display a field/row in a field list |
c4256f35 CW |
122 | // example: <div crm-ui-field="{title: ts('My Field')}"> {{mydata}} </div> |
123 | // example: <div crm-ui-field="{name: 'subform.myfield', title: ts('My Field')}"> <input crm-ui-id="subform.myfield" name="myfield" /> </div> | |
124 | // example: <div crm-ui-field="{name: 'subform.myfield', title: ts('My Field')}"> <input crm-ui-id="subform.myfield" name="myfield" required /> </div> | |
563ba527 | 125 | // example: <div crm-ui-field="{name: 'subform.myfield', title: ts('My Field'), help: hs('help_field_name')}"> {{mydata}} </div> |
3cc9c048 | 126 | .directive('crmUiField', function() { |
489c2674 TO |
127 | // Note: When writing new templates, the "label" position is particular. See/patch "var label" below. |
128 | var templateUrls = { | |
ef5d18a1 TO |
129 | default: '~/crmUi/field.html', |
130 | checkbox: '~/crmUi/field-cb.html' | |
489c2674 TO |
131 | }; |
132 | ||
133 | return { | |
f8601d61 TO |
134 | require: '^crmUiIdScope', |
135 | restrict: 'EA', | |
489c2674 | 136 | scope: { |
d8356d0b | 137 | // {title, name, help, helpFile} |
c4256f35 | 138 | crmUiField: '=' |
489c2674 TO |
139 | }, |
140 | templateUrl: function(tElement, tAttrs){ | |
141 | var layout = tAttrs.crmLayout ? tAttrs.crmLayout : 'default'; | |
142 | return templateUrls[layout]; | |
143 | }, | |
144 | transclude: true, | |
f8601d61 | 145 | link: function (scope, element, attrs, crmUiIdCtrl) { |
489c2674 | 146 | $(element).addClass('crm-section'); |
563ba527 | 147 | scope.help = null; |
dfc2a868 TO |
148 | scope.$watch('crmUiField', function(crmUiField) { |
149 | if (crmUiField && crmUiField.help) { | |
150 | scope.help = crmUiField.help.clone({}, { | |
151 | title: crmUiField.title | |
152 | }); | |
153 | } | |
154 | }); | |
f8601d61 TO |
155 | } |
156 | }; | |
157 | }) | |
158 | ||
159 | // example: <div ng-form="subform" crm-ui-id-scope><label crm-ui-for="subform.foo">Foo:</label><input crm-ui-id="subform.foo" name="foo"/></div> | |
160 | .directive('crmUiId', function () { | |
161 | return { | |
162 | require: '^crmUiIdScope', | |
163 | restrict: 'EA', | |
3cc9c048 TO |
164 | link: { |
165 | pre: function (scope, element, attrs, crmUiIdCtrl) { | |
166 | var id = crmUiIdCtrl.get(attrs.crmUiId); | |
167 | element.attr('id', id); | |
168 | } | |
f8601d61 TO |
169 | } |
170 | }; | |
171 | }) | |
489c2674 | 172 | |
dfc2a868 TO |
173 | // for example, see crmUiHelp |
174 | .service('crmUiHelp', function(){ | |
175 | // example: var h = new FieldHelp({id: 'foo'}); h.open(); | |
176 | function FieldHelp(options) { | |
177 | this.options = options; | |
178 | } | |
179 | angular.extend(FieldHelp.prototype, { | |
180 | get: function(n) { | |
181 | return this.options[n]; | |
182 | }, | |
183 | open: function open() { | |
dfc2a868 TO |
184 | CRM.help(this.options.title, {id: this.options.id, file: this.options.file}); |
185 | }, | |
186 | clone: function clone(options, defaults) { | |
dfc2a868 TO |
187 | return new FieldHelp(angular.extend({}, defaults, this.options, options)); |
188 | } | |
189 | }); | |
190 | ||
563ba527 | 191 | // example: var hs = crmUiHelp({file: 'CRM/Foo/Bar'}); |
dfc2a868 | 192 | return function(defaults){ |
563ba527 TO |
193 | // example: hs('myfield') |
194 | // example: hs({id: 'myfield', title: 'Foo Bar', file: 'Whiz/Bang'}) | |
dfc2a868 TO |
195 | return function(options) { |
196 | if (_.isString(options)) { | |
197 | options = {id: options}; | |
198 | } | |
199 | return new FieldHelp(angular.extend({}, defaults, options)); | |
6dc9d4ca TO |
200 | }; |
201 | }; | |
dfc2a868 TO |
202 | }) |
203 | ||
204 | // Display a help icon | |
9a593827 | 205 | // Example: Use a default *.hlp file |
563ba527 TO |
206 | // scope.hs = crmUiHelp({file: 'Path/To/Help/File'}); |
207 | // HTML: <a crm-ui-help="hs({title:ts('My Field'), id:'my_field'})"> | |
9a593827 | 208 | // Example: Use an explicit *.hlp file |
563ba527 | 209 | // HTML: <a crm-ui-help="hs({title:ts('My Field'), id:'my_field', file:'CRM/Foo/Bar'})"> |
a517b78a CW |
210 | .directive('crmUiHelp', function() { |
211 | return { | |
212 | restrict: 'EA', | |
563ba527 TO |
213 | link: function(scope, element, attrs) { |
214 | setTimeout(function() { | |
215 | var crmUiHelp = scope.$eval(attrs.crmUiHelp); | |
dfc2a868 TO |
216 | var title = crmUiHelp && crmUiHelp.get('title') ? ts('%1 Help', {1: crmUiHelp.get('title')}) : ts('Help'); |
217 | element.attr('title', title); | |
563ba527 | 218 | }, 50); |
dfc2a868 | 219 | |
a517b78a CW |
220 | element |
221 | .addClass('helpicon') | |
a517b78a CW |
222 | .attr('href', '#') |
223 | .on('click', function(e) { | |
224 | e.preventDefault(); | |
563ba527 | 225 | scope.$eval(attrs.crmUiHelp).open(); |
a517b78a CW |
226 | }); |
227 | } | |
228 | }; | |
229 | }) | |
230 | ||
f8601d61 TO |
231 | // example: <div ng-form="subform" crm-ui-id-scope><label crm-ui-for="subform.foo">Foo:</label><input crm-ui-id="subform.foo" name="foo"/></div> |
232 | .directive('crmUiFor', function ($parse, $timeout) { | |
233 | return { | |
234 | require: '^crmUiIdScope', | |
235 | restrict: 'EA', | |
236 | template: '<span ng-class="cssClasses"><span ng-transclude/><span crm-ui-visible="crmIsRequired" class="crm-marker" title="This field is required.">*</span></span>', | |
237 | transclude: true, | |
238 | link: function (scope, element, attrs, crmUiIdCtrl) { | |
239 | scope.crmIsRequired = false; | |
240 | scope.cssClasses = {}; | |
489c2674 | 241 | |
f8601d61 | 242 | if (!attrs.crmUiFor) return; |
489c2674 | 243 | |
f8601d61 TO |
244 | var id = crmUiIdCtrl.get(attrs.crmUiFor); |
245 | element.attr('for', id); | |
246 | var ngModel = null; | |
489c2674 | 247 | |
f8601d61 TO |
248 | var updateCss = function () { |
249 | scope.cssClasses['crm-error'] = !ngModel.$valid && !ngModel.$pristine; | |
250 | }; | |
489c2674 | 251 | |
f8601d61 TO |
252 | // Note: if target element is dynamically generated (eg via ngInclude), then it may not be available |
253 | // immediately for initialization. Use retries/retryDelay to initialize such elements. | |
254 | var init = function (retries, retryDelay) { | |
255 | var input = $('#' + id); | |
4109d03e | 256 | if (input.length === 0) { |
f8601d61 TO |
257 | if (retries) { |
258 | $timeout(function(){ | |
259 | init(retries-1, retryDelay); | |
260 | }, retryDelay); | |
261 | } | |
262 | return; | |
263 | } | |
489c2674 | 264 | |
f8601d61 TO |
265 | var tgtScope = scope;//.$parent; |
266 | if (attrs.crmDepth) { | |
267 | for (var i = attrs.crmDepth; i > 0; i--) { | |
268 | tgtScope = tgtScope.$parent; | |
269 | } | |
270 | } | |
489c2674 | 271 | |
f8601d61 TO |
272 | if (input.attr('ng-required')) { |
273 | scope.crmIsRequired = scope.$parent.$eval(input.attr('ng-required')); | |
274 | scope.$parent.$watch(input.attr('ng-required'), function (isRequired) { | |
275 | scope.crmIsRequired = isRequired; | |
276 | }); | |
277 | } | |
278 | else { | |
f2bad133 | 279 | scope.crmIsRequired = input.prop('required'); |
f8601d61 | 280 | } |
489c2674 | 281 | |
f8601d61 TO |
282 | ngModel = $parse(attrs.crmUiFor)(tgtScope); |
283 | if (ngModel) { | |
284 | ngModel.$viewChangeListeners.push(updateCss); | |
285 | } | |
286 | }; | |
489c2674 | 287 | |
f8601d61 TO |
288 | $timeout(function(){ |
289 | init(3, 100); | |
489c2674 TO |
290 | }); |
291 | } | |
292 | }; | |
293 | }) | |
294 | ||
d376f33e | 295 | // Define a scope in which a name like "subform.foo" maps to a unique ID. |
f8601d61 TO |
296 | // example: <div ng-form="subform" crm-ui-id-scope><label crm-ui-for="subform.foo">Foo:</label><input crm-ui-id="subform.foo" name="foo"/></div> |
297 | .directive('crmUiIdScope', function () { | |
298 | return { | |
299 | restrict: 'EA', | |
300 | scope: {}, | |
301 | controllerAs: 'crmUiIdCtrl', | |
302 | controller: function($scope) { | |
303 | var ids = {}; | |
304 | this.get = function(name) { | |
305 | if (!ids[name]) { | |
306 | ids[name] = "crmUiId_" + (++uidCount); | |
307 | } | |
308 | return ids[name]; | |
f2bad133 | 309 | }; |
f8601d61 TO |
310 | }, |
311 | link: function (scope, element, attrs) {} | |
312 | }; | |
313 | }) | |
314 | ||
d376f33e | 315 | // Display an HTML blurb inside an IFRAME. |
107c5cc7 | 316 | // example: <iframe crm-ui-iframe="getHtmlContent()"></iframe> |
79cf1116 | 317 | // example: <iframe crm-ui-iframe crm-ui-iframe-src="getUrl()"></iframe> |
107c5cc7 TO |
318 | .directive('crmUiIframe', function ($parse) { |
319 | return { | |
320 | scope: { | |
79cf1116 TO |
321 | crmUiIframeSrc: '@', // expression which evaluates to a URL |
322 | crmUiIframe: '@' // expression which evaluates to HTML content | |
107c5cc7 TO |
323 | }, |
324 | link: function (scope, elm, attrs) { | |
325 | var iframe = $(elm)[0]; | |
326 | iframe.setAttribute('width', '100%'); | |
327 | iframe.setAttribute('frameborder', '0'); | |
328 | ||
329 | var refresh = function () { | |
79cf1116 TO |
330 | if (attrs.crmUiIframeSrc) { |
331 | iframe.setAttribute('src', scope.$parent.$eval(attrs.crmUiIframeSrc)); | |
107c5cc7 | 332 | } |
79cf1116 TO |
333 | else { |
334 | var iframeHtml = scope.$parent.$eval(attrs.crmUiIframe); | |
107c5cc7 | 335 | |
79cf1116 TO |
336 | var doc = iframe.document; |
337 | if (iframe.contentDocument) { | |
338 | doc = iframe.contentDocument; | |
339 | } | |
340 | else if (iframe.contentWindow) { | |
341 | doc = iframe.contentWindow.document; | |
342 | } | |
343 | ||
344 | doc.open(); | |
345 | doc.writeln(iframeHtml); | |
346 | doc.close(); | |
347 | } | |
f2bad133 | 348 | }; |
107c5cc7 | 349 | |
02cd9764 CW |
350 | // If the iframe is in a dialog, respond to resize events |
351 | $(elm).parent().on('dialogresize dialogopen', function(e, ui) { | |
352 | $(this).css({padding: '0', margin: '0', overflow: 'hidden'}); | |
353 | iframe.setAttribute('height', '' + $(this).innerHeight() + 'px'); | |
354 | }); | |
355 | ||
107c5cc7 | 356 | scope.$parent.$watch(attrs.crmUiIframe, refresh); |
107c5cc7 TO |
357 | } |
358 | }; | |
359 | }) | |
360 | ||
f8f85764 TO |
361 | // Example: |
362 | // <a ng-click="$broadcast('my-insert-target', 'some new text')>Insert</a> | |
363 | // <textarea crm-ui-insert-rx='my-insert-target'></textarea> | |
f8f85764 TO |
364 | .directive('crmUiInsertRx', function() { |
365 | return { | |
366 | link: function(scope, element, attrs) { | |
367 | scope.$on(attrs.crmUiInsertRx, function(e, tokenName) { | |
c62731c3 TC |
368 | CRM.wysiwyg.insert(element, tokenName); |
369 | $(element).select2('close').select2('val', ''); | |
f91b1c0c | 370 | CRM.wysiwyg.focus(element); |
f8f85764 TO |
371 | }); |
372 | } | |
373 | }; | |
374 | }) | |
375 | ||
d376f33e | 376 | // Define a rich text editor. |
3cc9c048 TO |
377 | // example: <textarea crm-ui-id="myForm.body_html" crm-ui-richtext name="body_html" ng-model="mailing.body_html"></textarea> |
378 | .directive('crmUiRichtext', function ($timeout) { | |
38737af8 TO |
379 | return { |
380 | require: '?ngModel', | |
381 | link: function (scope, elm, attr, ngModel) { | |
65d3e04c | 382 | |
c62731c3 | 383 | var editor = CRM.wysiwyg.create(elm); |
38737af8 TO |
384 | if (!ngModel) { |
385 | return; | |
386 | } | |
387 | ||
07996588 | 388 | if (attr.ngBlur) { |
f91b1c0c CW |
389 | $(elm).on('blur', function() { |
390 | $timeout(function() { | |
07996588 | 391 | scope.$eval(attr.ngBlur); |
d03e0d13 | 392 | }); |
07996588 TO |
393 | }); |
394 | } | |
395 | ||
f91b1c0c | 396 | ngModel.$render = function(value) { |
c63f9bfb CW |
397 | editor.done(function() { |
398 | CRM.wysiwyg.setVal(elm, ngModel.$viewValue); | |
399 | }); | |
38737af8 TO |
400 | }; |
401 | } | |
402 | }; | |
403 | }) | |
404 | ||
d376f33e | 405 | // Display a lock icon (based on a boolean). |
685acae4 | 406 | // example: <a crm-ui-lock binding="mymodel.boolfield"></a> |
407 | // example: <a crm-ui-lock | |
408 | // binding="mymodel.boolfield" | |
409 | // title-locked="ts('Boolfield is locked')" | |
410 | // title-unlocked="ts('Boolfield is unlocked')"></a> | |
411 | .directive('crmUiLock', function ($parse, $rootScope) { | |
412 | var defaultVal = function (defaultValue) { | |
413 | var f = function (scope) { | |
414 | return defaultValue; | |
f2bad133 | 415 | }; |
685acae4 | 416 | f.assign = function (scope, value) { |
417 | // ignore changes | |
f2bad133 | 418 | }; |
685acae4 | 419 | return f; |
420 | }; | |
421 | ||
422 | // like $parse, but accepts a defaultValue in case expr is undefined | |
423 | var parse = function (expr, defaultValue) { | |
424 | return expr ? $parse(expr) : defaultVal(defaultValue); | |
425 | }; | |
426 | ||
427 | return { | |
428 | template: '', | |
429 | link: function (scope, element, attrs) { | |
f2bad133 TO |
430 | var binding = parse(attrs.binding, true); |
431 | var titleLocked = parse(attrs.titleLocked, ts('Locked')); | |
432 | var titleUnlocked = parse(attrs.titleUnlocked, ts('Unlocked')); | |
685acae4 | 433 | |
77ec5a8d | 434 | $(element).addClass('crm-i lock-button'); |
685acae4 | 435 | var refresh = function () { |
436 | var locked = binding(scope); | |
437 | if (locked) { | |
438 | $(element) | |
77ec5a8d AH |
439 | .removeClass('fa-unlock') |
440 | .addClass('fa-lock') | |
685acae4 | 441 | .prop('title', titleLocked(scope)) |
442 | ; | |
443 | } | |
444 | else { | |
445 | $(element) | |
77ec5a8d AH |
446 | .removeClass('fa-lock') |
447 | .addClass('fa-unlock') | |
685acae4 | 448 | .prop('title', titleUnlocked(scope)) |
449 | ; | |
450 | } | |
451 | }; | |
452 | ||
453 | $(element).click(function () { | |
454 | binding.assign(scope, !binding(scope)); | |
455 | //scope.$digest(); | |
456 | $rootScope.$digest(); | |
457 | }); | |
458 | ||
459 | scope.$watch(attrs.binding, refresh); | |
460 | scope.$watch(attrs.titleLocked, refresh); | |
461 | scope.$watch(attrs.titleUnlocked, refresh); | |
462 | ||
463 | refresh(); | |
464 | } | |
465 | }; | |
466 | }) | |
030dce01 | 467 | |
b21c9cdc TO |
468 | // CrmUiOrderCtrl is a controller class which manages sort orderings. |
469 | // Ex: | |
470 | // JS: $scope.myOrder = new CrmUiOrderCtrl(['+field1', '-field2]); | |
471 | // $scope.myOrder.toggle('field1'); | |
472 | // $scope.myOrder.setDir('field2', ''); | |
473 | // HTML: <tr ng-repeat="... | order:myOrder.get()">...</tr> | |
474 | .service('CrmUiOrderCtrl', function(){ | |
475 | // | |
476 | function CrmUiOrderCtrl(defaults){ | |
477 | this.values = defaults; | |
478 | } | |
479 | angular.extend(CrmUiOrderCtrl.prototype, { | |
480 | get: function get() { | |
481 | return this.values; | |
482 | }, | |
483 | getDir: function getDir(name) { | |
484 | if (this.values.indexOf(name) >= 0 || this.values.indexOf('+' + name) >= 0) { | |
485 | return '+'; | |
486 | } | |
487 | if (this.values.indexOf('-' + name) >= 0) { | |
488 | return '-'; | |
489 | } | |
490 | return ''; | |
491 | }, | |
492 | // @return bool TRUE if something is removed | |
493 | remove: function remove(name) { | |
494 | var idx = this.values.indexOf(name); | |
495 | if (idx >= 0) { | |
496 | this.values.splice(idx, 1); | |
497 | return true; | |
498 | } | |
499 | else { | |
500 | return false; | |
501 | } | |
502 | }, | |
503 | setDir: function setDir(name, dir) { | |
504 | return this.toggle(name, dir); | |
505 | }, | |
506 | // Toggle sort order on a field. | |
507 | // To set a specific order, pass optional parameter 'next' ('+', '-', or ''). | |
508 | toggle: function toggle(name, next) { | |
509 | if (!next && next !== '') { | |
510 | next = '+'; | |
511 | if (this.remove(name) || this.remove('+' + name)) { | |
512 | next = '-'; | |
513 | } | |
514 | if (this.remove('-' + name)) { | |
515 | next = ''; | |
516 | } | |
517 | } | |
518 | ||
519 | if (next == '+') { | |
520 | this.values.unshift('+' + name); | |
521 | } | |
522 | else if (next == '-') { | |
523 | this.values.unshift('-' + name); | |
524 | } | |
525 | } | |
526 | }); | |
527 | return CrmUiOrderCtrl; | |
528 | }) | |
529 | ||
530 | // Define a controller which manages sort order. You may interact with the controller | |
531 | // directly ("myOrder.toggle('fieldname')") order using the helper, crm-ui-order-by. | |
532 | // example: | |
533 | // <span crm-ui-order="{var: 'myOrder', defaults: {'-myField'}}"></span> | |
534 | // <th><a crm-ui-order-by="[myOrder,'myField']">My Field</a></th> | |
535 | // <tr ng-repeat="... | order:myOrder.get()">...</tr> | |
536 | // <button ng-click="myOrder.toggle('myField')"> | |
537 | .directive('crmUiOrder', function(CrmUiOrderCtrl) { | |
538 | return { | |
539 | link: function(scope, element, attrs){ | |
540 | var options = angular.extend({var: 'crmUiOrderBy'}, scope.$eval(attrs.crmUiOrder)); | |
541 | scope[options.var] = new CrmUiOrderCtrl(options.defaults); | |
542 | } | |
543 | }; | |
544 | }) | |
545 | ||
546 | // For usage, see crmUiOrder (above) | |
547 | .directive('crmUiOrderBy', function() { | |
548 | return { | |
549 | link: function(scope, element, attrs) { | |
550 | function updateClass(crmUiOrderCtrl, name) { | |
551 | var dir = crmUiOrderCtrl.getDir(name); | |
552 | element | |
553 | .toggleClass('sorting_asc', dir === '+') | |
554 | .toggleClass('sorting_desc', dir === '-') | |
555 | .toggleClass('sorting', dir === ''); | |
556 | } | |
557 | ||
558 | element.on('click', function(e){ | |
559 | var tgt = scope.$eval(attrs.crmUiOrderBy); | |
560 | tgt[0].toggle(tgt[1]); | |
561 | updateClass(tgt[0], tgt[1]); | |
562 | e.preventDefault(); | |
563 | scope.$digest(); | |
564 | }); | |
565 | ||
566 | var tgt = scope.$eval(attrs.crmUiOrderBy); | |
567 | updateClass(tgt[0], tgt[1]); | |
568 | } | |
569 | }; | |
570 | }) | |
571 | ||
d376f33e | 572 | // Display a fancy SELECT (based on select2). |
ebfe3efb TO |
573 | // usage: <select crm-ui-select="{placeholder:'Something',allowClear:true,...}" ng-model="myobj.field"><option...></select> |
574 | .directive('crmUiSelect', function ($parse, $timeout) { | |
8c632f2b | 575 | return { |
ebfe3efb | 576 | require: '?ngModel', |
8c632f2b | 577 | scope: { |
8674b5ac | 578 | crmUiSelect: '=' |
8c632f2b | 579 | }, |
ebfe3efb | 580 | link: function (scope, element, attrs, ngModel) { |
8c632f2b TO |
581 | // In cases where UI initiates update, there may be an extra |
582 | // call to refreshUI, but it doesn't create a cycle. | |
583 | ||
c81696a6 CW |
584 | if (ngModel) { |
585 | ngModel.$render = function () { | |
586 | $timeout(function () { | |
587 | // ex: msg_template_id adds new item then selects it; use $timeout to ensure that | |
588 | // new item is added before selection is made | |
589 | element.select2('val', ngModel.$viewValue); | |
590 | }); | |
591 | }; | |
592 | } | |
8c632f2b | 593 | function refreshModel() { |
50e25421 | 594 | var oldValue = ngModel.$viewValue, newValue = element.select2('val'); |
8c632f2b | 595 | if (oldValue != newValue) { |
ebfe3efb TO |
596 | scope.$parent.$apply(function () { |
597 | ngModel.$setViewValue(newValue); | |
8c632f2b | 598 | }); |
8c632f2b TO |
599 | } |
600 | } | |
ebfe3efb | 601 | |
8c632f2b TO |
602 | function init() { |
603 | // TODO watch select2-options | |
8c3a97ed | 604 | element.crmSelect2(scope.crmUiSelect || {}); |
c81696a6 CW |
605 | if (ngModel) { |
606 | element.on('change', refreshModel); | |
607 | $timeout(ngModel.$render); | |
608 | } | |
8099bfee CW |
609 | } |
610 | ||
611 | init(); | |
612 | } | |
613 | }; | |
614 | }) | |
615 | ||
616 | // Render a crmEntityRef widget | |
617 | // usage: <input crm-entityref="{entity: 'Contact', select: {allowClear:true}}" ng-model="myobj.field" /> | |
618 | .directive('crmEntityref', function ($parse, $timeout) { | |
619 | return { | |
620 | require: '?ngModel', | |
621 | scope: { | |
622 | crmEntityref: '=' | |
623 | }, | |
624 | link: function (scope, element, attrs, ngModel) { | |
625 | // In cases where UI initiates update, there may be an extra | |
626 | // call to refreshUI, but it doesn't create a cycle. | |
627 | ||
628 | ngModel.$render = function () { | |
629 | $timeout(function () { | |
630 | // ex: msg_template_id adds new item then selects it; use $timeout to ensure that | |
631 | // new item is added before selection is made | |
632 | element.select2('val', ngModel.$viewValue); | |
633 | }); | |
634 | }; | |
635 | function refreshModel() { | |
636 | var oldValue = ngModel.$viewValue, newValue = element.select2('val'); | |
637 | if (oldValue != newValue) { | |
638 | scope.$parent.$apply(function () { | |
639 | ngModel.$setViewValue(newValue); | |
640 | }); | |
641 | } | |
642 | } | |
643 | ||
644 | function init() { | |
8099bfee CW |
645 | // TODO can we infer "entity" from model? |
646 | element.crmEntityRef(scope.crmEntityref || {}); | |
647 | element.on('change', refreshModel); | |
648 | $timeout(ngModel.$render); | |
8c632f2b | 649 | } |
ebfe3efb | 650 | |
8c632f2b TO |
651 | init(); |
652 | } | |
653 | }; | |
654 | }) | |
655 | ||
b1f92f72 | 656 | // example <div crm-ui-tab id="tab-1" crm-title="ts('My Title')" count="3">...content...</div> |
5f3568fd | 657 | // WISHLIST: use a full Angular component instead of an incomplete jQuery wrapper |
030dce01 TO |
658 | .directive('crmUiTab', function($parse) { |
659 | return { | |
5f3568fd TO |
660 | require: '^crmUiTabSet', |
661 | restrict: 'EA', | |
030dce01 | 662 | scope: { |
5f3568fd | 663 | crmTitle: '@', |
cf500087 | 664 | crmIcon: '@', |
b1f92f72 | 665 | count: '@', |
5f3568fd | 666 | id: '@' |
030dce01 | 667 | }, |
5f3568fd | 668 | template: '<div ng-transclude></div>', |
030dce01 | 669 | transclude: true, |
5f3568fd TO |
670 | link: function (scope, element, attrs, crmUiTabSetCtrl) { |
671 | crmUiTabSetCtrl.add(scope); | |
672 | } | |
030dce01 TO |
673 | }; |
674 | }) | |
675 | ||
676 | // example: <div crm-ui-tab-set><div crm-ui-tab crm-title="Tab 1">...</div><div crm-ui-tab crm-title="Tab 2">...</div></div> | |
677 | .directive('crmUiTabSet', function() { | |
678 | return { | |
5f3568fd TO |
679 | restrict: 'EA', |
680 | scope: { | |
681 | crmUiTabSet: '@' | |
682 | }, | |
ef5d18a1 | 683 | templateUrl: '~/crmUi/tabset.html', |
030dce01 | 684 | transclude: true, |
5f3568fd TO |
685 | controllerAs: 'crmUiTabSetCtrl', |
686 | controller: function($scope, $parse) { | |
687 | var tabs = $scope.tabs = []; // array<$scope> | |
688 | this.add = function(tab) { | |
689 | if (!tab.id) throw "Tab is missing 'id'"; | |
690 | tabs.push(tab); | |
691 | }; | |
692 | }, | |
030dce01 TO |
693 | link: function (scope, element, attrs) {} |
694 | }; | |
695 | }) | |
696 | ||
d376f33e | 697 | // Generic, field-independent form validator. |
3afb86ef TO |
698 | // example: <span ng-model="placeholder" crm-ui-validate="foo && bar || whiz" /> |
699 | // example: <span ng-model="placeholder" crm-ui-validate="foo && bar || whiz" crm-ui-validate-name="myError" /> | |
3afb86ef TO |
700 | .directive('crmUiValidate', function() { |
701 | return { | |
702 | restrict: 'EA', | |
703 | require: 'ngModel', | |
704 | link: function(scope, element, attrs, ngModel) { | |
705 | var validationKey = attrs.crmUiValidateName ? attrs.crmUiValidateName : 'crmUiValidate'; | |
706 | scope.$watch(attrs.crmUiValidate, function(newValue){ | |
707 | ngModel.$setValidity(validationKey, !!newValue); | |
708 | }); | |
709 | } | |
710 | }; | |
711 | }) | |
712 | ||
e84a11d8 TO |
713 | // like ng-show, but hides/displays elements using "visibility" which maintains positioning |
714 | // example <div crm-ui-visible="false">...content...</div> | |
715 | .directive('crmUiVisible', function($parse) { | |
716 | return { | |
717 | restrict: 'EA', | |
718 | scope: { | |
719 | crmUiVisible: '@' | |
720 | }, | |
721 | link: function (scope, element, attrs) { | |
722 | var model = $parse(attrs.crmUiVisible); | |
723 | function updatecChildren() { | |
724 | element.css('visibility', model(scope.$parent) ? 'inherit' : 'hidden'); | |
725 | } | |
726 | updatecChildren(); | |
727 | scope.$parent.$watch(attrs.crmUiVisible, updatecChildren); | |
728 | } | |
729 | }; | |
730 | }) | |
731 | ||
6717e4b9 TO |
732 | // example: <div crm-ui-wizard="myWizardCtrl"><div crm-ui-wizard-step crm-title="ts('Step 1')">...</div><div crm-ui-wizard-step crm-title="ts('Step 2')">...</div></div> |
733 | // Note: "myWizardCtrl" has various actions/properties like next() and $first(). | |
734 | // WISHLIST: Allow each step to determine if it is "complete" / "valid" / "selectable" | |
735 | // WISHLIST: Allow each step to enable/disable (show/hide) itself | |
030dce01 TO |
736 | .directive('crmUiWizard', function() { |
737 | return { | |
6717e4b9 TO |
738 | restrict: 'EA', |
739 | scope: { | |
740 | crmUiWizard: '@' | |
741 | }, | |
ef5d18a1 | 742 | templateUrl: '~/crmUi/wizard.html', |
030dce01 | 743 | transclude: true, |
6717e4b9 TO |
744 | controllerAs: 'crmUiWizardCtrl', |
745 | controller: function($scope, $parse) { | |
746 | var steps = $scope.steps = []; // array<$scope> | |
747 | var crmUiWizardCtrl = this; | |
748 | var maxVisited = 0; | |
749 | var selectedIndex = null; | |
750 | ||
751 | var findIndex = function() { | |
752 | var found = null; | |
753 | angular.forEach(steps, function(step, stepKey) { | |
754 | if (step.selected) found = stepKey; | |
755 | }); | |
756 | return found; | |
757 | }; | |
758 | ||
759 | /// @return int the index of the current step | |
760 | this.$index = function() { return selectedIndex; }; | |
761 | /// @return bool whether the currentstep is first | |
762 | this.$first = function() { return this.$index() === 0; }; | |
763 | /// @return bool whether the current step is last | |
764 | this.$last = function() { return this.$index() === steps.length -1; }; | |
f2bad133 | 765 | this.$maxVisit = function() { return maxVisited; }; |
3f0da451 | 766 | this.$validStep = function() { |
f8c05c87 | 767 | return steps[selectedIndex] && steps[selectedIndex].isStepValid(); |
3f0da451 | 768 | }; |
6717e4b9 TO |
769 | this.iconFor = function(index) { |
770 | if (index < this.$index()) return '√'; | |
771 | if (index === this.$index()) return '»'; | |
772 | return ' '; | |
f2bad133 | 773 | }; |
6717e4b9 TO |
774 | this.isSelectable = function(step) { |
775 | if (step.selected) return false; | |
776 | var result = false; | |
777 | angular.forEach(steps, function(otherStep, otherKey) { | |
778 | if (step === otherStep && otherKey <= maxVisited) result = true; | |
779 | }); | |
780 | return result; | |
781 | }; | |
782 | ||
783 | /*** @param Object step the $scope of the step */ | |
784 | this.select = function(step) { | |
785 | angular.forEach(steps, function(otherStep, otherKey) { | |
786 | otherStep.selected = (otherStep === step); | |
787 | if (otherStep === step && maxVisited < otherKey) maxVisited = otherKey; | |
788 | }); | |
789 | selectedIndex = findIndex(); | |
790 | }; | |
791 | /*** @param Object step the $scope of the step */ | |
792 | this.add = function(step) { | |
793 | if (steps.length === 0) { | |
794 | step.selected = true; | |
795 | selectedIndex = 0; | |
796 | } | |
797 | steps.push(step); | |
8688b463 TO |
798 | steps.sort(function(a,b){ |
799 | return a.crmUiWizardStep - b.crmUiWizardStep; | |
800 | }); | |
801 | selectedIndex = findIndex(); | |
802 | }; | |
803 | this.remove = function(step) { | |
804 | var key = null; | |
805 | angular.forEach(steps, function(otherStep, otherKey) { | |
806 | if (otherStep === step) key = otherKey; | |
807 | }); | |
4109d03e | 808 | if (key !== null) { |
8688b463 TO |
809 | steps.splice(key, 1); |
810 | } | |
6717e4b9 TO |
811 | }; |
812 | this.goto = function(index) { | |
813 | if (index < 0) index = 0; | |
814 | if (index >= steps.length) index = steps.length-1; | |
815 | this.select(steps[index]); | |
816 | }; | |
817 | this.previous = function() { this.goto(this.$index()-1); }; | |
818 | this.next = function() { this.goto(this.$index()+1); }; | |
819 | if ($scope.crmUiWizard) { | |
f2bad133 | 820 | $parse($scope.crmUiWizard).assign($scope.$parent, this); |
6717e4b9 TO |
821 | } |
822 | }, | |
c4991710 TO |
823 | link: function (scope, element, attrs) { |
824 | scope.ts = CRM.ts(null); | |
825 | } | |
030dce01 TO |
826 | }; |
827 | }) | |
828 | ||
6717e4b9 TO |
829 | // Use this to add extra markup to wizard |
830 | .directive('crmUiWizardButtons', function() { | |
030dce01 | 831 | return { |
6717e4b9 TO |
832 | require: '^crmUiWizard', |
833 | restrict: 'EA', | |
834 | scope: {}, | |
835 | template: '<span ng-transclude></span>', | |
030dce01 | 836 | transclude: true, |
6717e4b9 TO |
837 | link: function (scope, element, attrs, crmUiWizardCtrl) { |
838 | var realButtonsEl = $(element).closest('.crm-wizard').find('.crm-wizard-buttons'); | |
839 | $(element).appendTo(realButtonsEl); | |
840 | } | |
030dce01 TO |
841 | }; |
842 | }) | |
843 | ||
77ec5a8d AH |
844 | // Example for Font Awesome: <button crm-icon="fa-check">Save</button> |
845 | // Example for jQuery UI (deprecated): <button crm-icon="check">Save</button> | |
39f4f54f CW |
846 | .directive('crmIcon', function() { |
847 | return { | |
848 | restrict: 'EA', | |
39f4f54f | 849 | link: function (scope, element, attrs) { |
cf500087 CW |
850 | if (element.is('[crm-ui-tab]')) { |
851 | // handled in crmUiTab ctrl | |
852 | return; | |
853 | } | |
aee84611 AH |
854 | if (attrs.crmIcon.substring(0,3) == 'fa-') { |
855 | $(element).prepend('<i class="crm-i ' + attrs.crmIcon + '"></i> '); | |
856 | } | |
857 | else { | |
858 | $(element).prepend('<span class="icon ui-icon-' + attrs.crmIcon + '"></span> '); | |
859 | } | |
39f4f54f CW |
860 | if ($(element).is('button')) { |
861 | $(element).addClass('crm-button'); | |
862 | } | |
863 | } | |
864 | }; | |
865 | }) | |
866 | ||
3f0da451 | 867 | // example: <div crm-ui-wizard-step crm-title="ts('My Title')" ng-form="mySubForm">...content...</div> |
8688b463 TO |
868 | // If there are any conditional steps, then be sure to set a weight explicitly on *all* steps to maintain ordering. |
869 | // example: <div crm-ui-wizard-step="100" crm-title="..." ng-if="...">...content...</div> | |
030dce01 | 870 | .directive('crmUiWizardStep', function() { |
8688b463 | 871 | var nextWeight = 1; |
030dce01 | 872 | return { |
3f0da451 | 873 | require: ['^crmUiWizard', 'form'], |
6717e4b9 | 874 | restrict: 'EA', |
030dce01 | 875 | scope: { |
8688b463 TO |
876 | crmTitle: '@', // expression, evaluates to a printable string |
877 | crmUiWizardStep: '@' // int, a weight which determines the ordering of the steps | |
030dce01 | 878 | }, |
6717e4b9 | 879 | template: '<div class="crm-wizard-step" ng-show="selected" ng-transclude/></div>', |
030dce01 | 880 | transclude: true, |
3f0da451 TO |
881 | link: function (scope, element, attrs, ctrls) { |
882 | var crmUiWizardCtrl = ctrls[0], form = ctrls[1]; | |
8688b463 TO |
883 | if (scope.crmUiWizardStep) { |
884 | scope.crmUiWizardStep = parseInt(scope.crmUiWizardStep); | |
885 | } else { | |
886 | scope.crmUiWizardStep = nextWeight++; | |
887 | } | |
3f0da451 TO |
888 | scope.isStepValid = function() { |
889 | return form.$valid; | |
890 | }; | |
6717e4b9 | 891 | crmUiWizardCtrl.add(scope); |
8688b463 TO |
892 | element.on('$destroy', function(){ |
893 | crmUiWizardCtrl.remove(scope); | |
894 | }); | |
6717e4b9 | 895 | } |
030dce01 TO |
896 | }; |
897 | }) | |
898 | ||
5fb5b3cf | 899 | // Example: <button crm-confirm="{message: ts('Are you sure you want to continue?')}" on-yes="frobnicate(123)">Frobincate</button> |
4b8c8b42 | 900 | // Example: <button crm-confirm="{type: 'disable', obj: myObject}" on-yes="myObject.is_active=0; myObject.save()">Disable</button> |
6a6d0f41 TO |
901 | // Example: <button crm-confirm="{templateUrl: '~/path/to/view.html', export: {foo: bar}}" on-yes="frobnicate(123)">Frobincate</button> |
902 | .directive('crmConfirm', function ($compile, $rootScope, $templateRequest, $q) { | |
88fcc9f1 | 903 | // Helpers to calculate default options for CRM.confirm() |
4b8c8b42 TO |
904 | var defaultFuncs = { |
905 | 'disable': function (options) { | |
906 | return { | |
907 | message: ts('Are you sure you want to disable this?'), | |
908 | options: {no: ts('Cancel'), yes: ts('Disable')}, | |
909 | width: 300, | |
910 | title: ts('Disable %1?', { | |
911 | 1: options.obj.title || options.obj.label || options.obj.name || ts('the record') | |
912 | }) | |
913 | }; | |
914 | }, | |
470a458e TO |
915 | 'revert': function (options) { |
916 | return { | |
917 | message: ts('Are you sure you want to revert this?'), | |
918 | options: {no: ts('Cancel'), yes: ts('Revert')}, | |
919 | width: 300, | |
920 | title: ts('Revert %1?', { | |
921 | 1: options.obj.title || options.obj.label || options.obj.name || ts('the record') | |
922 | }) | |
923 | }; | |
924 | }, | |
4b8c8b42 TO |
925 | 'delete': function (options) { |
926 | return { | |
927 | message: ts('Are you sure you want to delete this?'), | |
928 | options: {no: ts('Cancel'), yes: ts('Delete')}, | |
929 | width: 300, | |
930 | title: ts('Delete %1?', { | |
931 | 1: options.obj.title || options.obj.label || options.obj.name || ts('the record') | |
932 | }) | |
933 | }; | |
934 | } | |
935 | }; | |
6a6d0f41 | 936 | var confirmCount = 0; |
4b8c8b42 | 937 | return { |
4b8c8b42 TO |
938 | link: function (scope, element, attrs) { |
939 | $(element).click(function () { | |
f2bad133 | 940 | var options = scope.$eval(attrs.crmConfirm); |
b8603a6d CW |
941 | if (attrs.title && !options.title) { |
942 | options.title = attrs.title; | |
943 | } | |
4b8c8b42 | 944 | var defaults = (options.type) ? defaultFuncs[options.type](options) : {}; |
6a6d0f41 TO |
945 | |
946 | var tpl = null, stubId = null; | |
947 | if (!options.message) { | |
948 | if (options.templateUrl) { | |
949 | tpl = $templateRequest(options.templateUrl); | |
950 | } | |
951 | else if (options.template) { | |
952 | tpl = options.template; | |
953 | } | |
954 | if (tpl) { | |
955 | stubId = 'crmUiConfirm_' + (++confirmCount); | |
956 | options.message = '<div id="' + stubId + '"></div>'; | |
957 | } | |
958 | } | |
959 | ||
4b8c8b42 | 960 | CRM.confirm(_.extend(defaults, options)) |
6a6d0f41 TO |
961 | .on('crmConfirm:yes', function() { scope.$apply(attrs.onYes); }) |
962 | .on('crmConfirm:no', function() { scope.$apply(attrs.onNo); }); | |
963 | ||
964 | if (tpl && stubId) { | |
965 | $q.when(tpl, function(html) { | |
966 | var scope = options.scope || $rootScope.$new(); | |
967 | if (options.export) { | |
968 | angular.extend(scope, options.export); | |
969 | } | |
970 | var linker = $compile(html); | |
971 | $('#' + stubId).append($(linker(scope))); | |
972 | }); | |
973 | } | |
4b8c8b42 TO |
974 | }); |
975 | } | |
976 | }; | |
977 | }) | |
02308c07 TO |
978 | .run(function($rootScope, $location) { |
979 | /// Example: <button ng-click="goto('home')">Go home!</button> | |
980 | $rootScope.goto = function(path) { | |
981 | $location.path(path); | |
982 | }; | |
4b8c8b42 | 983 | // useful for debugging: $rootScope.log = console.log || function() {}; |
02308c07 | 984 | }) |
685acae4 | 985 | ; |
986 | ||
5fb5b3cf | 987 | })(angular, CRM.$, CRM._); |