summaryrefslogtreecommitdiff
path: root/www/wiki/extensions/SemanticMediaWiki/res/smw/data/ext.smw.dataItem.text.js
blob: 51c92eb4ab34e6bed42580e54f5e4d4a3839feb0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
/**
 * SMW Text DataItem JavaScript representation
 *
 * @see  SMW\DIString, SMW\DIBlob
 *
 * A string is a text representation only limited by its length.
 *
 * @since 1.9
 *
 * @file
 * @ingroup SMW
 *
 * @licence GNU GPL v2 or later
 * @author mwjames
 */
( function( $, mw, smw ) {
	'use strict';

	/**
	 * Inheritance class for the smw.dataItem constructor
	 *
	 * @since 1.9
	 *
	 * @class
	 * @abstract
	 */
	smw.dataItem = smw.dataItem || {};

	/**
	 * Number constructor
	 *
	 * @since  1.9
	 *
	 * @param {string}
	 * @param {string}
	 * @return {this}
	 */
	var text = function ( text, type ) {
		this.text = text !== '' ? text : null;

		// If the type is not specified we assume it has to be '_txt'
		this.type = type !== '' && type !== undefined ? type : '_txt';

		return this;
	};

	/**
	 * Class constructor
	 *
	 * @since 1.9
	 *
	 * @class
	 * @constructor
	 * @extends smw.dataItem
	 */
	smw.dataItem.text = function( text, type ) {
		if ( $.type( text ) === 'string' ) {
			this.constructor( text, type );
		} else {
			throw new Error( 'smw.dataItem.text: invoked text must be a string but is of type ' + $.type( text ) );
		}
	};

	/* Public methods */

	var fn = {

		constructor: text,

		/**
		 * Returns type
		 *
		 * Flexible in what to return as type as it could be either '_str' or
		 * '_txt' but the methods are the same therefore there is no need for
		 * an extra dataItem representing a string
		 *
		 * @since  1.9
		 *
		 * @return {string}
		 */
		getDIType: function() {
			return this.type;
		},

		/**
		 * Returns a plain text representation
		 *
		 * @since  1.9
		 *
		 * @return {string}
		 */
		getText: function() {
			return this.text;
		}
	};

	// Alias
	fn.getValue = fn.getText;
	fn.getString = fn.getText;

	// Assign methods
	smw.dataItem.text.prototype = fn;

} )( jQuery, mediaWiki, semanticMediaWiki );