carbon-react
Version:
A library of reusable React components and an interface for easily building user interfaces based on Flux.
417 lines (335 loc) • 11.5 kB
JavaScript
'use strict';
Object.defineProperty(exports, "__esModule", {
value: true
});
var _react2 = require('react');
var _react3 = _interopRequireDefault(_react2);
var _babelTransform = require('livereactload/babel-transform');
var _babelTransform2 = _interopRequireDefault(_babelTransform);
var _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; };
var _createClass = function () { function defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } return function (Constructor, protoProps, staticProps) { if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; }; }();
var _class, _temp2;
var _propTypes = require('prop-types');
var _propTypes2 = _interopRequireDefault(_propTypes);
var _classnames = require('classnames');
var _classnames2 = _interopRequireDefault(_classnames);
var _md = require('crypto-js/md5');
var _md2 = _interopRequireDefault(_md);
var _tags = require('../../utils/helpers/tags');
var _icon = require('./../icon');
var _icon2 = _interopRequireDefault(_icon);
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
function _possibleConstructorReturn(self, call) { if (!self) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return call && (typeof call === "object" || typeof call === "function") ? call : self; }
function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function, not " + typeof superClass); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, enumerable: false, writable: true, configurable: true } }); if (superClass) Object.setPrototypeOf ? Object.setPrototypeOf(subClass, superClass) : subClass.__proto__ = superClass; }
var _components = {
Portrait: {
displayName: 'Portrait'
}
};
var _livereactloadBabelTransform2 = (0, _babelTransform2.default)({
filename: 'src/components/portrait/portrait.js',
components: _components,
locals: [],
imports: [_react3.default]
});
function _wrapComponent(id) {
return function (Component) {
return _livereactloadBabelTransform2(Component, id);
};
}
/**
* A Portrait Widget.
*
* == How to use a Portrait in a component
*
* In your file
*
* import Portrait from 'carbon/lib/components/portrait';
*
* To render the Portrait
*
* <Portrait src='/my-image' alt='my image' />
*
* To render a gravatar portrait
*
* <Portrait gravatar='mygrav@email.com' />
*
* You can pass a 'size' property to adjust the size of the portrait
* The default is lmed
* options: small, smed, lmed, large
*
* For additional properties specific to this component, see propTypes.
*/
var Portrait = _wrapComponent('Portrait')((_temp2 = _class = function (_React$Component) {
_inherits(Portrait, _React$Component);
function Portrait() {
var _ref;
var _temp, _this, _ret;
_classCallCheck(this, Portrait);
for (var _len = arguments.length, args = Array(_len), _key = 0; _key < _len; _key++) {
args[_key] = arguments[_key];
}
return _ret = (_temp = (_this = _possibleConstructorReturn(this, (_ref = Portrait.__proto__ || Object.getPrototypeOf(Portrait)).call.apply(_ref, [this].concat(args))), _this), _this.memoizeInitials = null, _this.applyBackground = function (context, size) {
var color = _this.props.darkBackground ? "#4E545F" : "#D8D9DC";
context.fillStyle = color;
context.fillRect(0, 0, size, size);
return context;
}, _this.applyText = function (context, size) {
var letters = _this.props.initials ? _this.props.initials.slice(0, 3) : "";
context.fillStyle = "#636872";
context.fillText(letters.toUpperCase(), size / 2, size / 1.5);
return context;
}, _temp), _possibleConstructorReturn(_this, _ret);
}
/**
* Cache the initials graphic.
*
* @param memoizeInitials
* @type {String}
*/
_createClass(Portrait, [{
key: 'componentWillReceiveProps',
/**
* @method componentWillReceiveProps
* @param {Object}
* @return {Void}
*/
value: function componentWillReceiveProps(nextProps) {
if (this.props.initials != nextProps.initials || this.props.size != nextProps.size) {
this.memoizeInitials = null;
}
}
/**
* Props for the HTML Img
*
* @method imgSrc
* @return {String}
*/
}, {
key: 'render',
/**
* Renders the component.
*
* @method render
* @return {Object} JSX
*/
value: function render() {
return _react3.default.createElement(
'div',
_extends({ className: this.mainClasses }, (0, _tags.tagComponent)('portrait', this.props)),
this.initialsImage,
this.avatarImage
);
}
}, {
key: 'imgSrc',
get: function get() {
if (this.props.gravatar) {
return this.gravatarSrc;
}
return this.props.src;
}
/**
* Gets src url based on passed gravatar email
*
* @method gravatarSrc
* @return {String}
*/
}, {
key: 'gravatarSrc',
get: function get() {
var base = 'https://www.gravatar.com/avatar/',
hash = (0, _md2.default)(this.props.gravatar.toLowerCase()),
size = this.numericSizes[this.props.size];
return '' + base + hash + '?s=' + size + '&d=blank';
}
/**
* Generates a graphic with initials.
*
* @method generateInitials
* @return {String}
*/
}, {
key: 'generateInitials',
get: function get() {
if (this.memoizeInitials) {
return this.memoizeInitials;
}
var canvas = document.createElement('canvas'),
context = canvas.getContext("2d"),
size = this.numericSizes[this.props.size];
// Set canvas with & height
canvas.width = size;
canvas.height = size;
// Select a font family to support different language characters
// like Arial
context.font = Math.round(canvas.width / 2.4) + "px Lato, Arial";
context.textAlign = "center";
// Setup background and front color
context = this.applyBackground(context, size);
context = this.applyText(context, size);
// Set image representation in default format (png)
var dataURI = canvas.toDataURL();
// Dispose canvas element
canvas = null;
this.memoizeInitials = dataURI;
return this.memoizeInitials;
}
/**
* Applies background to canvas.
*
* @method applyBackground
* @return {Object}
*/
/**
* Applies text to canvas.
*
* @method applyText
* @return {Object}
*/
}, {
key: 'numericSizes',
/**
* Maps size to width/height value
*
* @method numericSizes
* @return {Object}
*/
get: function get() {
var _ref2;
return _ref2 = {}, _defineProperty(_ref2, "extra-small", '26'), _defineProperty(_ref2, 'small', '30'), _defineProperty(_ref2, "medium-small", '50'), _defineProperty(_ref2, 'medium', '60'), _defineProperty(_ref2, "medium-large", '70'), _defineProperty(_ref2, 'large', '100'), _defineProperty(_ref2, "extra-large", '120'), _ref2;
}
/**
* Main Class getter
*
* @method mainClasses
* @return {String} Main className
*/
}, {
key: 'mainClasses',
get: function get() {
return (0, _classnames2.default)('carbon-portrait', 'carbon-portrait--image', 'carbon-portrait--' + this.props.size, 'carbon-portrait--' + this.props.shape, this.props.className);
}
/**
* Return the html for the initials image.
*
* @method initialsImage
* @return {Object}
*/
}, {
key: 'initialsImage',
get: function get() {
// if not using src, generate initials for potential fallback
if (this.props.src) {
return null;
}
if (!this.props.initials) {
return this.sansInitialsImage;
}
return _react3.default.createElement('img', {
'data-element': 'initials',
className: 'carbon-portrait__img carbon-portrait__initials',
src: this.generateInitials,
alt: this.props.alt
});
}
/**
* Return the html for the avatar image.
*
* @method avatarImage
* @return {Object}
*/
}, {
key: 'avatarImage',
get: function get() {
return _react3.default.createElement('img', {
'data-element': 'user-image',
className: 'carbon-portrait__img carbon-portrait__avatar',
src: this.imgSrc,
alt: this.props.alt
});
}
/**
*
* Return the html for the Icon displayed in the event that both the image and initials are missing
*
* @method sansInitialsImage
* @return {Object}
*/
}, {
key: 'sansInitialsImage',
get: function get() {
return _react3.default.createElement(_icon2.default, {
className: 'carbon-portrait__img carbon-portrait__sans-initials',
type: 'individual'
});
}
}]);
return Portrait;
}(_react3.default.Component), _class.propTypes = {
/**
* Size of the img
* Options: small, smed, lmed, large
*
* @property size
* @type {String}
*/
size: _propTypes2.default.string,
/**
* Source of the image
*
* @property src
* @type {String}
*/
src: function src(props) {
if (!props.gravatar && !props.src) {
throw new Error('Portrait requires a prop of \'src\' OR a prop of \'gravatar\'');
} else if (props.gravatar && props.src) {
throw new Error('Portrait requires a prop of \'src\' OR a prop of \'gravatar\' but not both');
}
},
/**
* Gravatar email
*
* @property src
* @type {String}
*/
gravatar: _propTypes2.default.string,
/**
* Alternate text for image
*
* @property src
* @type {String}
*/
alt: _propTypes2.default.string,
/**
* Shape of the portrait
* Options - standard, circle, leaf
*
* @property shape
* @type {String}
*/
shape: _propTypes2.default.string,
/**
* Initials to display as image
*
* @property initials
* @type {String}
* @default 'U'
*/
initials: _propTypes2.default.string,
/**
* If to use a dark background instead of a light background.
*
* @property darkBackground
* @type {Boolean}
* @default false
*/
darkBackground: _propTypes2.default.bool
}, _class.defaultProps = {
size: 'medium',
shape: 'standard'
}, _temp2));
exports.default = Portrait;