/* * Paper.js - The Swiss Army Knife of Vector Graphics Scripting. * http://paperjs.org/ * * Copyright (c) 2011 - 2016, Juerg Lehni & Jonathan Puckey * http://scratchdisk.com/ & http://jonathanpuckey.com/ * * Distributed under the MIT license. See LICENSE file for details. * * All rights reserved. */ /** * @name TextItem * * @class The TextItem type allows you to create typography. Its functionality * is inherited by different text item types such as {@link PointText}, and * {@link AreaText} (coming soon). They each add a layer of functionality * that is unique to their type, but share the underlying properties and * functions that they inherit from TextItem. * * @extends Item */ var TextItem = Item.extend(/** @lends TextItem# */{ _class: 'TextItem', _boundsSelected: true, _applyMatrix: false, _canApplyMatrix: false, _serializeFields: { content: null }, // TextItem doesn't make the distinction between the different bounds, // so use the same name for all of them _boundsGetter: 'getBounds', initialize: function TextItem(arg) { this._content = ''; this._lines = []; // Support two forms of item initialization: Passing one object literal // describing all the different properties to be set, or a point where // it should be placed (arg). // See if a point is passed, and if so, pass it on to _initialize(). // If not, it might be a properties object literal. var hasProps = arg && Base.isPlainObject(arg) && arg.x === undefined && arg.y === undefined; this._initialize(hasProps && arg, !hasProps && Point.read(arguments)); }, _equals: function(item) { return this._content === item._content; }, copyContent: function(source) { this.setContent(source._content); }, /** * The text contents of the text item. * * @bean * @type String * * @example {@paperscript} * // Setting the content of a PointText item: * * // Create a point-text item at {x: 30, y: 30}: * var text = new PointText(new Point(30, 30)); * text.fillColor = 'black'; * * // Set the content of the text item: * text.content = 'Hello world'; * * @example {@paperscript} * // Interactive example, move your mouse over the view below: * * // Create a point-text item at {x: 30, y: 30}: * var text = new PointText(new Point(30, 30)); * text.fillColor = 'black'; * * text.content = 'Move your mouse over the view, to see its position'; * * function onMouseMove(event) { * // Each time the mouse is moved, set the content of * // the point text to describe the position of the mouse: * text.content = 'Your position is: ' + event.point.toString(); * } */ getContent: function() { return this._content; }, setContent: function(content) { this._content = '' + content; this._lines = this._content.split(/\r\n|\n|\r/mg); this._changed(/*#=*/Change.CONTENT); }, isEmpty: function() { return !this._content; }, /** * {@grouptitle Character Style} * * The font-family to be used in text content. * * @name TextItem#fontFamily * @type String * @default 'sans-serif' */ /** * * The font-weight to be used in text content. * * @name TextItem#fontWeight * @type String|Number * @default 'normal' */ /** * The font size of text content, as a number in pixels, or as a string with * optional units `'px'`, `'pt'` and `'em'`. * * @name TextItem#fontSize * @type Number|String * @default 10 */ /** * * The font-family to be used in text content, as one string. * @deprecated use {@link #fontFamily} instead. * * @name TextItem#font * @type String * @default 'sans-serif' */ /** * The text leading of text content. * * @name TextItem#leading * @type Number|String * @default fontSize * 1.2 */ /** * {@grouptitle Paragraph Style} * * The justification of text paragraphs. * * @name TextItem#justification * @type String * @values 'left', 'right', 'center' * @default 'left' */ /** * @bean * @private * @deprecated use {@link #getStyle()} instead. */ getCharacterStyle: '#getStyle', setCharacterStyle: '#setStyle', /** * @bean * @private * @deprecated use {@link #getStyle()} instead. */ getParagraphStyle: '#getStyle', setParagraphStyle: '#setStyle' });