www.gusucode.com > 一个基于extjs的强大聊天插件源码程序 > 一个基于extjs的强大聊天插件/extjame/ext-jame/js/ext2/source/util/Format.js
/* * Ext JS Library 2.0.2 * Copyright(c) 2006-2008, Ext JS, LLC. * licensing@extjs.com * * http://extjs.com/license */ /** * @class Ext.util.Format * Reusable data formatting functions * @singleton */ Ext.util.Format = function(){ var trimRe = /^\s+|\s+$/g; return { /** * Truncate a string and add an ellipsis ('...') to the end if it exceeds the specified length * @param {String} value The string to truncate * @param {Number} length The maximum length to allow before truncating * @return {String} The converted text */ ellipsis : function(value, len){ if(value && value.length > len){ return value.substr(0, len-3)+"..."; } return value; }, /** * Checks a reference and converts it to empty string if it is undefined * @param {Mixed} value Reference to check * @return {Mixed} Empty string if converted, otherwise the original value */ undef : function(value){ return value !== undefined ? value : ""; }, /** * Checks a reference and converts it to the default value if it's empty * @param {Mixed} value Reference to check * @param {String} defaultValue The value to insert of it's undefined (defaults to "") * @return {String} */ defaultValue : function(value, defaultValue){ return value !== undefined && value !== '' ? value : defaultValue; }, /** * Convert certain characters (&, <, >, and ') to their HTML character equivalents for literal display in web pages. * @param {String} value The string to encode * @return {String} The encoded text */ htmlEncode : function(value){ return !value ? value : String(value).replace(/&/g, "&").replace(/>/g, ">").replace(/</g, "<").replace(/"/g, """); }, /** * Convert certain characters (&, <, >, and ') from their HTML character equivalents. * @param {String} value The string to decode * @return {String} The decoded text */ htmlDecode : function(value){ return !value ? value : String(value).replace(/&/g, "&").replace(/>/g, ">").replace(/</g, "<").replace(/"/g, '"'); }, /** * Trims any whitespace from either side of a string * @param {String} value The text to trim * @return {String} The trimmed text */ trim : function(value){ return String(value).replace(trimRe, ""); }, /** * Returns a substring from within an original string * @param {String} value The original text * @param {Number} start The start index of the substring * @param {Number} length The length of the substring * @return {String} The substring */ substr : function(value, start, length){ return String(value).substr(start, length); }, /** * Converts a string to all lower case letters * @param {String} value The text to convert * @return {String} The converted text */ lowercase : function(value){ return String(value).toLowerCase(); }, /** * Converts a string to all upper case letters * @param {String} value The text to convert * @return {String} The converted text */ uppercase : function(value){ return String(value).toUpperCase(); }, /** * Converts the first character only of a string to upper case * @param {String} value The text to convert * @return {String} The converted text */ capitalize : function(value){ return !value ? value : value.charAt(0).toUpperCase() + value.substr(1).toLowerCase(); }, // private call : function(value, fn){ if(arguments.length > 2){ var args = Array.prototype.slice.call(arguments, 2); args.unshift(value); return eval(fn).apply(window, args); }else{ return eval(fn).call(window, value); } }, /** * Format a number as US currency * @param {Number/String} value The numeric value to format * @return {String} The formatted currency string */ usMoney : function(v){ v = (Math.round((v-0)*100))/100; v = (v == Math.floor(v)) ? v + ".00" : ((v*10 == Math.floor(v*10)) ? v + "0" : v); v = String(v); var ps = v.split('.'); var whole = ps[0]; var sub = ps[1] ? '.'+ ps[1] : '.00'; var r = /(\d+)(\d{3})/; while (r.test(whole)) { whole = whole.replace(r, '$1' + ',' + '$2'); } v = whole + sub; if(v.charAt(0) == '-'){ return '-$' + v.substr(1); } return "$" + v; }, /** * Parse a value into a formatted date using the specified format pattern. * @param {Mixed} value The value to format * @param {String} format (optional) Any valid date format string (defaults to 'm/d/Y') * @return {String} The formatted date string */ date : function(v, format){ if(!v){ return ""; } if(!Ext.isDate(v)){ v = new Date(Date.parse(v)); } return v.dateFormat(format || "m/d/Y"); }, /** * Returns a date rendering function that can be reused to apply a date format multiple times efficiently * @param {String} format Any valid date format string * @return {Function} The date formatting function */ dateRenderer : function(format){ return function(v){ return Ext.util.Format.date(v, format); }; }, // private stripTagsRE : /<\/?[^>]+>/gi, /** * Strips all HTML tags * @param {Mixed} value The text from which to strip tags * @return {String} The stripped text */ stripTags : function(v){ return !v ? v : String(v).replace(this.stripTagsRE, ""); }, stripScriptsRe : /(?:<script.*?>)((\n|\r|.)*?)(?:<\/script>)/ig, /** * Strips all script tags * @param {Mixed} value The text from which to strip script tags * @return {String} The stripped text */ stripScripts : function(v){ return !v ? v : String(v).replace(this.stripScriptsRe, ""); }, /** * Simple format for a file size (xxx bytes, xxx KB, xxx MB) * @param {Number/String} size The numeric value to format * @return {String} The formatted file size */ fileSize : function(size){ if(size < 1024) { return size + " bytes"; } else if(size < 1048576) { return (Math.round(((size*10) / 1024))/10) + " KB"; } else { return (Math.round(((size*10) / 1048576))/10) + " MB"; } }, math : function(){ var fns = {}; return function(v, a){ if(!fns[a]){ fns[a] = new Function('v', 'return v ' + a + ';'); } return fns[a](v); } }() }; }();