properties.js 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113
  1. /**
  2. * A utility that gets and sets properties of model elements.
  3. *
  4. * @param {Model} model
  5. */
  6. export default function Properties(model) {
  7. this.model = model;
  8. }
  9. /**
  10. * Sets a named property on the target element.
  11. * If the value is undefined, the property gets deleted.
  12. *
  13. * @param {Object} target
  14. * @param {String} name
  15. * @param {Object} value
  16. */
  17. Properties.prototype.set = function(target, name, value) {
  18. var property = this.model.getPropertyDescriptor(target, name);
  19. var propertyName = property && property.name;
  20. if (isUndefined(value)) {
  21. // unset the property, if the specified value is undefined;
  22. // delete from $attrs (for extensions) or the target itself
  23. if (property) {
  24. delete target[propertyName];
  25. } else {
  26. delete target.$attrs[name];
  27. }
  28. } else {
  29. // set the property, defining well defined properties on the fly
  30. // or simply updating them in target.$attrs (for extensions)
  31. if (property) {
  32. if (propertyName in target) {
  33. target[propertyName] = value;
  34. } else {
  35. defineProperty(target, property, value);
  36. }
  37. } else {
  38. target.$attrs[name] = value;
  39. }
  40. }
  41. };
  42. /**
  43. * Returns the named property of the given element
  44. *
  45. * @param {Object} target
  46. * @param {String} name
  47. *
  48. * @return {Object}
  49. */
  50. Properties.prototype.get = function(target, name) {
  51. var property = this.model.getPropertyDescriptor(target, name);
  52. if (!property) {
  53. return target.$attrs[name];
  54. }
  55. var propertyName = property.name;
  56. // check if access to collection property and lazily initialize it
  57. if (!target[propertyName] && property.isMany) {
  58. defineProperty(target, property, []);
  59. }
  60. return target[propertyName];
  61. };
  62. /**
  63. * Define a property on the target element
  64. *
  65. * @param {Object} target
  66. * @param {String} name
  67. * @param {Object} options
  68. */
  69. Properties.prototype.define = function(target, name, options) {
  70. Object.defineProperty(target, name, options);
  71. };
  72. /**
  73. * Define the descriptor for an element
  74. */
  75. Properties.prototype.defineDescriptor = function(target, descriptor) {
  76. this.define(target, '$descriptor', { value: descriptor });
  77. };
  78. /**
  79. * Define the model for an element
  80. */
  81. Properties.prototype.defineModel = function(target, model) {
  82. this.define(target, '$model', { value: model });
  83. };
  84. function isUndefined(val) {
  85. return typeof val === 'undefined';
  86. }
  87. function defineProperty(target, property, value) {
  88. Object.defineProperty(target, property.name, {
  89. enumerable: !property.isReference,
  90. writable: true,
  91. value: value,
  92. configurable: true
  93. });
  94. }