openhab2_tizen/lib/tau/wearable/js/tau.js

46158 lines
1.3 MiB
JavaScript
Raw Normal View History

2019-04-07 14:49:51 +02:00
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
(function(window, document, undefined) {
'use strict';
var ns = window.tau = window.tau || {},
nsConfig = window.tauConfig = window.tauConfig || {};
nsConfig.rootNamespace = 'tau';
nsConfig.fileName = 'tau';
ns.version = '0.13.46';
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global window, define */
/* eslint-disable no-console */
/**
* #Core namespace
* Object contains main framework methods.
* @class ns
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function (document, console) {
"use strict";
var idNumberCounter = 0,
currentDate = +new Date(),
slice = [].slice,
rootNamespace = "",
fileName = "",
infoForLog = function (args) {
var dateNow = new Date();
args.unshift("[" + rootNamespace + "][" + dateNow.toLocaleString() + "]");
},
ns = window.ns || window.tau || {},
nsConfig = window.nsConfig || window.tauConfig || {};
ns.info = ns.info || {
profile: "custom"
};
ns.tauPerf = ns.tauPerf || {};
window.ns = ns;
window.nsConfig = nsConfig;
window.tau = ns;
window.tauConfig = nsConfig;
rootNamespace = nsConfig.rootNamespace;
fileName = nsConfig.fileName;
/**
* Return unique id
* @method getUniqueId
* @static
* @return {string}
* @member ns
*/
ns.getUniqueId = function () {
return rootNamespace + "-" + ns.getNumberUniqueId() + "-" + currentDate;
};
/**
* Return unique id
* @method getNumberUniqueId
* @static
* @return {number}
* @member ns
*/
ns.getNumberUniqueId = function () {
return idNumberCounter++;
};
/**
* logs supplied messages/arguments
* @method log
* @static
* @member ns
*/
ns.log = function () {
var args = slice.call(arguments);
infoForLog(args);
if (console) {
console.log.apply(console, args);
}
};
/**
* logs supplied messages/arguments ad marks it as warning
* @method warn
* @static
* @member ns
*/
ns.warn = function () {
var args = slice.call(arguments);
infoForLog(args);
if (console) {
console.warn.apply(console, args);
}
};
/**
* logs supplied messages/arguments and marks it as error
* @method error
* @static
* @member ns
*/
ns.error = function () {
var args = slice.call(arguments);
infoForLog(args);
if (console) {
console.error.apply(console, args);
}
};
/**
* get from nsConfig
* @method getConfig
* @param {string} key
* @param {*} [defaultValue] value returned when config is not set
* @return {*}
* @static
* @member ns
*/
ns.getConfig = function (key, defaultValue) {
return nsConfig[key] === undefined ? defaultValue : nsConfig[key];
};
/**
* set in nsConfig
* @method setConfig
* @param {string} key
* @param {*} value
* @param {boolean} [asDefault=false] value should be treated as default (doesn't overwrites
* the config[key] if it already exists)
* @static
* @member ns
*/
ns.setConfig = function (key, value, asDefault) {
if (!asDefault || nsConfig[key] === undefined) {
nsConfig[key] = value;
}
};
/**
* Return path for framework script file.
* @method getFrameworkPath
* @return {?string}
* @member ns
*/
ns.getFrameworkPath = function () {
var scripts = document.getElementsByTagName("script"),
countScripts = scripts.length,
i,
url,
arrayUrl,
count;
for (i = 0; i < countScripts; i++) {
url = scripts[i].src;
arrayUrl = url.split("/");
count = arrayUrl.length;
if (arrayUrl[count - 1] === fileName + ".js" ||
arrayUrl[count - 1] === fileName + ".min.js") {
return arrayUrl.slice(0, count - 1).join("/");
}
}
return null;
};
}(window.document, window.console));
/*global window, ns, define*/
/*jslint bitwise: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @class ns.support
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (window, document) {
"use strict";
var isTizen = !(typeof window.tizen === "undefined");
function isCircleShape() {
var testDivElement = document.createElement("div"),
fakeBodyElement = document.createElement("body"),
htmlElement = document.getElementsByTagName("html")[0],
style = getComputedStyle(testDivElement),
isCircle;
testDivElement.classList.add("is-circle-test");
fakeBodyElement.appendChild(testDivElement);
htmlElement.insertBefore(fakeBodyElement, htmlElement.firstChild);
isCircle = style.width === "1px";
htmlElement.removeChild(fakeBodyElement);
// to support circle in browser by additional parameter in url
/* istanbul ignore if */
if (window.location.search === "?circle") {
/* istanbul ignore next: we can't test this part because set location is not supported in
test environment */
isCircle = true;
}
return isCircle;
}
ns.support = {
cssTransitions: true,
mediaquery: true,
cssPseudoElement: true,
touchOverflow: true,
cssTransform3d: true,
boxShadow: true,
scrollTop: 0,
dynamicBaseTag: true,
cssPointerEvents: false,
boundingRect: true,
browser: {
ie: false,
tizen: isTizen
},
shape: {
circle: isTizen ? window.matchMedia("(-tizen-geometric-shape: circle)").matches :
isCircleShape()
},
gradeA: function () {
return true;
},
isCircleShape: isCircleShape
};
}(window, window.document));
/*global window, ns, define*/
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint bitwise: true */
/*
* @author Piotr Karny <p.karny@samsung.com>
*/
(function () {
"use strict";
// Default configuration properties for wearable
ns.setConfig("autoBuildOnPageChange", false, true);
if (ns.support.shape.circle) {
ns.setConfig("pageTransition", "pop", true);
ns.setConfig("popupTransition", "pop", true);
ns.setConfig("popupFullSize", true, true);
ns.setConfig("scrollEndEffectArea", "screen", true);
ns.setConfig("enablePageScroll", true, true);
ns.setConfig("enablePopupScroll", true, true);
} else {
ns.setConfig("popupTransition", "slideup", true);
ns.setConfig("enablePageScroll", false, true);
ns.setConfig("enablePopupScroll", false, true);
}
// .. other possible options
// ns.setConfig('autoInitializePage', true);
// ns.setConfig('pageContainer', document.body); // defining application container for wearable
}());
/*global window, define, ns*/
/*jslint bitwise: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function () {
"use strict";
// Default configuration properties
ns.setConfig("rootDir", ns.getFrameworkPath(), true);
ns.setConfig("version", "", true);
ns.setConfig("allowCrossDomainPages", false, true);
ns.setConfig("domCache", false, true);
// .. other possible options
ns.setConfig("autoBuildOnPageChange", true, true);
ns.setConfig("autoInitializePage", true, true);
ns.setConfig("dynamicBaseEnabled", true, true);
ns.setConfig("pageTransition", "none", true);
ns.setConfig("popupTransition", "none", true);
ns.setConfig("popupFullSize", false, true);
ns.setConfig("scrollEndEffectArea", "content", true);
ns.setConfig("enablePopupScroll", false, true);
// ns.setConfig('container', document.body); // for defining application container
// same as above, but for wearable version
ns.setConfig("pageContainer", document.body, true);
ns.setConfig("findProfileFile", false, true);
}());
/*global window, ns, define, XMLHttpRequest, console, Blob */
/*jslint nomen: true, browser: true, plusplus: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Utilities
*
* The Tizen Advanced UI (TAU) framework provides utilities for easy-developing
* and fully replaceable with jQuery method. When user using these DOM and
* selector methods, it provide more light logic and it proves performance
* of web app. The following table displays the utilities provided by the
* TAU framework.
*
* @class ns.util
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var currentFrame = null,
util = ns.util || {},
// frames callbacks which should be run in next request animation frame
waitingFrames = [],
slice = [].slice,
// inform that loop was added to request animation frame callback
loopWork = false;
/**
* Function which is use as workaround when any type of request animation frame not exists
* @param {Function} callback
* @method _requestAnimationFrameOnSetTimeout
* @static
* @member ns.util
* @protected
*/
util._requestAnimationFrameOnSetTimeout = function (callback) {
currentFrame = window.setTimeout(callback.bind(callback, +new Date()), 1000 / 60);
};
/**
* Function which support every request animation frame.
* @method _loop
* @protected
* @static
* @member ns.util
*/
util._loop = function () {
var loopWaitingFrames = slice.call(waitingFrames),
currentFrameFunction = loopWaitingFrames.shift(),
loopTime = performance.now();
waitingFrames = [];
while (currentFrameFunction) {
currentFrameFunction();
if (performance.now() - loopTime < 15) {
currentFrameFunction = loopWaitingFrames.shift();
} else {
currentFrameFunction = null;
}
}
if (loopWaitingFrames.length || waitingFrames.length) {
waitingFrames.unshift.apply(waitingFrames, loopWaitingFrames);
util.windowRequestAnimationFrame(util._loop);
} else {
loopWork = false;
}
};
/**
* Find browser prefixed request animation frame function.
* @method _getRequestAnimationFrame
* @protected
* @static
* @member ns.util
*/
util._getRequestAnimationFrame = function () {
return (window.requestAnimationFrame ||
window.webkitRequestAnimationFrame ||
window.mozRequestAnimationFrame ||
window.oRequestAnimationFrame ||
window.msRequestAnimationFrame ||
util._requestAnimationFrameOnSetTimeout).bind(window);
};
/**
* Original requestAnimationFrame from object window.
* @method windowRequestAnimationFrame
* @static
* @member ns.util
*/
util.windowRequestAnimationFrame = util._getRequestAnimationFrame();
/**
* Special requestAnimationFrame function which add functions to queue of callbacks
* @method requestAnimationFrame
* @static
* @member ns.util
*/
util.requestAnimationFrame = function (callback) {
waitingFrames.push(callback);
if (!loopWork) {
util.windowRequestAnimationFrame(util._loop);
loopWork = true;
}
};
util._cancelAnimationFrameOnSetTimeout = function () {
// probably wont work if there is any more than 1
// active animationFrame but we are trying anyway
window.clearTimeout(currentFrame);
};
util._getCancelAnimationFrame = function () {
return (window.cancelAnimationFrame ||
window.webkitCancelAnimationFrame ||
window.mozCancelAnimationFrame ||
window.oCancelAnimationFrame ||
window.msCancelAnimationFrame ||
util._cancelAnimationFrameOnSetTimeout).bind(window);
};
util.cancelAnimationFrame = util._getCancelAnimationFrame();
/**
* fetchSync retrieves a text document synchronously, returns null on error
* @param {string} url
* @param {=string} [mime=""] Mime type of the resource
* @return {string|null}
* @static
* @member ns.util
*/
function fetchSync(url, mime) {
var xhr = new XMLHttpRequest(),
status;
xhr.open("get", url, false);
if (mime) {
xhr.overrideMimeType(mime);
}
xhr.send();
if (xhr.readyState === 4) {
status = xhr.status;
if (status === 200 || (status === 0 && xhr.responseText)) {
return xhr.responseText;
}
}
return null;
}
util.fetchSync = fetchSync;
/**
* Removes all script tags with src attribute from document and returns them
* @param {HTMLElement} container
* @return {Array.<HTMLElement>}
* @protected
* @static
* @member ns.util
*/
function removeExternalScripts(container) {
var scripts = slice.call(container.querySelectorAll("script[src]")),
i = scripts.length,
script;
while (--i >= 0) {
script = scripts[i];
script.parentNode.removeChild(script);
}
return scripts;
}
util._removeExternalScripts = removeExternalScripts;
/**
* Evaluates code, reason for a function is for an atomic call to evaluate code
* since most browsers fail to optimize functions with try-catch blocks, so this
* minimizes the effect, returns the function to run
* @param {string} code
* @return {Function}
* @static
* @member ns.util
*/
function safeEvalWrap(code) {
return function () {
try {
window.eval(code);
} catch (e) {
if (e.stack) {
ns.error(e.stack);
} else if (e.name && e.message) {
ns.error(e.name, e.message);
} else {
ns.error(e);
}
}
};
}
util.safeEvalWrap = safeEvalWrap;
/**
* Calls functions in supplied queue (array)
* @param {Array.<Function>} functionQueue
* @static
* @member ns.util
*/
function batchCall(functionQueue) {
var i,
length = functionQueue.length;
for (i = 0; i < length; ++i) {
functionQueue[i]();
}
}
util.batchCall = batchCall;
/**
* Creates new script elements for scripts gathered from a different document
* instance, blocks asynchronous evaluation (by renaming src attribute) and
* returns an array of functions to run to evaluate those scripts
* @param {Array.<HTMLElement>} scripts
* @param {HTMLElement} container
* @return {Array.<Function>}
* @protected
* @static
* @member ns.util
*/
function createScriptsSync(scripts, container) {
var scriptElement,
scriptBody,
i,
length,
queue = [];
// proper order of execution
for (i = 0, length = scripts.length; i < length; ++i) {
scriptBody = util.fetchSync(scripts[i].src, "text/plain");
if (scriptBody) {
scriptElement = document.adoptNode(scripts[i]);
scriptElement.setAttribute("data-src", scripts[i].src);
scriptElement.removeAttribute("src"); // block evaluation
queue.push(util.safeEvalWrap(scriptBody));
if (container) {
container.appendChild(scriptElement);
}
}
}
return queue;
}
util._createScriptsSync = createScriptsSync;
/**
* Method make asynchronous call of function
* @method async
* @inheritdoc #requestAnimationFrame
* @member ns.util
* @static
*/
util.async = util.requestAnimationFrame;
/**
* Appends element from different document instance to current document in the
* container element and evaluates scripts (synchronously)
* @param {HTMLElement} element
* @param {HTMLElement} container
* @return {HTMLElement}
* @method importEvaluateAndAppendElement
* @member ns.util
* @static
*/
util.importEvaluateAndAppendElement = function (element, container) {
var externalScriptsQueue =
util._createScriptsSync(util._removeExternalScripts(element), element),
newNode = document.importNode(element, true);
container.appendChild(newNode); // append and eval inline
util.batchCall(externalScriptsQueue);
return newNode;
};
/**
* Checks if specified string is a number or not
* @method isNumber
* @param {string} query
* @return {boolean}
* @member ns.util
* @static
*/
util.isNumber = function (query) {
var parsed = parseFloat(query);
return !isNaN(parsed) && isFinite(parsed);
};
/**
* Reappear script tags to DOM structure to correct run script
* @method runScript
* @param {string} baseUrl
* @param {HTMLScriptElement} script
* @member ns.util
* @deprecated 2.3
*/
util.runScript = function (baseUrl, script) {
var newScript = document.createElement("script"),
scriptData,
i,
scriptAttributes = slice.call(script.attributes),
src = script.getAttribute("src"),
attribute,
status;
// 'src' may become null when none src attribute is set
if (src !== null) {
src = util.path.makeUrlAbsolute(src, baseUrl);
}
//Copy script tag attributes
i = scriptAttributes.length;
while (--i >= 0) {
attribute = scriptAttributes[i];
if (attribute.name !== "src") {
newScript.setAttribute(attribute.name, attribute.value);
} else {
newScript.setAttribute("data-src", attribute.value);
}
}
if (src) {
scriptData = util.fetchSync(src, "text/plain");
} else {
scriptData = script.textContent;
}
if (scriptData) {
// add the returned content to a newly created script tag
newScript.src = window.URL.createObjectURL(new Blob([scriptData], {type: "text/javascript"}));
newScript.textContent = scriptData; // for compatibility with some libs ex. template systems
}
script.parentNode.replaceChild(newScript, script);
};
ns.util = util;
}(window, window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define */
/**
* #Array Utility
*
* Utility helps work with arrays.
*
* @class ns.util.array
*/
(function (ns) {
"use strict";
/**
* Convert values to common type and return information about type string or not.
* @param {number|string} low
* @param {number|string} high
* @return {{inival: *, endval: *, chars: boolean}}
*/
function convertTypes(low, high) {
var inival,
endval,
chars = false;
if (isNaN(low) && isNaN(high)) {
chars = true;
inival = low.charCodeAt(0);
endval = high.charCodeAt(0);
} else {
inival = (isNaN(low) ? 0 : low);
endval = (isNaN(high) ? 0 : high);
}
return {
inival: inival,
endval: endval,
chars: chars
};
}
/**
* Create an array containing the range of integers or characters
* from low to high (inclusive)
* @method range
* @param {number|string} low
* @param {number|string} high
* @param {number} step
* @static
* @return {Array} array containing continuos elements
* @member ns.util.array
*/
function range(low, high, step) {
// Create an array containing the range of integers or characters
// from low to high (inclusive)
//
// version: 1107.2516
// discuss at: http://phpjs.org/functions/range
// + original by: Waldo Malqui Silva
// * example 1: range ( 0, 12 );
// * returns 1: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
// * example 2: range( 0, 100, 10 );
// * returns 2: [0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100]
// * example 3: range( 'a', 'i' );
// * returns 3: ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i']
// * example 4: range( 'c', 'a' );
// * returns 4: ['c', 'b', 'a']
var matrix = [],
inival,
endval,
plus,
walker = step || 1,
chars,
typeData;
typeData = convertTypes(low, high);
inival = typeData.inival;
endval = typeData.endval;
chars = typeData.chars;
plus = inival <= endval;
if (plus) {
while (inival <= endval) {
matrix.push((chars ? String.fromCharCode(inival) : inival));
inival += walker;
}
} else {
while (inival >= endval) {
matrix.push((chars ? String.fromCharCode(inival) : inival));
inival -= walker;
}
}
return matrix;
}
function isCorrectType(object) {
return Array.isArray(object) || object instanceof NodeList || typeof object === "function";
}
function hasCorrectLength(object) {
var length = object.length;
return (length === 0 || typeof length === "number" && length > 0 && (length - 1) in object);
}
/**
* Check object is array-like (array-like include array and
* collection)
* @method isArrayLike
* @param {Object} object
* @return {boolean} Whether array-like object or not
* @member ns.util.array
* @static
*/
function isArrayLike(object) {
// if object exists and is different from window
// window object has length property
if (object && object !== object.window) {
// If length value is not number, object is not array and collection.
// Collection type is not array but has length value.
// e.g) Array.isArray(document.childNodes) ==> false
return isCorrectType(object) && hasCorrectLength(object);
}
return false;
}
/**
* Faster version of standard forEach method in array
* Confirmed that this method is 20 times faster then native
* @method forEach
* @param {Array} array
* @param {Function} callback
* @member ns.util.array
* @static
*/
function forEach(array, callback) {
var i,
length,
convertedArray = array;
if (!(array instanceof Array)) {
convertedArray = [].slice.call(array);
}
length = convertedArray.length;
for (i = 0; i < length; i++) {
callback(convertedArray[i], i, convertedArray);
}
}
/**
* Faster version of standard filter method in array
* @method filter
* @param {Array} array
* @param {Function} callback
* @member ns.util.array
* @static
*/
function filter(array, callback) {
var result = [],
i,
length,
value,
convertedArray = array;
if (!(array instanceof Array)) {
convertedArray = [].slice.call(array);
}
length = convertedArray.length;
for (i = 0; i < length; i++) {
value = convertedArray[i];
if (callback(value, i, convertedArray)) {
result.push(value);
}
}
return result;
}
/**
* Faster version of standard map method in array
* Confirmed that this method is 60% faster then native
* @method map
* @param {Array} array
* @param {Function} callback
* @member ns.util.array
* @static
*/
function map(array, callback) {
var result = [],
i,
length,
convertedArray = array;
if (!(array instanceof Array)) {
convertedArray = [].slice.call(array);
}
length = convertedArray.length;
for (i = 0; i < length; i++) {
result.push(callback(convertedArray[i], i, convertedArray));
}
return result;
}
/**
* Faster version of standard reduce method in array
* Confirmed that this method is 60% faster then native
* @method reduce
* @param {Array} array
* @param {Function} callback
* @param {*} [initialValue]
* @member ns.util.array
* @return {*}
* @static
*/
function reduce(array, callback, initialValue) {
var i,
length,
value,
result = initialValue,
convertedArray = array;
if (!(array instanceof Array)) {
convertedArray = [].slice.call(array);
}
length = convertedArray.length;
for (i = 0; i < length; i++) {
value = convertedArray[i];
if (result === undefined && i === 0) {
result = value;
} else {
result = callback(result, value, i, convertedArray);
}
}
return result;
}
ns.util.array = {
range: range,
isArrayLike: isArrayLike,
forEach: forEach,
filter: filter,
map: map,
reduce: reduce
};
}(ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
/* global ns, define, CustomEvent */
/**
* #Events
*
* The Tizen Advanced UI (TAU) framework provides events optimized for the Tizen
* Web application. The following table displays the events provided by the TAU
* framework.
* @class ns.event
*/
(function (window, ns) {
"use strict";
/**
* Checks if specified variable is a array or not
* @method isArray
* @return {boolean}
* @member ns.event
* @private
* @static
*/
var instances = [],
isArray = Array.isArray,
isArrayLike = ns.util.array.isArrayLike,
/**
* @property {RegExp} SPLIT_BY_SPACES_REGEXP
*/
SPLIT_BY_SPACES_REGEXP = /\s+/g,
/**
* Returns trimmed value
* @method trim
* @param {string} value
* @return {string} trimmed string
* @static
* @private
* @member ns.event
*/
trim = function (value) {
return value.trim();
},
/**
* Split string to array
* @method getEventsListeners
* @param {string|Array|Object} names string with one name of event, many names of events
* divided by spaces, array with names of widgets or object in which keys are names of
* events and values are callbacks
* @param {Function} globalListener
* @return {Array}
* @static
* @private
* @member ns.event
*/
getEventsListeners = function (names, globalListener) {
var name,
result = [],
i;
if (typeof names === "string") {
names = names.split(SPLIT_BY_SPACES_REGEXP).map(trim);
}
if (isArray(names)) {
for (i = 0; i < names.length; i++) {
result.push({type: names[i], callback: globalListener});
}
} else {
for (name in names) {
if (names.hasOwnProperty(name)) {
result.push({type: name, callback: names[name]});
}
}
}
return result;
};
/**
* Find instance by element
* @method findInstance
* @param {HTMLElement} element
* @return {ns.event.gesture.Instance}
* @member ns.event
* @static
* @private
*/
function findInstance(element) {
var instance;
instances.forEach(function (item) {
if (item.element === element) {
instance = item.instance;
}
});
return instance;
}
/**
* Remove instance from instances by element
* @method removeInstance
* @param {HTMLElement} element
* @member ns.event
* @static
* @private
*/
function removeInstance(element) {
instances.forEach(function (item, key) {
if (item.element === element) {
instances.splice(key, 1);
}
});
}
ns.event = {
/**
* Triggers custom event fastOn element
* The return value is false, if at least one of the event
* handlers which handled this event, called preventDefault.
* Otherwise it returns true.
* @method trigger
* @param {HTMLElement|HTMLDocument} element
* @param {string} type
* @param {?*} [data=null]
* @param {boolean=} [bubbles=true]
* @param {boolean=} [cancelable=true]
* @return {boolean}
* @member ns.event
* @static
*/
trigger: function (element, type, data, bubbles, cancelable) {
var evt = new CustomEvent(type, {
"detail": data,
//allow event to bubble up, required if we want to allow to listen fastOn document etc
bubbles: typeof bubbles === "boolean" ? bubbles : true,
cancelable: typeof cancelable === "boolean" ? cancelable : true
});
return element.dispatchEvent(evt);
},
/**
* Prevent default on original event
* @method preventDefault
* @param {Event} event
* @member ns.event
* @static
*/
preventDefault: function (event) {
var originalEvent = event._originalEvent;
// @todo this.isPropagationStopped = returnTrue;
if (originalEvent && originalEvent.preventDefault) {
originalEvent.preventDefault();
}
event.preventDefault();
},
/**
* Stop event propagation
* @method stopPropagation
* @param {Event} event
* @member ns.event
* @static
*/
stopPropagation: function (event) {
var originalEvent = event._originalEvent;
// @todo this.isPropagationStopped = returnTrue;
if (originalEvent && originalEvent.stopPropagation) {
originalEvent.stopPropagation();
}
event.stopPropagation();
},
/**
* Stop event propagation immediately
* @method stopImmediatePropagation
* @param {Event} event
* @member ns.event
* @static
*/
stopImmediatePropagation: function (event) {
var originalEvent = event._originalEvent;
// @todo this.isPropagationStopped = returnTrue;
if (originalEvent && originalEvent.stopImmediatePropagation) {
originalEvent.stopImmediatePropagation();
}
event.stopImmediatePropagation();
},
/**
* Return document relative cords for event
* @method documentRelativeCoordsFromEvent
* @param {Event} event
* @return {Object}
* @return {number} return.x
* @return {number} return.y
* @member ns.event
* @static
*/
documentRelativeCoordsFromEvent: function (event) {
var _event = event ? event : window.event,
client = {
x: _event.clientX,
y: _event.clientY
},
page = {
x: _event.pageX,
y: _event.pageY
},
posX = 0,
posY = 0,
touch0,
body = document.body,
documentElement = document.documentElement;
if (event.type.match(/^touch/)) {
touch0 = _event.targetTouches[0] || _event.originalEvent.targetTouches[0];
page = {
x: touch0.pageX,
y: touch0.pageY
};
client = {
x: touch0.clientX,
y: touch0.clientY
};
}
if (page.x || page.y) {
posX = page.x;
posY = page.y;
} else if (client.x || client.y) {
posX = client.x + body.scrollLeft + documentElement.scrollLeft;
posY = client.y + body.scrollTop + documentElement.scrollTop;
}
return {x: posX, y: posY};
},
/**
* Return target relative cords for event
* @method targetRelativeCoordsFromEvent
* @param {Event} event
* @return {Object}
* @return {number} return.x
* @return {number} return.y
* @member ns.event
* @static
*/
targetRelativeCoordsFromEvent: function (event) {
var target = event.target,
cords = {
x: event.offsetX,
y: event.offsetY
};
if (cords.x === undefined || isNaN(cords.x) ||
cords.y === undefined || isNaN(cords.y)) {
cords = ns.event.documentRelativeCoordsFromEvent(event);
cords.x -= target.offsetLeft;
cords.y -= target.offsetTop;
}
return cords;
},
/**
* Add event listener to element
* @method fastOn
* @param {HTMLElement} element
* @param {string} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
fastOn: function (element, type, listener, useCapture) {
element.addEventListener(type, listener, useCapture || false);
},
/**
* Remove event listener to element
* @method fastOff
* @param {HTMLElement} element
* @param {string} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
fastOff: function (element, type, listener, useCapture) {
element.removeEventListener(type, listener, useCapture || false);
},
/**
* Add event listener to element with prefixes for all browsers
*
* @example
* tau.event.prefixedFastOn(document, "animationEnd", function() {
* console.log("animation ended");
* });
* // write "animation ended" on console on event "animationEnd", "webkitAnimationEnd", "mozAnimationEnd", "msAnimationEnd", "oAnimationEnd"
*
* @method fastPrefixedOn
* @param {HTMLElement} element
* @param {string} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
prefixedFastOn: function (element, type, listener, useCapture) {
var nameForPrefix = type.charAt(0).toLocaleUpperCase() + type.substring(1);
element.addEventListener(type.toLowerCase(), listener, useCapture || false);
element.addEventListener("webkit" + nameForPrefix, listener, useCapture || false);
element.addEventListener("moz" + nameForPrefix, listener, useCapture || false);
element.addEventListener("ms" + nameForPrefix, listener, useCapture || false);
element.addEventListener("o" + nameForPrefix.toLowerCase(), listener, useCapture || false);
},
/**
* Remove event listener to element with prefixes for all browsers
*
* @example
* tau.event.prefixedFastOff(document, "animationEnd", functionName);
* // remove listeners functionName on events "animationEnd", "webkitAnimationEnd", "mozAnimationEnd", "msAnimationEnd", "oAnimationEnd"
*
* @method fastPrefixedOff
* @param {HTMLElement} element
* @param {string} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
prefixedFastOff: function (element, type, listener, useCapture) {
var nameForPrefix = type.charAt(0).toLocaleUpperCase() + type.substring(1);
element.removeEventListener(type.toLowerCase(), listener, useCapture || false);
element.removeEventListener("webkit" + nameForPrefix, listener, useCapture || false);
element.removeEventListener("moz" + nameForPrefix, listener, useCapture || false);
element.removeEventListener("ms" + nameForPrefix, listener, useCapture || false);
element.removeEventListener("o" + nameForPrefix.toLowerCase(), listener, useCapture || false);
},
/**
* Add event listener to element that can be added addEventListener
* @method on
* @param {HTMLElement|HTMLDocument|Window} element
* @param {string|Array|Object} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
on: function (element, type, listener, useCapture) {
var i,
j,
elementsLength,
typesLength,
elements,
listeners;
if (isArrayLike(element)) {
elements = element;
} else {
elements = [element];
}
elementsLength = elements.length;
listeners = getEventsListeners(type, listener);
typesLength = listeners.length;
for (i = 0; i < elementsLength; i++) {
if (typeof elements[i].addEventListener === "function") {
for (j = 0; j < typesLength; j++) {
ns.event.fastOn(elements[i], listeners[j].type, listeners[j].callback, useCapture);
}
}
}
},
/**
* Remove event listener to element
* @method off
* @param {HTMLElement|HTMLDocument|Window} element
* @param {string|Array|Object} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
off: function (element, type, listener, useCapture) {
var i,
j,
elementsLength,
typesLength,
elements,
listeners;
if (isArrayLike(element)) {
elements = element;
} else {
elements = [element];
}
elementsLength = elements.length;
listeners = getEventsListeners(type, listener);
typesLength = listeners.length;
for (i = 0; i < elementsLength; i++) {
if (typeof elements[i].addEventListener === "function") {
for (j = 0; j < typesLength; j++) {
ns.event.fastOff(elements[i], listeners[j].type, listeners[j].callback, useCapture);
}
}
}
},
/**
* Add event listener to element only for one trigger
* @method one
* @param {HTMLElement|HTMLDocument|window} element
* @param {string|Array|Object} type
* @param {Function} listener
* @param {boolean} [useCapture=false]
* @member ns.event
* @static
*/
one: function (element, type, listener, useCapture) {
var arraySlice = [].slice,
i,
j,
elementsLength,
typesLength,
elements,
listeners,
callbacks = [];
if (isArrayLike(element)) {
elements = arraySlice.call(element);
} else {
elements = [element];
}
elementsLength = elements.length;
// pair type with listener
listeners = getEventsListeners(type, listener);
typesLength = listeners.length;
// on each element
for (i = 0; i < elementsLength; i++) {
// if element has possibility of add listener
if (typeof elements[i].addEventListener === "function") {
callbacks[i] = [];
// for each event type
for (j = 0; j < typesLength; j++) {
callbacks[i][j] = (function (i, j) {
var args = arraySlice.call(arguments);
ns.event.fastOff(elements[i], listeners[j].type, callbacks[i][j], useCapture);
// remove the first argument of binding function
args.shift();
// remove the second argument of binding function
args.shift();
listeners[j].callback.apply(this, args);
}).bind(null, i, j);
ns.event.fastOn(elements[i], listeners[j].type, callbacks[i][j], useCapture);
}
}
}
},
// disable is required because method has changing arguments
/* eslint-disable jsdoc/check-param-names */
/**
* Enable gesture handling on given HTML element or object
* @method enableGesture
* @param {HTMLElement} element
* @param {...Object} [gesture] Gesture object {@link ns.event.gesture}
* @member ns.event
*/
enableGesture: function (element) {
var gestureInstance = findInstance(element),
length = arguments.length,
i = 1;
if (!gestureInstance) {
gestureInstance = new ns.event.gesture.Instance(element);
instances.push({element: element, instance: gestureInstance});
}
for (; i < length; i++) {
gestureInstance.addDetector(arguments[i]);
}
},
/**
* Disable gesture handling from given HTML element or object
* @method disableGesture
* @param {HTMLElement} element
* @param {...Object} [gesture] Gesture object {@link ns.event.gesture}
* @member ns.event
*/
disableGesture: function (element) {
var gestureInstance = findInstance(element),
length = arguments.length,
i = 1;
if (!gestureInstance) {
return;
}
if (length > 1) {
gestureInstance.removeDetector(arguments[i]);
} else {
gestureInstance.destroy();
removeInstance(element);
}
}
/* eslint-disable jsdoc/check-param-names */
};
}(window, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Info
*
* Various TAU information
* @class ns.info
*/
(function (window, document) {
"use strict";
/**
* @property {Object} info
* @property {string} [info.profile="default"] Current runtime profile
* @property {string} [info.theme="default"] Current runtime theme
* @property {string} info.version Current runtime version
* @member ns.info
* @static
*/
var eventUtils = ns.event,
info = {
profile: "default",
theme: "default",
version: ns.version,
/**
* Refreshes information about runtime
* @method refreshTheme
* @param {Function} done Callback run when the theme is discovered
* @member ns.info
* @return {null|String}
* @static
*/
refreshTheme: function (done) {
var el = document.createElement("span"),
parent = document.body,
themeName;
if (document.readyState !== "interactive" && document.readyState !== "complete") {
eventUtils.fastOn(document, "DOMContentLoaded", this.refreshTheme.bind(this, done));
return null;
}
el.classList.add("tau-info-theme");
parent.appendChild(el);
themeName = window.getComputedStyle(el, ":after").content;
parent.removeChild(el);
if (themeName && themeName.length > 0) {
this.theme = themeName;
}
themeName = themeName || null;
if (done) {
done(themeName);
}
return themeName;
}
};
info.refreshTheme();
ns.info = info;
}(window, window.document));
/*global define: false, window: false, ns: false */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Selectors Utility
* Object contains functions to get HTML elements by different selectors.
* @class ns.util.selectors
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@partner.samsung.com>
* @author Damian Osipiuk <d.osipiuk@samsung.com>
*/
(function (document, ns) {
"use strict";
/**
* @method slice Alias for array slice method
* @member ns.util.selectors
* @private
* @static
*/
var slice = [].slice,
/**
* @method matchesSelectorType
* @return {string|boolean}
* @member ns.util.selectors
* @private
* @static
*/
matchesSelectorType = (function () {
var el = document.createElement("div");
if (typeof el.webkitMatchesSelector === "function") {
return "webkitMatchesSelector";
}
if (typeof el.mozMatchesSelector === "function") {
return "mozMatchesSelector";
}
if (typeof el.msMatchesSelector === "function") {
return "msMatchesSelector";
}
if (typeof el.matchesSelector === "function") {
return "matchesSelector";
}
if (typeof el.matches === "function") {
return "matches";
}
return "";
}());
/**
* Prefix selector with 'data-' and namespace if present
* @method getDataSelector
* @param {string} selector
* @return {string}
* @member ns.util.selectors
* @private
* @static
*/
function getDataSelector(selector) {
var namespace = ns.getConfig("namespace");
return "[data-" + (namespace ? namespace + "-" : "") + selector + "]";
}
/**
* Runs matches implementation of matchesSelector
* method on specified element
* @method matchesSelector
* @param {HTMLElement} element
* @param {string} selector
* @return {boolean}
* @static
* @member ns.util.selectors
*/
function matchesSelector(element, selector) {
if (matchesSelectorType && element[matchesSelectorType]) {
return element[matchesSelectorType](selector);
}
return false;
}
/**
* Return array with all parents of element.
* @method parents
* @param {HTMLElement} element
* @return {Array}
* @member ns.util.selectors
* @private
* @static
*/
function parents(element) {
var items = [],
current = element.parentNode;
while (current && current !== document) {
items.push(current);
current = current.parentNode;
}
return items;
}
/**
* Checks if given element and its ancestors matches given function
* @method closest
* @param {HTMLElement} element
* @param {Function} testFunction
* @return {?HTMLElement}
* @member ns.util.selectors
* @static
* @private
*/
function closest(element, testFunction) {
var current = element;
while (current && current !== document) {
if (testFunction(current)) {
return current;
}
current = current.parentNode;
}
return null;
}
/**
* @method testSelector
* @param {string} selector
* @param {HTMLElement} node
* @return {boolean}
* @member ns.util.selectors
* @static
* @private
*/
function testSelector(selector, node) {
return matchesSelector(node, selector);
}
/**
* @method testClass
* @param {string} className
* @param {HTMLElement} node
* @return {boolean}
* @member ns.util.selectors
* @static
* @private
*/
function testClass(className, node) {
return node && node.classList && node.classList.contains(className);
}
/**
* @method testTag
* @param {string} tagName
* @param {HTMLElement} node
* @return {boolean}
* @member ns.util.selectors
* @static
* @private
*/
function testTag(tagName, node) {
return node.tagName.toLowerCase() === tagName;
}
/**
* @class ns.util.selectors
*/
ns.util.selectors = {
matchesSelector: matchesSelector,
/**
* Return array with children pass by given selector.
* @method getChildrenBySelector
* @param {HTMLElement} context
* @param {string} selector
* @return {Array}
* @static
* @member ns.util.selectors
*/
getChildrenBySelector: function (context, selector) {
return slice.call(context.children).filter(testSelector.bind(null, selector));
},
/**
* Return array with children pass by given data-namespace-selector.
* @method getChildrenByDataNS
* @param {HTMLElement} context
* @param {string} dataSelector
* @return {Array}
* @static
* @member ns.util.selectors
*/
getChildrenByDataNS: function (context, dataSelector) {
return slice.call(context.children).filter(testSelector.bind(null,
getDataSelector(dataSelector)));
},
/**
* Return array with children with given class name.
* @method getChildrenByClass
* @param {HTMLElement} context
* @param {string} className
* @return {Array}
* @static
* @member ns.util.selectors
*/
getChildrenByClass: function (context, className) {
return slice.call(context.children).filter(testClass.bind(null, className));
},
/**
* Return array with children with given tag name.
* @method getChildrenByTag
* @param {HTMLElement} context
* @param {string} tagName
* @return {Array}
* @static
* @member ns.util.selectors
*/
getChildrenByTag: function (context, tagName) {
return slice.call(context.children).filter(testTag.bind(null, tagName));
},
/**
* Return array with all parents of element.
* @method getParents
* @param {HTMLElement} context
* @param {string} selector
* @return {Array}
* @static
* @member ns.util.selectors
*/
getParents: parents,
/**
* Return array with all parents of element pass by given selector.
* @method getParentsBySelector
* @param {HTMLElement} context
* @param {string} selector
* @return {Array}
* @static
* @member ns.util.selectors
*/
getParentsBySelector: function (context, selector) {
return parents(context).filter(testSelector.bind(null, selector));
},
/**
* Return array with all parents of element pass by given selector with namespace.
* @method getParentsBySelectorNS
* @param {HTMLElement} context
* @param {string} selector
* @return {Array}
* @static
* @member ns.util.selectors
*/
getParentsBySelectorNS: function (context, selector) {
return parents(context).filter(testSelector.bind(null, getDataSelector(selector)));
},
/**
* Return array with all parents of element with given class name.
* @method getParentsByClass
* @param {HTMLElement} context
* @param {string} className
* @return {Array}
* @static
* @member ns.util.selectors
*/
getParentsByClass: function (context, className) {
return parents(context).filter(testClass.bind(null, className));
},
/**
* Return array with all parents of element with given tag name.
* @method getParentsByTag
* @param {HTMLElement} context
* @param {string} tagName
* @return {Array}
* @static
* @member ns.util.selectors
*/
getParentsByTag: function (context, tagName) {
return parents(context).filter(testTag.bind(null, tagName));
},
/**
* Return first element from parents of element pass by selector.
* @method getClosestBySelector
* @param {HTMLElement} context
* @param {string} selector
* @return {HTMLElement}
* @static
* @member ns.util.selectors
*/
getClosestBySelector: function (context, selector) {
return closest(context, testSelector.bind(null, selector));
},
/**
* Return first element from parents of element pass by selector with namespace.
* @method getClosestBySelectorNS
* @param {HTMLElement} context
* @param {string} selector
* @return {HTMLElement}
* @static
* @member ns.util.selectors
*/
getClosestBySelectorNS: function (context, selector) {
return closest(context, testSelector.bind(null, getDataSelector(selector)));
},
/**
* Return first element from parents of element with given class name.
* @method getClosestByClass
* @param {HTMLElement} context
* @param {string} selector
* @return {HTMLElement}
* @static
* @member ns.util.selectors
*/
getClosestByClass: function (context, selector) {
return closest(context, testClass.bind(null, selector));
},
/**
* Return first element from parents of element with given tag name.
* @method getClosestByTag
* @param {HTMLElement} context
* @param {string} selector
* @return {HTMLElement}
* @static
* @member ns.util.selectors
*/
getClosestByTag: function (context, selector) {
return closest(context, testTag.bind(null, selector));
},
/**
* Return array of elements from context with given data-selector
* @method getAllByDataNS
* @param {HTMLElement} context
* @param {string} dataSelector
* @return {Array}
* @static
* @member ns.util.selectors
*/
getAllByDataNS: function (context, dataSelector) {
return slice.call(context.querySelectorAll(getDataSelector(dataSelector)));
},
/**
* Get scrollable parent element
* @method getScrollableParent
* @param {HTMLElement} element
* @return {HTMLElement}
* @static
* @member ns.util.selectors
*/
getScrollableParent: function (element) {
var overflow,
style;
while (element && element !== document.body) {
style = window.getComputedStyle(element);
if (style) {
overflow = style.getPropertyValue("overflow-y");
if (overflow === "scroll" || (overflow === "auto" &&
element.scrollHeight > element.clientHeight)) {
return element;
}
}
element = element.parentNode;
}
return null;
}
};
}(window.document, ns));
/*global define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright (c) 2010 - 2014 Samsung Electronics Co., Ltd.
* License : MIT License V2
*/
/**
* #Object Utility
* Object contains functions help work with objects.
* @class ns.util.object
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function () {
"use strict";
var object = {
/**
* Copy object to new object
* @method copy
* @param {Object} orgObject
* @return {Object}
* @static
* @member ns.util.object
*/
copy: function (orgObject) {
return object.merge({}, orgObject);
},
/**
* Attach fields from second object to first object.
* @method fastMerge
* @param {Object} newObject
* @param {Object} orgObject
* @return {Object}
* @static
* @member ns.util.object
*/
fastMerge: function (newObject, orgObject) {
var key;
for (key in orgObject) {
if (orgObject.hasOwnProperty(key)) {
newObject[key] = orgObject[key];
}
}
return newObject;
},
/**
* Attach fields from second and next object to first object.
* @method merge
* @return {Object}
* @static
* @member ns.util.object
*/
merge: function (/* newObject, orgObject, override */) {
var newObject,
orgObject,
override,
key,
args = [].slice.call(arguments),
argsLength = args.length,
i;
newObject = args.shift();
override = true;
if (typeof arguments[argsLength - 1] === "boolean") {
override = arguments[argsLength - 1];
argsLength--;
}
for (i = 0; i < argsLength; i++) {
orgObject = args.shift();
if (orgObject !== null) {
for (key in orgObject) {
if (orgObject.hasOwnProperty(key) && (override || newObject[key] === undefined)) {
newObject[key] = orgObject[key];
}
}
}
}
return newObject;
},
/**
* Function add to Constructor prototype Base object and add to prototype properties and methods from
* prototype object.
* @method inherit
* @param {Function} Constructor
* @param {Function} Base
* @param {Object} prototype
* @static
* @member ns.util.object
*/
/* jshint -W083 */
inherit: function (Constructor, Base, prototype) {
var basePrototype = new Base(),
property,
value;
for (property in prototype) {
if (prototype.hasOwnProperty(property)) {
value = prototype[property];
if (typeof value === "function") {
basePrototype[property] = (function createFunctionWithSuper(Base, property, value) {
var _super = function () {
var superFunction = Base.prototype[property];
if (superFunction) {
return superFunction.apply(this, arguments);
}
return null;
};
return function () {
var __super = this._super,
returnValue;
this._super = _super;
returnValue = value.apply(this, arguments);
this._super = __super;
return returnValue;
};
}(Base, property, value));
} else {
basePrototype[property] = value;
}
}
}
Constructor.prototype = basePrototype;
Constructor.prototype.constructor = Constructor;
},
/**
* Returns true if every property value corresponds value from 'value' argument
* @method hasPropertiesOfValue
* @param {Object} obj
* @param {*} [value=undefined]
* @return {boolean}
*/
hasPropertiesOfValue: function (obj, value) {
var keys = Object.keys(obj),
i = keys.length;
// Empty array should return false
if (i === 0) {
return false;
}
while (--i >= 0) {
if (obj[keys[i]] !== value) {
return false;
}
}
return true;
},
/**
* Remove properties from object.
* @method removeProperties
* @param {Object} object
* @param {Array} propertiesToRemove
* @return {Object}
*/
removeProperties: function (object, propertiesToRemove) {
var length = propertiesToRemove.length,
property,
i;
for (i = 0; i < length; i++) {
property = propertiesToRemove[i];
if (object.hasOwnProperty(property)) {
delete object[property];
}
}
return object;
}
};
ns.util.object = object;
}());
/*global window, define, ns, Node */
/*jslint nomen: true, plusplus: true, bitwise: false */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright (c) 2010 - 2014 Samsung Electronics Co., Ltd.
* License : MIT License V2
*/
/**
* #Engine
* Main class with engine of library which control communication
* between parts of framework.
* @class ns.engine
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Michal Szepielak <m.szepielak@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@partner.samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
* @author Przemyslaw Ciezkowski <p.ciezkowski@samsung.com>
* @author Hyunkook, Cho <hk0713.cho@samsung.com>
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
* @author Piotr Ostalski <p.ostalski@samsung.com>
*/
(function (window, document) {
"use strict";
var slice = [].slice,
/**
* @property {Object} eventUtils {@link ns.event}
* @private
* @static
* @member ns.engine
*/
eventUtils = ns.event,
util = ns.util,
objectUtils = util.object,
selectors = util.selectors,
arrayUtils = ns.util.array,
/**
* @property {Object} widgetDefinitions Object with widgets definitions
* @private
* @static
* @member ns.engine
*/
widgetDefinitions = {},
/**
* @property {Object} widgetBindingMap Object with widgets bindings
* @private
* @static
* @member ns.engine
*/
widgetBindingMap = {},
location = window.location,
/**
* engine mode, if true then engine only builds widgets
* @property {boolean} justBuild
* @private
* @static
* @member ns.engine
*/
justBuild = location.hash === "#build",
/**
* @property {string} [TYPE_STRING="string"] local cache of string type name
* @private
* @static
* @readonly
* @member ns.engine
*/
TYPE_STRING = "string",
/**
* @property {string} [TYPE_FUNCTION="function"] local cache of function type name
* @private
* @static
* @readonly
* @member ns.engine
*/
TYPE_FUNCTION = "function",
/**
* @property {string} [DATA_BUILT="data-tau-built"] attribute informs that widget id build
* @private
* @static
* @readonly
* @member ns.engine
*/
DATA_BUILT = "data-tau-built",
/**
* @property {string} [DATA_NAME="data-tau-name"] attribute contains widget name
* @private
* @static
* @readonly
* @member ns.engine
*/
DATA_NAME = "data-tau-name",
/**
* @property {string} [DATA_BOUND="data-tau-bound"] attribute informs that widget id bound
* @private
* @static
* @readonly
* @member ns.engine
*/
DATA_BOUND = "data-tau-bound",
/**
* @property {string} NAMES_SEPARATOR
* @private
* @static
* @readonly
*/
NAMES_SEPARATOR = ",",
/**
* @property {string} [querySelectorWidgets="*[data-tau-built][data-tau-name]:not([data-tau-bound])"] query selector for all widgets which are built but not bound
* @private
* @static
* @member ns.engine
*/
querySelectorWidgets = "*[" + DATA_BUILT + "][" + DATA_NAME + "]:not([" + DATA_BOUND + "])",
/**
* @method excludeBuildAndBound
* @private
* @static
* @param {string} widgetType
* @member ns.engine
* @return {string} :not([data-tau-built*='widgetName']):not([data-tau-bound*='widgetName'])
*/
excludeBuiltAndBound = function (widgetType) {
return ":not([" + DATA_BUILT + "*='" + widgetType + "']):not([" + DATA_BOUND + "*='" + widgetType + "'])";
},
/**
* Engine event types
* @property {Object} eventType
* @property {string} eventType.INIT="tauinit" INIT of framework init event
* @property {string} eventType.WIDGET_BOUND="widgetbound" WIDGET_BOUND of widget bound event
* @property {string} eventType.WIDGET_DEFINED="widgetdefined" WIDGET_DEFINED of widget built event
* @property {string} eventType.WIDGET_BUILT="widgetbuilt" WIDGET_BUILT of widget built event
* @property {string} eventType.BOUND="bound" BOUND of bound event
* @static
* @readonly
* @member ns.engine
*/
eventType = {
INIT: "tauinit",
READY: "tauready",
WIDGET_BOUND: "widgetbound",
WIDGET_DEFINED: "widgetdefined",
WIDGET_BUILT: "widgetbuilt",
DESTROY: "taudestroy",
BOUND: "bound",
WIDGET_INIT: "init"
},
engine;
/**
* This function prepares selector for widget' definition
* @method selectorChange
* @param {string} selectorName
* @return {string} new selector
* @member ns.engine
* @static
*/
function selectorChange(selectorName) {
if (selectorName.match(/\[data-role=/) && !selectorName.match(/:not\(\[data-role=/)) {
return selectorName.trim();
}
return selectorName.trim() + ":not([data-role='none'])";
}
/**
* Function to define widget
* @method defineWidget
* @param {string} name
* @param {string} selector
* @param {Array} methods
* @param {Object} widgetClass
* @param {string} [namespace]
* @param {boolean} [redefine]
* @param {boolean} [widgetNameToLowercase=true]
* @return {boolean}
* @member ns.engine
* @static
*/
function defineWidget(name, selector, methods, widgetClass, namespace, redefine, widgetNameToLowercase, BaseElement) {
var definition;
// Widget name is absolutely required
if (name) {
if (!widgetDefinitions[name] || redefine) {
methods = methods || [];
methods.push("destroy", "disable", "enable", "option", "refresh", "value");
definition = {
name: name,
methods: methods,
selector: selector || "",
selectors: selector ? selector.split(",").map(selectorChange) : [],
widgetClass: widgetClass || null,
namespace: namespace || "",
widgetNameToLowercase: widgetNameToLowercase === undefined ? true : !!widgetNameToLowercase,
BaseElement: BaseElement
};
widgetDefinitions[name] = definition;
if (namespace) {
widgetDefinitions[namespace + "." + name] = definition;
}
eventUtils.trigger(document, "widgetdefined", definition, false);
return true;
}
} else {
ns.error("Widget with selector [" + selector + "] defined without a name, aborting!");
}
return false;
}
/**
* Get widget instance from binding for given element and type
* @method getInstanceByElement
* @static
* @param {Object} binding
* @param {HTMLElement} element
* @param {string} [type] widget name, if is empty then return first built widget
* @return {?Object}
* @member ns.engine
*/
function getInstanceByElement(binding, element, type) {
var widgetInstance,
bindingElement,
storedWidgetNames,
names = type ? type.split(".") : [],
name = names.pop(),
namespace = names.pop();
// If name is defined it's possible to fetch it instantly
if (name) {
widgetInstance = binding.instances[name];
} else {
storedWidgetNames = Object.keys(binding.instances);
widgetInstance = binding.instances[storedWidgetNames[0]];
}
if (namespace && widgetInstance && widgetInstance.namespace !== namespace) {
widgetInstance = null;
}
// Return only it instance of the proper widget exists
if (widgetInstance) {
// Check if widget instance has that same object referenced
if (widgetInstance.element === element) {
return widgetInstance;
}
}
return null;
}
/**
* Get binding for element
* @method getBinding
* @static
* @param {HTMLElement|string} element
* @param {string} [type] widget name
* @return {?Object}
* @member ns.engine
*/
function getBinding(element, type) {
var id = !element || typeof element === TYPE_STRING ? element : element.id,
binding;
if (typeof element === TYPE_STRING) {
element = document.getElementById(id);
}
if (element) {
// Fetch group of widget defined for this element
binding = widgetBindingMap[id];
if (binding && typeof binding === "object") {
return getInstanceByElement(binding, element, type);
}
}
return null;
}
/**
* Set binding of widget
* @method setBinding
* @param {ns.widget.BaseWidget} widgetInstance
* @static
* @member ns.engine
*/
function setBinding(widgetInstance) {
var id = widgetInstance.element.id,
type = widgetInstance.name,
widgetBinding = widgetBindingMap[id];
// If the HTMLElement never had a widget declared create an empty object
if (!widgetBinding) {
widgetBinding = {
elementId: id,
element: widgetInstance.element,
instances: {}
};
}
widgetBinding.instances[type] = widgetInstance;
widgetBindingMap[id] = widgetBinding;
}
/**
* Returns all bindings for element or id gives as parameter
* @method getAllBindings
* @param {HTMLElement|string} element
* @return {?Object}
* @static
* @member ns.engine
*/
function getAllBindings(element) {
var id = !element || typeof element === TYPE_STRING ? element : element.id;
return (widgetBindingMap[id] && widgetBindingMap[id].instances) || null;
}
/**
* Removes given name from attributeValue string.
* Names should be separated with a NAMES_SEPARATOR
* @param {string} name
* @param {string} attributeValue
* @private
* @static
* @return {string}
*/
function _removeWidgetNameFromAttribute(name, attributeValue) {
var widgetNames,
searchResultIndex;
// Split attribute value by separator
widgetNames = attributeValue.split(NAMES_SEPARATOR);
searchResultIndex = widgetNames.indexOf(name);
if (searchResultIndex > -1) {
widgetNames.splice(searchResultIndex, 1);
attributeValue = widgetNames.join(NAMES_SEPARATOR);
}
return attributeValue;
}
function _removeAllBindingAttributes(element) {
element.removeAttribute(DATA_BUILT);
element.removeAttribute(DATA_BOUND);
element.removeAttribute(DATA_NAME);
}
/**
* Remove binding data attributes for element.
* @method _removeBindingAttributes
* @param {HTMLElement} element
* @param {string} type widget type (name)
* @private
* @static
* @member ns.engine
*/
function _removeWidgetFromAttributes(element, type) {
var dataBuilt,
dataBound,
dataName;
// Most often case is that name is not defined
if (!type) {
_removeAllBindingAttributes(element);
} else {
dataBuilt = _removeWidgetNameFromAttribute(type, element.getAttribute(DATA_BUILT) || "");
dataBound = _removeWidgetNameFromAttribute(type, element.getAttribute(DATA_BOUND) || "");
dataName = _removeWidgetNameFromAttribute(type, element.getAttribute(DATA_NAME) || "");
// Check if all attributes have at least one widget
if (dataBuilt && dataBound && dataName) {
element.setAttribute(DATA_BUILT, dataBuilt);
element.setAttribute(DATA_BOUND, dataBound);
element.setAttribute(DATA_NAME, dataName);
} else {
// If something is missing remove everything
_removeAllBindingAttributes(element);
}
}
}
/**
* Method removes binding for single widget.
* @method _removeSingleBinding
* @param {Object} bindingGroup
* @param {string} type
* @return {boolean}
* @private
* @static
*/
function _removeSingleBinding(bindingGroup, type) {
var widgetInstance = bindingGroup[type];
if (widgetInstance) {
if (widgetInstance.element && typeof widgetInstance.element.setAttribute === TYPE_FUNCTION) {
_removeWidgetFromAttributes(widgetInstance.element, type);
}
delete bindingGroup[type];
return true;
}
return false;
}
/**
* Remove group of bindings for all types of widgets based on the same element
* @method removeGroupBindingAllTypes
* @param {Object} bindingGroup
* @param {string} id widget element id
* @return {boolean}
* @static
* @member ns.engine
*/
function removeGroupBindingAllTypes(bindingGroup, id) {
var singleSuccess,
widgetName,
fullSuccess = true;
// Iterate over group of created widgets
for (widgetName in bindingGroup) {
if (bindingGroup.hasOwnProperty(widgetName)) {
singleSuccess = _removeSingleBinding(bindingGroup, widgetName);
// As we iterate over keys we are sure we want to remove this element
// NOTE: Removing property by delete is slower than assigning null value
bindingGroup[widgetName] = null;
fullSuccess = (fullSuccess && singleSuccess);
}
}
// If the object bindingGroup is empty or every key has a null value
if (objectUtils.hasPropertiesOfValue(bindingGroup, null)) {
// NOTE: Removing property by delete is slower than assigning null value
widgetBindingMap[id] = null;
}
return fullSuccess;
}
/**
* Remove group of bindings for widgets based on the same element
* @method removeGroupBinding
* @param {Object} bindingGroup
* @param {string} type object name
* @param {string} id widget element id
* @return {boolean}
* @static
* @member ns.engine
*/
function removeGroupBinding(bindingGroup, type, id) {
var success;
if (!type) {
success = removeGroupBindingAllTypes(bindingGroup, id);
} else {
success = _removeSingleBinding(bindingGroup, type);
if (objectUtils.hasPropertiesOfValue(bindingGroup, null)) {
widgetBindingMap[id] = null;
}
}
return success;
}
/**
* Remove binding for widget based on element.
* @method removeBinding
* @param {HTMLElement|string} element
* @param {?string} [type=null] widget name
* @return {boolean}
* @static
* @member ns.engine
*/
function removeBinding(element, type) {
var id = (typeof element === TYPE_STRING) ? element : element.id,
binding = widgetBindingMap[id],
bindingGroup;
// [NOTICE] Due to backward compatibility calling removeBinding
// with one parameter should remove all bindings
if (binding) {
if (typeof element === TYPE_STRING) {
// Search based on current document may return bad results,
// use previously defined element if it exists
element = binding.element;
}
if (element) {
_removeWidgetFromAttributes(element, type);
}
bindingGroup = widgetBindingMap[id] && widgetBindingMap[id].instances;
if (bindingGroup) {
return removeGroupBinding(bindingGroup, type, id);
}
if (widgetBindingMap[id].instances && (Object.keys(widgetBindingMap[id].instances).length === 0)) {
widgetBindingMap[id] = null;
}
}
return false;
}
/**
* Removes all bindings of widgets.
* @method removeAllBindings
* @param {HTMLElement|string} element
* @return {boolean}
* @static
* @member ns.engine
*/
function removeAllBindings(element) {
// @TODO this should be coded in the other way around, removeAll should loop through all bindings and inside call removeBinding
// but due to backward compatibility that code should be more readable
return removeBinding(element);
}
/**
* If element not exist create base element for widget.
* @method ensureElement
* @param {HTMLElement} element
* @param {ns.widget.BaseWidget} Widget
* @return {HTMLElement}
* @static
* @private
* @member ns.engine
*/
function ensureElement(element, Widget) {
if (!element || !(element instanceof HTMLElement)) {
if (typeof Widget.createEmptyElement === TYPE_FUNCTION) {
element = Widget.createEmptyElement();
} else {
element = document.createElement("div");
}
}
return element;
}
/**
* Process core widget method
* - configure
* - build
* - init
* - bindEvents
* @method processWidget
* @param {HTMLElement} element base element of widget
* @param {Object} widgetInstance instance of widget
* @param {Object} definition definition of widget
* @param {ns.widget.BaseWidget} definition.widgetClass
* @param {string} definition.name
* @param {Object} [options] options for widget
* @private
* @static
* @member ns.engine
*/
function coreProcessWidget(element, widgetInstance, definition, options) {
var widgetOptions = options || {},
createFunction = widgetOptions.create,
buildAttribute;
widgetInstance.configure(definition, element, options);
// Run .create method from widget options when a [widgetName]create event is triggered
if (typeof createFunction === TYPE_FUNCTION) {
eventUtils.one(element, definition.name.toLowerCase() + "create", createFunction);
}
if (element.id) {
widgetInstance.id = element.id;
}
// Check if this type of widget was build for this element before
buildAttribute = element.getAttribute(DATA_BUILT);
if (!buildAttribute ||
buildAttribute.split(NAMES_SEPARATOR).indexOf(widgetInstance.name) === -1) {
element = widgetInstance.build(element);
}
if (element) {
widgetInstance.element = element;
setBinding(widgetInstance);
widgetInstance.trigger(eventType.WIDGET_BUILT, widgetInstance, false);
if (!justBuild) {
widgetInstance.init(element);
}
widgetInstance.bindEvents(element, justBuild);
widgetInstance.trigger(widgetInstance.widgetEventPrefix + eventType.WIDGET_INIT);
widgetInstance.trigger(eventType.WIDGET_BOUND, widgetInstance, false);
eventUtils.trigger(document, eventType.WIDGET_BOUND, widgetInstance);
} else {
}
}
/**
* Load widget
* @method processWidget
* @param {HTMLElement} element base element of widget
* @param {Object} definition definition of widget
* @param {ns.widget.BaseWidget} definition.widgetClass
* @param {string} definition.name
* @param {Object} [options] options for widget
* @return {?HTMLElement}
* @private
* @static
* @member ns.engine
*/
function processWidget(element, definition, options) {
var Widget = definition.widgetClass,
/**
* @type {ns.widget.BaseWidget} widgetInstance
*/
widgetInstance,
parentEnhance,
existingBinding;
element = ensureElement(element, Widget);
widgetInstance = Widget ? new Widget(element) : false;
// if any parent has attribute data-enhance=false then stop building widgets
parentEnhance = selectors.getParentsBySelectorNS(element, "enhance=false");
// While processing widgets queue other widget may built this one before
// it reaches it's turn
existingBinding = getBinding(element, definition.name);
if (existingBinding && existingBinding.element === element) {
return element;
}
if (widgetInstance) {
if (!parentEnhance.length) {
coreProcessWidget(element, widgetInstance, definition, options);
}
return widgetInstance.element;
}
return null;
}
/**
* Destroys widget of given 'type' for given HTMLElement.
* [NOTICE] This method won't destroy any children widgets.
* @method destroyWidget
* @param {HTMLElement|string} element
* @param {string} type
* @static
* @member ns.engine
*/
function destroyWidget(element, type) {
var widgetInstance;
if (typeof element === TYPE_STRING) {
element = document.getElementById(element);
}
// If type is not defined all widgets should be removed
// this is for backward compatibility
widgetInstance = getBinding(element, type);
if (widgetInstance) {
//Destroy widget
widgetInstance.destroy();
widgetInstance.trigger("widgetdestroyed");
removeBinding(element, type);
}
}
/**
* Calls destroy on group of widgets connected with given HTMLElement
* @method destroyGroupWidgets
* @param {HTMLElement|string} element
* @static
* @private
* @member ns.engine
*/
function destroyGroupWidgets(element) {
var widgetName,
widgetInstance,
widgetGroup;
widgetGroup = getAllBindings(element);
for (widgetName in widgetGroup) {
if (widgetGroup.hasOwnProperty(widgetName)) {
widgetInstance = widgetGroup[widgetName];
//Destroy widget
if (widgetInstance) {
widgetInstance.destroy();
widgetInstance.trigger("widgetdestroyed");
}
}
}
}
/**
* Calls destroy on widget (or widgets) connected with given HTMLElement
* Removes child widgets as well.
* @method destroyAllWidgets
* @param {HTMLElement|string} element
* @param {boolean} [childOnly=false] destroy only widgets on children elements
* @static
* @member ns.engine
*/
function destroyAllWidgets(element, childOnly) {
var childWidgets,
i;
if (typeof element === TYPE_STRING) {
element = document.getElementById(element);
}
if (!childOnly) {
// If type is not defined all widgets should be removed
// this is for backward compatibility
destroyGroupWidgets(element);
}
//Destroy child widgets, if something left.
childWidgets = slice.call(element.querySelectorAll("[" + DATA_BOUND + "]"));
for (i = childWidgets.length - 1; i >= 0; i -= 1) {
if (childWidgets[i]) {
destroyAllWidgets(childWidgets[i], false);
}
}
removeAllBindings(element);
}
/**
* Load widgets from data-* definition
* @method processHollowWidget
* @param {HTMLElement} element base element of widget
* @param {Object} definition widget definition
* @param {Object} [options] options for create widget
* @return {HTMLElement} base element of widget
* @private
* @static
* @member ns.engine
*/
function processHollowWidget(element, definition, options) {
var name = (element && element.getAttribute(DATA_NAME)) ||
(definition && definition.name);
definition = definition || (name && widgetDefinitions[name]) || {
"name": name
};
return processWidget(element, definition, options);
}
/**
* Compare function for nodes on build queue
* @param {Object} nodeA
* @param {Object} nodeB
* @return {number}
* @private
* @static
*/
function compareByDepth(nodeA, nodeB) {
/*jshint -W016 */
var mask = Node.DOCUMENT_POSITION_CONTAINS | Node.DOCUMENT_POSITION_PRECEDING;
if (nodeA.element === nodeB.element) {
return 0;
}
if (nodeA.element.compareDocumentPosition(nodeB.element) & mask) {
return 1;
}
/*jshint +W016 */
return -1;
}
/**
* Processes one build queue item. Runs processHollowWidget
* underneath
* @method processBuildQueueItem
* @param {Object|HTMLElement} queueItem
* @private
* @static
*/
function processBuildQueueItem(queueItem) {
// HTMLElement doesn't have .element property
// widgetDefinitions will return undefined when called widgetDefinitions[undefined]
processHollowWidget(queueItem.element || queueItem, widgetDefinitions[queueItem.widgetName]);
}
/**
* Build widgets on all children of context element
* @method createWidgets
* @static
* @param {HTMLElement} context base html for create children
* @member ns.engine
*/
function createWidgets(context) {
// find widget which are built
var builtWidgetElements = slice.call(context.querySelectorAll(querySelectorWidgets)),
normal,
buildQueue = [],
selectorKeys = Object.keys(widgetDefinitions),
excludeSelector,
i,
j,
len = selectorKeys.length,
definition,
widgetName,
definitionSelectors;
// process built widgets
builtWidgetElements.forEach(processBuildQueueItem);
// process widgets didn't build
for (i = 0; i < len; ++i) {
widgetName = selectorKeys[i];
if (widgetName.indexOf(".") === -1) {
definition = widgetDefinitions[widgetName];
definitionSelectors = definition.selectors;
if (definitionSelectors.length) {
excludeSelector = excludeBuiltAndBound(widgetName);
normal = slice.call(context.querySelectorAll(definitionSelectors.join(excludeSelector + ",") +
excludeSelector));
j = normal.length;
while (--j >= 0) {
buildQueue.push({
element: normal[j],
widgetName: widgetName
});
}
}
}
}
// Sort queue by depth, on every DOM branch outer most element go first
buildQueue.sort(compareByDepth);
// Build all widgets from queue
buildQueue.forEach(processBuildQueueItem);
eventUtils.trigger(document, "built");
eventUtils.trigger(document, eventType.BOUND);
}
/**
* Handler for event create
* @method createEventHandler
* @param {Event} event
* @static
* @member ns.engine
*/
function createEventHandler(event) {
createWidgets(event.target);
}
function setViewport() {
/**
* Sets viewport tag if not exists
*/
var documentHead = document.head,
metaTagListLength,
metaTagList,
metaTag,
i;
metaTagList = documentHead.querySelectorAll("[name=\"viewport\"]");
metaTagListLength = metaTagList.length;
if (metaTagListLength > 0) {
// Leave the last viewport tag
--metaTagListLength;
// Remove duplicated tags
for (i = 0; i < metaTagListLength; ++i) {
// Remove meta tag from DOM
documentHead.removeChild(metaTagList[i]);
}
} else {
// Create new HTML Element
metaTag = document.createElement("meta");
// Set required attributes
metaTag.setAttribute("name", "viewport");
metaTag.setAttribute("content", "width=device-width, user-scalable=no");
// Force that viewport tag will be first child of head
if (documentHead.firstChild) {
documentHead.insertBefore(metaTag, documentHead.firstChild);
} else {
documentHead.appendChild(metaTag);
}
}
}
/**
* Build first page
* @method build
* @static
* @member ns.engine
*/
function build() {
eventUtils.trigger(document, eventType.READY);
setViewport();
}
/**
* Method to remove all listeners bound in run
* @method stop
* @static
* @member ns.engine
*/
function stop() {
}
/**
* Method to remove all listeners bound in run
* @method destroy
* @static
* @member ns.engine
*/
function destroy() {
stop();
eventUtils.fastOff(document, "create", createEventHandler);
destroyAllWidgets(document.body, true);
eventUtils.trigger(document, eventType.DESTROY);
}
/**
* Add to object value at index equal to type of arg.
* @method getType
* @param {Object} result
* @param {*} arg
* @return {Object}
* @static
* @private
* @member ns.engine
*/
function getType(result, arg) {
var type = arg instanceof HTMLElement ? "HTMLElement" : typeof arg;
result[type] = arg;
return result;
}
/**
* Convert args array to object with keys being types and arguments mapped by values
* @method getArgumentsTypes
* @param {Arguments[]} args
* @return {Object}
* @static
* @private
* @member ns.engine
*/
function getArgumentsTypes(args) {
return arrayUtils.reduce(args, getType, {});
}
ns.widgetDefinitions = {};
engine = {
justBuild: location.hash === "#build",
/**
* object with names of engine attributes
* @property {Object} dataTau
* @property {string} [dataTau.built="data-tau-built"] attribute inform that widget id build
* @property {string} [dataTau.name="data-tau-name"] attribute contains widget name
* @property {string} [dataTau.bound="data-tau-bound"] attribute inform that widget id bound
* @property {string} [dataTau.separator=","] separation string for widget names
* @static
* @member ns.engine
*/
dataTau: {
built: DATA_BUILT,
name: DATA_NAME,
bound: DATA_BOUND,
separator: NAMES_SEPARATOR
},
destroyWidget: destroyWidget,
destroyAllWidgets: destroyAllWidgets,
createWidgets: createWidgets,
/**
* Method to get all definitions of widgets
* @method getDefinitions
* @return {Object}
* @static
* @member ns.engine
*/
getDefinitions: function () {
return widgetDefinitions;
},
/**
* Returns definition of widget
* @method getWidgetDefinition
* @param {string} name
* @static
* @member ns.engine
* @return {Object}
*/
getWidgetDefinition: function (name) {
return widgetDefinitions[name];
},
defineWidget: defineWidget,
getBinding: getBinding,
getAllBindings: getAllBindings,
setBinding: setBinding,
removeBinding: removeBinding,
removeAllBindings: removeAllBindings,
/**
* Clear bindings of widgets
* @method _clearBindings
* @static
* @member ns.engine
*/
_clearBindings: function () {
//clear and set references to the same object
widgetBindingMap = {};
},
build: build,
/**
* Run engine
* @method run
* @static
* @member ns.engine
*/
run: function () {
stop();
eventUtils.fastOn(document, "create", createEventHandler);
eventUtils.trigger(document, eventType.INIT, {tau: ns});
switch (document.readyState) {
case "interactive":
case "complete":
build();
break;
default:
eventUtils.one(document, "DOMContentLoaded", build.bind(engine));
break;
}
},
/**
* Build instance of widget and binding events
* Returns error when empty element is passed
* @method instanceWidget
* @param {HTMLElement|string} [element]
* @param {string} name
* @param {Object} [options]
* @return {?Object}
* @static
* @member ns.engine
*/
instanceWidget: function (element, name, options) {
var binding,
definition,
argumentsTypes = getArgumentsTypes(arguments);
// Map arguments with specific types to correct variables
// Only name is required argument
element = argumentsTypes.HTMLElement;
name = argumentsTypes.string;
options = argumentsTypes.object;
// If element exists try to find existing binding
if (element) {
binding = getBinding(element, name);
}
// If didn't found binding build new widget
if (!binding && widgetDefinitions[name]) {
definition = widgetDefinitions[name];
element = processHollowWidget(element, definition, options);
binding = getBinding(element, name);
} else if (binding) {
// if widget was built early we should set options delivered to constructor
binding.option(options);
}
return binding;
},
stop: stop,
destroy: destroy,
/**
* Method to change build mode
* @method setJustBuild
* @param {boolean} newJustBuild
* @static
* @member ns.engine
*/
setJustBuild: function (newJustBuild) {
// Set location hash to have a consistent behavior
if (newJustBuild) {
location.hash = "build";
} else {
location.hash = "";
}
justBuild = newJustBuild;
},
/**
* Method to get build mode
* @method getJustBuild
* @return {boolean}
* @static
* @member ns.engine
*/
getJustBuild: function () {
return justBuild;
},
_createEventHandler: createEventHandler
};
engine.eventType = eventType;
ns.engine = engine;
}(window, window.document));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns */
/**
* #Utility DOM
* Utility object with function to DOM manipulation, CSS properties support
* and DOM attributes support.
*
* # How to replace jQuery methods by ns methods
* ## append vs appendNodes
*
* #### HTML code before manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <div id="second">And</div>
* <div id="third">Goodbye</div>
* </div>
*
* #### jQuery manipulation
*
* @example
* $( "#second" ).append( "<span>Test</span>" );
* #### ns manipulation
*
* @example
* var context = document.getElementById("second"),
* element = document.createElement("span");
* element.innerHTML = "Test";
* ns.util.DOM.appendNodes(context, element);
*
* #### HTML code after manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <div id="second">And
* <span>Test</span>
* </div>
* <div id="third">Goodbye</div>
* </div>
*
* ## replaceWith vs replaceWithNodes
*
* #### HTML code before manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <div id="second">And</div>
* <div id="third">Goodbye</div>
* </div>
*
* #### jQuery manipulation
*
* @example
* $('#second').replaceWith("<span>Test</span>");
*
* #### ns manipulation
*
* @example
* var context = document.getElementById("second"),
* element = document.createElement("span");
* element.innerHTML = "Test";
* ns.util.DOM.replaceWithNodes(context, element);
*
* #### HTML code after manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <span>Test</span>
* <div id="third">Goodbye</div>
* </div>
*
* ## before vs insertNodesBefore
*
* #### HTML code before manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <div id="second">And</div>
* <div id="third">Goodbye</div>
* </div>
*
* #### jQuery manipulation
*
* @example
* $( "#second" ).before( "<span>Test</span>" );
*
* #### ns manipulation
*
* @example
* var context = document.getElementById("second"),
* element = document.createElement("span");
* element.innerHTML = "Test";
* ns.util.DOM.insertNodesBefore(context, element);
*
* #### HTML code after manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <span>Test</span>
* <div id="second">And</div>
* <div id="third">Goodbye</div>
* </div>
*
* ## wrapInner vs wrapInHTML
*
* #### HTML code before manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <div id="second">And</div>
* <div id="third">Goodbye</div>
* </div>
*
* #### jQuery manipulation
*
* @example
* $( "#second" ).wrapInner( "<span class="new"></span>" );
*
* #### ns manipulation
*
* @example
* var element = document.getElementById("second");
* ns.util.DOM.wrapInHTML(element, "<span class="new"></span>");
*
* #### HTML code after manipulation
*
* @example
* <div>
* <div id="first">Hello</div>
* <div id="second">
* <span class="new">And</span>
* </div>
* <div id="third">Goodbye</div>
* </div>
*
* @class ns.util.DOM
* @author Jadwiga Sosnowska <j.sosnowska@partner.samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function () {
"use strict";
ns.util.DOM = ns.util.DOM || {};
}());
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define */
/*
* @author Jadwiga Sosnowska <j.sosnowska@partner.samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function () {
"use strict";
var selectors = ns.util.selectors,
DOM = ns.util.DOM,
NAMESPACE = "namespace";
/**
* Returns given attribute from element or the closest parent,
* which matches the selector.
* @method inheritAttr
* @member ns.util.DOM
* @param {HTMLElement} element
* @param {string} attr
* @param {string} selector
* @return {?string}
* @static
*/
DOM.inheritAttr = function (element, attr, selector) {
var value = element.getAttribute(attr),
parent;
if (!value) {
parent = selectors.getClosestBySelector(element, selector);
if (parent) {
return parent.getAttribute(attr);
}
}
return value;
};
/**
* Returns Number from properties described in html tag
* @method getNumberFromAttribute
* @member ns.util.DOM
* @param {HTMLElement} element
* @param {string} attribute
* @param {string=} [type] auto type casting
* @param {number} [defaultValue] default returned value
* @static
* @return {number}
*/
DOM.getNumberFromAttribute = function (element, attribute, type, defaultValue) {
var value = element.getAttribute(attribute),
result = defaultValue;
if (!isNaN(value)) {
if (type === "float") {
value = parseFloat(value);
if (!isNaN(value)) {
result = value;
}
} else {
value = parseInt(value, 10);
if (!isNaN(value)) {
result = value;
}
}
}
return result;
};
function getDataName(name, skipData) {
var _namespace = ns.getConfig(NAMESPACE),
prefix = "";
if (!skipData) {
prefix = "data-";
}
return prefix + (_namespace ? _namespace + "-" : "") + name;
}
/**
* Special function to set attribute and property in the same time
* @method setAttribute
* @param {HTMLElement} element
* @param {string} name
* @param {Mixed} value
* @member ns.util.DOM
* @static
*/
function setAttribute(element, name, value) {
element[name] = value;
element.setAttribute(name, value);
}
/**
* This function sets value of attribute data-{namespace}-{name} for element.
* If the namespace is empty, the attribute data-{name} is used.
* @method setNSData
* @param {HTMLElement} element Base element
* @param {string} name Name of attribute
* @param {string|number|boolean} value New value
* @member ns.util.DOM
* @static
*/
DOM.setNSData = function (element, name, value) {
element.setAttribute(getDataName(name), value);
};
/**
* This function returns value of attribute data-{namespace}-{name} for element.
* If the namespace is empty, the attribute data-{name} is used.
* Method may return boolean in case of 'true' or 'false' strings as attribute value.
* @method getNSData
* @param {HTMLElement} element Base element
* @param {string} name Name of attribute
* @param {boolean} skipData
* @member ns.util.DOM
* @return {?string|boolean}
* @static
*/
DOM.getNSData = function (element, name, skipData) {
var value = element.getAttribute(getDataName(name, skipData));
if (value === "true") {
return true;
}
if (value === "false") {
return false;
}
return value;
};
/**
* This function returns true if attribute data-{namespace}-{name} for element is set
* or false in another case. If the namespace is empty, attribute data-{name} is used.
* @method hasNSData
* @param {HTMLElement} element Base element
* @param {string} name Name of attribute
* @member ns.util.DOM
* @return {boolean}
* @static
*/
DOM.hasNSData = function (element, name) {
return element.hasAttribute(getDataName(name));
};
/**
* Get or set value on data attribute.
* @method nsData
* @param {HTMLElement} element
* @param {string} name
* @param {?Mixed} [value]
* @static
* @member ns.util.DOM
*/
DOM.nsData = function (element, name, value) {
if (value === undefined) {
return DOM.getNSData(element, name);
} else {
return DOM.setNSData(element, name, value);
}
};
/**
* This function removes attribute data-{namespace}-{name} from element.
* If the namespace is empty, attribute data-{name} is used.
* @method removeNSData
* @param {HTMLElement} element Base element
* @param {string} name Name of attribute
* @member ns.util.DOM
* @static
*/
DOM.removeNSData = function (element, name) {
element.removeAttribute(getDataName(name));
};
/**
* Returns object with all data-* attributes of element
* @method getData
* @param {HTMLElement} element Base element
* @member ns.util.DOM
* @return {Object}
* @static
*/
DOM.getData = function (element) {
var dataPrefix = "data-",
data = {},
attributes = element.attributes,
attribute,
nodeName,
value,
i,
length = attributes.length,
lowerCaseValue;
for (i = 0; i < length; i++) {
attribute = attributes.item(i);
nodeName = attribute.nodeName;
if (nodeName.indexOf(dataPrefix) > -1) {
value = attribute.value;
lowerCaseValue = value.toLowerCase();
if (lowerCaseValue === "true") {
value = true;
} else if (lowerCaseValue === "false") {
value = false;
}
data[nodeName.replace(dataPrefix, "")] = value;
}
}
return data;
};
/**
* Special function to remove attribute and property in the same time
* @method removeAttribute
* @param {HTMLElement} element
* @param {string} name
* @member ns.util.DOM
* @static
*/
DOM.removeAttribute = function (element, name) {
element.removeAttribute(name);
element[name] = false;
};
DOM.setAttribute = setAttribute;
/**
* Special function to set attributes and properties in the same time
* @method setAttribute
* @param {HTMLElement} element
* @param {Object} values
* @member ns.util.DOM
* @static
*/
DOM.setAttributes = function (element, values) {
var i,
names = Object.keys(values),
name,
len;
for (i = 0, len = names.length; i < len; i++) {
name = names[i];
setAttribute(element, name, values[name]);
}
};
}());
/*global window, ns, define, RegExp */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Path Utility
* Object helps work with paths.
* @class ns.util.path
* @static
* @author Tomasz Lukawski <t.lukawski@samsung.com>
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var utilsObject = ns.util.object,
/**
* Local alias for ns.util.selectors
* @property {Object} utilsSelectors Alias for {@link ns.util.selectors}
* @member ns.util.path
* @static
* @private
*/
utilsSelectors = ns.util.selectors,
/**
* Local alias for ns.util.DOM
* @property {Object} utilsDOM Alias for {@link ns.util.DOM}
* @member ns.util.path
* @static
* @private
*/
utilsDOM = ns.util.DOM,
/**
* Cache for document base element
* @member ns.util.path
* @property {HTMLBaseElement} base
* @static
* @private
*/
base,
/**
* location object
* @property {Object} location
* @static
* @private
* @member ns.util.path
*/
location = {},
path = {
/**
* href part for mark state
* @property {string} [uiStateKey="&ui-state"]
* @static
* @member ns.util.path
*/
uiStateKey: "&ui-state",
// This scary looking regular expression parses an absolute URL or its relative
// variants (protocol, site, document, query, and hash), into the various
// components (protocol, host, path, query, fragment, etc that make up the
// URL as well as some other commonly used sub-parts. When used with RegExp.exec()
// or String.match, it parses the URL into a results array that looks like this:
//
// [0]: http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234&type=unread#
// msg-content?param1=true&param2=123
// [1]: http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234&type=unread
// [2]: http://jblas:password@mycompany.com:8080/mail/inbox
// [3]: http://jblas:password@mycompany.com:8080
// [4]: http:
// [5]: //
// [6]: jblas:password@mycompany.com:8080
// [7]: jblas:password
// [8]: jblas
// [9]: password
// [10]: mycompany.com:8080
// [11]: mycompany.com
// [12]: 8080
// [13]: /mail/inbox
// [14]: /mail/
// [15]: inbox
// [16]: ?msg=1234&type=unread
// [17]: #msg-content?param1=true&param2=123
// [18]: #msg-content
// [19]: ?param1=true&param2=123
//
/**
* @property {RegExp} urlParseRE Regular expression for parse URL
* @member ns.util.path
* @static
*/
urlParseRE: /^(((([^:\/#\?]+:)?(?:(\/\/)((?:(([^:@\/#\?]+)(?:\:([^:@\/#\?]+))?)@)?(([^:\/#\?\]\[]+|\[[^\/\]@#?]+\])(?:\:([0-9]+))?))?)?)?((\/?(?:[^\/\?#]+\/+)*)([^\?#]*)))?(\?[^#]+)?)((#[^\?]*)(\?.*)?)?/,
/**
* Abstraction to address xss (Issue #4787) by removing the authority in
* browsers that auto decode it. All references to location.href should be
* replaced with a call to this method so that it can be dealt with properly here
* @method getLocation
* @param {string|Object} [url]
* @return {string}
* @member ns.util.path
*/
getLocation: function (url) {
var uri = this.parseUrl(url || window.location.href),
hash = uri.hash,
search = uri.hashSearch;
// mimic the browser with an empty string when the hash and hashSearch are empty
hash = hash === "#" && !search ? "" : hash;
location = uri;
// Make sure to parse the url or the location object for the hash because using
// location.hash is automatically decoded in firefox, the rest of the url should be from the
// object (location unless we're testing) to avoid the inclusion of the authority
return uri.protocol + "//" + uri.host + uri.pathname + uri.search + hash + search;
},
/**
* Return the original document url
* @method getDocumentUrl
* @member ns.util.path
* @param {boolean} [asParsedObject=false]
* @return {string|Object}
* @static
*/
getDocumentUrl: function (asParsedObject) {
return asParsedObject ? utilsObject.copy(path.documentUrl) : path.documentUrl.href;
},
/**
* Parse a location into a structure
* @method parseLocation
* @return {Object}
* @member ns.util.path
*/
parseLocation: function () {
return this.parseUrl(this.getLocation());
},
/**
* Parse a URL into a structure that allows easy access to
* all of the URL components by name.
* If we're passed an object, we'll assume that it is
* a parsed url object and just return it back to the caller.
* @method parseUrl
* @member ns.util.path
* @param {string|Object} url
* @return {Object} uri record
* @return {string} return.href
* @return {string} return.hrefNoHash
* @return {string} return.hrefNoSearch
* @return {string} return.domain
* @return {string} return.protocol
* @return {string} return.doubleSlash
* @return {string} return.authority
* @return {string} return.username
* @return {string} return.password
* @return {string} return.host
* @return {string} return.hostname
* @return {string} return.port
* @return {string} return.pathname
* @return {string} return.directory
* @return {string} return.filename
* @return {string} return.search
* @return {string} return.hash
* @return {string} return.hashSearch
* @static
*/
parseUrl: function (url) {
var matches;
if (typeof url === "object") {
return url;
}
matches = path.urlParseRE.exec(url || "") || [];
// Create an object that allows the caller to access the sub-matches
// by name. Note that IE returns an empty string instead of undefined,
// like all other browsers do, so we normalize everything so its consistent
// no matter what browser we're running on.
return {
href: matches[0] || "",
hrefNoHash: matches[1] || "",
hrefNoSearch: matches[2] || "",
domain: matches[3] || "",
protocol: matches[4] || "",
doubleSlash: matches[5] || "",
authority: matches[6] || "",
username: matches[8] || "",
password: matches[9] || "",
host: matches[10] || "",
hostname: matches[11] || "",
port: matches[12] || "",
pathname: matches[13] || "",
directory: matches[14] || "",
filename: matches[15] || "",
search: matches[16] || "",
hash: matches[18] || "",
hashSearch: matches[19] || ""
};
},
/**
* Turn relPath into an absolute path. absPath is
* an optional absolute path which describes what
* relPath is relative to.
* @method makePathAbsolute
* @member ns.util.path
* @param {string} relPath
* @param {string} [absPath=""]
* @return {string}
* @static
*/
makePathAbsolute: function (relPath, absPath) {
var absStack,
relStack,
directory,
i;
if (relPath && relPath.charAt(0) === "/") {
return relPath;
}
relPath = relPath || "";
absPath = absPath ? absPath.replace(/^\/|(\/[^\/]*|[^\/]+)$/g, "") : "";
absStack = absPath ? absPath.split("/") : [];
relStack = relPath.split("/");
for (i = 0; i < relStack.length; i++) {
directory = relStack[i];
switch (directory) {
case ".":
break;
case "..":
if (absStack.length) {
absStack.pop();
}
break;
default:
absStack.push(directory);
break;
}
}
return "/" + absStack.join("/");
},
/**
* Returns true if both urls have the same domain.
* @method isSameDomain
* @member ns.util.path
* @param {string|Object} absUrl1
* @param {string|Object} absUrl2
* @return {boolean}
* @static
*/
isSameDomain: function (absUrl1, absUrl2) {
return path.parseUrl(absUrl1).domain === path.parseUrl(absUrl2).domain;
},
/**
* Returns true for any relative variant.
* @method isRelativeUrl
* @member ns.util.path
* @param {string|Object} url
* @return {boolean}
* @static
*/
isRelativeUrl: function (url) {
// All relative Url variants have one thing in common, no protocol.
return path.parseUrl(url).protocol === "";
},
/**
* Returns true for an absolute url.
* @method isAbsoluteUrl
* @member ns.util.path
* @param {string} url
* @return {boolean}
* @static
*/
isAbsoluteUrl: function (url) {
return path.parseUrl(url).protocol !== "";
},
/**
* Turn the specified relative URL into an absolute one. This function
* can handle all relative variants (protocol, site, document, query, fragment).
* @method makeUrlAbsolute
* @member ns.util.path
* @param {string} relUrl
* @param {string} absUrl
* @return {string}
* @static
*/
makeUrlAbsolute: function (relUrl, absUrl) {
var relObj,
absObj,
protocol,
doubleSlash,
authority,
hasPath,
pathname,
search,
hash;
if (!path.isRelativeUrl(relUrl)) {
return relUrl;
}
relObj = path.parseUrl(relUrl);
absObj = path.parseUrl(absUrl);
protocol = relObj.protocol || absObj.protocol;
doubleSlash = relObj.protocol ? relObj.doubleSlash : (relObj.doubleSlash || absObj.doubleSlash);
authority = relObj.authority || absObj.authority;
hasPath = relObj.pathname !== "";
pathname = path.makePathAbsolute(relObj.pathname || absObj.filename, absObj.pathname);
search = relObj.search || (!hasPath && absObj.search) || "";
hash = relObj.hash;
return protocol + doubleSlash + authority + pathname + search + hash;
},
/**
* Add search (aka query) params to the specified url.
* If page is embedded page, search query will be added after
* hash tag. It's allowed to add query content for both external
* pages and embedded pages.
* Examples:
* http://domain/path/index.html#embedded?search=test
* http://domain/path/external.html?s=query#embedded?s=test
* @method addSearchParams
* @member ns.util.path
* @param {string|Object} url
* @param {Object|string} params
* @return {string}
*/
addSearchParams: function (url, params) {
var urlObject = path.parseUrl(url),
paramsString = (typeof params === "object") ? this.getAsURIParameters(params) : params,
searchChar,
urlObjectHash = urlObject.hash;
if (path.isEmbedded(url) && paramsString.length > 0) {
searchChar = urlObject.hashSearch || "?";
return urlObject.hrefNoHash + (urlObjectHash || "") + searchChar + (searchChar.charAt(searchChar.length - 1) === "?" ? "" : "&") + paramsString;
}
searchChar = urlObject.search || "?";
return urlObject.hrefNoSearch + searchChar + (searchChar.charAt(searchChar.length - 1) === "?" ? "" : "&") + paramsString + (urlObjectHash || "");
},
/**
* Add search params to the specified url with hash
* @method addHashSearchParams
* @member ns.util.path
* @param {string|Object} url
* @param {Object|string} params
* @return {string}
*/
addHashSearchParams: function (url, params) {
var urlObject = path.parseUrl(url),
paramsString = (typeof params === "object") ? path.getAsURIParameters(params) : params,
hash = urlObject.hash,
searchChar = hash ? (hash.indexOf("?") < 0 ? hash + "?" : hash + "&") : "#?";
return urlObject.hrefNoHash + searchChar + (searchChar.charAt(searchChar.length - 1) === "?" ? "" : "&") + paramsString;
},
/**
* Convert absolute Url to data Url
* - for embedded pages strips parameters
* - for the same domain as document base remove domain
* otherwise returns decoded absolute Url
* @method convertUrlToDataUrl
* @member ns.util.path
* @param {string} absUrl
* @param {boolean} dialogHashKey
* @param {Object} documentBase uri structure
* @return {string}
* @static
*/
convertUrlToDataUrl: function (absUrl, dialogHashKey, documentBase) {
var urlObject = path.parseUrl(absUrl);
if (path.isEmbeddedPage(urlObject, !!dialogHashKey)) {
// Keep hash and search data for embedded page
return path.getFilePath(urlObject.hash + urlObject.hashSearch, dialogHashKey);
}
documentBase = documentBase || path.documentBase;
if (path.isSameDomain(urlObject, documentBase)) {
return urlObject.hrefNoHash.replace(documentBase.domain, "");
}
return window.decodeURIComponent(absUrl);
},
/**
* Get path from current hash, or from a file path
* @method get
* @member ns.util.path
* @param {string} newPath
* @return {string}
*/
get: function (newPath) {
if (newPath === undefined) {
newPath = this.parseLocation().hash;
}
return this.stripHash(newPath).replace(/[^\/]*\.[^\/*]+$/, "");
},
/**
* Test if a given url (string) is a path
* NOTE might be exceptionally naive
* @method isPath
* @member ns.util.path
* @param {string} url
* @return {boolean}
* @static
*/
isPath: function (url) {
return (/\//).test(url);
},
/**
* Return a url path with the window's location protocol/hostname/pathname removed
* @method clean
* @member ns.util.path
* @param {string} url
* @param {Object} documentBase uri structure
* @return {string}
* @static
*/
clean: function (url, documentBase) {
return url.replace(documentBase.domain, "");
},
/**
* Just return the url without an initial #
* @method stripHash
* @member ns.util.path
* @param {string} url
* @return {string}
* @static
*/
stripHash: function (url) {
return url.replace(/^#/, "");
},
/**
* Return the url without an query params
* @method stripQueryParams
* @member ns.util.path
* @param {string} url
* @return {string}
* @static
*/
stripQueryParams: function (url) {
return url.replace(/\?.*$/, "");
},
/**
* Validation proper hash
* @method isHashValid
* @member ns.util.path
* @param {string} hash
* @static
*/
isHashValid: function (hash) {
return (/^#[^#]+$/).test(hash);
},
/**
* Check whether a url is referencing the same domain, or an external domain or different
* protocol could be mailto, etc
* @method isExternal
* @member ns.util.path
* @param {string|Object} url
* @param {Object} documentUrl uri object
* @return {boolean}
* @static
*/
isExternal: function (url, documentUrl) {
var urlObject = path.parseUrl(url);
return urlObject.protocol && urlObject.domain !== documentUrl.domain ? true : false;
},
/**
* Check if the url has protocol
* @method hasProtocol
* @member ns.util.path
* @param {string} url
* @return {boolean}
* @static
*/
hasProtocol: function (url) {
return (/^(:?\w+:)/).test(url);
},
/**
* Check if the url refers to embedded content
* @method isEmbedded
* @member ns.util.path
* @param {string} url
* @return {boolean}
* @static
*/
isEmbedded: function (url) {
var urlObject = path.parseUrl(url);
if (urlObject.protocol !== "") {
return (!path.isPath(urlObject.hash) && !!urlObject.hash && (urlObject.hrefNoHash === path.parseLocation().hrefNoHash));
}
return (/\?.*#|^#/).test(urlObject.href);
},
/**
* Get the url as it would look squashed on to the current resolution url
* @method squash
* @member ns.util.path
* @param {string} url
* @param {string} [resolutionUrl=undefined]
* @return {string}
*/
squash: function (url, resolutionUrl) {
var href,
cleanedUrl,
search,
stateIndex,
isPath = this.isPath(url),
uri = this.parseUrl(url),
preservedHash = uri.hash,
uiState = "";
// produce a url against which we can resole the provided path
resolutionUrl = resolutionUrl || (path.isPath(url) ? path.getLocation() : path.getDocumentUrl());
// If the url is anything but a simple string, remove any preceding hash
// eg #foo/bar -> foo/bar
// #foo -> #foo
cleanedUrl = isPath ? path.stripHash(url) : url;
// If the url is a full url with a hash check if the parsed hash is a path
// if it is, strip the #, and use it otherwise continue without change
cleanedUrl = path.isPath(uri.hash) ? path.stripHash(uri.hash) : cleanedUrl;
// Split the UI State keys off the href
stateIndex = cleanedUrl.indexOf(this.uiStateKey);
// store the ui state keys for use
if (stateIndex > -1) {
uiState = cleanedUrl.slice(stateIndex);
cleanedUrl = cleanedUrl.slice(0, stateIndex);
}
// make the cleanedUrl absolute relative to the resolution url
href = path.makeUrlAbsolute(cleanedUrl, resolutionUrl);
// grab the search from the resolved url since parsing from
// the passed url may not yield the correct result
search = this.parseUrl(href).search;
// @TODO all this crap is terrible, clean it up
if (isPath) {
// reject the hash if it's a path or it's just a dialog key
if (path.isPath(preservedHash) || preservedHash.replace("#", "").indexOf(this.uiStateKey) === 0) {
preservedHash = "";
}
// Append the UI State keys where it exists and it's been removed
// from the url
if (uiState && preservedHash.indexOf(this.uiStateKey) === -1) {
preservedHash += uiState;
}
// make sure that pound is on the front of the hash
if (preservedHash.indexOf("#") === -1 && preservedHash !== "") {
preservedHash = "#" + preservedHash;
}
// reconstruct each of the pieces with the new search string and hash
href = path.parseUrl(href);
href = href.protocol + "//" + href.host + href.pathname + search + preservedHash;
} else {
href += href.indexOf("#") > -1 ? uiState : "#" + uiState;
}
return href;
},
/**
* Check if the hash is preservable
* @method isPreservableHash
* @member ns.util.path
* @param {string} hash
* @return {boolean}
*/
isPreservableHash: function (hash) {
return hash.replace("#", "").indexOf(this.uiStateKey) === 0;
},
/**
* Escape weird characters in the hash if it is to be used as a selector
* @method hashToSelector
* @member ns.util.path
* @param {string} hash
* @return {string}
* @static
*/
hashToSelector: function (hash) {
var hasHash = (hash.substring(0, 1) === "#");
if (hasHash) {
hash = hash.substring(1);
}
return (hasHash ? "#" : "") + hash.replace(new RegExp("([!\"#$%&'()*+,./:;<=>?@[\\]^`{|}~])", "g"), "\\$1");
},
/**
* Check if the specified url refers to the first page in the main application document.
* @method isFirstPageUrl
* @member ns.util.path
* @param {string} url
* @param {HTMLElement} firstPageElement first page element
* @param {string} documentBase uri structure
* @param {boolean} documentBaseDiffers
* @param {Object} documentUrl uri structure
* @return {boolean}
* @static
*/
isFirstPageUrl: function (url, firstPageElement, documentBase, documentBaseDiffers, documentUrl) {
var urlStructure,
samePath,
firstPageId,
hash;
documentBase = documentBase === undefined ? path.documentBase : documentBase;
documentBaseDiffers = documentBaseDiffers === undefined ? path.documentBaseDiffers : documentBaseDiffers;
documentUrl = documentUrl === undefined ? path.documentUrl : documentUrl;
// We only deal with absolute paths.
urlStructure = path.parseUrl(path.makeUrlAbsolute(url, documentBase));
// Does the url have the same path as the document?
samePath = urlStructure.hrefNoHash === documentUrl.hrefNoHash || (documentBaseDiffers && urlStructure.hrefNoHash === documentBase.hrefNoHash);
// Get the id of the first page element if it has one.
firstPageId = firstPageElement && firstPageElement.id || false;
hash = urlStructure.hash;
// The url refers to the first page if the path matches the document and
// it either has no hash value, or the hash is exactly equal to the id of the
// first page element.
return samePath && (!hash || hash === "#" || (firstPageId && hash.replace(/^#/, "") === firstPageId));
},
/**
* Some embedded browsers, like the web view in Phone Gap, allow cross-domain XHR
* requests if the document doing the request was loaded via the file:// protocol.
* This is usually to allow the application to "phone home" and fetch app specific
* data. We normally let the browser handle external/cross-domain urls, but if the
* allowCrossDomainPages option is true, we will allow cross-domain http/https
* requests to go through our page loading logic.
* @method isPermittedCrossDomainRequest
* @member ns.util.path
* @param {Object} docUrl
* @param {string} reqUrl
* @return {boolean}
* @static
*/
isPermittedCrossDomainRequest: function (docUrl, reqUrl) {
return ns.getConfig("allowCrossDomainPages", false) &&
docUrl.protocol === "file:" &&
reqUrl.search(/^https?:/) !== -1;
},
/**
* Convert a object data to URI parameters
* @method getAsURIParameters
* @member ns.util.path
* @param {Object} data
* @return {string}
* @static
*/
getAsURIParameters: function (data) {
var url = "",
key;
for (key in data) {
if (data.hasOwnProperty(key)) {
url += encodeURIComponent(key) + "=" + encodeURIComponent(data[key]) + "&";
}
}
return url.substring(0, url.length - 1);
},
/**
* Document Url
* @member ns.util.path
* @property {string|null} documentUrl
*/
documentUrl: null,
/**
* The document base differs
* @member ns.util.path
* @property {boolean} documentBaseDiffers
*/
documentBaseDiffers: false,
/**
* Set location hash to path
* @method set
* @member ns.util.path
* @param {string} path
* @static
*/
set: function (path) {
location.hash = path;
},
/**
* Return the substring of a file path before the sub-page key,
* for making a server request
* @method getFilePath
* @member ns.util.path
* @param {string} path
* @param {string} dialogHashKey
* @return {string}
* @static
*/
getFilePath: function (path, dialogHashKey) {
var splitKey = "&" + ns.getConfig("subPageUrlKey", "");
return path && path.split(splitKey)[0].split(dialogHashKey)[0];
},
/**
* Remove the preceding hash, any query params, and dialog notations
* @method cleanHash
* @member ns.util.path
* @param {string} hash
* @param {string} dialogHashKey
* @return {string}
* @static
*/
cleanHash: function (hash, dialogHashKey) {
return path.stripHash(hash.replace(/\?.*$/, "").replace(dialogHashKey, ""));
},
/**
* Check if url refers to the embedded page
* @method isEmbeddedPage
* @member ns.util.path
* @param {string} url
* @param {boolean} allowEmbeddedOnlyBaseDoc
* @return {boolean}
* @static
*/
isEmbeddedPage: function (url, allowEmbeddedOnlyBaseDoc) {
var urlObject = path.parseUrl(url);
//if the path is absolute, then we need to compare the url against
//both the documentUrl and the documentBase. The main reason for this
//is that links embedded within external documents will refer to the
//application document, whereas links embedded within the application
//document will be resolved against the document base.
if (urlObject.protocol !== "") {
return (urlObject.hash &&
(allowEmbeddedOnlyBaseDoc ?
urlObject.hrefNoHash === path.documentUrl.hrefNoHash :
urlObject.hrefNoHash === path.parseLocation().hrefNoHash));
}
return (/^#/).test(urlObject.href);
}
};
path.documentUrl = path.parseLocation();
base = document.querySelector("base");
/**
* The document base URL for the purposes of resolving relative URLs,
* and the name of the default browsing context for the purposes of
* following hyperlinks
* @member ns.util.path
* @property {Object} documentBase uri structure
* @static
*/
path.documentBase = base ? path.parseUrl(path.makeUrlAbsolute(base.getAttribute("href"),
path.documentUrl.href)) : path.documentUrl;
path.documentBaseDiffers = (path.documentUrl.hrefNoHash !== path.documentBase.hrefNoHash);
/**
* Get document base
* @method getDocumentBase
* @member ns.util.path
* @param {boolean} [asParsedObject=false]
* @return {string|Object}
* @static
*/
path.getDocumentBase = function (asParsedObject) {
return asParsedObject ? utilsObject.copy(path.documentBase) : path.documentBase.href;
};
/**
* Find the closest page and extract out its url
* @method getClosestBaseUrl
* @member ns.util.path
* @param {HTMLElement} element
* @param {string} selector
* @return {string}
* @static
*/
path.getClosestBaseUrl = function (element, selector) {
// Find the closest page and extract out its url.
var url = utilsDOM.getNSData(utilsSelectors.getClosestBySelector(element, selector), "url"),
baseUrl = path.documentBase.hrefNoHash;
if (!ns.getConfig("dynamicBaseEnabled", true) || !url || !path.isPath(url)) {
url = baseUrl;
}
return path.makeUrlAbsolute(url, baseUrl);
};
ns.util.path = path;
}(window, window.document, ns));
/**
*
*/
(function (window) {
"use strict";
var isarray = Array.isArray;
pathToRegexp.parse = parse
pathToRegexp.compile = compile
pathToRegexp.tokensToFunction = tokensToFunction
pathToRegexp.tokensToRegExp = tokensToRegExp
/**
* Start original file
* Licence MIT
* https://github.com/pillarjs/path-to-regexp
*/
/**
* The main path matching regexp utility.
*
* @type {RegExp}
*/
var PATH_REGEXP = new RegExp([
// Match escaped characters that would otherwise appear in future matches.
// This allows the user to escape special characters that won't transform.
'(\\\\.)',
// Match Express-style parameters and un-named parameters with a prefix
// and optional suffixes. Matches appear as:
//
// "/:test(\\d+)?" => ["/", "test", "\d+", undefined, "?"]
// "/route(\\d+)" => [undefined, undefined, undefined, "\d+", undefined]
'([\\/.])?(?:\\:(\\w+)(?:\\(((?:\\\\.|[^)])*)\\))?|\\(((?:\\\\.|[^)])*)\\))([+*?])?'
].join('|'), 'g')
/**
* Parse a string for the raw tokens.
*
* @param {String} str
* @return {Array}
*/
function parse (str) {
var tokens = []
var key = 0
var index = 0
var path = ''
var res
while ((res = PATH_REGEXP.exec(str)) != null) {
var m = res[0]
var escaped = res[1]
var offset = res.index
path += str.slice(index, offset)
index = offset + m.length
// Ignore already escaped sequences.
if (escaped) {
path += escaped[1]
continue
}
// Push the current path onto the tokens.
if (path) {
tokens.push(path)
path = ''
}
var prefix = res[2]
var name = res[3]
var capture = res[4]
var group = res[5]
var suffix = res[6]
var repeat = suffix === '+' || suffix === '*'
var optional = suffix === '?' || suffix === '*'
var delimiter = prefix || '/'
tokens.push({
name: name || key++,
prefix: prefix || '',
delimiter: delimiter,
optional: optional,
repeat: repeat,
pattern: escapeGroup(capture || group || '[^' + delimiter + ']+?')
})
}
// Match any characters still remaining.
if (index < str.length) {
path += str.substr(index)
}
// If the path exists, push it onto the end.
if (path) {
tokens.push(path)
}
return tokens
}
/**
* Compile a string to a template function for the path.
*
* @param {String} str
* @return {Function}
*/
function compile (str) {
return tokensToFunction(parse(str))
}
/**
* Expose a method for transforming tokens into the path function.
*/
function tokensToFunction (tokens) {
// Compile all the tokens into regexps.
var matches = new Array(tokens.length)
// Compile all the patterns before compilation.
for (var i = 0; i < tokens.length; i++) {
if (typeof tokens[i] === 'object') {
matches[i] = new RegExp('^' + tokens[i].pattern + '$')
}
}
return function (obj) {
var path = ''
obj = obj || {}
for (var i = 0; i < tokens.length; i++) {
var key = tokens[i]
if (typeof key === 'string') {
path += key
continue
}
var value = obj[key.name]
if (value == null) {
if (key.optional) {
continue
} else {
throw new TypeError('Expected "' + key.name + '" to be defined')
}
}
if (isarray(value)) {
if (!key.repeat) {
throw new TypeError('Expected "' + key.name + '" to not repeat')
}
if (value.length === 0) {
if (key.optional) {
continue
} else {
throw new TypeError('Expected "' + key.name + '" to not be empty')
}
}
for (var j = 0; j < value.length; j++) {
if (!matches[i].test(value[j])) {
throw new TypeError('Expected all "' + key.name + '" to match "' + key.pattern + '"')
}
path += (j === 0 ? key.prefix : key.delimiter) + encodeURIComponent(value[j])
}
continue
}
if (!matches[i].test(value)) {
throw new TypeError('Expected "' + key.name + '" to match "' + key.pattern + '"')
}
path += key.prefix + encodeURIComponent(value)
}
return path
}
}
/**
* Escape a regular expression string.
*
* @param {String} str
* @return {String}
*/
function escapeString (str) {
return str.replace(/([.+*?=^!:${}()[\]|\/])/g, '\\$1')
}
/**
* Escape the capturing group by escaping special characters and meaning.
*
* @param {String} group
* @return {String}
*/
function escapeGroup (group) {
return group.replace(/([=!:$\/()])/g, '\\$1')
}
/**
* Attach the keys as a property of the regexp.
*
* @param {RegExp} re
* @param {Array} keys
* @return {RegExp}
*/
function attachKeys (re, keys) {
re.keys = keys
return re
}
/**
* Get the flags for a regexp from the options.
*
* @param {Object} options
* @return {String}
*/
function flags (options) {
return options.sensitive ? '' : 'i'
}
/**
* Pull out keys from a regexp.
*
* @param {RegExp} path
* @param {Array} keys
* @return {RegExp}
*/
function regexpToRegexp (path, keys) {
// Use a negative lookahead to match only capturing groups.
var groups = path.source.match(/\((?!\?)/g)
if (groups) {
for (var i = 0; i < groups.length; i++) {
keys.push({
name: i,
prefix: null,
delimiter: null,
optional: false,
repeat: false,
pattern: null
})
}
}
return attachKeys(path, keys)
}
/**
* Transform an array into a regexp.
*
* @param {Array} path
* @param {Array} keys
* @param {Object} options
* @return {RegExp}
*/
function arrayToRegexp (path, keys, options) {
var parts = []
for (var i = 0; i < path.length; i++) {
parts.push(pathToRegexp(path[i], keys, options).source)
}
var regexp = new RegExp('(?:' + parts.join('|') + ')', flags(options))
return attachKeys(regexp, keys)
}
/**
* Create a path regexp from string input.
*
* @param {String} path
* @param {Array} keys
* @param {Object} options
* @return {RegExp}
*/
function stringToRegexp (path, keys, options) {
var tokens = parse(path)
var re = tokensToRegExp(tokens, options)
// Attach keys back to the regexp.
for (var i = 0; i < tokens.length; i++) {
if (typeof tokens[i] !== 'string') {
keys.push(tokens[i])
}
}
return attachKeys(re, keys)
}
/**
* Expose a function for taking tokens and returning a RegExp.
*
* @param {Array} tokens
* @param {Array} keys
* @param {Object} options
* @return {RegExp}
*/
function tokensToRegExp (tokens, options) {
options = options || {}
var strict = options.strict
var end = options.end !== false
var route = ''
var lastToken = tokens[tokens.length - 1]
var endsWithSlash = typeof lastToken === 'string' && /\/$/.test(lastToken)
// Iterate over the tokens and create our regexp string.
for (var i = 0; i < tokens.length; i++) {
var token = tokens[i]
if (typeof token === 'string') {
route += escapeString(token)
} else {
var prefix = escapeString(token.prefix)
var capture = token.pattern
if (token.repeat) {
capture += '(?:' + prefix + capture + ')*'
}
if (token.optional) {
if (prefix) {
capture = '(?:' + prefix + '(' + capture + '))?'
} else {
capture = '(' + capture + ')?'
}
} else {
capture = prefix + '(' + capture + ')'
}
route += capture
}
}
// In non-strict mode we allow a slash at the end of match. If the path to
// match already ends with a slash, we remove it for consistency. The slash
// is valid at the end of a path match, not in the middle. This is important
// in non-ending mode, where "/test/" shouldn't match "/test//route".
if (!strict) {
route = (endsWithSlash ? route.slice(0, -2) : route) + '(?:\\/(?=$))?'
}
if (end) {
route += '$'
} else {
// In non-ending mode, we need the capturing groups to match as much as
// possible by using a positive lookahead to the end or next path segment.
route += strict && endsWithSlash ? '' : '(?=\\/|$)'
}
return new RegExp('^' + route, flags(options))
}
/**
* Normalize the given path string, returning a regular expression.
*
* An empty array can be passed in for the keys, which will hold the
* placeholder key descriptions. For example, using `/user/:id`, `keys` will
* contain `[{ name: 'id', delimiter: '/', optional: false, repeat: false }]`.
*
* @param {(String|RegExp|Array)} path
* @param {Array} [keys]
* @param {Object} [
*
* options]
* @return {RegExp}
*/
function pathToRegexp (path, keys, options) {
keys = keys || []
if (!isarray(keys)) {
options = keys
keys = []
} else if (!options) {
options = {}
}
if (path instanceof RegExp) {
return regexpToRegexp(path, keys, options)
}
if (isarray(path)) {
return arrayToRegexp(path, keys, options)
}
return stringToRegexp(path, keys, options)
}
/**
* End original file
*/
window.pathToRegexp = pathToRegexp;
}(window));
/*global define, ns */
/*
* Copyright (c) 2010 - 2014 Samsung Electronics Co., Ltd.
* License : MIT License V2
*/
/**
* #Path to Regexp Utility
* Convert string to regexp and can match path string to one defined regex path
*
* Syntax of paths is the same as in Express for nodejs
*
* Library based on https://github.com/pillarjs/path-to-regexp
* @class ns.util.pathToRegexp
* @author Maciej Urbanski <m.urbanski@samsung.com>
*
*/
(function (window) {
"use strict";
ns.util.pathToRegexp = window.pathToRegexp;
}(window));
/*global define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Router
* Namespace for routers
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @class ns.router
*/
(function () {
"use strict";
ns.router = ns.router || {};
}());
/*global define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Route Namespace
* Object contains rules for router.
*
* @class ns.router.route
*/
/*
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function () {
"use strict";
ns.router.route = ns.router.route || {};
}());
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
/**
* #History
* Object controls history changes.
*
* @class ns.history
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (window) {
"use strict";
var historyVolatileMode,
object = ns.util.object,
historyUid = 0,
historyActiveIndex = 0,
windowHistory = window.history,
history = {
/**
* Property contains active state in history.
* @property {Object} activeState
* @static
* @member ns.history
*/
activeState: null,
/**
* This method replaces or pushes state to history.
* @method replace
* @param {Object} state The state object
* @param {string} stateTitle The title of state
* @param {string} url The new history entry's URL
* @static
* @member ns.history
*/
replace: function (state, stateTitle, url) {
var newState = object.merge({}, state, {
uid: historyVolatileMode ? historyActiveIndex : ++historyUid,
stateUrl: url,
stateTitle: stateTitle
});
windowHistory[historyVolatileMode ? "replaceState" : "pushState"](newState, stateTitle, url);
history.setActive(newState);
},
/**
* This method moves backward through history.
* @method back
* @static
* @member ns.history
*/
back: function () {
windowHistory.back();
},
/**
* This method sets active state.
* @method setActive
* @param {Object} state Activated state
* @static
* @member ns.history
*/
setActive: function (state) {
if (state) {
history.activeState = state;
historyActiveIndex = state.uid;
if (state.volatileRecord) {
history.enableVolatileMode();
return;
}
}
history.disableVolatileMode();
},
/**
* This method returns "back" if state is in history or "forward" if it is new state.
* @method getDirection
* @param {Object} state Checked state
* @return {"back"|"forward"}
* @static
* @member ns.history
*/
getDirection: function (state) {
if (state) {
return state.uid <= historyActiveIndex ? "back" : "forward";
}
return "back";
},
/**
* This method sets volatile mode to true.
* @method enableVolatileMode
* @static
* @member ns.history
*/
enableVolatileMode: function () {
historyVolatileMode = true;
},
/**
* This method sets volatile mode to false.
* @method disableVolatileMode
* @static
* @member ns.history
*/
disableVolatileMode: function () {
historyVolatileMode = false;
}
};
ns.history = history;
}(window));
/*global CustomEvent, define, window, ns */
/*jslint plusplus: true, nomen: true, bitwise: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Virtual Mouse Events
* Reimplementation of jQuery Mobile virtual mouse events.
*
* ##Purpose
* It will let for users to register callbacks to the standard events like bellow,
* without knowing if device support touch or mouse events
* @class ns.event.vmouse
*/
/**
* Triggered after mouse-down or touch-started.
* @event vmousedown
* @member ns.event.vmouse
*/
/**
* Triggered when mouse-click or touch-end when touch-move didn't occur
* @event vclick
* @member ns.event.vmouse
*/
/**
* Triggered when mouse-up or touch-end
* @event vmouseup
* @member ns.event.vmouse
*/
/**
* Triggered when mouse-move or touch-move
* @event vmousemove
* @member ns.event.vmouse
*/
/**
* Triggered when mouse-over or touch-start if went over coordinates
* @event vmouseover
* @member ns.event.vmouse
*/
/**
* Triggered when mouse-out or touch-end
* @event vmouseout
* @member ns.event.vmouse
*/
/**
* Triggered when mouse-cancel or touch-cancel and when scroll occur during touchmove
* @event vmousecancel
* @member ns.event.vmouse
*/
(function (window, document, ns) {
"use strict";
/**
* Object with default options
* @property {Object} vmouse
* @member ns.event.vmouse
* @static
* @private
**/
var vmouse,
/**
* @property {Object} eventProps Contains the properties which are copied from the original
* event to custom v-events
* @member ns.event.vmouse
* @static
* @private
**/
eventProps,
/**
* Indicates if the browser support touch events
* @property {boolean} touchSupport
* @member ns.event.vmouse
* @static
**/
touchSupport = window.hasOwnProperty("ontouchstart"),
/**
* @property {boolean} didScroll The flag tell us if the scroll event was triggered
* @member ns.event.vmouse
* @static
* @private
**/
didScroll,
/** @property {HTMLElement} lastOver holds reference to last element that touch was over
* @member ns.event.vmouse
* @private
*/
lastOver = null,
/**
* @property {number} [startX=0] Initial data for touchstart event
* @member ns.event.vmouse
* @static
* @private
**/
startX = 0,
/**
* @property {number} [startY=0] Initial data for touchstart event
* @member ns.event.vmouse
* @private
* @static
**/
startY = 0,
touchEventProps = ["clientX", "clientY", "pageX", "pageY", "screenX", "screenY"],
KEY_CODES = {
enter: 13
};
/**
* Extends objects with other objects
* @method copyProps
* @param {Object} from Sets the original event
* @param {Object} to Sets the new event
* @param {Object} properties Sets the special properties for position
* @param {Object} propertiesNames Describe parameters which will be copied from Original to
* event
* @private
* @static
* @member ns.event.vmouse
*/
function copyProps(from, to, properties, propertiesNames) {
var i,
length,
descriptor,
property;
for (i = 0, length = propertiesNames.length; i < length; ++i) {
property = propertiesNames[i];
if (isNaN(properties[property]) === false || isNaN(from[property]) === false) {
descriptor = Object.getOwnPropertyDescriptor(to, property);
if (property !== "detail" && (!descriptor || descriptor.writable)) {
to[property] = properties[property] || from[property];
}
}
}
}
/**
* Create custom event
* @method createEvent
* @param {string} newType gives a name for the new Type of event
* @param {Event} original Event which trigger the new event
* @param {Object} properties Sets the special properties for position
* @return {Event}
* @private
* @static
* @member ns.event.vmouse
*/
function createEvent(newType, original, properties) {
var evt = new CustomEvent(newType, {
"bubbles": original.bubbles,
"cancelable": original.cancelable,
"detail": original.detail
}),
originalType = original.type,
changeTouches,
touch,
j = 0,
len,
prop;
copyProps(original, evt, properties, eventProps);
evt._originalEvent = original;
if (originalType.indexOf("touch") !== -1) {
originalType = original.touches;
changeTouches = original.changedTouches;
if (originalType && originalType.length) {
touch = originalType[0];
} else {
touch = (changeTouches && changeTouches.length) ? changeTouches[0] : null;
}
if (touch) {
for (len = touchEventProps.length; j < len; j++) {
prop = touchEventProps[j];
evt[prop] = touch[prop];
}
}
}
return evt;
}
/**
* Dispatch Events
* @method fireEvent
* @param {string} eventName event name
* @param {Event} evt original event
* @param {Object} [properties] Sets the special properties for position
* @return {boolean}
* @private
* @static
* @member ns.event.vmouse
*/
function fireEvent(eventName, evt, properties) {
return evt.target.dispatchEvent(createEvent(eventName, evt, properties || {}));
}
eventProps = [
"currentTarget",
"detail",
"button",
"buttons",
"clientX",
"clientY",
"offsetX",
"offsetY",
"pageX",
"pageY",
"screenX",
"screenY",
"toElement",
"which"
];
vmouse = {
/**
* Sets the distance of pixels after which the scroll event will be successful
* @property {number} [eventDistanceThreshold=10]
* @member ns.event.vmouse
* @static
*/
eventDistanceThreshold: 10,
touchSupport: touchSupport
};
/**
* Handle click down
* @method handleDown
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleDown(evt) {
fireEvent("vmousedown", evt);
}
/**
* Prepare position of event for keyboard events.
* @method preparePositionForClick
* @param {Event} event
* @return {?Object} options
* @private
* @static
* @member ns.event.vmouse
*/
function preparePositionForClick(event) {
var x = event.clientX,
y = event.clientY;
// event comes from keyboard
if (!x && !y) {
return preparePositionForEvent(event);
}
}
/**
* Handle click
* @method handleClick
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleClick(evt) {
fireEvent("vclick", evt, preparePositionForClick(evt));
}
/**
* Handle click up
* @method handleUp
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleUp(evt) {
fireEvent("vmouseup", evt);
}
/**
* Handle click move
* @method handleMove
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleMove(evt) {
fireEvent("vmousemove", evt);
}
/**
* Handle click over
* @method handleOver
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleOver(evt) {
fireEvent("vmouseover", evt);
}
/**
* Handle click out
* @method handleOut
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleOut(evt) {
fireEvent("vmouseout", evt);
}
/**
* Handle touch start
* @method handleTouchStart
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleTouchStart(evt) {
var touches = evt.touches,
firstTouch;
//if touches are registered and we have only one touch
if (touches && touches.length === 1) {
didScroll = false;
firstTouch = touches[0];
startX = firstTouch.pageX;
startY = firstTouch.pageY;
// Check if we have touched something on our page
// @TODO refactor for multi touch
/*
over = document.elementFromPoint(startX, startY);
if (over) {
lastOver = over;
fireEvent("vmouseover", evt);
}
*/
fireEvent("vmousedown", evt);
}
}
/**
* Handle touch end
* @method handleTouchEnd
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleTouchEnd(evt) {
var touches = evt.touches;
if (touches && touches.length === 0) {
fireEvent("vmouseup", evt);
fireEvent("vmouseout", evt);
// Reset flag for last over element
lastOver = null;
}
}
/**
* Handle touch move
* @method handleTouchMove
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleTouchMove(evt) {
var over,
firstTouch = evt.touches && evt.touches[0],
didCancel = didScroll,
//sets the threshold, based on which we consider if it was the touch-move event
moveThreshold = vmouse.eventDistanceThreshold;
/**
* Ignore the touch which has identifier other than 0.
* Only first touch has control others are ignored.
* Patch for webkit behavior where touchmove event
* is triggered between touchend events
* if there is multi touch.
*/
if ((firstTouch === undefined) || firstTouch.identifier > 0) {
//evt.preventDefault(); // cant preventDefault passive events!!!
evt.stopPropagation();
return;
}
didScroll = didScroll ||
//check in both axes X,Y if the touch-move event occur
(Math.abs(firstTouch.pageX - startX) > moveThreshold ||
Math.abs(firstTouch.pageY - startY) > moveThreshold);
// detect over event
// for compatibility with mouseover because "touchenter" fires only once
// @TODO Handle many touches
over = document.elementFromPoint(firstTouch.pageX, firstTouch.pageY);
if (over && lastOver !== over) {
lastOver = over;
fireEvent("vmouseover", evt);
}
//if didScroll occur and wasn't canceled then trigger touchend otherwise just touchmove
if (didScroll && !didCancel) {
fireEvent("vmousecancel", evt);
lastOver = null;
}
fireEvent("vmousemove", evt);
}
/**
* Handle Scroll
* @method handleScroll
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleScroll(evt) {
if (!didScroll) {
fireEvent("vmousecancel", evt);
}
didScroll = true;
}
/**
* Handle touch cancel
* @method handleTouchCancel
* @param {Event} evt
* @private
* @static
* @member ns.event.vmouse
*/
function handleTouchCancel(evt) {
fireEvent("vmousecancel", evt);
lastOver = null;
}
/**
* Prepare position of event for keyboard events.
* @method preparePositionForEvent
* @param {Event} event
* @return {Object} properties
* @private
* @static
* @member ns.event.vmouse
*/
function preparePositionForEvent(event) {
var targetRect = event.target && event.target.getBoundingClientRect(),
properties = {};
if (targetRect) {
properties = {
"clientX": targetRect.left + targetRect.width / 2,
"clientY": targetRect.top + targetRect.height / 2,
"which": 1
};
}
return properties;
}
/**
* Handle key up
* @method handleKeyUp
* @param {Event} event
* @private
* @static
* @member ns.event.vmouse
*/
function handleKeyUp(event) {
var properties;
if (event.keyCode === KEY_CODES.enter) {
properties = preparePositionForEvent(event);
fireEvent("vmouseup", event, properties);
fireEvent("vclick", event, properties);
}
}
/**
* Handle key down
* @method handleKeyDown
* @param {Event} event
* @private
* @static
* @member ns.event.vmouse
*/
function handleKeyDown(event) {
if (event.keyCode === KEY_CODES.enter) {
fireEvent("vmousedown", event, preparePositionForEvent(event));
}
}
/**
* Binds events common to mouse and touch to support virtual mouse.
* @method bindCommonEvents
* @static
* @member ns.event.vmouse
*/
vmouse.bindCommonEvents = function () {
document.addEventListener("keyup", handleKeyUp, true);
document.addEventListener("keydown", handleKeyDown, true);
document.addEventListener("scroll", handleScroll, true);
document.addEventListener("click", handleClick, true);
};
// @TODO delete touchSupport flag and attach touch and mouse listeners,
// @TODO check if v-events are not duplicated if so then called only once
/**
* Binds touch events to support virtual mouse.
* @method bindTouch
* @static
* @member ns.event.vmouse
*/
vmouse.bindTouch = function () {
document.addEventListener("touchstart", handleTouchStart, true);
document.addEventListener("touchend", handleTouchEnd, true);
document.addEventListener("touchmove", handleTouchMove, true);
document.addEventListener("touchcancel", handleTouchCancel, true);
};
/**
* Binds mouse events to support virtual mouse.
* @method bindMouse
* @static
* @member ns.event.vmouse
*/
vmouse.bindMouse = function () {
document.addEventListener("mousedown", handleDown, true);
document.addEventListener("mouseup", handleUp, true);
document.addEventListener("mousemove", handleMove, true);
document.addEventListener("mouseover", handleOver, true);
document.addEventListener("mouseout", handleOut, true);
};
/**
* Unbinds touch events to support virtual mouse.
* @method unbindTouch
* @static
* @member ns.event.vmouse
*/
vmouse.unbindTouch = function () {
document.removeEventListener("touchstart", handleTouchStart, true);
document.removeEventListener("touchend", handleTouchEnd, true);
document.removeEventListener("touchmove", handleTouchMove, true);
document.removeEventListener("touchcancel", handleTouchCancel, true);
document.removeEventListener("click", handleClick, true);
};
/**
* Unbinds mouse events to support virtual mouse.
* @method unbindMouse
* @static
* @member ns.event.vmouse
*/
vmouse.unbindMouse = function () {
document.removeEventListener("mousedown", handleDown, true);
document.removeEventListener("mouseup", handleUp, true);
document.removeEventListener("mousemove", handleMove, true);
document.removeEventListener("mouseover", handleOver, true);
document.removeEventListener("mouseout", handleOut, true);
document.removeEventListener("keyup", handleKeyUp, true);
document.removeEventListener("keydown", handleKeyDown, true);
document.removeEventListener("scroll", handleScroll, true);
document.removeEventListener("click", handleClick, true);
};
ns.event.vmouse = vmouse;
if (touchSupport) {
vmouse.bindTouch();
} else {
vmouse.bindMouse();
}
vmouse.bindCommonEvents();
}(window, window.document, ns));
/*global window, define, ns */
/*jslint browser: true, nomen: true */
/**
* # History manager
*
* Control events connected with history change and trigger events to controller
* or router.
*
* @class ns.history.manager
* @since 2.4
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
/**
* Event historystatechange
* @event historystatechange
* @class ns.history.manager
*/
/**
* Event historyhashchange
* @event historyhashchange
* @class ns.history.manager
*/
/**
* Event historyenabled
* @event historyenabled
* @class ns.history.manager
*/
/**
* Event historydisabled
* @event historydisabled
* @class ns.history.manager
*/
(function (window, document) {
"use strict";
var manager = Object.create(null), // we don't need the Object proto
WINDOW_EVENT_POPSTATE = "popstate",
WINDOW_EVENT_HASHCHANGE = "hashchange",
DOC_EVENT_VCLICK = "vclick",
LINK_SELECTOR = "a,tau-button",
util = ns.util,
history = ns.history,
eventUtils = ns.event,
selectorUtils = util.selectors,
objectUtils = util.object,
pathUtils = util.path,
DOM = util.DOM,
EVENT_STATECHANGE = "historystatechange",
EVENT_HASHCHANGE = "historyhashchange",
EVENT_ENABLED = "historyenabled",
EVENT_DISABLED = "historydisabled",
/**
* Engine event types
* @property {Object} events
* @property {string} events.STATECHANGE="historystatechange" event name on history manager change state
* @property {string} events.HASHCHANGE="historyhashchange" event name on history manager change hash
* @property {string} events.ENABLED="historyenabled" event name on enable history manager
* @property {string} events.DISABLED="historydisabled" event name on disable history manager
* @static
* @readonly
* @member ns.history.manager
*/
events = {
STATECHANGE: EVENT_STATECHANGE,
HASHCHANGE: EVENT_HASHCHANGE,
ENABLED: EVENT_ENABLED,
DISABLED: EVENT_DISABLED
};
manager.events = events;
/**
* Trigger event "historystatechange" on document
* @param {Object} options
* @return {boolean}
*/
function triggerStateChange(options) {
return eventUtils.trigger(document, EVENT_STATECHANGE, options, true, true);
}
/**
* Callback for link click
* @param {Event} event
* @return {boolean}
*/
function onLinkAction(event) {
var target = event.target,
link = selectorUtils.getClosestBySelector(target, LINK_SELECTOR),
href,
useDefaultUrlHandling,
options, // this should be empty object but some utils that work on it
rel; // require hasOwnProperty :(
if (link && event.which === 1) {
href = link.getAttribute("href");
rel = link.getAttribute("rel");
useDefaultUrlHandling = rel === "external" || link.hasAttribute("target");
if (!useDefaultUrlHandling) {
options = DOM.getData(link);
options.event = event;
if (rel && !options.rel) {
options.rel = rel;
} else {
rel = options.rel;
}
if (href && !options.href) {
options.href = href;
}
if (rel === "popup" && link && !options.link) {
options.link = link;
}
history.disableVolatileMode();
if (!triggerStateChange(options)) {
// mark as handled
// but not on back
if (!rel || (rel !== "back")) {
eventUtils.preventDefault(event);
return false;
}
}
}
}
return true;
}
/**
* Callback on popstate event.
* @param {Event} event
*/
function onPopState(event) {
var state = event.state,
lastState = history.activeState,
options = {},
reverse,
resultOfTigger = true,
skipTriggerStateChange = false;
if (manager.locked) {
history.disableVolatileMode();
if (lastState) {
history.replace(lastState, lastState.stateTitle, lastState.stateUrl);
}
} else if (state) {
reverse = history.getDirection(state) === "back";
options = objectUtils.merge(options, state, {
reverse: reverse,
transition: reverse ? ((lastState && lastState.transition) || "none") : state.transition,
fromHashChange: true
});
if (lastState) {
resultOfTigger = eventUtils.trigger(document, EVENT_HASHCHANGE, objectUtils.merge(options,
{url: pathUtils.getLocation(), stateUrl: lastState.stateUrl}), true, true);
// if EVENT HASHCHANGE has been triggered successfuly then skip trigger HistoryStateChange
skipTriggerStateChange = resultOfTigger;
}
state.url = pathUtils.getLocation();
history.setActive(state);
if (!skipTriggerStateChange) {
options.event = event;
triggerStateChange(options);
}
}
}
/**
* Callback on "hashchange" event
* @param {Event} event
*/
function onHashChange(event) {
var newURL = event.newURL;
if (newURL && history.activeState.url !== newURL) {
triggerStateChange({href: newURL, fromHashChange: true, event: event});
}
}
/**
* Inform that manager is enabled or not.
* @property {boolean} [enabled=true]
* @static
* @since 2.4
* @member ns.history.manager
*/
manager.enabled = true;
/**
* Informs that manager is enabled or not.
*
* If manager is locked then not trigger events historystatechange.
* @property {boolean} [locked=false]
* @static
* @since 2.4
* @member ns.history.manager
*/
manager.locked = false;
/**
* Locks history manager.
*
* Sets locked property to true.
*
* @example
* tau.history.manager.lock();
*
* @method lock
* @static
* @since 2.4
* @member ns.history.manager
*/
manager.lock = function () {
this.locked = true;
};
/**
* Unlocks history manager.
*
* Sets locked property to false.
*
* @example
* tau.history.manager.unlock();
*
* @method unlock
* @static
* @since 2.4
* @member ns.history.manager
*/
manager.unlock = function () {
this.locked = false;
};
/**
* Enables history manager.
*
* This method adds all event listeners connected with history manager.
*
* Event listeners:
*
* - popstate on window
* - hashchange on window
* - vclick on document
*
* After set event listeners method sets property enabled to true.
*
* @example
* tau.history.manager.enable();
* // add event's listeners
* // after click on link or hash change history manager will handle events
*
* @method enable
* @static
* @since 2.4
* @member ns.history.manager
*/
manager.enable = function () {
document.addEventListener(DOC_EVENT_VCLICK, onLinkAction, false);
window.addEventListener(WINDOW_EVENT_POPSTATE, onPopState, false);
window.addEventListener(WINDOW_EVENT_HASHCHANGE, onHashChange, false);
history.enableVolatileMode();
this.enabled = true;
eventUtils.trigger(document, EVENT_ENABLED, this);
};
/**
* Disables history manager.
*
* This method removes all event listeners connected with history manager.
*
* After set event listeners method sets property enabled to true.
*
* @example
* tau.history.manager.disable();
* // remove event's listeners
* // after click on link or hash change history manager will not handle events
*
* @method disable
* @static
* @since 2.4
* @member ns.history.manager
*/
manager.disable = function () {
document.removeEventListener(DOC_EVENT_VCLICK, onLinkAction, false);
window.removeEventListener(WINDOW_EVENT_POPSTATE, onPopState, false);
window.removeEventListener(WINDOW_EVENT_HASHCHANGE, onHashChange, false);
history.disableVolatileMode();
this.enabled = false;
eventUtils.trigger(document, EVENT_DISABLED, this);
};
ns.history.manager = manager;
}(window, window.document));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global define, ns */
/**
* #String Utility
* Utility helps work with strings.
* @class ns.util.string
*/
(function () {
"use strict";
var DASH_TO_UPPER_CASE_REGEXP = /-([a-z])/gi,
UPPER_TO_DASH_CASE_REGEXP = /([A-Z])/g,
arrayUtil = ns.util.array;
/**
* Callback method for regexp used in dashesToCamelCase method
* @method toUpperCaseFn
* @param {string} match
* @param {string} value
* @return {string}
* @member ns.util.string
* @static
* @private
*/
function toUpperCaseFn(match, value) {
return value.toLocaleUpperCase();
}
/**
* Callback method for regexp used in camelCaseToDashes method
* @method toUpperCaseFn
* @param {string} match
* @param {string} value
* @return {string}
* @member ns.util.string
* @static
* @private
*/
function toLowerCaseFn(match, value) {
return "-" + value.toLowerCase();
}
/**
* Changes dashes string to camel case string
* @method firstToUpperCase
* @param {string} str
* @return {string}
* @member ns.util.string
* @static
*/
function dashesToCamelCase(str) {
return str.replace(DASH_TO_UPPER_CASE_REGEXP, toUpperCaseFn);
}
/**
* Changes camel case string to dashes string
* @method camelCaseToDashes
* @param {string} str
* @return {string}
* @member ns.util.string
* @static
*/
function camelCaseToDashes(str) {
return str.replace(UPPER_TO_DASH_CASE_REGEXP, toLowerCaseFn);
}
/**
* Changes the first char in string to uppercase
* @method firstToUpperCase
* @param {string} str
* @return {string}
* @member ns.util.string
* @static
*/
function firstToUpperCase(str) {
return str.charAt(0).toLocaleUpperCase() + str.substring(1);
}
/**
* Map different types to number if is possible.
* @param {string|*} x
* @return {*}
*/
function mapToNumber(x) {
var parsed;
if (x && (x + "").indexOf("%") === -1) {
parsed = parseInt(x, 10);
if (isNaN(parsed)) {
parsed = null;
}
return parsed;
}
return x;
}
/**
* Parses comma separated string to array
* @method parseProperty
* @param {string} property
* @return {Array} containing number or null
* @member ns.util.string
* @static
*/
function parseProperty(property) {
var arrayProperty;
if (typeof property === "string") {
arrayProperty = property.split(",");
} else {
arrayProperty = property || [];
}
return arrayUtil.map(arrayProperty, mapToNumber);
}
ns.util.string = {
dashesToCamelCase: dashesToCamelCase,
camelCaseToDashes: camelCaseToDashes,
firstToUpperCase: firstToUpperCase,
parseProperty: parseProperty
};
}());
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define */
/*
* @author Jadwiga Sosnowska <j.sosnowska@partner.samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function (window, ns) {
"use strict";
var DOM = ns.util.DOM,
stringUtil = ns.util.string,
appStyleSheet;
/**
* Returns css property for element
* @method getCSSProperty
* @param {HTMLElement} element
* @param {string} property
* @param {string|number|null} [def=null] default returned value
* @param {"integer"|"float"|null} [type=null] auto type casting
* @return {string|number|null}
* @member ns.util.DOM
* @static
*/
function getCSSProperty(element, property, def, type) {
var style = window.getComputedStyle(element),
value,
result = def;
if (style) {
value = style.getPropertyValue(property);
if (value) {
switch (type) {
case "integer":
value = parseInt(value, 10);
if (!isNaN(value)) {
result = value;
}
break;
case "float":
value = parseFloat(value);
if (!isNaN(value)) {
result = value;
}
break;
default:
result = value;
break;
}
}
}
return result;
}
/**
* Convert string to float or integer
* @param {string} value
* @return {number}
*/
function convertToNumber(value) {
if ((value + "").indexOf(".") > -1) {
return parseFloat(value);
}
return parseInt(value, 10);
}
/**
* Extracts css properties from computed css for an element.
* The properties values are applied to the specified
* properties list (dictionary)
* @method extractCSSProperties
* @param {HTMLElement} element
* @param {Object} properties
* @param {?string} [pseudoSelector=null]
* @param {boolean} [noConversion=false]
* @member ns.util.DOM
* @static
*/
function extractCSSProperties(element, properties, pseudoSelector, noConversion) {
var style = window.getComputedStyle(element, pseudoSelector),
property,
value,
newValue;
for (property in properties) {
if (properties.hasOwnProperty(property)) {
value = style.getPropertyValue(property);
newValue = convertToNumber(value);
if (!isNaN(newValue) || !noConversion) {
value = newValue;
}
properties[property] = value;
}
}
}
function getOffset(element, props, pseudoSelector, force, offsetProperty) {
var originalDisplay,
originalVisibility,
originalPosition,
offsetValue,
style = element.style;
if (style.display !== "none") {
extractCSSProperties(element, props, pseudoSelector, true);
offsetValue = element[offsetProperty];
} else if (force) {
originalDisplay = style.display;
originalVisibility = style.visibility;
originalPosition = style.position;
style.display = "block";
style.visibility = "hidden";
style.position = "relative";
extractCSSProperties(element, props, pseudoSelector, true);
offsetValue = element[offsetProperty];
style.display = originalDisplay;
style.visibility = originalVisibility;
style.position = originalPosition;
}
return offsetValue;
}
/**
* Returns elements height from computed style
* @method getElementHeight
* @param {HTMLElement} element
* if null then the "inner" value is assigned
* @param {"outer"|null} [type=null]
* @param {boolean} [includeOffset=false]
* @param {boolean} [includeMargin=false]
* @param {?string} [pseudoSelector=null]
* @param {boolean} [force=false] check even if element is hidden
* @return {number}
* @member ns.util.DOM
* @static
*/
function getElementHeight(element, type, includeOffset, includeMargin, pseudoSelector, force) {
var height = 0,
outer = (type && type === "outer") || false,
offsetHeight,
property,
props = {
"height": 0,
"margin-top": 0,
"margin-bottom": 0,
"padding-top": 0,
"padding-bottom": 0,
"border-top-width": 0,
"border-bottom-width": 0,
"box-sizing": ""
};
if (element) {
offsetHeight = getOffset(element, props, pseudoSelector, force, "offsetHeight");
for (property in props) {
if (props.hasOwnProperty(property) && property !== "box-sizing") {
props[property] = convertToNumber(props[property]);
}
}
height += props["height"];
if (props["box-sizing"] !== "border-box") {
height += props["padding-top"] + props["padding-bottom"];
}
if (includeOffset) {
height = offsetHeight;
} else if (outer && props["box-sizing"] !== "border-box") {
height += props["border-top-width"] + props["border-bottom-width"];
}
if (includeMargin) {
height += Math.max(0, props["margin-top"]) + Math.max(0, props["margin-bottom"]);
}
}
return height;
}
/**
* Returns elements width from computed style
* @method getElementWidth
* @param {HTMLElement} element
* if null then the "inner" value is assigned
* @param {"outer"|null} [type=null]
* @param {boolean} [includeOffset=false]
* @param {boolean} [includeMargin=false]
* @param {?string} [pseudoSelector=null]
* @param {boolean} [force=false] check even if element is hidden
* @return {number}
* @member ns.util.DOM
* @static
*/
function getElementWidth(element, type, includeOffset, includeMargin, pseudoSelector, force) {
var width = 0,
value,
offsetWidth,
property,
outer = (type && type === "outer") || false,
props = {
"width": 0,
"margin-left": 0,
"margin-right": 0,
"padding-left": 0,
"padding-right": 0,
"border-left-width": 0,
"border-right-width": 0,
"box-sizing": ""
};
if (element) {
offsetWidth = getOffset(element, props, pseudoSelector, force, "offsetWidth");
for (property in props) {
if (props.hasOwnProperty(property) && property !== "box-sizing") {
value = parseFloat(props[property]);
props[property] = value;
}
}
width += props["width"];
if (props["box-sizing"] !== "border-box") {
width += props["padding-left"] + props["padding-right"];
}
if (includeOffset) {
width = offsetWidth;
} else if (outer && props["box-sizing"] !== "border-box") {
width += props["border-left-width"] + props["border-right-width"];
}
if (includeMargin) {
width += Math.max(0, props["margin-left"]) + Math.max(0, props["margin-right"]);
}
}
return width;
}
/**
* Returns offset of element
* @method getElementOffset
* @param {HTMLElement} element
* @return {Object}
* @member ns.util.DOM
* @static
*/
function getElementOffset(element) {
var left = 0,
top = 0,
loopElement = element;
do {
top += loopElement.offsetTop;
left += loopElement.offsetLeft;
loopElement = loopElement.offsetParent;
} while (loopElement !== null);
return {
top: top,
left: left
};
}
/**
* Check if element occupies place at view
* @method isOccupiedPlace
* @param {HTMLElement} element
* @return {boolean}
* @member ns.util.DOM
* @static
*/
function isOccupiedPlace(element) {
return !(element.offsetWidth <= 0 && element.offsetHeight <= 0);
}
/**
* Set values for element with prefixes for browsers
* @method setPrefixedStyle
* @param {HTMLElement | CSSStyleRule} elementOrRule
* @param {string} property
* @param {string|Object|null} value
* @member ns.util.DOM
* @static
*/
function setPrefixedStyle(elementOrRule, property, value) {
var style = elementOrRule.style,
propertyForPrefix = property,
values = (typeof value !== "object") ? {
webkit: value,
moz: value,
o: value,
ms: value,
normal: value
} : value;
style.setProperty(property, values.normal);
style.setProperty("-webkit-" + propertyForPrefix, values.webkit);
style.setProperty("-moz-" + propertyForPrefix, values.moz);
style.setProperty("-o-" + propertyForPrefix, values.o);
style.setProperty("-ms-" + propertyForPrefix, values.ms);
}
/**
* Get value from element with prefixes for browsers
* @method getCSSProperty
* @param {string} value
* @return {Object}
* @member ns.util.DOM
* @static
*/
function getPrefixedValue(value) {
return {
webkit: "-webkit-" + value,
moz: "-moz-" + value,
o: "-ms-" + value,
ms: "-o-" + value,
normal: value
};
}
/**
* Returns style value for css property with browsers prefixes
* @method getPrefixedStyle
* @param {HTMLStyle} styles
* @param {string} property
* @return {Object}
* @member ns.util.DOM
* @static
*/
function getPrefixedStyleValue(styles, property) {
var prefixedProperties = getPrefixedValue(property),
value,
key;
for (key in prefixedProperties) {
if (prefixedProperties.hasOwnProperty(key)) {
value = styles[prefixedProperties[key]];
if (value && value !== "none") {
return value;
}
}
}
return value;
}
/**
* Returns size (width, height) as CSS string
* @method toCSSSize
* @param {string|Array} size has to be comma separated string (eg. "10,100") or array with 2
* elements
* @return {string} if not enough arguments the method returns empty string
* @member ns.util.DOM
* @static
*/
function toCSSSize(size) {
var cssSize = "",
arraySize = stringUtil.parseProperty(size);
if (arraySize && arraySize.length === 2) {
cssSize = "width: " + arraySize[0] + "px; " +
"height: " + arraySize[1] + "px;";
}
return cssSize;
}
/**
* Set CSS styles for pseudo class selector.
* @method setStylesForPseudoClass
* @param {string} selector selector of elements
* @param {string} pseudoClassName CSS pseudo class name to set, for example after, before
* @param {Object} cssValues object with styles to set
* @return {number?} return index of inserted rule
* @member ns.util.DOM
* @static
*/
function setStylesForPseudoClass(selector, pseudoClassName, cssValues) {
var cssValuesArray = [],
headElement,
styleElement,
name;
// create style element on first use
if (!appStyleSheet) {
headElement = document.head || document.getElementsByTagName("head")[0];
styleElement = document.createElement("style");
styleElement.type = "text/css";
headElement.appendChild(styleElement);
appStyleSheet = styleElement.sheet;
}
for (name in cssValues) {
if (cssValues.hasOwnProperty(name)) {
cssValuesArray.push(name + ": " + cssValues[name]);
}
}
if (cssValuesArray.length) {
return appStyleSheet.addRule(selector + "::" + pseudoClassName, cssValuesArray.join("; "));
}
return null;
}
/**
* Remove CSS rule from sheet.
* @method removeCSSRule
* @param {number} ruleIndex Index of rule to remove
* @static
*/
function removeCSSRule(ruleIndex) {
// create style element on first use
if (appStyleSheet) {
appStyleSheet.deleteRule(ruleIndex);
}
}
// assign methods to namespace
DOM.getCSSProperty = getCSSProperty;
DOM.extractCSSProperties = extractCSSProperties;
DOM.getElementHeight = getElementHeight;
DOM.getElementWidth = getElementWidth;
DOM.getElementOffset = getElementOffset;
DOM.isOccupiedPlace = isOccupiedPlace;
DOM.setPrefixedStyle = setPrefixedStyle;
DOM.getPrefixedValue = getPrefixedValue;
DOM.getPrefixedStyleValue = getPrefixedStyleValue;
DOM.toCSSSize = toCSSSize;
DOM.setStylesForPseudoClass = setStylesForPseudoClass;
DOM.removeCSSRule = removeCSSRule;
}(window, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define */
/**
* #Set Utility
*
* Own implementation of ECMAScript Set.
*
* @class ns.util.Set
*/
(function (window, ns) {
"use strict";
var Set = function () {
this._data = [];
};
Set.prototype = {
/**
* Add one or many arguments to set
* @method add
* @member ns.util.Set
*/
add: function () {
var data = this._data;
this._data = data.concat.apply(data, [].slice.call(arguments))
.filter(function (item, pos, array) {
return array.indexOf(item) === pos;
});
},
/**
* Remove all items from set
* @method clear
* @member ns.util.Set
*/
clear: function () {
this._data = [];
},
/**
* delete one item from set
* @method delete
* @param {*} item
* @member ns.util.Set
*/
delete: function (item) {
var data = this._data,
index = data.indexOf(item);
if (index > -1) {
data.splice(index, 1);
}
},
/**
* Check that item exists in set
* @method has
* @param {Object} item
* @member ns.util.Set
* @return {boolean}
*/
has: function (item) {
return this._data.indexOf(item) > -1;
},
/**
* Iterate on each set elements
* @method forEach
* @param {Function} cb
* @member ns.util.Set
*/
forEach: function (cb) {
this._data.forEach(cb);
}
};
// for tests
ns.util._Set = Set;
ns.util.Set = window.Set || Set;
}(window, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright (c) 2010 - 2014 Samsung Electronics Co., Ltd.
* License : MIT License V2
*/
/**
* #Namespace For Widgets
* Namespace For Widgets
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @class ns.widget
*/
(function (document) {
"use strict";
var engine = ns.engine,
eventType = engine.eventType,
widget = {
/**
* Get bound widget for element
* @method getInstance
* @static
* @param {HTMLElement|string} element
* @param {string} type widget name
* @return {?Object}
* @member ns.widget
*/
getInstance: engine.getBinding,
/**
* Returns Get all bound widget for element or id gives as parameter
* @method getAllInstances
* @param {HTMLElement|string} element
* @return {?Object}
* @static
* @member ns.widget
*/
getAllInstances: engine.getAllBindings
};
function mapWidgetDefinition(name, element, options) {
var widgetParams = {
name: name,
element: element,
options: options
}
return widgetParams;
}
function widgetConstructor(name, element, options) {
var widgetParams = mapWidgetDefinition(name, element, options);
return engine.instanceWidget(widgetParams.element, widgetParams.name, widgetParams.options);
}
/**
* Register simple widget constructor in namespace
* @param {Event} event
*/
function defineWidget(event) {
var definition = event.detail,
name = definition.name;
ns.widget[name] = widgetConstructor.bind(null, name);
}
/**
* Remove event listeners on framework destroy
*/
function destroy() {
document.removeEventListener(eventType.WIDGET_DEFINED, defineWidget, true);
document.removeEventListener(eventType.DESTROY, destroy, false);
}
document.addEventListener(eventType.WIDGET_DEFINED, defineWidget, true);
document.addEventListener(eventType.DESTROY, destroy, false);
/** @namespace ns.widget */
ns.widget = widget;
}(window.document));
/*global window, ns, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #BaseWidget
* Prototype class of widget
*
* ## How to invoke creation of widget from JavaScript
*
* To build and initialize widget in JavaScript you have to use method
* {@link ns.engine#instanceWidget}. First argument for method is HTMLElement, which specifies the
* element of widget. Second parameter is name of widget to create.
*
* If you load jQuery before initializing tau library, you can use standard jQuery UI Widget
* notation.
*
* ### Examples
* #### Build widget from JavaScript
*
* @example
* var element = document.getElementById("id"),
* ns.engine.instanceWidget(element, "Button");
*
* #### Build widget from jQuery
*
* @example
* var element = $("#id").button();
*
* ## How to create new widget
*
* @example
* (function (ns) {
* "use strict";
* * var BaseWidget = ns.widget.BaseWidget, // create alias to main objects
* ...
* arrayOfElements, // example of private property, common for all instances of widget
* Button = function () { // create local object with widget
* ...
* },
* prototype = new BaseWidget(); // add ns.widget.BaseWidget as prototype to widget's
* object, for better minification this should be assign to local variable and next
* variable should be assign to prototype of object.
*
* function closestEnabledButton(element) { // example of private method
* ...
* }
* ...
*
* prototype.options = { //add default options to be read from data- attributes
* theme: "s",
* ...
* };
*
* prototype._build = function (template, element) {
* // method called when the widget is being built, should contain all HTML
* // manipulation actions
* ...
* return element;
* };
*
* prototype._init = function (element) {
* // method called during initialization of widget, should contain all actions
* // necessary fastOn application start
* ...
* return element;
* };
*
* prototype._bindEvents = function (element) {
* // method to bind all events, should contain all event bindings
* ...
* };
*
* prototype._enable = function (element) {
* // method called during invocation of enable() method
* ...
* };
*
* prototype._disable = function (element) {
* // method called during invocation of disable() method
* ...
* };
*
* prototype.refresh = function (element) {
* // example of public method
* ...
* };
*
* prototype._refresh = function () {
* // example of protected method
* ...
* };
*
* Button.prototype = prototype;
*
* engine.defineWidget( // define widget
* "Button", //name of widget
* "[data-role='button'],button,[type='button'],[type='submit'],[type='reset']",
* //widget's selector
* [ // public methods, here should be list all public method
* "enable",
* "disable",
* "refresh"
* ],
* Button, // widget's object
* "mobile" // widget's namespace
* );
* ns.widget.Button = Button;
* * }(ns));
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
* @author Przemyslaw Ciezkowski <p.ciezkowski@samsung.com>
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Michał Szepielak <m.szepielak@samsung.com>
* @class ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var slice = [].slice,
/**
* Alias to ns.engine
* @property {ns.engine} engine
* @member ns.widget.BaseWidget
* @private
* @static
*/
engine = ns.engine,
engineDataTau = engine.dataTau,
util = ns.util,
/**
* Alias to {@link ns.event}
* @property {Object} eventUtils
* @member ns.widget.BaseWidget
* @private
* @static
*/
eventUtils = ns.event,
/**
* Alias to {@link ns.util.DOM}
* @property {Object} domUtils
* @private
* @static
*/
domUtils = util.DOM,
utilString = util.string,
/**
* Alias to {@link ns.util.object}
* @property {Object} objectUtils
* @private
* @static
*/
objectUtils = util.object,
Set = util.Set,
BaseWidget = function () {
this.flowState = "created";
return this;
},
getNSData = domUtils.getNSData,
prototype = {},
/**
* Property with string represent function type
* (for better minification)
* @property {string} [TYPE_FUNCTION="function"]
* @private
* @static
* @readonly
*/
TYPE_FUNCTION = "function",
disableClass = "ui-state-disabled",
ariaDisabled = "aria-disabled",
__callbacks;
BaseWidget.classes = {
disable: disableClass
};
prototype._configureDefinition = function (definition) {
var self = this,
definitionName,
definitionNamespace;
if (definition) {
definitionName = definition.name;
definitionNamespace = definition.namespace;
/**
* Name of the widget
* @property {string} name
* @member ns.widget.BaseWidget
*/
self.name = definitionName;
/**
* Name of the widget (in lower case)
* @property {string} widgetName
* @member ns.widget.BaseWidget
*/
self.widgetName = definitionName;
/**
* Namespace of widget events
* @property {string} widgetEventPrefix
* @member ns.widget.BaseWidget
*/
self.widgetEventPrefix = definitionName.toLowerCase();
/**
* Namespace of the widget
* @property {string} namespace
* @member ns.widget.BaseWidget
*/
self.namespace = definitionNamespace;
/**
* Full name of the widget
* @property {string} widgetFullName
* @member ns.widget.BaseWidget
*/
self.widgetFullName = ((definitionNamespace ? definitionNamespace + "-" : "") +
definitionName).toLowerCase();
/**
* Id of widget instance
* @property {string} id
* @member ns.widget.BaseWidget
*/
self.id = ns.getUniqueId();
/**
* Widget's selector
* @property {string} selector
* @member ns.widget.BaseWidget
*/
self.selector = definition.selector;
}
};
/**
* Protected method configuring the widget
* @method _configure
* @member ns.widget.BaseWidget
* @protected
* @template
* @ignore
*/
/**
* Configures widget object from definition.
*
* It calls such methods as #\_getCreateOptions and #\_configure.
* @method configure
* @param {Object} definition
* @param {string} definition.name Name of the widget
* @param {string} definition.selector Selector of the widget
* @param {HTMLElement} element Element of widget
* @param {Object} options Configure options
* @member ns.widget.BaseWidget
* @return {ns.widget.BaseWidget}
* @ignore
*/
prototype.configure = function (definition, element, options) {
var self = this;
/**
* Object with options for widget
* @property {Object} [options={}]
* @member ns.widget.BaseWidget
*/
self.flowState = "configuring";
self.options = self.options || {};
/**
* Base element of widget
* @property {?HTMLElement} [element=null]
* @member ns.widget.BaseWidget
*/
self.element = self.element || null;
self._configureDefinition(definition);
if (typeof self._configure === TYPE_FUNCTION) {
self._configure(element);
}
self.isCustomElement = !!element.createdCallback;
self._getCreateOptions(element);
objectUtils.fastMerge(self.options, options);
self.flowState = "configured";
};
/**
* Reads data-* attributes and save to options object.
* @method _getCreateOptions
* @param {HTMLElement} element Base element of the widget
* @return {Object}
* @member ns.widget.BaseWidget
* @protected
*/
prototype._getCreateOptions = function (element) {
var self = this,
options = self.options,
tag = element.localName.toLowerCase();
if (options) {
Object.keys(options).forEach(function (option) {
var attributeName = utilString.camelCaseToDashes(option),
baseValue = getNSData(element, attributeName, true),
prefixedValue = getNSData(element, attributeName);
if (prefixedValue !== null) {
options[option] = prefixedValue;
} else {
if (typeof options[option] === "boolean") {
self._readBooleanOptionFromElement(element, option);
}
}
if (option === "type" && tag === "input") { // don't set conflicting props
return;
}
if (baseValue !== null) {
options[option] = baseValue;
}
});
}
return options;
};
/**
* Protected method building the widget
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement} widget's element
* @member ns.widget.BaseWidget
* @protected
* @template
*/
/**
* Builds widget.
*
* It calls method #\_build.
*
* Before starting building process, the event beforecreate with
* proper prefix defined in variable widgetEventPrefix is triggered.
* @method build
* @param {HTMLElement} element Element of widget before building process
* @return {HTMLElement} Element of widget after building process
* @member ns.widget.BaseWidget
* @ignore
*/
prototype.build = function (element) {
var self = this,
id,
node,
dataBuilt = element.getAttribute(engineDataTau.built),
dataName = element.getAttribute(engineDataTau.name);
eventUtils.trigger(element, self.widgetEventPrefix + "beforecreate");
self.flowState = "building";
id = element.id;
if (id) {
self.id = id;
} else {
element.id = self.id;
}
if (typeof self._build === TYPE_FUNCTION) {
node = self._build(element);
} else {
node = element;
}
self._setBooleanOptions(element);
// Append current widget name to data-tau-built and data-tau-name attributes
dataBuilt = !dataBuilt ? self.name : dataBuilt + engineDataTau.separator + self.name;
dataName = !dataName ? self.name : dataName + engineDataTau.separator + self.name;
element.setAttribute(engineDataTau.built, dataBuilt);
element.setAttribute(engineDataTau.name, dataName);
self.flowState = "built";
return node;
};
/**
* Protected method initializing the widget
* @method _init
* @param {HTMLElement} element
* @member ns.widget.BaseWidget
* @template
* @protected
*/
/**
* Initializes widget.
*
* It calls method #\_init.
* @method init
* @param {HTMLElement} element Element of widget before initialization
* @member ns.widget.BaseWidget
* @return {ns.widget.BaseWidget}
* @ignore
*/
prototype.init = function (element) {
var self = this;
self.id = element.id;
self.flowState = "initiating";
if (typeof self._init === TYPE_FUNCTION) {
self._init(element);
}
if (element.getAttribute("disabled") || self.options.disabled === true) {
self.disable();
} else {
self.enable();
}
self.flowState = "initiated";
return self;
};
/**
* Returns base element widget
* @member ns.widget.BaseWidget
* @return {HTMLElement|null}
* @instance
*/
prototype.getContainer = function () {
var self = this;
if (typeof self._getContainer === TYPE_FUNCTION) {
return self._getContainer();
}
return self.element;
};
/**
* Bind widget events attached in init mode
* @method _bindEvents
* @param {HTMLElement} element Base element of widget
* @member ns.widget.BaseWidget
* @template
* @protected
*/
/**
* Binds widget events.
*
* It calls such methods as #\_buildBindEvents and #\_bindEvents.
* At the end of binding process, the event "create" with proper
* prefix defined in variable widgetEventPrefix is triggered.
* @method bindEvents
* @param {HTMLElement} element Base element of the widget
* @param {boolean} onlyBuild Inform about the type of bindings: build/init
* @member ns.widget.BaseWidget
* @return {ns.widget.BaseWidget}
* @ignore
*/
prototype.bindEvents = function (element, onlyBuild) {
var self = this,
dataBound = element.getAttribute(engineDataTau.bound);
if (!onlyBuild) {
dataBound = !dataBound ? self.name : dataBound + engineDataTau.separator + self.name;
element.setAttribute(engineDataTau.bound, dataBound);
}
if (typeof self._buildBindEvents === TYPE_FUNCTION) {
self._buildBindEvents(element);
}
if (!onlyBuild && typeof self._bindEvents === TYPE_FUNCTION) {
self._bindEvents(element);
}
self.trigger(self.widgetEventPrefix + "create", self);
return self;
};
/**
* Event triggered when method focus is called
* @event taufocus
* @member ns.widget.BaseWidget
*/
/**
* Focus widget's element.
*
* This function calls function focus on element and if it is known
* the direction of event, the proper css classes are added/removed.
* @method focus
* @param {Object} options The options of event.
* @param {HTMLElement} options.previousElement Element to blur
* @param {HTMLElement} options.element Element to focus
* @member ns.widget.BaseWidget
*/
prototype.focus = function (options) {
var self = this,
element = self.element,
blurElement,
blurWidget;
options = options || {};
blurElement = options.previousElement;
// we try to blur element, which has focus previously
if (blurElement) {
blurWidget = engine.getBinding(blurElement);
// call blur function on widget
if (blurWidget) {
options = objectUtils.merge({}, options, {element: blurElement});
blurWidget.blur(options);
} else {
// or on element, if widget does not exist
blurElement.blur();
}
}
options = objectUtils.merge({}, options, {element: element});
// set focus on element
eventUtils.trigger(document, "taufocus", options);
element.focus();
return true;
};
/**
* Event triggered then method blur is called.
* @event taublur
* @member ns.widget.BaseWidget
*/
/**
* Blur widget's element.
*
* This function calls function blur on element and if it is known
* the direction of event, the proper css classes are added/removed.
* @method blur
* @param {Object} options The options of event.
* @param {HTMLElement} options.element Element to blur
* @member ns.widget.BaseWidget
*/
prototype.blur = function (options) {
var self = this,
element = self.element;
options = objectUtils.merge({}, options, {element: element});
// blur element
eventUtils.trigger(document, "taublur", options);
element.blur();
return true;
};
/**
* Protected method destroying the widget
* @method _destroy
* @template
* @protected
* @member ns.widget.BaseWidget
*/
/**
* Destroys widget.
*
* It calls method #\_destroy.
*
* At the end of destroying process, the event "destroy" with proper
* prefix defined in variable widgetEventPrefix is triggered and
* the binding set in engine is removed.
* @method destroy
* @param {HTMLElement} element Base element of the widget
* @member ns.widget.BaseWidget
*/
prototype.destroy = function (element) {
var self = this;
element = element || self.element;
// the widget is in during destroy process
self.flowState = "destroying";
if (typeof self._destroy === TYPE_FUNCTION) {
self._destroy(element);
}
if (self.element) {
self.trigger(self.widgetEventPrefix + "destroy");
}
if (element) {
engine.removeBinding(element, self.name);
}
// the widget was destroyed
self.flowState = "destroyed";
};
/**
* Protected method disabling the widget
* @method _disable
* @protected
* @member ns.widget.BaseWidget
* @template
*/
/**
* Disables widget.
*
* It calls method #\_disable.
* @method disable
* @member ns.widget.BaseWidget
* @return {ns.widget.BaseWidget}
*/
prototype.disable = function () {
var self = this,
args = slice.call(arguments),
element = self.element;
element.classList.add(disableClass);
element.setAttribute(ariaDisabled, true);
if (typeof self._disable === TYPE_FUNCTION) {
args.unshift(element);
self._disable.apply(self, args);
}
return this;
};
/**
* Check if widget is disabled.
* @method isDisabled
* @member ns.widget.BaseWidget
* @return {boolean} Returns true if widget is disabled
*/
prototype.isDisabled = function () {
var self = this;
return self.element.getAttribute("disabled") || self.options.disabled === true;
};
/**
* Protected method enabling the widget
* @method _enable
* @protected
* @member ns.widget.BaseWidget
* @template
*/
/**
* Enables widget.
*
* It calls method #\_enable.
* @method enable
* @member ns.widget.BaseWidget
* @return {ns.widget.BaseWidget}
*/
prototype.enable = function () {
var self = this,
args = slice.call(arguments),
element = self.element;
element.classList.remove(disableClass);
element.setAttribute(ariaDisabled, false);
if (typeof self._enable === TYPE_FUNCTION) {
args.unshift(element);
self._enable.apply(self, args);
}
return this;
};
/**
* Protected method causing the widget to refresh
* @method _refresh
* @protected
* @member ns.widget.BaseWidget
* @template
*/
/**
* Refreshes widget.
*
* It calls method #\_refresh.
* @method refresh
* @member ns.widget.BaseWidget
* @return {ns.widget.BaseWidget}
*/
prototype.refresh = function () {
var self = this;
if (typeof self._refresh === TYPE_FUNCTION) {
self._refresh.apply(self, arguments);
}
return self;
};
/**
* Reads class based on name conversion option value, for all options which have boolean value
* we can read option value by check that exists classname connected with option name. To
* correct use this method is required define in widget property _classesPrefix.
*
* For example for option middle in Button widget we will check existing of class
* ui-btn-middle.
*
* @method _readBooleanOptionFromElement
* @param {HTMLElement} element Main element of widget
* @param {string} name Name of option which should be used
* @return {boolean}
* @member ns.widget.BaseWidget
* @protected
*/
prototype._readBooleanOptionFromElement = function (element, name) {
var classesPrefix = this._classesPrefix,
className;
if (classesPrefix) {
className = classesPrefix + utilString.camelCaseToDashes(name);
this.options[name] = element.classList.contains(className);
}
};
/**
* Sets or removes class based on name conversion option, for all options which have boolean
* value we can just set classname which is converted from camel case to dash style.
* To correct use this method is required define in widget property _classesPrefix.
*
* For example for option middle in Button widget we will set or remove class ui-btn-middle.
*
* @method _setBooleanOption
* @param {HTMLElement} element Main element of widget
* @param {string} name Name of option which should be used
* @param {boolean} value New value of option to set
* @member ns.widget.BaseWidget
* @protected
* @return {false} always return false to block refreshing
*/
prototype._setBooleanOption = function (element, name, value) {
var classesPrefix = this._classesPrefix,
className;
if (classesPrefix) {
className = classesPrefix + utilString.camelCaseToDashes(name);
element.classList.toggle(className, value);
}
// we don't need refresh, always can return false
return false;
};
/**
* For each options which has boolean value set or remove connected class.
*
* @method _setBooleanOptions
* @param {HTMLElement} element Base element of the widget
* @return {Object}
* @member ns.widget.BaseWidget
* @protected
*/
prototype._setBooleanOptions = function (element) {
var self = this,
classesPrefix = self._classesPrefix,
options = self.options;
if (classesPrefix && options !== undefined) {
Object.keys(options).forEach(function (option) {
if (typeof options[option] === "boolean") {
options[option] = self._setBooleanOption(element, option, options[option]);
}
});
}
return options;
};
prototype._processOptionObject = function (firstArgument) {
var self = this,
key,
partResult,
refresh = false;
for (key in firstArgument) {
if (firstArgument.hasOwnProperty(key)) {
partResult = self._oneOption(key, firstArgument[key]);
if (key !== undefined && firstArgument[key] !== undefined) {
refresh = refresh || partResult;
}
}
}
return refresh;
};
/**
* Gets or sets options of the widget.
*
* This method can work in many context.
*
* If first argument is type of object them, method set values for options given in object.
* Keys of object are names of options and values from object are values to set.
*
* If you give only one string argument then method return value for given option.
*
* If you give two arguments and first argument will be a string then second argument will be
* intemperate as value to set.
*
* @method option
* @param {string|Object} [name] name of option
* @param {*} [value] value to set
* @member ns.widget.BaseWidget
* @return {*} return value of option or null if method is called in setter context
*/
prototype.option = function (name, value) {
var self = this,
firstArgument = name,
secondArgument = value,
result = null,
refresh = false;
if (typeof firstArgument === "string") {
result = self._oneOption(firstArgument, secondArgument);
if (secondArgument !== undefined) {
refresh = result;
result = null;
}
} else if (typeof firstArgument === "object") {
refresh = self._processOptionObject(firstArgument);
}
if (refresh) {
self.refresh();
}
return result;
};
/**
* Gets or sets one option of the widget.
*
* @method _oneOption
* @param {string} field
* @param {*} value
* @member ns.widget.BaseWidget
* @return {*}
* @protected
*/
prototype._oneOption = function (field, value) {
var self = this,
methodName,
refresh = false;
if (value === undefined) {
methodName = "_get" + (field[0].toUpperCase() + field.slice(1));
if (typeof self[methodName] === TYPE_FUNCTION) {
return self[methodName]();
}
return self.options[field];
}
methodName = "_set" + (field[0].toUpperCase() + field.slice(1));
if (typeof self[methodName] === TYPE_FUNCTION) {
refresh = self[methodName](self.element, value);
} else if (typeof value === "boolean") {
refresh = self._setBooleanOption(self.element, field, value);
} else {
self.options[field] = value;
if (self.element) {
self.element.setAttribute("data-" + (field.replace(/[A-Z]/g, function (c) {
return "-" + c.toLowerCase();
})), value);
refresh = true;
}
}
return refresh;
};
/**
* Returns true if widget has bounded events.
*
* This methods enables to check if the widget has bounded
* events through the {@link ns.widget.BaseWidget#bindEvents} method.
* @method isBound
* @param {string} [type] Type of widget
* @member ns.widget.BaseWidget
* @ignore
* @return {boolean} true if events are bounded
*/
prototype.isBound = function (type) {
var element = this.element;
type = type || this.name;
return element && element.hasAttribute(engineDataTau.bound) &&
element.getAttribute(engineDataTau.bound).indexOf(type) > -1;
};
/**
* Returns true if widget is built.
*
* This methods enables to check if the widget was built
* through the {@link ns.widget.BaseWidget#build} method.
* @method isBuilt
* @param {string} [type] Type of widget
* @member ns.widget.BaseWidget
* @ignore
* @return {boolean} true if the widget was built
*/
prototype.isBuilt = function (type) {
var element = this.element;
type = type || this.name;
return element && element.hasAttribute(engineDataTau.built) &&
element.getAttribute(engineDataTau.built).indexOf(type) > -1;
};
/**
* Protected method getting the value of widget
* @method _getValue
* @return {*}
* @member ns.widget.BaseWidget
* @template
* @protected
*/
/**
* Protected method setting the value of widget
* @method _setValue
* @param {*} value
* @return {*}
* @member ns.widget.BaseWidget
* @template
* @protected
*/
/**
* Gets or sets value of the widget.
*
* @method value
* @param {*} [value] New value of widget
* @member ns.widget.BaseWidget
* @return {*}
*/
prototype.value = function (value) {
var self = this;
if (value !== undefined) {
if (typeof self._setValue === TYPE_FUNCTION) {
return self._setValue(value);
}
return self;
}
if (typeof self._getValue === TYPE_FUNCTION) {
return self._getValue();
}
return self;
};
/**
* Triggers an event on widget's element.
*
* @method trigger
* @param {string} eventName The name of event to trigger
* @param {?*} [data] additional Object to be carried with the event
* @param {boolean} [bubbles=true] Indicating whether the event
* bubbles up through the DOM or not
* @param {boolean} [cancelable=true] Indicating whether
* the event is cancelable
* @member ns.widget.BaseWidget
* @return {boolean} False, if any callback invoked preventDefault on event object
*/
prototype.trigger = function (eventName, data, bubbles, cancelable) {
return eventUtils.trigger(this.element, eventName, data, bubbles, cancelable);
};
/**
* Adds event listener to widget's element.
* @method on
* @param {string} eventName The name of event
* @param {Function} listener Function called after event will be trigger
* @param {boolean} [useCapture=false] useCapture Parameter of addEventListener
* @member ns.widget.BaseWidget
*/
prototype.on = function (eventName, listener, useCapture) {
eventUtils.on(this.element, eventName, listener, useCapture);
};
/**
* Removes event listener from widget's element.
* @method off
* @param {string} eventName The name of event
* @param {Function} listener Function call after event will be trigger
* @param {boolean} [useCapture=false] useCapture Parameter of addEventListener
* @member ns.widget.BaseWidget
*/
prototype.off = function (eventName, listener, useCapture) {
eventUtils.off(this.element, eventName, listener, useCapture);
};
prototype._framesFlow = function () {
var self = this,
args = slice.call(arguments),
func = args.shift();
if (typeof func === "function") {
func();
}
if (func !== undefined) {
util.requestAnimationFrame(function frameFlowCallback() {
self._framesFlow.apply(self, args);
});
}
};
function callbacksFilter(item) {
return !item.toRemove;
}
function callbacksForEach(item) {
if (item.object[item.property] === item.value) {
util.requestAnimationFrame(item.callback.bind(item.object));
item.toRemove = true;
}
}
function _controlWaitFor() {
__callbacks.forEach(callbacksForEach);
__callbacks = __callbacks.filter(callbacksFilter);
if (__callbacks.length) {
util.requestAnimationFrame(_controlWaitFor);
}
}
prototype._waitFor = function (property, value, callback) {
var self = this;
if (self[property] === value) {
callback.call(self);
} else {
__callbacks = __callbacks || [];
__callbacks.push({
object: self,
property: property,
value: value,
callback: callback
});
}
_controlWaitFor();
};
function readDOMElementStateClassList(element, stateObject) {
var classList = stateObject.classList;
if (classList !== undefined) {
if (classList instanceof Set) {
classList.clear();
} else {
classList = new Set();
stateObject.classList = classList;
}
if (element.classList.length) {
classList.add.apply(classList, slice.call(element.classList));
}
}
}
function readDOMElementState(element, stateObject) {
readDOMElementStateClassList(element, stateObject);
if (stateObject.offsetWidth !== undefined) {
stateObject.offsetWidth = element.offsetWidth;
}
if (stateObject.style !== undefined) {
domUtils.extractCSSProperties(element, stateObject.style, null, true);
}
if (stateObject.children !== undefined) {
stateObject.children.forEach(function (child, index) {
readDOMElementState(element.children[index], child);
});
}
}
function render(stateObject, element, isChild) {
var recalculate = false;
if (stateObject.classList !== undefined) {
slice.call(element.classList).forEach(function renderRemoveClassList(className) {
if (!stateObject.classList.has(className)) {
element.classList.remove(className);
recalculate = true;
}
});
stateObject.classList.forEach(function renderAddClassList(className) {
if (!element.classList.contains(className)) {
element.classList.add(className);
recalculate = true;
}
});
}
if (stateObject.style !== undefined) {
Object.keys(stateObject.style).forEach(function renderUpdateStyle(styleName) {
element.style[styleName] = stateObject.style[styleName];
});
}
if (stateObject.children !== undefined) {
stateObject.children.forEach(function renderChildren(child, index) {
render(child, element.children[index], true);
});
}
if (recalculate && !isChild) {
util.requestAnimationFrame(readDOMElementState.bind(null, element, stateObject));
}
}
prototype._render = function (now) {
var self = this,
stateDOM = self._stateDOM,
element = self.element;
if (now) {
render(stateDOM, element);
} else {
util.requestAnimationFrame(render.bind(null, stateDOM, element));
}
};
prototype._initDOMstate = function () {
readDOMElementState(this.element, this._stateDOM);
};
prototype._togglePrefixedClass = function (stateDOM, prefix, name) {
var requireRefresh = false,
prefixedClassName = prefix + name;
stateDOM.classList.forEach(function (className) {
if (className.indexOf(prefix) === 0 && prefixedClassName !== className) {
stateDOM.classList.delete(className);
requireRefresh = true;
}
});
if (!stateDOM.classList.has(prefixedClassName)) {
stateDOM.classList.add(prefixedClassName);
requireRefresh = true;
}
return requireRefresh;
};
BaseWidget.prototype = prototype;
// definition
ns.widget.BaseWidget = BaseWidget;
}(window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* #Namespace For Core Widgets
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @class ns.widget.core
*/
(function (document, ns) {
"use strict";
ns.widget.core = ns.widget.core || {};
}(window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true */
/**
* # Page Widget
* Page is main element of application's structure.
*
* ## Default selectors
* In the Tizen Web UI framework the application page structure is based on a header, content and footer elements:
*
* - **The header** is placed at the top, and displays the page title and optionally buttons.
* - **The content** is the section below the header, showing the main content of the page.
* - **The footer** is a bottom part of page which can display for example buttons
*
* The following table describes the specific information for each section.
*
* <table>
* <tr>
* <th>Section</th>
* <th>Class</th>
* <th>Mandatory</th>
* <th>Description</th>
* </tr>
* <tr>
* <td rowspan="2">Page</td>
* <td>ui-page</td>
* <td>Yes</td>
* <td>Defines the element as a page.
*
* The page widget is used to manage a single item in a page-based architecture.
*
* A page is composed of header (optional), content (mandatory), and footer (optional) elements.</td>
* </tr>
* <tr>
* <td>ui-page-active</td>
* <td>No</td>
* <td>If an application has a static start page, insert the ui-page-active class in the page element to
* speed up the application launch. The start page with the ui-page-active class can be displayed before
* the framework is fully loaded.
*
* If this class is not used, the framework inserts the class automatically to the first page of the
* application.
*
* However, this has a slowing effect on the application launch, because the page is displayed only after
* *the* framework is fully loaded.</td>
* </tr>
* <tr>
* <td>Header</td>
* <td>ui-header</td>
* <td>No</td>
* <td>Defines the element as a header.</td>
* </tr>
* <tr>
* <td>Content</td>
* <td>ui-content</td>
* <td>Yes</td>
* <td>Defines the element as content.</td>
* </tr>
* <tr>
* <td>Footer</td>
* <td>ui-footer</td>
* <td>No</td>
* <td>Defines the element as a footer.
*
* The footer section is mostly used to include option buttons.</td>
* </tr>
* </table>
*
* All elements with class=ui-page will be become page widgets
*
* @example
* <!--Page layout-->
* <div class="ui-page ui-page-active">
* <header class="ui-header"></header>
* <div class="ui-content"></div>
* <footer class="ui-footer"></footer>
* </div>
*
* <!--Page layout with more button in header-->
* <div class="ui-page ui-page-active">
* <header class="ui-header ui-has-more">
* <h2 class="ui-title">Call menu</h2>
* <button type="button" class="ui-more ui-icon-overflow">More Options</button>
* </header>
* <div class="ui-content">Content message</div>
* <footer class="ui-footer">
* <button type="button" class="ui-btn">Footer Button</button>
* </footer>
* </div>
*
* ## Manual constructor
* For manual creation of page widget you can use constructor of widget from **tau** namespace:
*
* @example
* var pageElement = document.getElementById("page"),
* page = tau.widget.Page(buttonElement);
*
* Constructor has one require parameter **element** which are base **HTMLElement** to create widget.
* We recommend get
* this element by method *document.getElementById*.
*
* ## Multi-page Layout
*
* You can implement a template containing multiple page containers in the application index.html file.
*
* In the multi-page layout, the main page is defined with the ui-page-active class.
* If no page has the ui-page-active
* class, the framework automatically sets up the first page in the source order
* as the main page. You can improve the
* launch performance by explicitly defining the main page to be displayed first.
* If the application has to wait for
* the framework to set up the main page, the page is displayed with some delay
* only after the framework is fully
* loaded.
*
* You can link to internal pages by referring to the ID of the page. For example, to link to the page with an ID
* of
* two, the link element needs the href="#two" attribute in the code, as in the following example.
*
* @example
* <!--Main page-->
* <div id="one" class="ui-page ui-page-active">
* <header class="ui-header"></header>
* <div class="ui-content"></div>
* <footer class="ui-footer"></footer>
* </div>
*
* <!--Secondary page-->
* <div id="two" class="ui-page">
* <header class="ui-header"></header>
* <div class="ui-content"></div>
* <footer class="ui-footer"></footer>
* </div>
*
* To find the currently active page, use the ui-page-active class.
*
* ## Changing Pages
* ### Go to page in JavaScript
* To change page use method *tau.changePage*
*
* @example
* tau.changePage("page-two");
*
* ### Back in JavaScript
* To back to previous page use method *tau.back*
*
* @example
* tau.back();
*
* ## Transitions
*
* When changing the active page, you can use a page transition.
*
* Tizen Web UI Framework does not apply transitions by default. To set a custom transition effect,
* you must add the
* data-transition attribute to a link:
*
* @example
* <a href="index.html" data-transition="slideup">I\'ll slide up</a>
*
* To set a default custom transition effect for all pages, use the pageTransition property:
*
* @example
* tau.defaults.pageTransition = "slideup";
*
* ### Transitions list
*
* - **none** no transition.
* - **slideup** Makes the content of the next page slide up, appearing to conceal the content of the previous page.
*
* ## Handling Page Events
*
* With page widget we have connected many of events.
*
* To handle page events, use the following code:
*
* @example
* <div id="page" class="ui-page">
* <header class="ui-header"></header>
* <div class="ui-content"></div>
* </div>
*
* <script>
* var page = document.getElementById("page");
* page.addEventListener("Event", function(event) {
* // Your code
* });
* </script>
*
* To bind an event callback on the Back key, use the following code:
*
* Full list of available events is in [events list section](#events-list).
*
* To bind an event callback on the Back key, use the following code:
*
* @example
* <script>
* window.addEventListener("tizenhwkey", function (event) {
* if (event.keyName == "back") {
* // Call window.history.back() to go to previous browser window
* // Call tizen.application.getCurrentApplication().exit() to exit application
* // Add script to add another behavior
* }
* });
* </script>
*
*
* ## Methods
*
* To call method on widget you can use tau API:
*
* @example
* var pageElement = document.getElementById("page"),
* page = tau.widget.Page(buttonElement);
*
* page.methodName(methodArgument1, methodArgument2, ...);
*
* @class ns.widget.core.Page
* @extends ns.widget.BaseWidget
* @component-selector .ui-page
* @component-type container-component
* @component-constraint 'popup', 'drawer', 'header', 'bottom-button'
* @component-attachable false
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Damian Osipiuk <d.osipiuk@samsung.com>
*/
(function (document, ns) {
"use strict";
/**
* Alias for {@link ns.widget.BaseWidget}
* @property {Object} BaseWidget
* @member ns.widget.core.Page
* @private
* @static
*/
var BaseWidget = ns.widget.BaseWidget,
/**
* Alias for {@link ns.util}
* @property {Object} util
* @member ns.widget.core.Page
* @private
* @static
*/
util = ns.util,
utilsDOM = util.DOM,
/**
* Alias for {@link ns.util.selectors}
* @property {Object} utilSelectors
* @member ns.widget.core.Page
* @private
* @static
*/
utilSelectors = util.selectors,
/**
* Alias for {@link ns.engine}
* @property {Object} engine
* @member ns.widget.core.Page
* @private
* @static
*/
engine = ns.engine,
Page = function () {
var self = this;
/**
* Callback on resize
* @property {?Function} _contentFillAfterResizeCallback
* @private
* @member ns.widget.core.Page
*/
self._contentFillAfterResizeCallback = null;
self._initialContentStyle = {};
/**
* Options for widget.
* It is empty object, because widget Page does not have any options.
* @property {Object} options
* @member ns.widget.core.Page
*/
self.options = {};
self._contentStyleAttributes = ["height", "width", "minHeight", "marginTop", "marginBottom"];
self._ui = {};
},
/**
* Dictionary for page related event types
* @property {Object} EventType
* @member ns.widget.core.Page
* @static
*/
EventType = {
/**
* Triggered on the page we are transitioning to,
* after the transition animation has completed.
* @event pageshow
* @member ns.widget.core.Page
*/
SHOW: "pageshow",
/**
* Triggered on the page we are transitioning away from,
* after the transition animation has completed.
* @event pagehide
* @member ns.widget.core.Page
*/
HIDE: "pagehide",
/**
* Triggered when the page has been created in the DOM
* (for example, through Ajax) but before all widgets
* have had an opportunity to enhance the contained markup.
* @event pagecreate
* @member ns.widget.core.Page
*/
CREATE: "pagecreate",
/**
* Triggered when the page is being initialized,
* before most plugin auto-initialization occurs.
* @event pagebeforecreate
* @member ns.widget.core.Page
*/
BEFORE_CREATE: "pagebeforecreate",
/**
* Triggered on the page we are transitioning to,
* before the actual transition animation is kicked off.
* @event pagebeforeshow
* @member ns.widget.core.Page
*/
BEFORE_SHOW: "pagebeforeshow",
/**
* Triggered on the page we are transitioning away from,
* before the actual transition animation is kicked off.
* @event pagebeforehide
* @member ns.widget.core.Page
*/
BEFORE_HIDE: "pagebeforehide"
},
/**
* Dictionary for page related css class names
* @property {Object} classes
* @member ns.widget.core.Page
* @static
* @readonly
*/
classes = {
uiPage: "ui-page",
/**
* Indicates active page
* @style ui-page-active
* @member ns.widget.core.Page
*/
uiPageActive: "ui-page-active",
uiSection: "ui-section",
uiHeader: "ui-header",
uiFooter: "ui-footer",
uiContent: "ui-content",
uiTitle: "ui-title",
uiPageScroll: "ui-scroll-on",
uiScroller: "ui-scroller"
},
HEADER_SELECTOR = "header,[data-role='header'],." + classes.uiHeader,
FOOTER_SELECTOR = "footer,[data-role='footer'],." + classes.uiFooter,
//ui-indexscrollbar is needed as widget ads html markup at the
//same level as content, other wise page content is build on
//indexscrollbar element
CONTENT_SELECTOR = "[data-role='content'],." + classes.uiContent,
prototype = new BaseWidget();
Page.classes = classes;
Page.events = EventType;
/**
* Configure default options for widget
* @method _configure
* @protected
* @member ns.widget.core.Page
*/
prototype._configure = function () {
var options = this.options;
/**
* Object with default options
* @property {Object} options
* @property {boolean|string|null} [options.header=false] Sets content of header.
* @property {boolean|string|null} [options.footer=false] Sets content of footer.
* @property {boolean} [options.autoBuildWidgets=false] Automatically build widgets inside page.
* @property {string} [options.content=null] Sets content of popup.
* @member ns.widget.core.Page
* @static
*/
options.header = null;
options.footer = null;
options.content = null;
options.enablePageScroll = ns.getConfig("enablePageScroll");
options.autoBuildWidgets = ns.getConfig("autoBuildOnPageChange");
this.options = options;
};
/**
* Setup size of element to 100% of screen
* @method _contentFill
* @protected
* @member ns.widget.core.Page
*/
prototype._contentFill = function () {
var self = this,
element = self.element,
screenWidth = window.innerWidth,
screenHeight = window.innerHeight,
elementStyle = element.style,
ui = self._ui,
content = ui.content,
contentStyle,
header = ui.header,
top = 0,
bottom = 0,
footer = ui.footer;
elementStyle.width = screenWidth + "px";
elementStyle.height = screenHeight + "px";
if (content && !element.classList.contains("ui-page-flex")) {
contentStyle = content.style;
if (header) {
top = utilsDOM.getElementHeight(header);
}
if (footer) {
bottom = utilsDOM.getElementHeight(footer);
contentStyle.marginBottom = bottom + "px";
contentStyle.paddingBottom = (-bottom) + "px";
}
if (!self.options.enablePageScroll) {
contentStyle.height = (screenHeight - top - bottom) + "px";
}
}
};
prototype._storeContentStyle = function () {
var self = this,
initialContentStyle = self._initialContentStyle,
contentStyleAttributes = self._contentStyleAttributes,
content = self.element.querySelector("." + classes.uiContent),
contentStyle = content ? content.style : {};
contentStyleAttributes.forEach(function (name) {
initialContentStyle[name] = contentStyle[name];
});
};
/**
* Restore saved styles for content.
* Called on refresh or hide.
* @protected
*/
prototype._restoreContentStyle = function () {
var self = this,
initialContentStyle = self._initialContentStyle,
contentStyleAttributes = self._contentStyleAttributes,
content = self.element.querySelector("." + classes.uiContent),
contentStyle = content ? content.style : {};
contentStyleAttributes.forEach(function (name) {
contentStyle[name] = initialContentStyle[name];
});
};
/**
* Setter for footer option
* @method _setFooter
* @param {HTMLElement} element
* @param {string} value
* @protected
* @member ns.widget.core.Page
*/
prototype._setFooter = function (element, value) {
var self = this,
ui = self._ui,
footer = ui.footer;
// footer element if footer does not exist and value is true or string
if (!footer && value) {
footer = document.createElement("footer");
element.appendChild(footer);
ui.footer = footer;
}
if (footer) {
// remove child if footer does not exist and value is set to false
if (value === false) {
element.removeChild(footer);
ui.footer = null;
} else {
// if options is set to true, to string or not is set
// add class
footer.classList.add(classes.uiFooter);
// if is string fill content by string value
if (typeof value === "string") {
ui.footer.textContent = value;
}
}
// and remember options
self.options.footer = value;
}
};
/**
* Setter for header option
* @method _setHeader
* @param {HTMLElement} element
* @param {string} value
* @protected
* @member ns.widget.core.Page
*/
prototype._setHeader = function (element, value) {
var self = this,
ui = self._ui,
header = ui.header;
// header element if header does not exist and value is true or string
if (!header && value) {
header = document.createElement("header");
element.appendChild(header);
ui.header = header;
}
if (header) {
// remove child if header does not exist and value is set to false
if (value === false) {
element.removeChild(header);
ui.header = null;
} else {
// if options is set to true, to string or not is set
// add class
header.classList.add(classes.uiHeader);
// if is string fill content by string value
if (typeof value === "string") {
ui.header.textContent = value;
}
}
// and remember options
self.options.header = value;
}
};
/**
* Setter for content option
* @method _setContent
* @param {HTMLElement} element
* @param {string} value
* @protected
* @member ns.widget.core.Page
*/
prototype._setContent = function (element, value) {
var self = this,
ui = self._ui,
content = ui.content,
child = element.firstChild,
next;
if (!content && value) {
content = document.createElement("div");
while (child) {
next = child.nextSibling;
if (child !== ui.footer && child !== ui.header) {
content.appendChild(child);
}
child = next;
}
element.insertBefore(content, ui.footer);
ui.content = content;
}
if (content) {
// remove child if content exist and value is set to false
if (value === false) {
element.removeChild(content);
ui.content = null;
} else {
// if options is set to true, to string or not is set
// add class
content.classList.add(classes.uiContent);
// if is string fill content by string value
if (typeof value === "string") {
content.textContent = value;
}
}
// and remember options
self.options.content = value;
}
};
/**
* Method creates empty page header. It also checks for additional
* content to be added in header.
* @method _buildHeader
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Page
*/
prototype._buildHeader = function (element) {
var self = this;
self._ui.header = utilSelectors.getChildrenBySelector(element, HEADER_SELECTOR)[0] || null;
if (self.options.header === undefined) {
self.options.header = !!self._ui.header;
}
self._setHeader(element, self.options.header);
};
/**
* Method creates empty page footer.
* @method _buildFooter
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Page
*/
prototype._buildFooter = function (element) {
var self = this;
self._ui.footer = utilSelectors.getChildrenBySelector(element, FOOTER_SELECTOR)[0] || null;
if (self.options.footer === undefined) {
self.options.footer = !!self._ui.footer;
}
self._setFooter(element, self.options.footer);
};
/**
* Method creates empty page content.
* @method _buildContent
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Page
*/
prototype._buildContent = function (element) {
var self = this;
self._ui.content = utilSelectors.getChildrenBySelector(element, CONTENT_SELECTOR)[0] || null;
if (self.options.content === undefined) {
self.options.content = !!self._ui.content;
}
self._setContent(element, self.options.content);
};
/**
* Set ARIA attributes on page structure
* @method _setAria
* @protected
* @member ns.widget.core.Page
*/
prototype._setAria = function () {
var self = this,
ui = self._ui,
content = ui.content,
header = ui.header,
footer = ui.footer,
title = ui.title;
if (content) {
content.setAttribute("role", "main");
}
if (header) {
header.setAttribute("role", "header");
}
if (footer) {
footer.setAttribute("role", "footer");
}
if (title) {
title.setAttribute("role", "heading");
title.setAttribute("aria-level", 1);
title.setAttribute("aria-label", "title");
}
};
/**
* Find title of page
* @param {HTMLElement} element
* @method _setTitle
* @protected
* @member ns.widget.core.Page
*/
prototype._setTitle = function (element) {
var self = this,
dataPageTitle = utilsDOM.getNSData(element, "title"),
header = self._ui.header,
pageTitle = dataPageTitle,
titleElement;
if (header) {
titleElement = utilSelectors.getChildrenBySelector(header, "h1, h2, h3, h4, h5, h6")[0];
if (titleElement) {
titleElement.classList.add(classes.uiTitle);
}
if (!pageTitle && titleElement) {
pageTitle = titleElement.innerText;
self._ui.title = titleElement;
}
if (!dataPageTitle && pageTitle) {
utilsDOM.setNSData(element, "title", pageTitle);
}
}
};
/**
* Build page
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.core.Page
*/
prototype._build = function (element) {
var self = this;
element.classList.add(classes.uiPage);
self._buildHeader(element);
self._buildFooter(element);
self._buildContent(element);
self._setTitle(element);
self._setAria();
//it means that we are in wearable profile and we want to make a scrollview on page element (not content)
if (self.options.enablePageScroll === true && !element.querySelector("." + classes.uiScroller)) {
engine.instanceWidget(element, "Scrollview");
}
return element;
};
/**
* This method sets page active or inactive.
*
* @example
* <div id="myPage"></div>
* <script type="text/javascript">
* var page = tau.widget.Page(document.getElementById("myPage"));
* page.setActive(true);
* </script>
*
* @method setActive
* @param {boolean} [value=true] If true, then page will be active. Otherwise, page will be inactive.
* @member ns.widget.core.Page
*/
prototype.setActive = function (value) {
var elementClassList = this.element.classList;
if (value || value === undefined) {
this.focus();
elementClassList.add(classes.uiPageActive);
} else {
this.blur();
elementClassList.remove(classes.uiPageActive);
}
};
/**
* Return current status of page.
* @method isActive
* @member ns.widget.core.Page
* @instance
*/
prototype.isActive = function () {
return this.element.classList.contains(classes.uiPageActive);
};
/**
* Sets the focus to page
* @method focus
* @member ns.widget.core.Page
*/
prototype.focus = function () {
var element = this.element,
focusable = element.querySelector("[autofocus]") || element;
focusable.focus();
};
/**
* Removes focus from page and all descendants
* @method blur
* @member ns.widget.core.Page
*/
prototype.blur = function () {
var element = this.element,
focusable = document.activeElement || element;
focusable.blur();
};
/**
* Bind events to widget
* @method _bindEvents
* @protected
* @member ns.widget.core.Page
*/
prototype._bindEvents = function () {
var self = this;
self._contentFillAfterResizeCallback = self._contentFill.bind(self);
window.addEventListener("resize", self._contentFillAfterResizeCallback, false);
};
/**
* Refresh widget structure
* @method _refresh
* @protected
* @member ns.widget.core.Page
*/
prototype._refresh = function () {
this._restoreContentStyle();
this._contentFill();
};
/**
* Layouting page structure
* @method layout
* @internal
* @member ns.widget.core.Page
*/
prototype.layout = function () {
this._storeContentStyle();
this._contentFill();
};
/**
* This method triggers BEFORE_SHOW event.
* @method onBeforeShow
* @internal
* @member ns.widget.core.Page
*/
prototype.onBeforeShow = function () {
this.trigger(EventType.BEFORE_SHOW);
};
/**
* This method triggers SHOW event.
* @method onShow
* @internal
* @member ns.widget.core.Page
*/
prototype.onShow = function () {
this.trigger(EventType.SHOW);
};
/**
* This method triggers BEFORE_HIDE event.
* @method onBeforeHide
* @internal
* @member ns.widget.core.Page
*/
prototype.onBeforeHide = function () {
this.trigger(EventType.BEFORE_HIDE);
};
/**
* This method triggers HIDE event.
* @method onHide
* @internal
* @member ns.widget.core.Page
*/
prototype.onHide = function () {
this._restoreContentStyle();
this.trigger(EventType.HIDE);
};
/**
* Destroy widget
* @method _destroy
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Page
*/
prototype._destroy = function (element) {
var self = this;
element = element || self.element;
window.removeEventListener("resize", self._contentFillAfterResizeCallback, false);
// destroy widgets on children
engine.destroyAllWidgets(element, true);
self._contentFillAfterResizeCallback = null;
};
/**
* Return scroller
* @method getScroller
* @member ns.widget.core.Page
*/
prototype.getScroller = function () {
var element = this.element,
scroller = element.querySelector("." + classes.uiScroller);
return scroller || element.querySelector("." + classes.uiContent) || element;
};
Page.prototype = prototype;
Page.createEmptyElement = function () {
var div = document.createElement("div");
div.classList.add(classes.uiPage);
return div;
};
engine.defineWidget(
"Page",
"[data-role=page],.ui-page",
[
"focus",
"blur",
"setActive"
],
Page,
// for register in jQuery Mobile space
"mobile"
);
ns.widget.core.Page = Page;
}(window.document, ns));
/**
* #Footer
*
* ## Creating footer
*
* @example template
* <footer class="ui-footer"></footer>
*
* @class ns.widget.core.Footer
* @component-selector .ui-page > footer, .ui-page .ui-footer
* @component-type layout-component
* @extends ns.widget.BaseWidget
*
*/
/**
* #Header
*
* @example template
* <header class="ui-header"><h2 class="ui-title">Header</h2></header>
*
* @class ns.widget.core.Header
* @component-selector .ui-page > header, .ui-page > .ui-header
* @component-type layout-component
* @extends ns.widget.BaseWidget
*/
/**
* Button for menu with icon in header
* @style ui-more
* @selector .ui-btn
* @member ns.widget.core.Header
* @wearable
* @since 2.3.1
*/
/**
* Icon style for menu button
* @style ui-icon-detail
* @selector .ui-btn.ui-more
* @member ns.widget.core.Header
* @wearable
* @since 2.3.1
*/
/**
* Icon style for menu button
* @style ui-icon-overflow
* @selector .ui-btn.ui-more
* @member ns.widget.core.Header
* @wearable
* @since 2.3.1
*/
/**
* Icon style for menu button
* @style ui-icon-selectall
* @selector .ui-btn.ui-more
* @member ns.widget.core.Header
* @wearable
* @since 2.3.1
*/
/**
* #Content
*
* @example template
* <div class="ui-content"></div>
*
* @class ns.widget.core.Content
* @component-selector .ui-content
* @component-type container-component
* @component-constraint 'bottom-button', 'checkbox', 'listview', 'processing', 'closet-tau-circle-progress', 'radio', 'toggleswitch', 'text', 'closet-image', 'sectionchanger'
* @extends ns.widget.BaseWidget
*/
/**
* Defines the buttons inside column width as 100% of the screen
* @style ui-grid-col-1
* @selector div:not(.ui-grid-col-1):not(.ui-grid-col-2):not(.ui-grid-col-3):not(.ui-grid-row)
* @member ns.widget.core.Content
* @wearable
* @since 2.3.1
*/
/**
* Defines the buttons inside column width as 50% of the screen
* @style ui-grid-col-2
* @selector div:not(.ui-grid-col-1):not(.ui-grid-col-2):not(.ui-grid-col-3):not(.ui-grid-row)
* @member ns.widget.core.Content
* @wearable
* @since 2.3.1
*/
/**
* Defines the buttons inside column width as 50% of the screen
* @style ui-grid-col-3
* @selector div:not(.ui-grid-col-1):not(.ui-grid-col-2):not(.ui-grid-col-3):not(.ui-grid-row)
* @member ns.widget.core.Content
* @wearable
* @since 2.3.1
*/
/**
* Arranges the buttons inside in a row
* @style ui-grid-row
* @selector div:not(.ui-grid-col-1):not(.ui-grid-col-2):not(.ui-grid-col-3):not(.ui-grid-row)
* @member ns.widget.core.Content
* @wearable
* @since 2.3.1
*/
;
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # PageContainer Widget
* PageContainer is a widget, which is supposed to have multiple child pages but display only one at a time.
*
* @class ns.widget.core.PageContainer
* @extends ns.widget.BaseWidget
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Krzysztof Głodowski <k.glodowski@samsung.com>
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
util = ns.util,
DOM = util.DOM,
engine = ns.engine,
classes = {
pageContainer: "ui-page-container",
uiViewportTransitioning: "ui-viewport-transitioning",
out: "out",
in: "in",
reverse: "reverse",
uiPreIn: "ui-pre-in",
uiBuild: "ui-page-build"
},
PageContainer = function () {
/**
* Active page.
* @property {ns.widget.core.Page} [activePage]
* @member ns.widget.core.PageContainer
*/
this.activePage = null;
this.inTransition = false;
},
EventType = {
/**
* Triggered before the changePage() request
* has started loading the page into the DOM.
* @event pagebeforechange
* @member ns.widget.core.PageContainer
*/
PAGE_BEFORE_CHANGE: "pagebeforechange",
/**
* Triggered after the changePage() request
* has finished loading the page into the DOM and
* all page transition animations have completed.
* @event pagechange
* @member ns.widget.core.PageContainer
*/
PAGE_CHANGE: "pagechange",
PAGE_REMOVE: "pageremove"
},
animationend = "animationend",
webkitAnimationEnd = "webkitAnimationEnd",
mozAnimationEnd = "mozAnimationEnd",
msAnimationEnd = "msAnimationEnd",
oAnimationEnd = "oAnimationEnd",
animationEndNames = [
animationend,
webkitAnimationEnd,
mozAnimationEnd,
msAnimationEnd,
oAnimationEnd
],
prototype = new BaseWidget();
//When resolved deferred function is responsible for triggering events related to page change as well as
//destroying unused widgets from last page and/or removing last page
function deferredFunction(fromPageWidget, toPageWidget, self, options) {
if (fromPageWidget) {
fromPageWidget.onHide();
if (options.reverse) {
fromPageWidget.destroy();
}
self._removeExternalPage(fromPageWidget, options);
}
toPageWidget.onShow();
self.trigger(EventType.PAGE_CHANGE);
}
/**
* Dictionary for PageContainer related event types.
* @property {Object} events
* @property {string} [events.PAGE_CHANGE="pagechange"]
* @member ns.router.route.popup
* @static
*/
PageContainer.events = EventType;
/**
* Dictionary for PageContainer related css class names
* @property {Object} classes
* @member ns.widget.core.Page
* @static
* @readonly
*/
PageContainer.classes = classes;
/**
* Build widget structure
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._build = function (element) {
element.classList.add(classes.pageContainer);
return element;
};
/**
* This method changes active page to specified element.
* @method change
* @param {HTMLElement} toPageElement The element to set
* @param {Object} [options] Additional options for the transition
* @param {string} [options.transition=none] Specifies the type of transition
* @param {boolean} [options.reverse=false] Specifies the direction of transition
* @member ns.widget.core.PageContainer
*/
prototype.change = function (toPageElement, options) {
var self = this,
fromPageWidget = self.getActivePage(),
toPageWidget,
calculatedOptions = options || {};
// store options to detect that option was changed before process finish
self._options = calculatedOptions;
calculatedOptions.widget = calculatedOptions.widget || "Page";
// The change should be made only if no active page exists
// or active page is changed to another one.
if (!fromPageWidget || (fromPageWidget.element !== toPageElement)) {
if (toPageElement.parentNode !== self.element) {
toPageElement = self._include(toPageElement);
}
self.trigger(EventType.PAGE_BEFORE_CHANGE);
toPageElement.classList.add(classes.uiBuild);
toPageWidget = engine.instanceWidget(toPageElement, calculatedOptions.widget);
// set sizes of page for correct display
toPageWidget.layout();
if (toPageWidget.option("autoBuildWidgets")) {
engine.createWidgets(toPageElement);
}
if (fromPageWidget) {
fromPageWidget.onBeforeHide();
}
toPageWidget.onBeforeShow();
toPageElement.classList.remove(classes.uiBuild);
// if options is different that this mean that another change page was called and we need stop
// previous change page
if (calculatedOptions === self._options) {
calculatedOptions.deferred = {
resolve: deferredFunction
};
self._transition(toPageWidget, fromPageWidget, calculatedOptions);
}
}
};
/**
* This method performs transition between the old and a new page.
* @method _transition
* @param {ns.widget.core.Page} toPageWidget The new page
* @param {ns.widget.core.Page} fromPageWidget The page to be replaced
* @param {Object} [options] Additional options for the transition
* @param {string} [options.transition=none] The type of transition
* @param {boolean} [options.reverse=false] Specifies transition direction
* @param {Object} [options.deferred] Deferred object
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._transition = function (toPageWidget, fromPageWidget, options) {
var self = this,
element = self.element,
elementClassList = element.classList,
transition = !fromPageWidget || !options.transition ? "none" : options.transition,
deferred = options.deferred,
clearClasses = [classes.in, classes.out, classes.uiPreIn, transition],
oldDeferredResolve,
oneEvent;
if (options.reverse) {
clearClasses.push(classes.reverse);
}
self.inTransition = true;
elementClassList.add(classes.uiViewportTransitioning);
oldDeferredResolve = deferred.resolve;
deferred.resolve = function () {
var fromPageWidgetClassList = fromPageWidget && fromPageWidget.element.classList,
toPageWidgetClassList = toPageWidget.element.classList;
self._setActivePage(toPageWidget);
self._clearTransitionClasses(clearClasses, fromPageWidgetClassList, toPageWidgetClassList);
oldDeferredResolve(fromPageWidget, toPageWidget, self, options);
};
if (transition !== "none") {
oneEvent = function () {
toPageWidget.off(
animationEndNames,
oneEvent,
false
);
deferred.resolve();
};
toPageWidget.on(
animationEndNames,
oneEvent,
false
);
self._appendTransitionClasses(fromPageWidget, toPageWidget, transition, options.reverse);
} else {
window.setTimeout(deferred.resolve, 0);
}
};
/**
* This method adds proper transition classes to specified page widgets.
* @param {ns.widget.core.Page} fromPageWidget Page widget from which transition will occur
* @param {ns.widget.core.Page} toPageWidget Destination page widget for transition
* @param {string} transition Specifies the type of transition
* @param {boolean} reverse Specifies the direction of transition
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._appendTransitionClasses = function (fromPageWidget, toPageWidget, transition, reverse) {
var classList;
if (fromPageWidget) {
classList = fromPageWidget.element.classList;
classList.add(transition, classes.out);
if (reverse) {
classList.add(classes.reverse);
}
}
classList = toPageWidget.element.classList;
classList.add(transition, classes.in, classes.uiPreIn);
if (reverse) {
classList.add(classes.reverse);
}
};
/**
* This method removes transition classes from classLists of page widget elements.
* @param {Object} clearClasses An array containing classes to be removed
* @param {Object} fromPageWidgetClassList classList object from source page element
* @param {Object} toPageWidgetClassList classList object from destination page element
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._clearTransitionClasses = function (clearClasses, fromPageWidgetClassList, toPageWidgetClassList) {
var self = this,
element = self.element,
elementClassList = element.classList;
elementClassList.remove(classes.uiViewportTransitioning);
self.inTransition = false;
clearClasses.forEach(function (className) {
toPageWidgetClassList.remove(className);
});
if (fromPageWidgetClassList) {
clearClasses.forEach(function (className) {
fromPageWidgetClassList.remove(className);
});
}
};
/**
* This method adds an element as a page.
* @method _include
* @param {HTMLElement} page an element to add
* @return {HTMLElement}
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._include = function (page) {
var element = this.element;
if (!page.parentNode || page.ownerDocument !== document) {
page = util.importEvaluateAndAppendElement(page, element);
}
return page;
};
/**
* This method sets currently active page.
* @method _setActivePage
* @param {ns.widget.core.Page} page a widget to set as the active page
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._setActivePage = function (page) {
var self = this;
if (self.activePage) {
self.activePage.setActive(false);
}
self.activePage = page;
page.setActive(true);
};
/**
* This method returns active page widget.
* @method getActivePage
* @member ns.widget.core.PageContainer
* @return {ns.widget.core.Page} Currently active page
*/
prototype.getActivePage = function () {
return this.activePage;
};
/**
* This method removes page element from the given widget and destroys it.
* @method _removeExternalPage
* @param {ns.widget.core.Page} fromPageWidget the widget to destroy
* @param {Object} [options] transition options
* @param {boolean} [options.reverse=false] specifies transition direction
* @member ns.widget.core.PageContainer
* @protected
*/
prototype._removeExternalPage = function (fromPageWidget, options) {
var fromPageElement = fromPageWidget.element;
if (options && options.reverse && DOM.hasNSData(fromPageElement, "external") &&
fromPageElement.parentNode) {
fromPageElement.parentNode.removeChild(fromPageElement);
this.trigger(EventType.PAGE_REMOVE);
}
};
PageContainer.prototype = prototype;
// definition
ns.widget.core.PageContainer = PageContainer;
engine.defineWidget(
"pagecontainer",
"",
["change", "getActivePage"],
PageContainer,
"core"
);
}(window.document, ns));
/*global define, ns */
/*jslint nomen: true, plusplus: true, bitwise: false */
/*
* Copyright (c) 2010 - 2014 Samsung Electronics Co., Ltd.
* License : MIT License V2
*/
/**
* #Template Manager
*
* Object menage template's engines and renderer HTMLElement by template engine.
*
* @class ns.template
* @since 2.4
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
*/
(function () {
"use strict";
var utilPath = ns.util.path,
template,
templateFunctions = {},
globalOptions = {
"pathPrefix": "",
"default": ""
};
/**
* Function to get global option
*
* @example
* tau.template.get("pathPrefix");
* // -> "/prefix/to/all/paths"
*
* @method get
* @param {string} name param name which will be return
* @return {*} return value of option
* @since 2.4
* @member ns.template
*/
function get(name) {
return globalOptions[name];
}
/**
* Function to set global option
*
* @example
* tau.template.set("pathPrefix", "/views");
*
* @method set
* @param {string} name param name which will be set
* @param {*} value value to set
* @since 2.4
* @member ns.template
*/
function set(name, value) {
globalOptions[name] = value;
}
/**
* Register new template function
*
* Template function should have 4 arguments:
*
* - globalOptions - global options of template engine
* - path - path or id of template content
* - data - data for template render
* - callback - callback call on finish
*
* and should call callback on finish with arguments:
*
* - status - object describing status of render
* - element - base HTMLElement of template results (on error can be null)
*
* after registration you can use engine in render function.
*
* @example
* tau.template.register("inline", function(globalOptions, path, data, callback) {
* callback({
* success: true
* },
* document.createElement("div")
* );
* });
*
* @method register
* @param {string} name Engine name
* @param {Function} templateFunction function to renderer template
* @since 2.4
* @member ns.template
*/
function register(name, templateFunction) {
templateFunctions[name] = templateFunction;
}
/**
* Unregister template function
*
* @method unregister
* @param {string} name Engine name
* @since 2.4
* @member ns.template
*/
function unregister(name) {
templateFunctions[name] = null;
}
/**
* Return engine with given name
*
* @method engine
* @param {string} name Engine name
* @since 2.4
* @member ns.template
*/
function engine(name) {
return templateFunctions[name];
}
/**
* Create absolute path for given path.
* If parameter withProfile is true, the returned path will have name of profile
* separated by dots before the last dot.
* @method getAbsUrl
* @param {string} path
* @param {boolean} withProfile Create path with profile's name
* @return {string} changed path
* @since 2.4
*/
function getAbsUrl(path, withProfile) {
var profile = ns.info.profile,
lastDot = path.lastIndexOf(".");
if (utilPath.isAbsoluteUrl(path)) {
return path;
}
if (withProfile) {
path = path.substring(0, lastDot) + "." + profile + path.substring(lastDot);
}
return utilPath.makeUrlAbsolute((globalOptions.pathPrefix || "") + path, utilPath.getLocation());
}
/**
* Return HTMLElement for given path
*
* When engine name is not given then get default name from global options. If this is not set then get first registered engine.
*
* Result of this method is handed to callback. First parameter of callback is object with status. Second is HTMLElement generated by engine.
*
* Status object contains properties:
*
* - _boolean_ success - inform about success or error
* - _string_ description contains details on error
*
* @example
* tau.template.render("external/path/to/file.html", {additionalParameter: true}, function(status, element) {
* if (status.success) {
* document.body.appendChild(element);
* } else {
* console.error(status.description);
* }, "html");
*
* @method render
* @param {string} path Path to file ot other id for template system
* @param {Object} data additional data for template system
* @param {Function} callback function which will be called on finish
* @param {string} [engineName] engine name
* @since 2.4
* @member ns.template
*/
function render(path, data, callback, engineName) {
var templateFunction = templateFunctions[engineName || get("default") || ""],
targetCallback = function (status, element) {
// add current patch
status.absUrl = targetPath;
callback(status, element);
},
templateCallback = function (status, element) {
if (status.success) {
// path was found and callback can be called
targetCallback(status, element);
} else {
// try one more time with path without profile
targetPath = getAbsUrl(path, false);
templateFunction(globalOptions, targetPath, data || {}, targetCallback);
}
},
targetPath;
// if template engine name and default name is not given then we
// take first registered engine
if (!templateFunction) {
templateFunction = templateFunctions[Object.keys(templateFunctions).pop()];
}
// if template system exists then we go to him
if (templateFunction) {
targetPath = getAbsUrl(path, ns.getConfig("findProfileFile", false));
templateFunction(globalOptions, targetPath, data || {}, templateCallback);
} else {
// else we return error
callback({
success: false,
description: "Can't get engine system"
}, null);
}
}
template = {
get: get,
set: set,
register: register,
unregister: unregister,
engine: engine,
render: render
};
ns.template = template;
}());
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global define, HTMLElement, ns */
/**
* #Router
*
* Main class to navigate between pages, popups and other widgets which has own rules in all profiles.
*
* Class communicates with PageContainer which deactivate and activate changed pages.
*
* Router listening on events triggered by history manager.
*
* ## Getting instance
*
* To receive instance of router you should use method _getInstance_
*
* @example
* var router = ns.router.Router.getInstance();
*
* By default TAU create instance of router and getInstance method return this instance.
*
* ##Connected widgets
*
* Router cooperate with widgets:
*
* - Page
* - Popup
* - Drawer
* - Dialog (mobile)
* - CircularIndexScrollBar (wearable - circle)
*
* Opening or closing these widgets are possible by create link with correct rel.
*
* ##Global options used in router
*
* - *pageContainer* = document.body - default container element
* - *pageContainerBody* = false - use body instead pageContainer option
* - *autoInitializePage* = true - automatically initialize first page
* - *addPageIfNotExist* = true - automatically add page if doesn't exist
* - *loader* = false - enable loader on change page
* - *disableRouter* = false - disable auto initialize of router
*
* @class ns.router.Router
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
* @author Hyunkook, Cho <hk0713.cho@samsung.com>
* @author Piotr Czajka <p.czajka@samsung.com>
* @author Junhyeon Lee <juneh.lee@samsung.com>
* @author Michał Szepielak <m.szepielak@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @author Heeju Joo <heeju.joo@samsung.com>
*/
(function (window, document) {
"use strict";
/**
* Local alias for ns.util
* @property {Object} util Alias for {@link ns.util}
* @member ns.router.Router
* @static
* @private
*/
var util = ns.util,
/**
* Local alias for ns.event
* @property {Object} eventUtils Alias for {@link ns.event}
* @member ns.router.Router
* @static
* @private
*/
eventUtils = ns.event,
/**
* Alias for {@link ns.util.DOM}
* @property {Object} DOM
* @member ns.router.Router
* @static
* @private
*/
DOM = util.DOM,
/**
* Local alias for ns.util.path
* @property {Object} path Alias for {@link ns.util.path}
* @member ns.router.Router
* @static
* @private
*/
path = util.path,
/**
* Local alias for ns.util.selectors
* @property {Object} selectors Alias for {@link ns.util.selectors}
* @member ns.router.Router
* @static
* @private
*/
selectors = util.selectors,
/**
* Local alias for ns.util.object
* @property {Object} object Alias for {@link ns.util.object}
* @member ns.router.Router
* @static
* @private
*/
object = util.object,
/**
* Local alias for ns.engine
* @property {Object} engine Alias for {@link ns.engine}
* @member ns.router.Router
* @static
* @private
*/
engine = ns.engine,
/**
* Local alias for ns.router
* @property {Object} router Alias for namespace ns.router
* @member ns.router.Router
* @static
* @private
*/
router = ns.router,
/**
* Local alias for ns.history
* @property {Object} history Alias for {@link ns.history}
* @member ns.router.Router
* @static
* @private
*/
history = ns.history,
historyManager = history.manager,
/**
* Local alias for ns.history.manager.events
* @property {Object} historyManagerEvents Alias for (@link ns.history.manager.events}
* @member ns.router.Router
* @static
* @private
*/
historyManagerEvents = historyManager.events,
/**
* Local alias for ns.router.route
* @property {Object} route Alias for namespace ns.router.route
* @member ns.router.Router
* @static
* @private
*/
route = router.route,
/**
* Local alias for document body element
* @property {HTMLElement} body
* @member ns.router.Router
* @static
* @private
*/
body = document.body,
/**
* Alias to Array.slice method
* @method slice
* @member ns.router.Router
* @private
* @static
*/
slice = [].slice,
/**
* Local instance of the Router
* @property {Object} routerInstance
* @member ns.router.Router
* @static
* @private
*/
_isLock = false,
ORDER_NUMBER = {
1: "page",
10: "panel",
100: "popup",
101: "dialog",
1000: "drawer",
2000: "circularindexscrollbar"
},
eventType = {
BEFORE_ROUTER_INIT: "beforerouterinit",
ROUTER_INIT: "routerinit"
},
HASH_REGEXP = /[#|\s]/g,
Page = ns.widget.core.Page,
routerInstance,
template = ns.template,
Router = function () {
var self = this;
/**
* Instance of widget PageContainer which controls page changing.
* @property {?ns.widget.core.PageContainer} [container=null]
* @member ns.router.Router
*/
self.container = null;
/**
* Settings for last call of method open
* @property {Object} [settings={}]
* @member ns.router.Router
*/
self.settings = {};
/**
* Handler for event "statechange"
* @property {Function} [_onStateChangeHandler=null]
* @member ns.router.Router
* @protected
* @since 2.4
*/
self._onStateChangeHandler = null;
/**
* Handler for event "hashchange"
* @property {Function} [_onHashChangeHandler=null]
* @member ns.router.Router
* @protected
* @since 2.4
*/
self._onHashChangeHandler = null;
/**
* Handler for event "controllercontent"
* @property {Function} [_onControllerContent=null]
* @member ns.router.Router
* @protected
* @since 2.4
*/
self._onControllerContent = null;
/**
* Router locking flag
* @property {boolean} locked=false
* @member ns.router.Router
* @since 2.4
*/
self.locked = false;
};
/**
* Default values for router
* @property {Object} defaults
* @property {boolean} [defaults.fromHashChange=false] Sets if will be changed after hashchange.
* @property {boolean} [defaults.reverse=false] Sets the direction of change.
* @property {boolean} [defaults.volatileRecord=false] Sets if the current history entry will be modified or a new one will be created.
* @member ns.router.Router
*/
Router.prototype.defaults = {
fromHashChange: false,
reverse: false,
volatileRecord: false
};
/**
* Find the closest link for element
* @method findClosestLink
* @param {HTMLElement} element
* @return {HTMLElement}
* @private
* @static
* @member ns.router.Router
*/
function findClosestLink(element) {
while (element) {
if (element.nodeType === Node.ELEMENT_NODE && element.nodeName && element.nodeName === "A") {
break;
}
element = element.parentNode;
}
return element;
}
/**
* Handle event link click
* @method linkClickHandler
* @param {ns.router.Router} router
* @param {Event} event
* @private
* @static
* @member ns.router.Router
*/
function linkClickHandler(router, event) {
var link = findClosestLink(event.target),
href,
useDefaultUrlHandling,
options;
if (link && event.which === 1) {
href = link.getAttribute("href");
useDefaultUrlHandling = (link.getAttribute("rel") === "external") || link.hasAttribute("target");
if (!useDefaultUrlHandling) {
options = DOM.getData(link);
router.open(href, options, event);
eventUtils.preventDefault(event);
}
}
}
Router.prototype.linkClick = function (event) {
linkClickHandler(this, event);
};
function openUrlFromState(instanceRouter, state) {
var rules = router.route,
prevState = history.activeState,
reverse = state && history.getDirection(state) === "back",
maxOrderNumber,
orderNumberArray = [],
ruleKey,
options,
url = path.getLocation(),
isContinue = true,
transition,
rule;
transition = reverse ? ((prevState && prevState.transition) || "none") : state.transition;
options = object.merge({}, state, {
reverse: reverse,
transition: transition,
fromHashChange: true
});
// find rule with max order number
for (ruleKey in rules) {
if (rules.hasOwnProperty(ruleKey) && rules[ruleKey].active) {
orderNumberArray.push(rules[ruleKey].orderNumber);
}
}
maxOrderNumber = Math.max.apply(null, orderNumberArray);
rule = rules[ORDER_NUMBER[maxOrderNumber]];
if (rule && rule.onHashChange(url, options, prevState)) {
if (maxOrderNumber === 10) {
// rule is panel
return;
}
isContinue = false;
}
history.setActive(state);
if (isContinue) {
instanceRouter.open(state.url, options);
}
}
/**
* Detect rel attribute from HTMLElement.
*
* This method tries to match element to each rule filter and return first rule name which match.
*
* If don't match any rule then return null.
*
* @example
* var router = tau.router.Router.getInstance();
* router.detectRel(document.getElementById("pageId"));
* // if HTML element will be match to selector of page then return rule for page
*
* @param {HTMLElement} to element to check
* @member ns.router.Router
* @return {?string}
*/
Router.prototype.detectRel = function (to) {
var rule,
i;
for (i in route) {
if (route.hasOwnProperty(i)) {
rule = route[i];
if (selectors.matchesSelector(to, rule.filter)) {
return i;
}
}
}
return null;
};
/**
* Open given page with deferred
* @method _openDeferred
* @param {HTMLElement} to HTMLElement of page
* @param {Object} [options]
* @param {"page"|"popup"|"external"} [options.rel = "page"] Represents kind of link as "page"
* or "popup"
* or "external" for linking to another domain.
* @param {string} [options.transition = "none"] Sets the animation used during change of
* page.
* @param {boolean} [options.reverse = false] Sets the direction of change.
* @param {boolean} [options.fromHashChange = false] Sets if will be changed after hashchange.
* @param {boolean} [options.volatileRecord = false] Sets if the current history entry will
* be modified or
* a new one will be created.
* @param {boolean} [options.dataUrl] Sets if page has url attribute.
* @param {?string} [options.container = null] It is used in RoutePopup as selector for
* container.
* @param {Event} event
* @member ns.router.Router
* @protected
*/
Router.prototype._openDeferred = function (to, options, event) {
var self = this,
rule = route[options.rel],
deferred = {
resolve: function (_options, content) {
rule.open(content, _options, event);
},
reject: function (_options) {
eventUtils.trigger(self.container.element, "changefailed", _options);
}
};
if (typeof to === "string") {
if (to.replace(HASH_REGEXP, "")) {
self._loadUrl(to, options, rule, deferred);
}
} else {
// execute deferred object immediately
if (to && selectors.matchesSelector(to, rule.filter)) {
deferred.resolve(options, to);
} else {
deferred.reject(options);
}
}
};
/**
* Change page to page given in parameter "to".
*
* @example
* var router = tau.router.Router.getInstance();
* router.open("pageId");
* // open page with given id
* router.open("page.html");
* // open page from html file
* router.open("popupId");
* // open popup with given id
*
* @method open
* @param {string|HTMLElement} to Id of page or file url or HTMLElement of page
* @param {Object} [options]
* @param {"page"|"popup"|"external"} [options.rel="page"] Represents kind of link as "page" or "popup" or "external" for linking to another domain.
* @param {string} [options.transition="none"] Sets the animation used during change of page.
* @param {boolean} [options.reverse=false] Sets the direction of change.
* @param {boolean} [options.fromHashChange=false] Sets if will be changed after hashchange.
* @param {boolean} [options.volatileRecord=false] Sets if the current history entry will be modified or a new one will be created.
* @param {boolean} [options.dataUrl] Sets if page has url attribute.
* @param {?string} [options.container=null] It is used in RoutePopup as selector for container.
* @param {Event} [event] Event object
* @member ns.router.Router
*/
Router.prototype.open = function (to, options, event) {
var self = this,
rel,
rule;
if (!_isLock) {
to = getHTMLElement(to);
rel = (options && options.rel) ||
(to instanceof HTMLElement && self.detectRel(to));
rel = rel || "page";
rule = route[rel];
if (rel === "back") {
history.back();
} else if (rule) {
options = object.merge(
{
rel: rel
},
self.defaults,
rule.option(),
options
);
self._openDeferred(to, options, event);
} else {
throw new Error("Not defined router rule [" + rel + "]");
}
}
};
/**
* Init routes defined in router
* @method _initRoutes
* @member ns.router.Router
*/
Router.prototype._initRoutes = function () {
var ruleKey,
rules = router.route;
for (ruleKey in rules) {
if (rules.hasOwnProperty(ruleKey) && rules[ruleKey].init) {
rules[ruleKey].init();
}
}
};
function removeActivePageClass(containerElement) {
var PageClasses = Page.classes,
uiPageActiveSelector = "." + PageClasses.uiPageActive,
activePages = slice.call(containerElement.querySelectorAll(uiPageActiveSelector));
activePages.forEach(function (page) {
page.classList.remove(uiPageActiveSelector);
});
}
Router.prototype._autoInitializePage = function (containerElement, pages, pageSelector) {
var self = this,
page,
location = window.location,
uiPageActiveClass = Page.classes.uiPageActive,
firstPage = containerElement.querySelector("." + uiPageActiveClass);
if (!firstPage) {
firstPage = pages[0];
}
if (firstPage) {
removeActivePageClass(containerElement);
}
if (location.hash) {
//simple check to determine if we should show firstPage or other
page = document.getElementById(location.hash.replace("#", ""));
if (page && selectors.matchesSelector(page, pageSelector)) {
firstPage = page;
}
}
if (!firstPage && ns.getConfig("addPageIfNotExist", true)) {
firstPage = Page.createEmptyElement();
while (containerElement.firstChild) {
firstPage.appendChild(containerElement.firstChild);
}
containerElement.appendChild(firstPage);
}
if (self.justBuild) {
if (firstPage) {
self.register(
engine.instanceWidget(containerElement, "pagecontainer"),
firstPage
);
}
}
return firstPage;
};
/**
* Method initializes page container and builds the first page if flag autoInitializePage is
* set.
* @method init
* @param {boolean} justBuild
* @member ns.router.Router
*/
Router.prototype.init = function (justBuild) {
var containerElement,
firstPage,
pages,
pageDefinition = ns.engine.getWidgetDefinition("Page"),
pageSelector = pageDefinition.selector,
self = this;
eventUtils.trigger(document, eventType.BEFORE_ROUTER_INIT, self, false);
body = document.body;
self.justBuild = justBuild;
containerElement = ns.getConfig("pageContainer") || body;
pages = slice.call(containerElement.querySelectorAll(pageSelector));
if (!ns.getConfig("pageContainerBody", false)) {
containerElement = pages.length ? pages[0].parentNode : containerElement;
}
if (ns.getConfig("autoInitializePage", true)) {
firstPage = self._autoInitializePage(containerElement, pages, pageSelector);
if (justBuild) {
return;
}
}
historyManager.enable();
// init router's routes
self._initRoutes();
self.register(
engine.instanceWidget(containerElement, "pagecontainer"),
firstPage
);
eventUtils.trigger(document, eventType.ROUTER_INIT, self, false);
};
/**
* Method removes all events listeners set by router.
*
* Also remove singleton instance of router;
*
* @example
* var router = tau.router.Router.getInstance();
* router.destroy();
* var router2 = tau.router.Router.getInstance();
* // router !== router2
*
* @method destroy
* @member ns.router.Router
*/
Router.prototype.destroy = function () {
var self = this;
historyManager.disable();
window.removeEventListener("popstate", self.popStateHandler, false);
if (body) {
body.removeEventListener("pagebeforechange", self.pagebeforechangeHandler, false);
body.removeEventListener("vclick", self.linkClickHandler, false);
}
};
/**
* Method sets instance of PageContainer widget
*
* @example
* var router = tau.router.Router.getInstance();
* router.setContainer(new ns.widget.PageContainer());
*
* @method setContainer
* @param {ns.widget.core.PageContainer} container
* @member ns.router.Router
*/
Router.prototype.setContainer = function (container) {
this.container = container;
};
/**
* Method returns instance of PageContainer widget
*
* @example
* var router = tau.router.Router.getInstance();
* containerWidget = router.getContainer();
*
* @method getContainer
* @return {ns.widget.core.PageContainer}
* @member ns.router.Router
*/
Router.prototype.getContainer = function () {
return this.container;
};
/**
* Method returns ths first page HTMLElement
* @method getFirstPage
* @return {HTMLElement}
* @member ns.router.Router
*/
Router.prototype.getFirstPage = function () {
return this.getRoute("page").getFirstElement();
};
/**
* Callback for event "historyhashchange" which is triggered by history manager after hash is changed
* @param {ns.router.Router} router
* @param {Event} event
*/
function onHistoryHashChange(router, event) {
openUrlFromState(router, event.detail);
}
/**
* Callback for event "historystatechange" which is triggered by history manager after hash is changed
* @param {ns.router.Router} router
* @param {Event} event
*/
function onHistoryStateChange(router, event) {
var options = event.detail,
//
url = options.reverse ? options.url : (options.href || options.url);
delete options.event;
router.open(url, options);
// prevent current event
eventUtils.preventDefault(event);
eventUtils.stopImmediatePropagation(event);
}
/**
* Convert HTML string to HTMLElement
* @param {string|HTMLElement} content
* @param {string} title
* @return {?HTMLElement}
*/
function convertToNode(content, title) {
var contentNode = null,
externalDocument = document.implementation.createHTMLDocument(title),
externalBody = externalDocument.body;
if (content instanceof HTMLElement) {
// if content is HTMLElement just set to contentNode
contentNode = content;
} else {
// otherwise convert string to HTMLElement
try {
externalBody.insertAdjacentHTML("beforeend", content);
contentNode = externalBody.firstChild;
} catch (e) {
ns.error("Failed to inject element", e);
}
}
return contentNode;
}
/**
* Set data-url on HTMLElement if not exists
* @param {HTMLElement} contentNode
* @param {string} url
*/
function setURLonElement(contentNode, url) {
if (url) {
if (contentNode instanceof HTMLElement && !DOM.hasNSData(contentNode, "url")) {
// if url is missing we need set data-url attribute for good finding by method open in router
url = url.replace(/^#/, "");
DOM.setNSData(contentNode, "url", url);
}
}
}
/**
* Callback for event "controller-content-available" which is triggered by controller after application handle hash change
* @param {ns.router.Router} router
* @param {Event} event
*/
function onControllerContent(router, event) {
var data = event.detail,
content = data.content,
options = data.options,
contentNode,
url = (options.href || options.url);
// if controller give content
if (content) {
// convert to node if content is string
contentNode = convertToNode(content, options.title);
// set data-url on node
setURLonElement(contentNode, url);
// calling open method
router.open(contentNode, options);
//prevent event
eventUtils.preventDefault(event);
}
}
/**
* Method registers page container and the first page.
*
* @example
* var router = tau.router.Router.getInstance();
* router.register(new ns.widget.PageContainer(), document.getElementById("firstPage"));
*
* @method register
* @param {ns.widget.core.PageContainer} container
* @param {HTMLElement} firstPage
* @member ns.router.Router
*/
Router.prototype.register = function (container, firstPage) {
var self = this,
routePopup = this.getRoute("popup");
// sets instance of PageContainer widget
self.container = container;
// sets first page HTMLElement
self.getRoute("page").setFirstElement(firstPage);
eventUtils.trigger(document, "themeinit", self);
// sets events handlers
if (!self._onHashChangeHandler) {
self._onHashChangeHandler = onHistoryHashChange.bind(null, self);
window.addEventListener(historyManagerEvents.HASHCHANGE, self._onHashChangeHandler, false);
}
if (!self._onStateChangeHandler) {
self._onStateChangeHandler = onHistoryStateChange.bind(null, self);
window.addEventListener(historyManagerEvents.STATECHANGE, self._onStateChangeHandler, false);
}
if (!self._onControllerContent) {
self._onControllerContent = onControllerContent.bind(null, self);
window.addEventListener("controller-content-available", self._onControllerContent, false);
}
// if loader config is set then create loader widget
if (ns.getConfig("loader", false)) {
container.element.appendChild(self.getLoader().element);
}
// set history support
history.enableVolatileMode();
// if first page exist open this page without transition
if (firstPage) {
self.open(firstPage, {transition: "none"});
}
if (routePopup) {
routePopup.setActive(null);
}
};
/**
* Convert string id to HTMLElement or return HTMLElement if is given
* @param {string|HTMLElement} idOrElement
* @return {HTMLElement|string}
*/
function getHTMLElement(idOrElement) {
var stringId,
toElement;
// if given argument is string then
if (typeof idOrElement === "string") {
if (idOrElement[0] === "#") {
// trim first char if it is #
stringId = idOrElement.substr(1);
} else {
stringId = idOrElement;
}
// find element by id
toElement = document.getElementById(stringId);
if (toElement) {
// is exists element by id then return it
idOrElement = toElement;
}
// otherwise return string
}
return idOrElement;
}
/**
* Method close route element, eg page or popup.
*
* @example
* var router = tau.router.Router.getInstance();
* router.close("popupId", {transition: "none"});
*
* @method close
* @param {string|HTMLElement} to Id of page or file url or HTMLElement of page
* @param {Object} [options]
* @param {"page"|"popup"|"external"} [options.rel="page"] Represents kind of link as "page" or "popup" or "external" for linking to another domain
* @member ns.router.Router
*/
Router.prototype.close = function (to, options) {
var rel = "back",
closingWidget = getHTMLElement(to),
rule;
if (options && options.rel) {
rel = options.rel;
} else if (closingWidget) {
rel = this.detectRel(closingWidget);
}
rule = route[rel];
// if router is not locked
if (!this.locked) {
// if rel is back then call back method
if (rel === "back") {
history.back();
} else {
// otherwise if rule exists
if (rule) {
// call close on rule
rule.close(closingWidget, options);
} else {
throw new Error("Not defined router rule [" + rel + "]");
}
}
}
};
/**
* Method back to previous state.
*
* @example
* var router = tau.router.Router.getInstance();
* router.back();
*
* @method close
* @member ns.router.Router
*/
Router.prototype.back = function () {
// if router is not locked
if (!this.locked) {
history.back();
}
};
/**
* Method opens popup.
*
* @example
* var router = tau.router.Router.getInstance();
* router.openPopup("popupId", {transition: "none"});
*
* @method openPopup
* @param {HTMLElement|string} to Id or HTMLElement of popup.
* @param {Object} [options]
* @param {string} [options.transition="none"] Sets the animation used during change of page.
* @param {boolean} [options.reverse=false] Sets the direction of change.
* @param {boolean} [options.fromHashChange=false] Sets if will be changed after hashchange.
* @param {boolean} [options.volatileRecord=false] Sets if the current history entry will be modified or a new one will be created.
* @param {boolean} [options.dataUrl] Sets if page has url attribute.
* @param {?string} [options.container=null] It is used in RoutePopup as selector for container.
* @member ns.router.Router
*/
Router.prototype.openPopup = function (to, options) {
// call method open with overwrite rel option
this.open(to, object.fastMerge({rel: "popup"}, options));
};
/**
* Method closes popup.
*
* @example
* var router = tau.router.Router.getInstance();
* router.closePopup();
*
* @method closePopup
* @param {Object} options
* @param {string=} [options.transition]
* @param {string=} [options.ext="in ui-pre-in"] options.ext
* @member ns.router.Router
*/
Router.prototype.closePopup = function (options) {
var popupRoute = this.getRoute("popup");
if (popupRoute) {
popupRoute.close(null, options);
}
};
/**
* Lock router
* @method lock
* @member ns.router.Router
*/
Router.prototype.lock = function () {
this.locked = true;
};
/**
* Unlock router and history manager
* @method unlock
* @member ns.router.Router
*/
Router.prototype.unlock = function () {
this.locked = false;
};
/**
* Load content from url.
*
* Method prepare url and call template function to load external file.
*
* If option showLoadMsg is ste to tru open loader widget before start loading.
*
* @method _loadUrl
* @param {string} url full URL to load
* @param {Object} options options for this and next methods in chain
* @param {boolean} [options.data] Sets if page has url attribute.
* @param {Object} rule rule which support given call
* @param {Object} deferred object with callbacks
* @param {Function} deferred.reject callback on error
* @param {Function} deferred.resolve callback on success
* @member ns.router.Router
* @protected
*/
Router.prototype._loadUrl = function (url, options, rule, deferred) {
var absUrl = path.makeUrlAbsolute(url, path.getLocation()),
content,
self = this,
data = options.data || {};
// check if content is loaded in current document
content = rule.find(absUrl);
// if content doesn't find and url is embedded url
if (!content && path.isEmbedded(absUrl)) {
// reject
deferred.reject({});
} else {
// If the content we are interested in is already in the DOM,
// and the caller did not indicate that we should force a
// reload of the file, we are done. Resolve the deferred so that
// users can bind to .done on the promise
if (content) {
// content was found and we resolve
deferred.resolve(object.fastMerge({absUrl: absUrl}, options), content);
} else {
// Load the new content.
eventUtils.trigger(self.getContainer().element, options.rel + "beforeload");
// force return full document from template system
data.fullDocument = true;
// we put url, not the whole path to function render,
// because this path can be modified by template's module
template.render(url, data, function (status, element) {
// if template loaded successful
if (status.success) {
self._loadSuccess(status.absUrl, options, rule, deferred, element);
eventUtils.trigger(self.getContainer().element, options.rel + "load");
} else {
self._loadError(status.absUrl, options, deferred);
}
});
}
}
};
/**
* Error handler for loading content by AJAX
* @method _loadError
* @param {string} absUrl full URL to load
* @param {Object} options options for this and next methods in chain
* @param {boolean} [options.showLoadMsg=true] Sets if message will be shown during loading.
* @param {Object} deferred object with callbacks
* @param {Function} deferred.reject callback on error
* @member ns.router.Router
* @protected
*/
Router.prototype._loadError = function (absUrl, options, deferred) {
var detail = object.fastMerge({url: absUrl}, options),
self = this;
ns.error("load error, file: ", absUrl);
self.container.trigger("loadfailed", detail);
deferred.reject(detail);
};
// TODO it would be nice to split this up more but everything appears to be "one off"
// or require ordering such that other bits are sprinkled in between parts that
// could be abstracted out as a group
/**
* Success handler for loading content by AJAX
* @method _loadSuccess
* @param {string} absUrl full URL to load
* @param {Object} options options for this and next methods in chain
* @param {boolean} [options.showLoadMsg=true] Sets if message will be shown during loading.
* @param {Object} rule rule which support given call
* @param {Object} deferred object with callbacks
* @param {Function} deferred.reject callback on error
* @param {Function} deferred.resolve callback on success
* @param {string} html
* @member ns.router.Router
* @protected
*/
Router.prototype._loadSuccess = function (absUrl, options, rule, deferred, html) {
var detail = object.fastMerge({url: absUrl}, options),
// find element with given id in returned html
content = rule.parse(html, absUrl);
if (content) {
deferred.resolve(detail, content);
} else {
deferred.reject(detail);
}
};
// TODO the first page should be a property set during _create using the logic
// that currently resides in init
/**
* Get initial content
* @method _getInitialContent
* @member ns.router.Router
* @return {HTMLElement} the first page
* @protected
*/
Router.prototype._getInitialContent = function () {
return this.getRoute("page").getFirstElement();
};
/**
* Report an error loading
* @method _showError
* @param {string} absUrl
* @member ns.router.Router
* @protected
*/
Router.prototype._showError = function (absUrl) {
ns.error("load error, file: ", absUrl);
};
/**
* Returns Page or Popup widget
* @param {string} [routeName="page"] in default page or popup
* @method getActive
* @return {ns.widget.BaseWidget}
* @member ns.router.Router
*/
Router.prototype.getActive = function (routeName) {
var route = this.getRoute(routeName || "page");
return route && route.getActive();
};
/**
* Returns true if element in given route is active.
* @param {string} [routeName="page"] in default page or popup
* @method hasActive
* @return {boolean}
* @member ns.router.Router
*/
Router.prototype.hasActive = function (routeName) {
var route = this.getRoute(routeName || "page");
return !!(route && route.hasActive());
};
/**
* Returns true if any popup is active.
*
* @example
* var router = tau.router.Router.getInstance(),
* hasActivePopup = router.hasActivePopup();
* // -> true | false
*
* @method hasActivePopup
* @return {boolean}
* @member ns.router.Router
*/
Router.prototype.hasActivePopup = function () {
return this.hasActive("popup");
};
/**
* This function returns proper route.
*
* @example
* var router = tau.router.Router.getInstance(),
* route = router.getRoute("page"),
* // -> Object with pages support
* activePage = route.getActive();
* // instance of Page widget
*
* @method getRoute
* @param {string} type Type of route
* @return {?ns.router.route.interface}
* @member ns.router.Router
*/
Router.prototype.getRoute = function (type) {
return route[type];
};
/**
* Returns instance of loader widget.
*
* If loader not exist then is created on first element matched to selector
* or is created new element.
*
* @example
* var loader = router.getLoader();
* // get or create loader
* loader.show();
* // show loader
*
* @return {?ns.widget.mobile.Loader}
* @member ns.router.Page
* @method getLoader
*/
Router.prototype.getLoader = function () {
var loaderDefinition = engine.getWidgetDefinition("Loader"),
loaderSelector = loaderDefinition.selector,
loaderElement;
if (loaderDefinition) {
loaderElement = document.querySelector(loaderSelector);
return engine.instanceWidget(loaderElement, "Loader");
}
return null;
};
/**
* Creates a new instance of the router and returns it
*
* @example
* var router = Router.newInstance();
*
* @method newInstance
* @member ns.router.Router
* @static
* @return {ns.router.Router}
* @since 2.4
*/
Router.newInstance = function () {
return (routerInstance = new Router());
};
/**
* Returns a instance of the router, creates a new if does not exist
*
* @example
* var router = tau.router.Router.getInstance(),
* // if router not exists create new instance and return
* router2 = tau.router.Router.getInstance();
* // only return router from first step
* // router === router2
*
* @method getInstance
* @member ns.router.Router
* @return {ns.router.Router}
* @since 2.4
* @static
*/
Router.getInstance = function () {
if (!routerInstance) {
return this.newInstance();
}
return routerInstance;
};
router.Router = Router;
Router.eventType = eventType;
/**
* Returns router instance
* @deprecated 2,4
* @return {ns.router.Router}
*/
engine.getRouter = function () { //@TODO FIX HACK old API
//@TODO this is suppressed since the tests are unreadable
// tests need fixes
ns.warn("getRouter() method is deprecated! Use tau.router.Router.getInstance() instead");
return Router.getInstance();
};
if (!ns.getConfig("disableRouter", false)) {
document.addEventListener(engine.eventType.READY, function () {
Router.getInstance().init();
}, false);
document.addEventListener(engine.eventType.DESTROY, function () {
Router.getInstance().destroy();
}, false);
}
//engine.initRouter(Router);
}(window, window.document));
/*global window, ns, define, ns */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Route Page
* Support class for router to control changing pages.
* @class ns.router.route.page
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (document) {
"use strict";
var util = ns.util,
path = util.path,
DOM = util.DOM,
object = util.object,
utilSelector = util.selectors,
history = ns.history,
engine = ns.engine,
baseElement,
routePage = {},
head;
/**
* Tries to find a page element matching id and filter (selector).
* Adds data url attribute to found page, sets page = null when nothing found
* @method findPageAndSetDataUrl
* @param {string} dataUrl DataUrl of searching element
* @param {string} filter Query selector for searching page
* @return {?HTMLElement}
* @private
* @static
* @member ns.router.route.page
*/
function findPageAndSetDataUrl(dataUrl, filter) {
var id = path.stripQueryParams(dataUrl).replace("#", ""),
page = document.getElementById(id);
if (page && utilSelector.matchesSelector(page, filter)) {
if (dataUrl === id) {
DOM.setNSData(page, "url", "#" + id);
} else {
DOM.setNSData(page, "url", dataUrl);
}
} else {
// if we matched any element, but it doesn't match our filter
// reset page to null
page = null;
}
return page;
}
routePage.orderNumber = 1;
/**
* Property containing default properties
* @property {Object} defaults
* @property {string} defaults.transition="none"
* @static
* @member ns.router.route.page
*/
routePage.defaults = {
transition: "none"
};
/**
* Property defining selector without spaces for filtering only page elements.
* @property {string} filter
* @member ns.router.route.page
* @static
*/
routePage.filter = engine.getWidgetDefinition("Page").selector.replace(/(\s*)/g, "");
/**
* Property contains first page element
* @property {?HTMLElement} firstPage
* @member ns.router.route.page
* @static
*/
routePage.firstPage = null;
/**
* Returns default route options used inside Router.
* @method option
* @static
* @member ns.router.route.page
* @return {Object} default route options
*/
routePage.option = function () {
var defaults = object.merge({}, routePage.defaults);
defaults.transition = ns.getConfig("pageTransition", defaults.transition);
return defaults;
};
routePage.init = function () {
var pages = [].slice.call(document.querySelectorAll(this.filter));
pages.forEach(function (page) {
if (!DOM.getNSData(page, "url")) {
DOM.setNSData(page, "url",
(page.id && "#" + page.id) || location.pathname + location.search);
}
});
};
/**
* This method changes page. It sets history and opens page passed as a parameter.
* @method open
* @param {HTMLElement|string} toPage The page which will be opened.
* @param {Object} [options]
* @param {boolean} [options.fromHashChange] Sets if call was made on hash change.
* @param {string} [options.dataUrl] Sets if page has url attribute.
* @member ns.router.route.page
*/
routePage.open = function (toPage, options) {
var pageTitle = document.title,
url,
state;
if (toPage === this.getFirstElement() && !options.dataUrl) {
url = path.documentUrl.hrefNoHash;
} else {
url = DOM.getNSData(toPage, "url");
}
// if no url is set, apply the address of chosen page to data-url attribute
// and use it as url, as this is needed for history state
if (!url && options.href) {
url = options.href;
DOM.setNSData(toPage, "url", url);
}
pageTitle = DOM.getNSData(toPage, "title") ||
utilSelector.getChildrenBySelector(toPage, ".ui-header > .ui-title").textContent ||
pageTitle;
if (!DOM.getNSData(toPage, "title")) {
DOM.setNSData(toPage, "title", pageTitle);
}
if (url && !options.fromHashChange) {
if (!path.isPath(url) && url.indexOf("#") < 0) {
url = path.makeUrlAbsolute("#" + url, path.documentUrl.hrefNoHash);
}
state = object.merge(
{},
options,
{
url: url
}
);
history.replace(state, pageTitle, url);
}
// write base element
this._setBase(url);
//set page title
document.title = pageTitle;
this.active = true;
this.getContainer().change(toPage, options);
};
/**
* This method determines target page to open.
* @method find
* @param {string} absUrl Absolute path to opened page
* @member ns.router.route.page
* @return {?HTMLElement} Element of page to open.
*/
routePage.find = function (absUrl) {
var self = this,
router = ns.router.Router.getInstance(),
dataUrl = self._createDataUrl(absUrl),
initialContent = self.getFirstElement(),
pageContainer = router.getContainer(),
page,
selector = "[data-url='" + dataUrl + "']",
filterRegexp = /,/gm;
if (/#/.test(absUrl) && path.isPath(dataUrl)) {
return null;
}
// Check to see if the page already exists in the DOM.
// NOTE do _not_ use the :jqmData pseudo selector because parenthesis
// are a valid url char and it breaks on the first occurrence
// prepare selector for new page
selector += self.filter.replace(filterRegexp, ",[data-url='" + dataUrl + "']");
page = pageContainer.element.querySelector(selector);
// If we failed to find the page, check to see if the url is a
// reference to an embedded page. If so, it may have been dynamically
// injected by a developer, in which case it would be lacking a
// data-url attribute and in need of enhancement.
if (!page && dataUrl && !path.isPath(dataUrl)) {
//Remove search data
page = findPageAndSetDataUrl(dataUrl, self.filter);
}
// If we failed to find a page in the DOM, check the URL to see if it
// refers to the first page in the application. Also check to make sure
// our cached-first-page is actually in the DOM. Some user deployed
// apps are pruning the first page from the DOM for various reasons.
// We check for this case here because we don't want a first-page with
// an id falling through to the non-existent embedded page error case.
if (!page &&
path.isFirstPageUrl(dataUrl, self.getFirstElement()) &&
initialContent) {
page = initialContent;
}
return page;
};
/**
* This method parses HTML and runs scripts from parsed code.
* Fetched external scripts if required.
* Sets document base to parsed document absolute path.
* @method parse
* @param {string} html HTML code to parse
* @param {string} absUrl Absolute url for parsed page
* @member ns.router.route.page
* @return {?HTMLElement} Element of page in parsed document.
*/
routePage.parse = function (html, absUrl) {
var self = this,
page,
dataUrl = self._createDataUrl(absUrl);
// write base element
self._setBase(absUrl);
// Finding matching page inside created element
page = html.querySelector(self.filter);
// If a page exists...
if (page) {
DOM.setNSData(page, "url", dataUrl);
DOM.setNSData(page, "external", true);
}
return page;
};
/**
* This method handles hash change, **currently does nothing**.
* @method onHashChange
* @static
* @member ns.router.route.page
* @return {null}
*/
routePage.onHashChange = function (/* url, options */) {
return null;
};
/**
* This method creates data url from absolute url given as argument.
* @method _createDataUrl
* @param {string} absoluteUrl
* @protected
* @static
* @member ns.router.route.page
* @return {string}
*/
routePage._createDataUrl = function (absoluteUrl) {
return path.convertUrlToDataUrl(absoluteUrl, true);
};
/**
* On open fail, currently never used
* @method onOpenFailed
* @member ns.router.route.page
*/
routePage.onOpenFailed = function (/* options */) {
this._setBase(path.parseLocation().hrefNoSearch);
};
/**
* This method returns base element from document head.
* If no base element is found, one is created based on current location.
* @method _getBaseElement
* @protected
* @static
* @member ns.router.route.page
* @return {HTMLElement}
*/
routePage._getBaseElement = function () {
// Fetch document head if never cached before
if (!head) {
head = document.querySelector("head");
}
// Find base element
if (!baseElement) {
baseElement = document.querySelector("base");
if (!baseElement) {
baseElement = document.createElement("base");
baseElement.href = path.documentBase.hrefNoHash;
head.appendChild(baseElement);
}
}
return baseElement;
};
/**
* Sets document base to url given as argument
* @method _setBase
* @param {string} url
* @protected
* @member ns.router.route.page
*/
routePage._setBase = function (url) {
var base = this._getBaseElement(),
baseHref = base.href;
if (path.isPath(url)) {
url = path.makeUrlAbsolute(url, path.documentBase);
if (path.parseUrl(baseHref).hrefNoSearch !== path.parseUrl(url).hrefNoSearch) {
base.href = url;
path.documentBase = path.parseUrl(path.makeUrlAbsolute(url, path.documentUrl.href));
}
}
};
/**
* Returns container of pages
* @method getContainer
* @return {?ns.widget.core.Page}
* @member ns.router.route.page
* @static
*/
routePage.getContainer = function () {
return ns.router.Router.getInstance().getContainer();
};
/**
* Returns active page.
* @method getActive
* @return {?ns.widget.core.Page}
* @member ns.router.route.page
* @static
*/
routePage.getActive = function () {
return this.getContainer().getActivePage();
};
/**
* Returns element of active page.
* @method getActiveElement
* @return {HTMLElement}
* @member ns.router.route.page
* @static
*/
routePage.getActiveElement = function () {
return this.getActive().element;
};
/**
* Method returns ths first page.
* @method getFirstElement
* @return {HTMLElement} the first page
* @member ns.router.route.page
*/
routePage.getFirstElement = function () {
return this.firstPage;
};
/**
* Method sets ths first page.
* @method setFirstElement
* @param {HTMLElement} firstPage the first page
* @member ns.router.route.page
*/
routePage.setFirstElement = function (firstPage) {
this.firstPage = firstPage;
};
ns.router.route.page = routePage;
}(window.document));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Callback Utility
* Class creates a callback list
*
* Create a callback list using the following parameters:
* options: an optional list of space-separated options that will change how
* the callback list behaves or a more traditional option object
*
* By default a callback list will act like an event callback list and can be
* "fired" multiple times.
*
* Possible options:
*
* once: will ensure the callback list can only be fired once (like a Deferred)
*
* memory: will keep track of previous values and will call any callback added
* after the list has been fired right away with the latest "memorized"
* values (like a Deferred)
*
* unique: will ensure a callback can only be added once (no duplicate in the list)
*
* stopOnFalse: interrupt callings when a callback returns false
* @class ns.util.callbacks
*/
(function (window, document, ns) {
"use strict";
ns.util.callbacks = function (orgOptions) {
var object = ns.util.object,
options = object.copy(orgOptions),
/**
* Alias to Array.slice function
* @method slice
* @member ns.util.callbacks
* @private
*/
slice = [].slice,
/**
* Last fire value (for non-forgettable lists)
* @property {Object} memory
* @member ns.util.callbacks
* @private
*/
memory,
/**
* Flag to know if list was already fired
* @property {boolean} fired
* @member ns.util.callbacks
* @private
*/
fired,
/**
* Flag to know if list is currently firing
* @property {boolean} firing
* @member ns.util.callbacks
* @private
*/
firing,
/**
* First callback to fire (used internally by add and fireWith)
* @property {number} [firingStart=0]
* @member ns.util.callbacks
* @private
*/
firingStart,
/**
* End of the loop when firing
* @property {number} firingLength
* @member ns.util.callbacks
* @private
*/
firingLength,
/**
* Index of currently firing callback (modified by remove if needed)
* @property {number} firingIndex
* @member ns.util.callbacks
* @private
*/
firingIndex,
/**
* Actual callback list
* @property {Array} list
* @member ns.util.callbacks
* @private
*/
list = [],
/**
* Stack of fire calls for repeatable lists
* @property {Array} stack
* @member ns.util.callbacks
* @private
*/
stack = !options.once && [],
fire,
add,
self = {
/**
* Add a callback or a collection of callbacks to the list
* @method add
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
add: function () {
var start;
if (list) {
// First, we save the current length
start = list.length;
add(arguments);
// Do we need to add the callbacks to the
// current firing batch?
if (firing) {
firingLength = list.length;
// With memory, if we're not firing then
// we should call right away
} else if (memory) {
firingStart = start;
fire(memory);
}
}
return this;
},
/**
* Remove a callback from the list
* @method remove
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
remove: function () {
if (list) {
slice.call(arguments).forEach(function (arg) {
var index = list.indexOf(arg);
while (index > -1) {
list.splice(index, 1);
// Handle firing indexes
if (firing) {
if (index <= firingLength) {
firingLength--;
}
if (index <= firingIndex) {
firingIndex--;
}
}
index = list.indexOf(arg, index);
}
});
}
return this;
},
/**
* Check if a given callback is in the list.
* If no argument is given,
* return whether or not list has callbacks attached.
* @method has
* @param {Function} fn
* @return {boolean}
* @member ns.util.callbacks
*/
has: function (fn) {
return fn ? !!list && list.indexOf(fn) > -1 : !!(list && list.length);
},
/**
* Remove all callbacks from the list
* @method empty
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
empty: function () {
list = [];
firingLength = 0;
return this;
},
/**
* Have the list do nothing anymore
* @method disable
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
disable: function () {
list = stack = memory = undefined;
return this;
},
/**
* Is it disabled?
* @method disabled
* @return {boolean}
* @member ns.util.callbacks
*/
disabled: function () {
return !list;
},
/**
* Lock the list in its current state
* @method lock
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
lock: function () {
stack = undefined;
if (!memory) {
self.disable();
}
return this;
},
/**
* Is it locked?
* @method locked
* @return {boolean} stack
* @member ns.util.callbacks
*/
locked: function () {
return !stack;
},
/**
* Call all callbacks with the given context and
* arguments
* @method fireWith
* @param {Object} context
* @param {Array} args
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
fireWith: function (context, args) {
if (list && (!fired || stack)) {
args = args || [];
args = [context, args.slice ? args.slice() : args];
if (firing) {
stack.push(args);
} else {
fire(args);
}
}
return this;
},
/**
* Call all the callbacks with the given arguments
* @method fire
* @return {ns.util.callbacks} self
* @member ns.util.callbacks
*/
fire: function () {
self.fireWith(this, arguments);
return this;
},
/**
* To know if the callbacks have already been called at
* least once
* @method fired
* @return {boolean}
* @member ns.util.callbacks
*/
fired: function () {
return !!fired;
}
};
/**
* Adds functions to the callback list
* @method add
* @param {...*} argument
* @member ns.util.bezierCurve
* @private
*/
add = function (args) {
slice.call(args).forEach(function (arg) {
var type = typeof arg;
if (type === "function") {
if (!options.unique || !self.has(arg)) {
list.push(arg);
}
} else if (arg && arg.length && type !== "string") {
// Inspect recursively
add(arg);
}
});
};
/**
* Fire callbacks
* @method fire
* @param {Array} data
* @member ns.util.bezierCurve
* @private
*/
fire = function (data) {
memory = options.memory && data;
fired = true;
firingIndex = firingStart || 0;
firingStart = 0;
firingLength = list.length;
firing = true;
while (list && firingIndex < firingLength) {
if (list[firingIndex].apply(data[0], data[1]) === false && options.stopOnFalse) {
memory = false; // To prevent further calls using add
break;
}
firingIndex++;
}
firing = false;
if (list) {
if (stack) {
if (stack.length) {
fire(stack.shift());
}
} else if (memory) {
list = [];
} else {
self.disable();
}
}
};
return self;
};
}(window, window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Deferred Utility
* Class creates object which can call registered callback depend from
* state of object..
* @class ns.util.deferred
* @author Tomasz Lukawski <t.lukawski@samsung.com>
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/(function (window, document, ns) {
"use strict";
var Deferred = function (callback) {
var callbacks = ns.util.callbacks,
object = ns.util.object,
/**
* Register additional action for deferred object
* @property {Array} tuples
* @member ns.util.deferred
* @private
*/
tuples = [
// action, add listener, listener list, final state
["resolve", "done", callbacks({once: true, memory: true}), "resolved"],
["reject", "fail", callbacks({once: true, memory: true}), "rejected"],
["notify", "progress", callbacks({memory: true})]
],
state = "pending",
deferred = {},
promise = {
/**
* Determine the current state of a Deferred object.
* @method state
* @return {"pending" | "resolved" | "rejected"} representing the current state
* @member ns.util.deferred
*/
state: function () {
return state;
},
/**
* Add handlers to be called when the Deferred object
* is either resolved or rejected.
* @method always
* @return {ns.util.deferred} self
* @member ns.util.deferred
*/
always: function () {
deferred.done(arguments).fail(arguments);
return this;
},
/**
* Add handlers to be called when the Deferred object
* is resolved, rejected, or still in progress.
* @method then
* @return {Object} returns a new promise
* @member ns.util.deferred
*/
then: function () { /* fnDone, fnFail, fnProgress */
var functions = arguments;
return new Deferred(function (newDefer) {
tuples.forEach(function (tuple, i) {
var fn = (typeof functions[i] === "function") && functions[i];
// deferred[ done | fail | progress ] for forwarding actions to newDefer
deferred[tuple[1]](function () {
var returned = fn && fn.apply(this, arguments);
if (returned && (typeof returned.promise === "function")) {
returned.promise()
.done(newDefer.resolve)
.fail(newDefer.reject)
.progress(newDefer.notify);
} else {
newDefer[tuple[0] + "With"](this === promise ? newDefer.promise() : this, fn ? [returned] : arguments);
}
});
});
functions = null;
}).promise();
},
/**
* Get a promise for this deferred. If obj is provided,
* the promise aspect is added to the object
* @method promise
* @param {Object} obj
* @return {Object} return a Promise object
* @member ns.util.deferred
*/
promise: function (obj) {
if (obj) {
return object.merge(obj, promise);
}
return promise;
}
};
/**
* alias for promise.then, Keep pipe for back-compat
* @method pipe
* @member ns.util.deferred
*/
promise.pipe = promise.then;
// Add list-specific methods
tuples.forEach(function (tuple, i) {
var list = tuple[2],
stateString = tuple[3];
// promise[ done | fail | progress ] = list.add
promise[tuple[1]] = list.add;
// Handle state
if (stateString) {
list.add(function () {
// state = [ resolved | rejected ]
state = stateString;
// mapping of values [ reject_list | resolve_list ].disable; progress_list.lock
}, tuples[i ^ 1][2].disable, tuples[2][2].lock);
}
// deferred[ resolve | reject | notify ]
deferred[tuple[0]] = function () {
deferred[tuple[0] + "With"](this === deferred ? promise : this, arguments);
return this;
};
deferred[tuple[0] + "With"] = list.fireWith;
});
// Make the deferred a promise
promise.promise(deferred);
// Call given func if any
if (callback) {
callback.call(deferred, deferred);
}
// All done!
return deferred;
};
ns.util.deferred = Deferred;
}(window, window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Popup
* Popup component supports 2 pop-ups: the position-to-window pop-up (like a system pop-up), and the context pop-up.
*
* @since 2.0
* @author Hyunkook Cho <hk0713.cho@samsung.com>
* @class ns.widget.mobile.Popup
* @extends ns.widget.core.BaseWidget
*/
(function () {
"use strict";
/**
* Alias for {@link ns.widget.BaseWidget}
* @property {Function} BaseWidget
* @member ns.widget.core.Popup
* @private
*/
var BaseWidget = ns.widget.BaseWidget,
/**
* Alias for class ns.engine
* @property {ns.engine} engine
* @member ns.widget.core.Popup
* @private
*/
engine = ns.engine,
/**
* Alias for class ns.util.object
* @property {Object} objectUtils
* @member ns.widget.core.Popup
* @private
*/
objectUtils = ns.util.object,
/**
* Alias for class ns.util.deferred
* @property {Object} UtilDeferred
* @member ns.widget.core.Popup
* @private
*/
UtilDeferred = ns.util.deferred,
/**
* Alias for class ns.util.selectors
* @property {Object} utilSelector
* @member ns.widget.core.Popup
* @private
*/
utilSelector = ns.util.selectors,
/**
* Alias for class ns.event
* @property {Object} eventUtils
* @member ns.widget.core.Popup
* @private
*/
eventUtils = ns.event,
/**
* Alias for Router, loose requirement
* @property {ns.router.Router} Router
* @member ns.widget.core.Popup
* @private
*/
Router = ns.router && ns.router.Router,
POPUP_SELECTOR = "[data-role='popup'], .ui-popup",
Popup = function () {
var self = this,
ui = {};
self.selectors = selectors;
self.options = objectUtils.merge({}, Popup.defaults);
self.storedOptions = null;
/**
* Popup state flag
* @property {0|1|2|3} [state=null]
* @member ns.widget.core.Popup
* @private
*/
self.state = states.CLOSED;
ui.overlay = null;
ui.header = null;
ui.footer = null;
ui.content = null;
ui.container = null;
ui.wrapper = null;
self._ui = ui;
// event callbacks
self._callbacks = {};
},
/**
* Object with default options
* @property {Object} defaults
* @property {string} [options.transition="none"] Sets the default transition for the popup.
* @property {string} [options.positionTo="window"] Sets the element relative to which the popup will be centered.
* @property {boolean} [options.dismissible=true] Sets whether to close popup when a popup is open to support the back button.
* @property {boolean} [options.overlay=true] Sets whether to show overlay when a popup is open.
* @property {boolean|string} [options.header=false] Sets content of header.
* @property {boolean|string} [options.footer=false] Sets content of footer.
* @property {string} [options.content=null] Sets content of popup.
* @property {string} [options.overlayClass=""] Sets the custom class for the popup background, which covers the entire window.
* @property {string} [options.closeLinkSelector="a[data-rel='back']"] Sets selector for close buttons in popup.
* @property {boolean} [options.history=true] Sets whether to alter the url when a popup is open to support the back button.
* @member ns.widget.core.Popup
* @static
*/
defaults = {
transition: "none",
dismissible: true,
overlay: true,
header: false,
footer: false,
content: null,
overlayClass: "",
closeLinkSelector: "[data-rel='back']",
history: null,
closeAfter: null
},
states = {
DURING_OPENING: 0,
OPENED: 1,
DURING_CLOSING: 2,
CLOSED: 3
},
CLASSES_PREFIX = "ui-popup",
/**
* Dictionary for popup related css class names
* @property {Object} classes
* @member ns.widget.core.Popup
* @static
*/
/**
* Toast style of popup
* @style ui-popup-toast
* @member ns.widget.core.Popup
* @wearable
*/
/**
* Toast style of popup with graphic
* @style ui-popup-toast-graphic
* @member ns.widget.core.Popup
* @wearable
*/
classes = {
popup: CLASSES_PREFIX,
active: CLASSES_PREFIX + "-active",
overlay: CLASSES_PREFIX + "-overlay",
header: CLASSES_PREFIX + "-header",
footer: CLASSES_PREFIX + "-footer",
content: CLASSES_PREFIX + "-content",
wrapper: CLASSES_PREFIX + "-wrapper",
toast: CLASSES_PREFIX + "-toast",
toastSmall: CLASSES_PREFIX + "-toast-small",
build: "ui-build"
},
/**
* Dictionary for popup related selectors
* @property {Object} selectors
* @member ns.widget.core.Popup
* @static
*/
selectors = {
header: "." + classes.header,
content: "." + classes.content,
footer: "." + classes.footer
},
EVENTS_PREFIX = "popup",
/**
* Dictionary for popup related events
* @property {Object} events
* @member ns.widget.core.Popup
* @static
*/
events = {
/**
* Triggered when the popup has been created in the DOM (via ajax or other) but before all widgets have had an opportunity to enhance the contained markup.
* @event popupshow
* @member ns.widget.core.Popup
*/
show: EVENTS_PREFIX + "show",
/**
* Triggered on the popup after the transition animation has completed.
* @event popuphide
* @member ns.widget.core.Popup
*/
hide: EVENTS_PREFIX + "hide",
/**
* Triggered on the popup we are transitioning to, before the actual transition animation is kicked off.
* @event popupbeforeshow
* @member ns.widget.core.Popup
*/
/* eslint-disable camelcase */
// we can't change this in this moment because this is part of API
before_show: EVENTS_PREFIX + "beforeshow",
/**
* Triggered on the popup we are transitioning to, before the actual transition animation is kicked off, animation has started.
* @event popuptransitionstart
* @member ns.widget.core.Popup
*/
transition_start: EVENTS_PREFIX + "transitionstart",
/**
* Triggered on the popup we are transitioning away from, before the actual transition animation is kicked off.
* @event popupbeforehide
* @member ns.widget.core.Popup
*/
before_hide: EVENTS_PREFIX + "beforehide"
/* eslint-enable camelcase */
},
prototype = new BaseWidget();
Popup.classes = classes;
Popup.events = events;
Popup.defaults = defaults;
Popup.selector = POPUP_SELECTOR;
/**
* Build the content of popup
* @method _buildContent
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Popup
*/
prototype._buildContent = function (element) {
var self = this,
ui = self._ui,
selectors = self.selectors,
options = self.options,
content = ui.content || element.querySelector(selectors.content),
footer = ui.footer || element.querySelector(selectors.footer),
elementChildren = [].slice.call(element.childNodes),
elementChildrenLength = elementChildren.length,
i,
node;
if (!content) {
content = document.createElement("div");
content.className = classes.content;
for (i = 0; i < elementChildrenLength; ++i) {
node = elementChildren[i];
if (node !== ui.footer && node !== ui.header) {
content.appendChild(node);
}
}
if (typeof options.content === "string") {
content.innerHTML = options.content;
}
element.insertBefore(content, footer);
}
content.classList.add(classes.content);
ui.content = content;
};
/**
* Build the header of popup
* @method _buildHeader
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Popup
*/
prototype._buildHeader = function (element) {
var self = this,
ui = self._ui,
options = self.options,
selectors = self.selectors,
content = ui.content || element.querySelector(selectors.content),
header = ui.header || element.querySelector(selectors.header);
if (!header && options.header !== false) {
header = document.createElement("div");
header.className = classes.header;
if (typeof options.header !== "boolean") {
header.innerHTML = options.header;
}
element.insertBefore(header, content);
}
if (header) {
header.classList.add(classes.header);
}
ui.header = header;
};
/**
* Set the header of popup.
* This function is called by function "option" when the option "header" is set.
* @method _setHeader
* @param {HTMLElement} element
* @param {boolean|string} value
* @protected
* @member ns.widget.core.Popup
*/
prototype._setHeader = function (element, value) {
var self = this,
ui = self._ui,
header = ui.header;
if (header) {
header.parentNode.removeChild(header);
ui.header = null;
}
self.options.header = value;
self._buildHeader(ui.container);
};
/**
* Build the footer of popup
* @method _buildFooter
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Popup
*/
prototype._buildFooter = function (element) {
var self = this,
ui = self._ui,
options = self.options,
footer = ui.footer || element.querySelector(self.selectors.footer);
if (!footer && options.footer !== false) {
footer = document.createElement("div");
footer.className = classes.footer;
if (typeof options.footer !== "boolean") {
footer.innerHTML = options.footer;
}
element.appendChild(footer);
}
if (footer) {
footer.classList.add(classes.footer);
}
ui.footer = footer;
};
/**
* Set the footer of popup.
* This function is called by function "option" when the option "footer" is set.
* @method _setFooter
* @param {HTMLElement} element
* @param {boolean|string} value
* @protected
* @member ns.widget.core.Popup
*/
prototype._setFooter = function (element, value) {
var self = this,
ui = self._ui,
footer = ui.footer;
if (footer) {
footer.parentNode.removeChild(footer);
ui.footer = null;
}
self.options.footer = value;
self._buildFooter(ui.container);
};
/**
* Build structure of Popup widget
* @method _build
* @param {HTMLElement} element of popup
* @return {HTMLElement}
* @protected
* @member ns.widget.Popup
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
wrapper,
child = element.firstChild,
elementClassList = element.classList;
// set class for element
elementClassList.add(classes.popup);
if (elementClassList.contains(classes.toastSmall)) {
elementClassList.add(classes.toast);
}
// create wrapper
wrapper = document.createElement("div");
wrapper.classList.add(classes.wrapper);
ui.wrapper = wrapper;
ui.container = wrapper;
// move all children to wrapper
while (child) {
wrapper.appendChild(child);
child = element.firstChild;
}
// add wrapper and arrow to popup element
element.appendChild(wrapper);
// build header, footer and content
self._buildHeader(ui.container);
self._buildFooter(ui.container);
self._buildContent(ui.container);
// set overlay
self._setOverlay(element, self.options.overlay);
return element;
};
/**
* Set overlay
* @method _setOverlay
* @param {HTMLElement} element
* @param {boolean} enable
* @protected
* @member ns.widget.Popup
*/
prototype._setOverlay = function (element, enable) {
var self = this,
overlayClass = self.options.overlayClass,
ui = self._ui,
overlay = ui.overlay;
// if this popup is not connected with slider,
// we create overlay, which is invisible when
// the value of option overlay is false
/// @TODO: get class from widget
if (!element.classList.contains("ui-slider-popup") && !element.classList.contains(classes.toast)) {
// create overlay
if (!overlay) {
overlay = document.createElement("div");
if (element.parentNode) {
element.parentNode.insertBefore(overlay, element);
} else {
ns.warn("Popup is creating on element outside DOM");
}
ui.overlay = overlay;
}
overlay.className = classes.overlay + (overlayClass ? " " + overlayClass : "");
if (enable) {
overlay.style.opacity = "";
} else {
// if option is set on "false", the overlay is not visible
overlay.style.opacity = 0;
}
}
};
/**
* Returns the state of the popup
* @method _isActive
* @protected
* @member ns.widget.core.Popup
*/
prototype._isActive = function () {
var state = this.state;
return state === states.DURING_OPENING || state === states.OPENED;
};
/**
* Returns true if popup is already opened and visible
* @method _isActive
* @protected
* @member ns.widget.core.Popup
*/
prototype._isOpened = function () {
return this.state === states.OPENED;
};
/**
* Init widget
* @method _init
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Popup
*/
prototype._init = function (element) {
var self = this,
selectors = self.selectors,
ui = self._ui,
options = self.options,
elementClassList = self.element.classList;
ui.header = ui.header || element.querySelector(selectors.header);
ui.footer = ui.footer || element.querySelector(selectors.footer);
ui.content = ui.content || element.querySelector(selectors.content);
ui.wrapper = ui.wrapper || element.querySelector("." + classes.wrapper);
ui.container = ui.wrapper || element;
// @todo - use selector from page's definition in engine
ui.page = utilSelector.getClosestByClass(element, "ui-page") || window;
if (elementClassList.contains(classes.toast)) {
options.closeAfter = options.closeAfter || 2000;
}
// if option history is not set in constructor or in HTML
if (options.history === null) {
// for toast we set false for other true
options.history = !elementClassList.contains(classes.toast);
}
};
/**
* Set the state of the popup
* @method _setActive
* @param {boolean} active
* @protected
* @member ns.widget.core.Popup
*/
prototype._setActive = function (active) {
var self = this,
activeClass = classes.active,
elementClassList = self.element.classList,
route = Router && Router.getInstance().getRoute("popup"),
options;
// NOTE: popup's options object is stored in window.history at the router module,
// and this window.history can't store DOM element object.
options = objectUtils.merge({}, self.options, {positionTo: null, link: null});
// set state of popup and add proper class
if (active) {
// set global variable
if (route) {
route.setActive(self, options);
}
// add proper class
elementClassList.add(activeClass);
// set state of popup 358
self.state = states.OPENED;
} else {
// no popup is opened, so set global variable on "null"
if (route) {
route.setActive(null, options);
}
// remove proper class
elementClassList.remove(activeClass);
// set state of popup
self.state = states.CLOSED;
}
};
/**
* Bind events
* @method _bindEvents
* @protected
* @member ns.widget.core.Popup
*/
prototype._bindEvents = function () {
var self = this;
eventUtils.on(self._ui.page, "pagebeforehide", self, false);
eventUtils.on(window, "resize", self, false);
eventUtils.on(document, "click touchstart", self, false);
};
/**
* Unbind events
* @method _bindEvents
* @protected
* @member ns.widget.core.Popup
*/
prototype._unbindEvents = function () {
var self = this;
eventUtils.off(self._ui.page, "pagebeforehide", self, false);
eventUtils.off(window, "resize", self, false);
eventUtils.off(document, "click touchstart", self, false);
};
/**
* Layouting popup structure
* @method layout
* @member ns.widget.core.Popup
*/
prototype._layout = function () {
};
/**
* Open the popup
* @method open
* @param {Object=} [options]
* @param {string=} [options.transition] options.transition
* @member ns.widget.core.Popup
*/
prototype.open = function (options) {
var self = this,
newOptions,
onClose = self.close.bind(self);
if (!self._isActive()) {
/*
* Some passed options on open need to be kept until popup closing.
* For example, transition parameter should be kept for closing animation.
* On the other hand, fromHashChange or x, y parameter should be removed.
* We store options and restore them on popup closing.
*/
self._storeOpenOptions(options);
newOptions = objectUtils.merge(self.options, options);
if (!newOptions.dismissible) {
ns.router.Router.getInstance().lock();
}
if (newOptions.closeAfter > 0) {
if (self.element.classList.contains(classes.toast)) {
newOptions.transition = "fade";
}
self._show(newOptions);
self._closeTimeout = window.setTimeout(onClose, newOptions.closeAfter);
} else {
self._show(newOptions);
}
}
};
/**
* Close the popup
* @method close
* @param {Object=} [options]
* @param {string=} [options.transition]
* @member ns.widget.core.Popup
*/
prototype.close = function (options) {
var self = this,
newOptions = objectUtils.merge(self.options, options);
if (self._isActive()) {
clearTimeout(self._closeTimeout);
if (!newOptions.dismissible) {
ns.router.Router.getInstance().unlock();
}
self._hide(newOptions);
}
};
/**
* Store Open options.
* @method _storeOpenOptions
* @param {Object} options
* @protected
* @member ns.widget.core.Popup
*/
prototype._storeOpenOptions = function (options) {
var self = this,
oldOptions = self.options,
storedOptions = {},
key;
for (key in options) {
if (options.hasOwnProperty(key)) {
storedOptions[key] = oldOptions[key];
}
}
self.storedOptions = storedOptions;
};
/**
* Restore Open options and remove some unnecessary ones.
* @method _storeOpenOptions
* @protected
* @member ns.widget.core.Popup
*/
prototype._restoreOpenOptions = function () {
var self = this,
options = self.options,
propertiesToRemove = ["x", "y", "fromHashChange"];
// we restore opening values of all options
options = objectUtils.merge(options, self.storedOptions);
// and remove all values which should not be stored
objectUtils.removeProperties(options, propertiesToRemove);
};
/**
* Show popup.
* @method _show
* @param {Object} options
* @protected
* @member ns.widget.core.Popup
*/
prototype._show = function (options) {
var self = this,
transitionOptions = objectUtils.merge({}, options),
overlay = self._ui.overlay;
// set layout
self._layout(self.element);
// change state of popup
self.state = states.DURING_OPENING;
// set transition
transitionOptions.ext = " in ";
self.trigger(events.before_show);
// show overlay
if (overlay) {
overlay.style.display = "block";
}
// start opening animation
self._transition(transitionOptions, self._onShow.bind(self));
// animation has started
self.trigger(events.transition_start);
};
/**
* Show popup
* @method _onShow
* @protected
* @member ns.widget.core.Popup
*/
prototype._onShow = function () {
var self = this;
self._setActive(true);
self.trigger(events.show);
};
/**
* Hide popup
* @method _hide
* @param {Object} options
* @protected
* @member ns.widget.core.Popup
*/
prototype._hide = function (options) {
var self = this,
isOpened = self._isOpened(),
callbacks = self._callbacks;
// change state of popup
self.state = states.DURING_CLOSING;
self.trigger(events.before_hide);
if (isOpened) {
// popup is opened, so we start closing animation
options.ext = " out ";
self._transition(options, self._onHide.bind(self));
} else {
// popup is active, but not opened yet (DURING_OPENING), so
// we stop opening animation
if (callbacks.transitionDeferred) {
callbacks.transitionDeferred.reject();
}
if (callbacks.animationEnd) {
callbacks.animationEnd();
}
// and set popup as inactive
self._onHide();
}
};
/**
* Hide popup
* @method _onHide
* @protected
* @member ns.widget.core.Popup
*/
prototype._onHide = function () {
var self = this,
overlay = self._ui.overlay;
self._setActive(false);
if (overlay) {
overlay.style.display = "";
}
self._restoreOpenOptions();
self.trigger(events.hide);
};
/**
* Handle events
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.Popup
*/
prototype.handleEvent = function (event) {
var self = this,
router = ns.router.Router.getInstance();
switch (event.type) {
case "pagebeforehide":
// we need close active popup if exists
router.close(null, {transition: "none", rel: "popup"});
break;
case "resize":
self._onResize(event);
break;
case "click":
if (event.target === self._ui.overlay) {
self._onClickOverlay(event);
}
break;
case "touchstart":
if (self.element.classList.contains(classes.toast) && self._isActive()) {
router.close(null, {rel: "popup"});
}
break;
}
};
/**
* Refresh structure
* @method _refresh
* @protected
* @member ns.widget.core.Popup
*/
prototype._refresh = function () {
var self = this;
self._setOverlay(self.element, self.options.overlay);
};
/**
* Callback function fires after clicking on overlay.
* @method _onClickOverlay
* @param {Event} event
* @protected
* @member ns.widget.core.Popup
*/
prototype._onClickOverlay = function (event) {
var options = this.options;
event.preventDefault();
event.stopPropagation();
if (options.dismissible) {
ns.router.Router.getInstance().close(null, {rel: "popup"});
}
};
/**
* Callback function fires on resizing
* @method _onResize
* @protected
* @member ns.widget.core.Popup
*/
prototype._onResize = function () {
if (this._isOpened()) {
this._refresh();
}
};
function clearAnimation(self, transitionClass, deferred) {
var element = self.element,
elementClassList = element.classList,
overlay = self._ui.overlay,
animationEndCallback = self._callbacks.animationEnd;
// remove callbacks on animation events
element.removeEventListener("animationend", animationEndCallback, false);
element.removeEventListener("webkitAnimationEnd", animationEndCallback, false);
element.removeEventListener("mozAnimationEnd", animationEndCallback, false);
element.removeEventListener("oAnimationEnd", animationEndCallback, false);
element.removeEventListener("msAnimationEnd", animationEndCallback, false);
// clear classes
transitionClass.split(" ").forEach(function (currentClass) {
currentClass = currentClass.trim();
if (currentClass.length > 0) {
elementClassList.remove(currentClass);
if (overlay) {
overlay.classList.remove(currentClass);
}
}
});
if (deferred.state() === "pending") {
// we resolve only pending (not rejected) deferred
deferred.resolve();
}
}
function setTransitionDeferred(self, resolve) {
var deferred = new UtilDeferred();
deferred.then(function () {
if (deferred === self._callbacks.transitionDeferred) {
resolve();
}
});
self._callbacks.transitionDeferred = deferred;
return deferred;
}
/**
* Animate popup opening/closing
* @method _transition
* @protected
* @param {Object} [options]
* @param {string=} [options.transition]
* @param {string=} [options.ext]
* @param {?Function} [resolve]
* @member ns.widget.core.Popup
*/
prototype._transition = function (options, resolve) {
var self = this,
transition = options.transition || self.options.transition || "none",
transitionClass = transition + options.ext,
element = self.element,
elementClassList = element.classList,
overlayClassList,
deferred,
animationEndCallback;
if (self._ui.overlay) {
overlayClassList = self._ui.overlay.classList;
}
deferred = setTransitionDeferred(self, resolve);
if (transition !== "none") {
// set animationEnd callback
animationEndCallback = clearAnimation.bind(null, self, transitionClass, deferred);
self._callbacks.animationEnd = animationEndCallback;
// add animation callbacks
element.addEventListener("animationend", animationEndCallback, false);
element.addEventListener("webkitAnimationEnd", animationEndCallback, false);
element.addEventListener("mozAnimationEnd", animationEndCallback, false);
element.addEventListener("oAnimationEnd", animationEndCallback, false);
element.addEventListener("msAnimationEnd", animationEndCallback, false);
// add transition classes
transitionClass.split(" ").forEach(function (currentClass) {
currentClass = currentClass.trim();
if (currentClass.length > 0) {
elementClassList.add(currentClass);
if (overlayClassList) {
overlayClassList.add(currentClass);
}
}
});
} else {
if (!ns.getConfig("noAsync", false)) {
window.setTimeout(deferred.resolve, 0);
} else {
deferred.resolve();
}
}
return deferred;
};
/**
* Destroy popup
* @method _destroy
* @protected
* @member ns.widget.core.Popup
*/
prototype._destroy = function () {
var self = this,
element = self.element,
ui = self._ui,
wrapper = ui.wrapper,
child;
if (wrapper) {
// restore all children from wrapper
child = wrapper.firstChild;
while (child) {
element.appendChild(child);
child = wrapper.firstChild;
}
if (wrapper.parentNode) {
wrapper.parentNode.removeChild(wrapper);
}
}
self._unbindEvents(element);
self._setOverlay(element, false);
ui.wrapper = null;
};
Popup.prototype = prototype;
ns.widget.core.Popup = Popup;
engine.defineWidget(
"Popup",
POPUP_SELECTOR,
[
"open",
"close",
"reposition"
],
Popup,
"core"
);
}());
/*global window, define, ns */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Route Popup
* Support class for router to control changing popups.
* @class ns.router.route.popup
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Damian Osipiuk <d.osipiuk@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var
/**
* @property {Object} Popup Alias for {@link ns.widget.Popup}
* @member ns.router.route.popup
* @private
* @static
*/
Popup = ns.widget.core.Popup,
util = ns.util,
routePopup = {
/**
* Object with default options
* @property {Object} defaults
* @property {string} [defaults.transition='none'] Sets the animation used during change
* of popup.
* @property {?HTMLElement} [defaults.container=null] Sets container of element.
* @property {boolean} [defaults.volatileRecord=true] Sets if the current history entry
* will be modified or a new one will be created.
* @member ns.router.route.popup
* @static
*/
defaults: {
transition: "none",
container: null,
volatileRecord: true
},
/**
* Popup Element Selector
* @property {string} filter
* @member ns.router.route.popup
* @static
*/
filter: "." + Popup.classes.popup,
/**
* Storage variable for active popup
* @property {?HTMLElement} activePopup
* @member ns.router.route.popup
* @static
*/
activePopup: null,
/**
* Dictionary for popup related event types
* @property {Object} events
* @property {string} [events.POPUP_HIDE='popuphide']
* @member ns.router.route.popup
* @static
*/
events: {
POPUP_HIDE: "popuphide"
},
/**
* Alias for {@link ns.util.path}
* @property {Object} path
* @member ns.router.route.popup
* @protected
* @static
*/
_path: ns.util.path,
/**
* Alias for {@link ns.router.history}
* @property {Object} history
* @member ns.router.route.popup
* @protected
* @static
*/
_history: ns.history
},
/**
* Alias for {@link ns.engine}
* @property {Object} engine
* @member ns.router.route.popup
* @private
* @static
*/
engine = ns.engine,
/**
* Alias for {@link ns.util.selectors}
* @property {Object} utilSelector
* @member ns.router.route.popup
* @private
* @static
*/
utilSelector = ns.util.selectors,
/**
* Alias for {@link ns.util.DOM}
* @property {Object} DOM
* @member ns.router.route.popup
* @private
* @static
*/
DOM = ns.util.DOM,
/**
* Alias for Object utils
* @method slice
* @member ns.router.route.popup
* @private
* @static
*/
object = ns.util.object,
/**
* Popup's hash added to url
* @property {string} popupHashKey
* @member ns.router.route.popup
* @private
* @static
*/
popupHashKey = "popup=true",
/**
* Regexp for popup's hash
* @property {RegExp} popupHashKeyReg
* @member ns.router.route.popup
* @private
* @static
*/
popupHashKeyReg = /([&|\?]popup=true)/;
/**
* Tries to find a popup element matching id and filter (selector).
* Adds data url attribute to found page, sets page = null when nothing found.
* @method findPopupAndSetDataUrl
* @param {string} id
* @param {string} filter
* @return {HTMLElement}
* @member ns.router.route.popup
* @private
* @static
*/
function findPopupAndSetDataUrl(id, filter) {
var popup,
hashReg = /^#/;
id = id.replace(hashReg, "");
popup = document.getElementById(id);
if (popup && utilSelector.matchesSelector(popup, filter)) {
DOM.setNSData(popup, "url", "#" + id);
} else {
// if we matched any element, but it doesn't match our filter
// reset page to null
popup = null;
}
// probably there is a need for running onHashChange while going back to a history entry
// without state, eg. manually entered #fragment. This may not be a problem on target device
return popup;
}
routePopup.orderNumber = 100;
/**
* This method returns default options for popup router.
* @method option
* @return {Object}
* @member ns.router.route.popup
* @static
*/
routePopup.option = function () {
var defaults = object.merge({}, routePopup.defaults);
defaults.transition = ns.getConfig("popupTransition", defaults.transition);
return defaults;
};
/**
* This method sets active popup and manages history.
* @method setActive
* @param {?ns.widget.core.popup} activePopup
* @param {Object} options
* @member ns.router.route.popup
* @static
*/
routePopup.setActive = function (activePopup, options) {
var url,
pathLocation = routePopup._path.getLocation(),
documentUrl = pathLocation.replace(popupHashKeyReg, "");
this.activePopup = activePopup;
if (activePopup) {
// If popup is being opened, the new state is added to history.
if (options && !options.fromHashChange && options.history) {
url = routePopup._path.addHashSearchParams(documentUrl, popupHashKey);
routePopup._history.replace(options, "", url);
this.active = true;
}
} else if (pathLocation !== documentUrl) {
// If popup is being closed, the history.back() is called
// but only if url has special hash.
// Url is changed after opening animation and in some cases,
// the popup is closed before this animation and then the history.back
// could cause undesirable change of page.
this.active = false;
routePopup._history.back();
}
};
/**
* This method opens popup if no other popup is opened.
* It also changes history to show that popup is opened.
* If there is already active popup, it will be closed.
* @method open
* @param {HTMLElement|string} toPopup
* @param {Object} options
* @param {"page"|"popup"|"external"} [options.rel = 'popup'] Represents kind of link as
* 'page' or 'popup' or 'external' for linking to another domain.
* @param {string} [options.transition = 'none'] Sets the animation used during change of
* popup.
* @param {boolean} [options.reverse = false] Sets the direction of change.
* @param {boolean} [options.fromHashChange = false] Sets if will be changed after hashchange.
* @param {boolean} [options.showLoadMsg = true] Sets if message will be shown during loading.
* @param {number} [options.loadMsgDelay = 0] Sets delay time for the show message during
* loading.
* @param {boolean} [options.dataUrl] Sets if page has url attribute.
* @param {string} [options.container = null] Selector for container.
* @param {boolean} [options.volatileRecord=true] Sets if the current history entry will be
* modified or a new one will be created.
* @param {Event} event
* @member ns.router.route.popup
* @static
*/
routePopup.open = function (toPopup, options, event) {
var self = this,
popup,
router = ns.router.Router.getInstance(),
events = self.events,
removePopup = function () {
document.removeEventListener(events.POPUP_HIDE, removePopup, false);
toPopup.parentNode.removeChild(toPopup);
self.activePopup = null;
},
openPopup = function () {
var positionTo = options["position-to"],
touch;
// add such option only if it exists
if (positionTo) {
options.positionTo = positionTo;
}
if (event) {
touch = event.touches ? event.touches[0] : event;
options.x = touch.clientX;
options.y = touch.clientY;
}
document.removeEventListener(events.POPUP_HIDE, openPopup, false);
popup = engine.instanceWidget(toPopup, "Popup", options);
popup.open(options);
self.activePopup = popup;
self.active = popup.options.history;
},
activePage = router.container.getActivePage(),
container;
if (DOM.getNSData(toPopup, "external") === true) {
container = options.container ?
activePage.element.querySelector(options.container) : activePage.element;
if (toPopup.parentNode !== container) {
toPopup = util.importEvaluateAndAppendElement(toPopup, container);
}
document.addEventListener(routePopup.events.POPUP_HIDE, removePopup, false);
}
if (self.hasActive()) {
document.addEventListener(events.POPUP_HIDE, openPopup, false);
if (!self.close()) {
openPopup();
}
} else {
openPopup();
}
};
/**
* This method closes active popup.
* @method close
* @param {ns.widget.core.Popup} [activePopup]
* @param {Object} options
* @param {string} [options.transition]
* @param {string} [options.ext= in ui-pre-in] options.ext
* @member ns.router.route.popup
* @protected
* @static
*/
routePopup.close = function (activePopup, options) {
var popupOptions,
pathLocation = routePopup._path.getLocation(),
documentUrl = pathLocation.replace(popupHashKeyReg, "");
options = options || {};
if (activePopup && !(activePopup instanceof Popup)) {
activePopup = engine.instanceWidget(activePopup, "Popup", options);
}
activePopup = activePopup || this.activePopup;
// if popup is active
if (activePopup) {
popupOptions = activePopup.options;
// we check if it changed the history
if (popupOptions.history && pathLocation !== documentUrl) {
// and then set new options for popup
popupOptions.transition = options.transition || popupOptions.transition;
popupOptions.ext = options.ext || popupOptions.ext;
// unlock the router if it was locked
if (!popupOptions.dismissible) {
ns.router.Router.getInstance().unlock();
}
// and call history.back()
routePopup._history.back();
} else {
// if popup did not change the history, we close it normally
activePopup.close(options);
}
return true;
}
return false;
};
/**
* This method handles hash change.
* It closes opened popup.
* @method onHashChange
* @param {string} url
* @param {Object} options
* @return {boolean}
* @member ns.router.route.popup
* @static
*/
routePopup.onHashChange = function (url, options) {
var activePopup = this.activePopup;
if (activePopup) {
activePopup.close(options);
// Default routing setting cause to rewrite further window history
// even if popup has been closed
// To prevent this onHashChange after closing popup we need to change
// disable volatile mode to allow pushing new history elements
if (this.active) {
this.active = false;
return true;
}
}
return false;
};
/**
* On open fail, currently never used
* @method onOpenFailed
* @member ns.router.route.popup
* @return {null}
* @static
*/
routePopup.onOpenFailed = function (/* options */) {
return null;
};
/**
* This method finds popup by data-url.
* @method find
* @param {string} absUrl Absolute path to opened popup
* @return {HTMLElement} Element of popup
* @member ns.router.route.popup
*/
routePopup.find = function (absUrl) {
var self = this,
dataUrl = self._createDataUrl(absUrl),
activePage = ns.router.Router.getInstance().getContainer().getActivePage(),
popup;
popup = activePage.element.querySelector("[data-url='" + dataUrl + "']" + self.filter);
if (!popup && dataUrl && !routePopup._path.isPath(dataUrl)) {
popup = findPopupAndSetDataUrl(dataUrl, self.filter);
}
return popup;
};
/**
* This method parses HTML and runs scripts from parsed code.
* Fetched external scripts if required.
* @method parse
* @param {string} html HTML code to parse
* @param {string} absUrl Absolute url for parsed popup
* @return {HTMLElement}
* @member ns.router.route.popup
*/
routePopup.parse = function (html, absUrl) {
var self = this,
popup,
dataUrl = self._createDataUrl(absUrl);
popup = html.querySelector(self.filter);
if (popup) {
// TODO tagging a popup with external to make sure that embedded popups aren't
// removed by the various popup handling code is bad. Having popup handling code
// in many places is bad. Solutions post 1.0
DOM.setNSData(popup, "url", dataUrl);
DOM.setNSData(popup, "external", true);
}
return popup;
};
/**
* Convert url to data-url
* @method _createDataUrl
* @param {string} absoluteUrl
* @return {string}
* @member ns.router.route.popup
* @protected
* @static
*/
routePopup._createDataUrl = function (absoluteUrl) {
return routePopup._path.convertUrlToDataUrl(absoluteUrl);
};
/**
* Return true if active popup exists.
* @method hasActive
* @return {boolean}
* @member ns.router.route.popup
* @static
*/
routePopup.hasActive = function () {
return this.active;
};
/**
* Returns active popup.
* @method getActive
* @return {?ns.widget.core.Popup}
* @member ns.router.route.popup
* @static
*/
routePopup.getActive = function () {
return this.activePopup;
};
/**
* Returns element of active popup.
* @method getActiveElement
* @return {HTMLElement}
* @member ns.router.route.popup
* @static
*/
routePopup.getActiveElement = function () {
var active = this.getActive();
return active && active.element;
};
ns.router.route.popup = routePopup;
}(window, window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global window, define, ns, CustomEvent */
/*
* @class ns.event.gesture
*/
(function (ns) {
"use strict";
var event = ns.event,
gesture = function (elem, options) {
return new ns.event.gesture.Instance(elem, options);
};
/**
* Default values for Gesture feature
* @property {Object} defaults
* @property {boolean} [defaults.triggerEvent=false]
* @property {number} [defaults.updateVelocityInterval=16]
* Interval in which Gesture recalculates current velocity in ms
* @property {number} [defaults.estimatedPointerTimeDifference=15]
* pause time threshold.. tune the number to up if it is slow
* @member ns.event.gesture
* @static
*/
gesture.defaults = {
triggerEvent: false,
updateVelocityInterval: 16,
estimatedPointerTimeDifference: 15
};
/**
* Dictionary of orientation
* @property {Object} Orientation
* @property {1} Orientation.VERTICAL vertical orientation
* @property {2} Orientation.HORIZONTAL horizontal orientation
* @member ns.event.gesture
* @static
*/
gesture.Orientation = {
VERTICAL: "vertical",
HORIZONTAL: "horizontal"
};
/**
* Dictionary of direction
* @property {Object} Direction
* @property {1} Direction.UP up
* @property {2} Direction.DOWN down
* @property {3} Direction.LEFT left
* @property {4} Direction.RIGHT right
* @member ns.event.gesture
* @static
*/
gesture.Direction = {
UP: "up",
DOWN: "down",
LEFT: "left",
RIGHT: "right"
};
/**
* Dictionary of gesture events state
* @property {Object} Event
* @property {"start"} Event.START start
* @property {"move"} Event.MOVE move
* @property {"end"} Event.END end
* @property {"cancel"} Event.CANCEL cancel
* @property {"blocked"} Event.BLOCKED blocked
* @member ns.event.gesture
* @static
*/
gesture.Event = {
START: "start",
MOVE: "move",
END: "end",
CANCEL: "cancel",
BLOCKED: "blocked"
};
/**
* Dictionary of gesture events flags
* @property {Object} Result
* @property {number} [Result.PENDING=1] is pending
* @property {number} [Result.RUNNING=2] is running
* @property {number} [Result.FINISHED=4] is finished
* @property {number} [Result.BLOCK=8] is blocked
* @member ns.event.gesture
* @static
*/
gesture.Result = {
PENDING: 1,
RUNNING: 2,
FINISHED: 4,
BLOCK: 8
};
/**
* Create plugin namespace.
* @property {Object} plugin
* @member ns.event.gesture
* @static
*/
gesture.plugin = {};
/**
* Create object of Detector
* @method createDetector
* @param {string} gesture
* @param {HTMLElement} eventSender
* @param {Object} options
* @return {ns.event.gesture.Gesture}
* @member ns.event.gesture
* @static
*/
gesture.createDetector = function (gesture, eventSender, options) {
if (!gesture.plugin[gesture]) {
throw gesture + " gesture is not supported";
}
return new gesture.plugin[gesture](eventSender, options);
};
event.gesture = gesture;
}(ns));
/*global window, ns, define, ns */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Drawer Widget
* Core Drawer widget is a base for creating Drawer widgets for profiles. It
* provides drawer functionality - container with ability to open and close with
* an animation.
*
* ### Positioning Drawer left / right (option)
* To change position of a Drawer please set data-position attribute of Drawer
* element to:
*
* - left (left position, default)
* - right (right position)
*
* ##Opening / Closing Drawer
* To open / close Drawer one can use open() and close() methods.
*
* ##Checking if Drawer is opened.
* To check if Drawer is opened use widget`s isOpen() method.
*
* ##Creating widget
* Core drawer is a base class - examples of creating widgets are described in
* documentation of profiles
*
* @class ns.widget.core.Drawer
* @extends ns.widget.BaseWidget
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (document, ns) {
"use strict";
/**
* @property {Object} Widget Alias for {@link ns.widget.BaseWidget}
* @member ns.widget.core.Drawer
* @private
* @static
*/
var BaseWidget = ns.widget.BaseWidget,
/**
* @property {Object} selectors Alias for class ns.util.selectors
* @member ns.widget.core.Drawer
* @private
* @static
* @readonly
*/
selectors = ns.util.selectors,
utilDOM = ns.util.DOM,
events = ns.event,
history = ns.history,
Gesture = ns.event.gesture,
Page = ns.widget.core.Page,
STATE = {
CLOSED: "closed",
OPENED: "opened",
SLIDING: "sliding",
SETTLING: "settling"
},
/**
* Events
* @event draweropen Event triggered then the drawer is opened.
* @event drawerclose Event triggered then the drawer is closed.
* @member ns.widget.core.Drawer
*/
CUSTOM_EVENTS = {
OPEN: "draweropen",
CLOSE: "drawerclose"
},
/**
* Default values
*/
DEFAULT = {
WIDTH: 240,
DURATION: 300,
POSITION: "left"
},
/**
* Drawer constructor
* @method Drawer
*/
Drawer = function () {
var self = this;
/**
* Drawer field containing options
* @property {string} options.position Position of Drawer ("left" or "right")
* @property {number} options.width Width of Drawer
* @property {number} options.duration Duration of Drawer entrance animation
* @property {boolean} options.closeOnClick If true Drawer will be closed on overlay
* @property {boolean} options.overlay Sets whether to show an overlay when Drawer is open.
* @property {string} options.drawerTarget Set drawer target element as the css selector
* @property {boolean} options.enable Enable drawer component
* @property {number} options.dragEdge Set the area that can open the drawer as drag gesture in drawer target element
* @member ns.widget.core.Drawer
*/
self.options = {
position: DEFAULT.POSITION,
width: DEFAULT.WIDTH,
duration: DEFAULT.DURATION,
closeOnClick: true,
overlay: true,
drawerTarget: "." + Page.classes.uiPage,
enable: true,
dragEdge: 1
};
self._pageSelector = null;
self._isDrag = false;
self._state = STATE.CLOSED;
self._settlingType = STATE.CLOSED;
self._translatedX = 0;
self._ui = {};
self._eventBoundElement = null;
self._drawerOverlay = null;
},
/**
* Dictionary object containing commonly used widget classes
* @property {Object} classes
* @member ns.widget.core.Drawer
* @private
* @static
* @readonly
*/
classes = {
page: Page.classes.uiPage,
drawer: "ui-drawer",
left: "ui-drawer-left",
right: "ui-drawer-right",
overlay: "ui-drawer-overlay",
open: "ui-drawer-open",
close: "ui-drawer-close"
},
/**
* {Object} Drawer widget prototype
* @member ns.widget.core.Drawer
* @private
* @static
*/
prototype = new BaseWidget();
Drawer.prototype = prototype;
Drawer.classes = classes;
/**
* Unbind drag events
* @method unbindDragEvents
* @param {Object} self
* @param {HTMLElement} element
* @member ns.widget.core.Drawer
* @private
* @static
*/
function unbindDragEvents(self, element) {
var overlayElement = self._ui.drawerOverlay;
events.disableGesture(element);
events.off(element, "drag dragstart dragend dragcancel swipe swipeleft swiperight vmouseup", self, false);
events.prefixedFastOff(self.element, "transitionEnd", self, false);
events.off(window, "resize", self, false);
if (overlayElement) {
events.off(overlayElement, "vclick", self, false);
}
}
/**
* Bind drag events
* @method bindDragEvents
* @param {Object} self
* @param {HTMLElement} element
* @member ns.widget.core.Drawer
* @private
* @static
*/
function bindDragEvents(self, element) {
var overlayElement = self._ui.drawerOverlay;
self._eventBoundElement = element;
events.enableGesture(
element,
new Gesture.Drag(),
new Gesture.Swipe({
orientation: Gesture.Orientation.HORIZONTAL
})
);
events.on(element, "drag dragstart dragend dragcancel swipe swipeleft swiperight vmouseup", self, false);
events.prefixedFastOn(self.element, "transitionEnd", self, false);
events.on(window, "resize", self, false);
if (overlayElement) {
events.on(overlayElement, "vclick", self, false);
}
}
/**
* Handle events
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.Drawer
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "drag":
self._onDrag(event);
break;
case "dragstart":
self._onDragStart(event);
break;
case "dragend":
self._onDragEnd(event);
break;
case "dragcancel":
self._onDragCancel(event);
break;
case "vmouseup":
self._onMouseup(event);
break;
case "swipe":
case "swipeleft":
case "swiperight":
self._onSwipe(event);
break;
case "vclick":
self._onClick(event);
break;
case "transitionend":
case "webkitTransitionEnd":
case "mozTransitionEnd":
case "oTransitionEnd":
case "msTransitionEnd":
self._onTransitionEnd(event);
break;
case "resize":
self._onResize(event);
break;
}
};
/**
* MouseUp event handler
* @method _onMouseup
* @member ns.widget.core.Drawer
* @protected
*/
prototype._onMouseup = function () {
var self = this;
if (self._state === STATE.SLIDING) {
self.close();
}
};
/**
* Click event handler
* @method _onClick
* @member ns.widget.core.Drawer
* @protected
*/
prototype._onClick = function () {
var self = this;
if (self._state === STATE.OPENED) {
self.close();
}
};
/**
* Resize event handler
* @method _onResize
* @member ns.widget.core.Drawer
* @protected
*/
prototype._onResize = function () {
var self = this;
// resize event handler
self._refresh();
};
/**
* webkitTransitionEnd event handler
* @method _onTransitionEnd
* @member ns.widget.core.Drawer
* @protected
*/
prototype._onTransitionEnd = function () {
var self = this,
position = self.options.position,
drawerOverlay = self._drawerOverlay;
if (self._state === STATE.SETTLING) {
if (self._settlingType === STATE.OPENED) {
self.trigger(CUSTOM_EVENTS.OPEN, {
position: position
});
self._setActive(true);
self._state = STATE.OPENED;
} else {
self.close();
self.trigger(CUSTOM_EVENTS.CLOSE, {
position: position
});
self._setActive(false);
self._state = STATE.CLOSED;
if (drawerOverlay) {
drawerOverlay.style.visibility = "hidden";
}
}
}
};
/**
* Swipe event handler
* @method _onSwipe
* @protected
* @param {Event} event
* @member ns.widget.core.Drawer
*/
prototype._onSwipe = function (event) {
var self = this,
direction,
options = self.options;
// Now mobile has two swipe event
if (event.detail) {
direction = event.detail.direction === "left" ? "right" : "left";
} else if (event.type === "swiperight") {
direction = "left";
} else if (event.type === "swipeleft") {
direction = "right";
}
if (options.enable && self._isDrag && options.position === direction) {
self.open();
self._isDrag = false;
}
};
/**
* Dragstart event handler
* @method _onDragStart
* @protected
* @param {Event} event
* @member ns.widget.core.Drawer
*/
prototype._onDragStart = function (event) {
var self = this;
if (self._state === STATE.OPENED) {
return;
}
if (self.options.enable && !self._isDrag && self._state !== STATE.SETTLING && self._checkSideEdge(event)) {
self._isDrag = true;
} else {
self.close();
}
};
/**
* Drag event handler
* @method _onDrag
* @protected
* @param {Event} event
* @member ns.widget.core.Drawer
*/
prototype._onDrag = function (event) {
var self = this,
deltaX = event.detail.deltaX,
options = self.options,
translatedX = self._translatedX,
movedX;
if (options.enable && self._isDrag && self._state !== STATE.SETTLING) {
if (options.position === "left") {
movedX = -options.width + deltaX + translatedX;
if (movedX < 0) {
self._translate(movedX, 0);
}
} else {
movedX = window.innerWidth + deltaX - translatedX;
if (movedX > 0 && movedX > window.innerWidth - options.width) {
self._translate(movedX, 0);
}
}
}
};
/**
* DragEnd event handler
* @method _onDragEnd
* @protected
* @param {Event} event
* @member ns.widget.core.Drawer
*/
prototype._onDragEnd = function (event) {
var self = this,
options = self.options,
detail = event.detail;
if (options.enable && self._isDrag) {
if (Math.abs(detail.deltaX) > options.width / 2) {
self.open();
} else if (self._state !== STATE.SETTLING) {
self.close();
}
}
self._isDrag = false;
};
/**
* DragCancel event handler
* @method _onDragCancel
* @protected
* @member ns.widget.core.Drawer
*/
prototype._onDragCancel = function () {
var self = this;
if (self.options.enable && self._isDrag) {
self.close();
}
self._isDrag = false;
};
/**
* Drawer translate function
* @method _translate
* @param {number} x
* @param {number} duration
* @member ns.widget.core.Drawer
* @protected
*/
prototype._translate = function (x, duration) {
var self = this,
element = self.element;
if (self._state !== STATE.SETTLING) {
self._state = STATE.SLIDING;
}
if (duration) {
utilDOM.setPrefixedStyle(element, "transition", utilDOM.getPrefixedValue("transform " + duration / 1000 + "s ease-out"));
}
// there should be a helper for this :(
utilDOM.setPrefixedStyle(element, "transform", "translate3d(" + x + "px, 0px, 0px)");
if (self.options.overlay) {
self._setOverlay(x);
}
if (!duration) {
self._onTransitionEnd();
}
};
/**
* Set overlay opacity and visibility
* @method _setOverlay
* @param {number} x
* @member ns.widget.core.Drawer
* @protected
*/
prototype._setOverlay = function (x) {
var self = this,
options = self.options,
overlay = self._ui.drawerOverlay,
overlayStyle = overlay.style,
absX = Math.abs(x),
ratio = options.position === "right" ? absX / window.innerWidth : absX / options.width;
if (ratio < 1) {
overlayStyle.visibility = "visible";
} else {
overlayStyle.visibility = "hidden";
}
overlayStyle.opacity = 1 - ratio;
};
/**
* Set active status in drawer router
* @method _setActive
* @param {boolean} active
* @member ns.widget.core.Drawer
* @protected
*/
prototype._setActive = function (active) {
var self = this,
route = ns.router.getInstance().getRoute("drawer");
if (active) {
route.setActive(self);
} else {
route.setActive(null);
}
};
/**
* Build structure of Drawer widget
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement} Returns built element
* @member ns.widget.core.Drawer
* @protected
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
options = self.options,
targetElement;
element.classList.add(classes.drawer);
element.style.top = 0;
targetElement = selectors.getClosestBySelector(element, options.drawerTarget);
if (targetElement) {
targetElement.appendChild(element);
targetElement.style.overflowX = "hidden";
}
if (self.options.overlay) {
ui.drawerOverlay = self._createOverlay(element);
ui.drawerOverlay.style.visibility = "hidden";
}
if (!ui.placeholder) {
ui.placeholder = document.createComment(element.id + "-placeholder");
element.parentNode.insertBefore(ui.placeholder, element);
}
ui.targetElement = targetElement;
return element;
};
/**
* Initialization of Drawer widget
* @method _init
* @param {HTMLElement} element
* @member ns.widget.core.Drawer
* @protected
*/
prototype._init = function (element) {
var self = this,
ui = self._ui;
ui.drawerPage = selectors.getClosestByClass(element, classes.page);
ui.drawerPage.style.overflowX = "hidden";
self._initLayout();
return element;
};
/**
* init Drawer widget layout
* @method _initLayout
* @protected
* @member ns.widget.core.Drawer
*/
prototype._initLayout = function () {
var self = this,
options = self.options,
element = self.element,
elementStyle = element.style,
ui = self._ui,
overlayStyle = ui.drawerOverlay ? ui.drawerOverlay.style : null,
height;
options.width = options.width || ui.targetElement.offsetWidth;
height = ui.targetElement.offsetHeight;
elementStyle.width = (options.width !== 0) ? options.width + "px" : "100%";
elementStyle.height = (height !== 0) ? height + "px" : "100%";
elementStyle.top = "0";
if (overlayStyle) {
overlayStyle.width = window.innerWidth + "px";
overlayStyle.height = window.innerHeight + "px";
overlayStyle.top = 0;
}
if (options.position === "right") {
element.classList.add(classes.right);
self._translate(window.innerWidth, 0);
} else {
// left or default
element.classList.add(classes.left);
self._translate(-options.width, 0);
}
self._state = STATE.CLOSED;
};
/**
* Provides translation if position is set to right
* @method _translateRight
* @member ns.widget.core.Drawer
* @protected
*/
prototype._translateRight = function () {
var self = this,
options = self.options;
if (options.position === "right") {
// If drawer position is right, drawer should be moved right side
if (self._state === STATE.OPENED) {
// drawer opened
self._translate(window.innerWidth - options.width, 0);
} else {
// drawer closed
self._translate(window.innerWidth, 0);
}
}
};
/**
* Check dragstart event whether triggered on side edge area or not
* @method _checkSideEdge
* @protected
* @param {Event} event
* @member ns.widget.core.Drawer
*/
prototype._checkSideEdge = function (event) {
var self = this,
detail = event.detail,
eventClientX = detail.pointer.clientX - detail.estimatedDeltaX,
options = self.options,
position = options.position,
boundElement = self._eventBoundElement,
boundElementOffsetWidth = boundElement.offsetWidth,
boundElementRightEdge = boundElement.offsetLeft + boundElementOffsetWidth,
dragStartArea = boundElementOffsetWidth * options.dragEdge;
return ((position === "left" && eventClientX > 0 && eventClientX < dragStartArea) ||
(position === "right" && eventClientX > boundElementRightEdge - dragStartArea &&
eventClientX < boundElementRightEdge));
};
/**
* Refreshes Drawer widget
* @method _refresh
* @member ns.widget.core.Drawer
* @protected
*/
prototype._refresh = function () {
// Drawer layout has been set by parent element layout
var self = this;
self._translateRight();
self._initLayout();
};
/**
* Creates Drawer overlay element
* @method _createOverlay
* @param {HTMLElement} element
* @member ns.widget.core.Drawer
* @protected
*/
prototype._createOverlay = function (element) {
var overlayElement = document.createElement("div");
overlayElement.classList.add(classes.overlay);
element.parentNode.insertBefore(overlayElement, element);
return overlayElement;
};
/**
* Binds events to a Drawer widget
* @method _bindEvents
* @member ns.widget.core.Drawer
* @protected
*/
prototype._bindEvents = function () {
var self = this,
targetElement = self._ui.targetElement;
bindDragEvents(self, targetElement);
};
/**
* Enable Drawer widget
* @method _enable
* @protected
* @member ns.widget.core.Drawer
*/
prototype._enable = function () {
this._oneOption("enable", true);
};
/**
* Disable Drawer widget
* @method _disable
* @protected
* @member ns.widget.core.Drawer
*/
prototype._disable = function () {
this._oneOption("enable", false);
};
/**
* Checks Drawer status
* @method isOpen
* @member ns.widget.core.Drawer
* @return {boolean} Returns true if Drawer is open
*/
prototype.isOpen = function () {
return (this._state === STATE.OPENED);
};
/**
* Opens Drawer widget
* @method open
* @param {number} [duration] Duration for opening, if is not set then method take value from options
* @member ns.widget.core.Drawer
*/
prototype.open = function (duration) {
var self = this,
options = self.options,
drawerClassList = self.element.classList,
drawerOverlay = self._ui.drawerOverlay;
if (self._state !== STATE.OPENED) {
self._state = STATE.SETTLING;
self._settlingType = STATE.OPENED;
duration = duration !== undefined ? duration : options.duration;
if (drawerOverlay) {
drawerOverlay.style.visibility = "visible";
}
drawerClassList.remove(classes.close);
drawerClassList.add(classes.open);
if (options.position === "left") {
self._translate(0, duration);
} else {
self._translate(window.innerWidth - options.width, duration);
}
}
};
/**
* Closes Drawer widget
* @requires mobile wearable
*
*
* @method close
* @param {Object} options This value is router options whether reverse or not.
* @param {number} [duration] Duration for closing, if is not set then method take value from options
* @member ns.widget.core.Drawer
*/
prototype.close = function (options, duration) {
var self = this,
reverse = options ? options.reverse : false,
selfOptions = self.options,
drawerClassList = self.element.classList;
if (self._state !== STATE.CLOSED) {
if (!reverse && self._state === STATE.OPENED && !ns.getConfig("disableRouter")) {
// This method was fired by JS code or this widget.
history.back();
return;
}
self._state = STATE.SETTLING;
self._settlingType = STATE.CLOSED;
duration = duration !== undefined ? duration : selfOptions.duration;
drawerClassList.remove(classes.open);
drawerClassList.add(classes.close);
if (selfOptions.position === "left") {
self._translate(-selfOptions.width, duration);
} else {
self._translate(window.innerWidth, duration);
}
}
};
/**
* Set Drawer drag handler.
* If developer use handler, drag event is bound at handler only.
* @method setDragHandler
* @param {HTMLElement} element
* @member ns.widget.core.Drawer
*/
prototype.setDragHandler = function (element) {
var self = this;
self.options.dragEdge = 1;
unbindDragEvents(self, self._eventBoundElement);
bindDragEvents(self, element);
};
/**
* Transition Drawer widget.
* This method use only positive integer number.
* @method transition
* @param {number} position
* @member ns.widget.core.Drawer
*/
prototype.transition = function (position) {
var self = this,
options = self.options;
if (options.position === "left") {
self._translate(-options.width + position, options.duration);
} else {
self._translate(options.width - position, options.duration);
}
self._translatedX = position;
};
/**
* Get state of Drawer widget.
*/
prototype.getState = function () {
return this._state;
};
/**
* Destroys Drawer widget
* @method _destroy
* @member ns.widget.core.Drawer
* @protected
*/
prototype._destroy = function () {
var self = this,
ui = self._ui,
drawerOverlay = ui.drawerOverlay,
placeholder = ui.placeholder,
placeholderParent = placeholder.parentNode,
element = self.element;
placeholderParent.insertBefore(element, placeholder);
placeholderParent.removeChild(placeholder);
if (drawerOverlay) {
drawerOverlay.removeEventListener("vclick", self._onClickBound, false);
}
unbindDragEvents(self, self._eventBoundElement);
};
ns.widget.core.Drawer = Drawer;
}(window.document, ns));
/*global window, ns, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Route Drawer
* Support class for router to control drawer widget in profile Wearable.
* @class ns.router.route.drawer
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function () {
"use strict";
var CoreDrawer = ns.widget.core.Drawer,
Router = ns.router.Router,
path = ns.util.path,
history = ns.history,
engine = ns.engine,
routeDrawer = {},
drawerHashKey = "drawer=true",
drawerHashKeyReg = /([&|\?]drawer=true)/;
routeDrawer.orderNumber = 1000;
/**
* Property containing default properties
* @property {Object} defaults
* @property {string} defaults.transition="none"
* @static
* @member ns.router.route.drawer
*/
routeDrawer.defaults = {
transition: "none"
};
/**
* Property defining selector for filtering only drawer elements
* @property {string} filter
* @member ns.router.route.drawer
* @static
*/
routeDrawer.filter = "." + CoreDrawer.classes.drawer;
/**
* Returns default route options used inside Router.
* But, drawer router has not options.
* @method option
* @static
* @member ns.router.route.drawer
* @return {null}
*/
routeDrawer.option = function () {
return null;
};
/**
* This method opens the drawer.
* @method open
* @param {HTMLElement} drawerElement
* @member ns.router.route.drawer
*/
routeDrawer.open = function (drawerElement) {
var drawer = engine.instanceWidget(drawerElement, "Drawer");
drawer.open();
};
/**
* This method determines target drawer to open.
* @method find
* @param {string} absUrl Absolute path to opened drawer widget
* @member ns.router.route.drawer
* @return {?HTMLElement} drawerElement
*/
routeDrawer.find = function (absUrl) {
var dataUrl = path.convertUrlToDataUrl(absUrl),
activePage = Router.getInstance().getContainer().getActivePage(),
drawer;
drawer = activePage.element.querySelector("#" + dataUrl);
return drawer;
};
/**
* This method parses HTML and runs scripts from parsed code.
* But, drawer router doesn't need to that.
* @method parse
* @member ns.router.route.drawer
*/
routeDrawer.parse = function () {
return null;
};
/**
* This method sets active drawer and manages history.
* @method setActive
* @param {Object} activeDrawer
* @member ns.router.route.drawer
* @static
*/
routeDrawer.setActive = function (activeDrawer) {
var url,
pathLocation = path.getLocation(),
documentUrl = pathLocation.replace(drawerHashKeyReg, "");
this._activeDrawer = activeDrawer;
if (activeDrawer) {
url = path.addHashSearchParams(documentUrl, drawerHashKey);
history.replace({}, "", url);
this.active = true;
} else if (pathLocation !== documentUrl) {
history.back();
}
};
/**
* This method handles hash change.
* @method onHashChange
* @param {string} url
* @param {Object} options
* @param {string} prev Previous url string
* @static
* @member ns.router.route.drawer
* @return {null}
*/
routeDrawer.onHashChange = function (url, options, prev) {
var self = this,
activeDrawer = self._activeDrawer,
stateUrl = prev.stateUrl;
if (activeDrawer && stateUrl.search(drawerHashKey) > 0 && url.search(drawerHashKey) < 0) {
activeDrawer.close(options);
this.active = false;
return true;
}
return false;
};
ns.router.route.drawer = routeDrawer;
}());
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Anchor Highlight Utility
*
* Utility enables highlight on clickable components.
* @class ns.util.anchorHighlight
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Damian Osipiuk <d.osipiuk@samsung.com>
* @author Konrad Lipner <k.lipner@samsung.com>
*/
(function (document, window, ns) {
"use strict";
/* anchorHighlightController.js
To prevent performance regression when scrolling,
do not apply hover class in anchor.
Instead, this code checks scrolling for time threshold and
decide how to handle the color.
When scrolling with anchor, it checks flag and decide to highlight anchor.
While it helps to improve scroll performance,
it lowers responsiveness of the element for 50msec.
*/
/**
* Touch start x
* @property {number} startX
* @member ns.util.anchorHighlight
* @private
* @static
*/
var startX = 0,
/**
* Touch start y
* @property {number} startY
* @member ns.util.anchorHighlight
* @private
* @static
*/
startY = 0,
/**
* Touch target element
* @property {HTMLElement} target
* @member ns.util.anchorHighlight
* @private
* @static
*/
classes = {
/**
* Class used to mark element as active
* @property {string} [classes.ACTIVE_LI="ui-li-active"]
* @member ns.util.anchorHighlight
* @private
* @static
*/
ACTIVE_LI: "ui-li-active",
/**
* Class used to mark button as active
* @property {string} [classes.ACTIVE_BTN="ui-btn-active"]
* @member ns.util.anchorHighlight
* @private
* @static
*/
ACTIVE_BTN: "ui-btn-active",
/**
* Class used to mark button as inactive
* @property {string} [classes.INACTIVE_BTN="ui-btn-inactive"]
* @member ns.util.anchorHighlight
* @private
* @static
*/
INACTIVE_BTN: "ui-btn-inactive",
/**
* Class used to select button
* @property {string} [classes.BUTTON="ui-btn"] btn
* @member ns.util.anchorHighlight
* @private
* @static
*/
BUTTON: "ui-btn",
/**
* Class used to select button in header (old notation)
* @property {string} [classes.HEADER_BUTTON="ui-header-btn"] btn
* @member ns.util.anchorHighlight
* @private
* @static
*/
HEADER_BUTTON: "ui-header-btn",
/**
* Class used to select anchor in tabbar widget
* @property {string} [classes.TABBAR_ANCHOR="ui-tabbar-anchor"] anchor
* @member ns.util.anchorHighlight
* @private
* @static
*/
TABBAR_ANCHOR: "ui-tabbar-anchor",
/**
* Class used to select navigation item
* @property {string} [classes.NAVIGATION_BUTTON="ui-navigation-item"] btn
* @member ns.util.anchorHighlight
* @private
* @static
*/
NAVIGATION_BUTTON: "ui-navigation-item"
},
events = {
ACTIVE_LI: "anchorhighlightactiveli"
},
/**
* Alias for class {@link ns.util.selectors}
* @property {Object} selectors
* @member ns.util.anchorHighlight
* @private
* @static
*/
selectors = ns.util.selectors,
/**
* Alias for class {@link ns.event}
* @property {Object} event
* @member ns.util.anchorHighlight
* @private
* @static
*/
eventUtil = ns.event,
// cache function
abs = Math.abs,
/**
* Get closest li element
* @method detectLiElement
* @param {HTMLElement} target
* @return {HTMLElement}
* @member ns.util.anchorHighlight
* @private
* @static
*/
detectLiElement = function (target) {
return selectors.getClosestByTag(target, "li");
},
anchorHighlight = {
/**
* Object with default options
* @property {Object} options
* Threshold after which didScroll will be set
* @property {number} [options.scrollThreshold=10]
* Time to wait before adding activeClass
* @property {number} [options.addActiveClassDelay=50]
* Time to stay activeClass after touch end
* @property {number} [options.keepActiveClassDelay=100]
* @member ns.util.anchorHighlight
* @private
* @static
*/
options: {
scrollThreshold: 10,
addActiveClassDelay: 50,
keepActiveClassDelay: 100
},
_startTime: 0,
_startRemoveTime: 0,
// inform that touch was ended
_touchEnd: false,
_liTarget: null,
/**
* Touch button target element
* @property {HTMLElement} buttonTarget
* @member ns.util.anchorHighlight
* @private
* @static
*/
_target: null,
/**
* Did page scrolled
* @property {boolean} didScroll
* @member ns.util.anchorHighlight
* @private
* @static
*/
_didScroll: false,
_buttonTarget: null,
// inform that animation of button's activation was ended
_activeAnimationFinished: false,
//cache function
_requestAnimationFrame: ns.util.windowRequestAnimationFrame
},
// cache function
slice = Array.prototype.slice;
/**
* Get closest highlightable element
* @method detectHighlightTarget
* @param {HTMLElement} target
* @return {HTMLElement}
* @member ns.util.anchorHighlight
* @private
* @static
*/
function detectHighlightTarget(target) {
return selectors.getClosestBySelector(target, "a, label");
}
/**
* Get closest button element
* @method detectLiElement
* @param {HTMLElement} target
* @return {HTMLElement}
* @member ns.util.anchorHighlight
* @private
* @static
*/
function detectBtnElement(target) {
return selectors.getClosestByClass(target, classes.BUTTON) ||
selectors.getClosestByClass(target, classes.HEADER_BUTTON) ||
selectors.getClosestByClass(target, classes.NAVIGATION_BUTTON) ||
selectors.getClosestByClass(target, classes.TABBAR_ANCHOR);
}
/**
* Clear active class on button
* @method clearBtnActiveClass
* @param {Event} event
* @member ns.util.anchorHighlight
* @private
* @static
*/
function clearBtnActiveClass(event) {
var target = event.target,
classList = target.classList;
// if this is callback of activate animation and
if (classList.contains(classes.ACTIVE_BTN) && !classList.contains(classes.INACTIVE_BTN)) {
// set that animation was ended (used in touch end)
anchorHighlight._activeAnimationFinished = true;
// if touch end previously
if (anchorHighlight._touchEnd || target !== anchorHighlight._buttonTarget) {
// start inactivate animation
classList.add(classes.INACTIVE_BTN);
}
} else {
//when target of animationend event is child of active element instead of active element
// itself
if (!classList.contains(classes.ACTIVE_BTN) &&
!classList.contains(classes.INACTIVE_BTN)) {
target.parentNode.classList.remove(classes.ACTIVE_BTN);
target.parentNode.classList.remove(classes.INACTIVE_BTN);
}
// this is callback for inactive animation end
classList.remove(classes.INACTIVE_BTN);
classList.remove(classes.ACTIVE_BTN);
}
}
/**
* Add inactive class on touch end
* @method addButtonInactiveClass
* @member ns.util.anchorHighlight
* @private
* @static
*/
function addButtonInactiveClass() {
if (anchorHighlight._buttonTarget) {
anchorHighlight._buttonTarget.classList.add(classes.INACTIVE_BTN);
}
}
/**
* Add active class on touch end
* @method addButtonActiveClass
* @member ns.util.anchorHighlight
* @private
* @static
*/
function addButtonActiveClass() {
anchorHighlight._buttonTarget.classList.add(classes.ACTIVE_BTN);
anchorHighlight._activeAnimationFinished = false;
}
/**
* Clear classes on page or popup hide
* @method hideClear
* @member ns.util.anchorHighlight
* @private
* @static
*/
function hideClear() {
var btnTarget = anchorHighlight._buttonTarget;
if (btnTarget) {
btnTarget.classList.remove(classes.ACTIVE_BTN);
btnTarget.classList.remove(classes.INACTIVE_BTN);
}
if (anchorHighlight._target) {
anchorHighlight._target.classList.remove(classes.ACTIVE_LI);
}
}
/**
* Add active class to touched element
* @method addActiveClass
* @member ns.util.anchorHighlight
* @private
* @static
*/
function addActiveClass() {
var btnTargetClassList,
dTime;
if (anchorHighlight._startTime) {
dTime = Date.now() - anchorHighlight._startTime;
if (dTime > anchorHighlight.options.addActiveClassDelay) {
anchorHighlight._startTime = 0;
anchorHighlight._buttonTarget = detectBtnElement(anchorHighlight._target);
anchorHighlight._target = detectHighlightTarget(anchorHighlight._target);
if (!anchorHighlight._didScroll) {
anchorHighlight._liTarget = anchorHighlight._detectLiElement(anchorHighlight._target);
if (anchorHighlight._liTarget) {
anchorHighlight._liTarget.classList.add(classes.ACTIVE_LI);
eventUtil.trigger(anchorHighlight._liTarget, events.ACTIVE_LI, {});
}
anchorHighlight._liTarget = null;
if (anchorHighlight._buttonTarget) {
btnTargetClassList = anchorHighlight._buttonTarget.classList;
btnTargetClassList.remove(classes.ACTIVE_BTN);
btnTargetClassList.remove(classes.INACTIVE_BTN);
anchorHighlight._requestAnimationFrame(addButtonActiveClass);
}
}
} else {
anchorHighlight._requestAnimationFrame(addActiveClass);
}
}
}
/**
* Get all active elements
* @method getActiveElements
* @return {Array}
* @member ns.util.anchorHighlight
* @private
* @static
*/
function getActiveElements() {
return slice.call(document.getElementsByClassName(classes.ACTIVE_LI));
}
/**
* Remove active class from current active objects
* @method clearActiveClass
* @member ns.util.anchorHighlight
* @private
* @static
*/
function clearActiveClass() {
var activeA = getActiveElements(),
activeALength = activeA.length,
i = 0;
for (; i < activeALength; i++) {
activeA[i].classList.remove(classes.ACTIVE_LI);
}
}
/**
* Remove active class from active elements
* @method removeActiveClass
* @member ns.util.anchorHighlight
* @private
* @static
*/
function removeActiveClassLoop() {
var dTime = Date.now() - anchorHighlight._startRemoveTime;
if (dTime > anchorHighlight.options.keepActiveClassDelay) {
// after touchend
clearActiveClass();
} else {
anchorHighlight._requestAnimationFrame(removeActiveClassLoop);
}
}
/**
* Function invoked during touch move
* @method touchmoveHandler
* @param {Event} event
* @member ns.util.anchorHighlight
* @private
* @static
*/
function touchmoveHandler(event) {
var touch = event.touches[0],
scrollThreshold = anchorHighlight.options.scrollThreshold;
// if move looks like scroll
if (!anchorHighlight._didScroll &&
// if move is bigger then threshold
(abs(touch.clientX - startX) > scrollThreshold ||
abs(touch.clientY - startY) > scrollThreshold)) {
anchorHighlight._startTime = 0;
// we clear active classes
anchorHighlight._requestAnimationFrame(clearActiveClass);
anchorHighlight._didScroll = true;
}
}
/**
* Function invoked after touch start
* @method touchstartHandler
* @param {Event} event
* @member ns.util.anchorHighlight
* @private
* @static
*/
function touchstartHandler(event) {
var touches = event.touches,
touch;
if (touches.length === 1) {
touch = touches[0];
anchorHighlight._didScroll = false;
startX = touch.clientX;
startY = touch.clientY;
anchorHighlight._target = event.target;
anchorHighlight._startTime = Date.now();
anchorHighlight._startRemoveTime = 0;
anchorHighlight._requestAnimationFrame(addActiveClass);
anchorHighlight._touchEnd = false;
}
}
/**
* Function invoked after touch
* @method touchendHandler
* @param {Event} event
* @member ns.util.anchorHighlight
* @private
* @static
*/
function touchendHandler(event) {
anchorHighlight._startRemoveTime = event.timeStamp;
if (event.touches.length === 0) {
if (!anchorHighlight._didScroll) {
anchorHighlight._startTime = 0;
anchorHighlight._requestAnimationFrame(removeActiveClassLoop);
}
// if we finished activate animation then start inactive animation
if (anchorHighlight._activeAnimationFinished) {
anchorHighlight._requestAnimationFrame(addButtonInactiveClass);
}
anchorHighlight._didScroll = false;
anchorHighlight._touchEnd = true;
}
}
/**
* Function invoked after visibilitychange event
* @method checkPageVisibility
* @member ns.util.anchorHighlight
* @private
* @static
*/
function checkPageVisibility() {
/* istanbul ignore if */
if (document.visibilityState === "hidden") {
anchorHighlight._removeActiveClassLoop();
}
}
ns.util.anchorHighlight = anchorHighlight;
anchorHighlight.enable = enable;
anchorHighlight.disable = disable;
anchorHighlight._clearActiveClass = clearActiveClass;
anchorHighlight._detectHighlightTarget = detectHighlightTarget;
anchorHighlight._detectBtnElement = detectBtnElement;
anchorHighlight._clearBtnActiveClass = clearBtnActiveClass;
anchorHighlight._removeActiveClassLoop = removeActiveClassLoop;
anchorHighlight._addButtonInactiveClass = addButtonInactiveClass;
anchorHighlight._addButtonActiveClass = addButtonActiveClass;
anchorHighlight._hideClear = hideClear;
anchorHighlight._addActiveClass = addActiveClass;
anchorHighlight._detectLiElement = detectLiElement;
anchorHighlight._touchmoveHandler = touchmoveHandler;
anchorHighlight._touchendHandler = touchendHandler;
anchorHighlight._touchstartHandler = touchstartHandler;
anchorHighlight._checkPageVisibility = checkPageVisibility;
anchorHighlight._hideClear = hideClear;
anchorHighlight._clearBtnActiveClass = clearBtnActiveClass;
/**
* Bind events to document
* @method enable
* @member ns.util.anchorHighlight
* @static
*/
function enable() {
document.addEventListener("touchstart", anchorHighlight._touchstartHandler, false);
document.addEventListener("touchend", anchorHighlight._touchendHandler, false);
document.addEventListener("touchmove", anchorHighlight._touchmoveHandler, false);
document.addEventListener("visibilitychange", anchorHighlight._checkPageVisibility, false);
document.addEventListener("pagehide", anchorHighlight._hideClear, false);
document.addEventListener("popuphide", anchorHighlight._hideClear, false);
document.addEventListener("animationend", anchorHighlight._clearBtnActiveClass, false);
document.addEventListener("animationEnd", anchorHighlight._clearBtnActiveClass, false);
document.addEventListener("webkitAnimationEnd", anchorHighlight._clearBtnActiveClass,
false);
}
/**
* Unbinds events from document.
* @method disable
* @member ns.util.anchorHighlight
* @static
*/
function disable() {
document.removeEventListener("touchstart", anchorHighlight._touchstartHandler, false);
document.removeEventListener("touchend", anchorHighlight._touchendHandler, false);
document.removeEventListener("touchmove", anchorHighlight._touchmoveHandler, false);
document.removeEventListener("visibilitychange", anchorHighlight._checkPageVisibility,
false);
document.removeEventListener("pagehide", anchorHighlight._hideClear, false);
document.removeEventListener("popuphide", anchorHighlight._hideClear, false);
document.removeEventListener("animationend", anchorHighlight._clearBtnActiveClass, false);
document.removeEventListener("animationEnd", anchorHighlight._clearBtnActiveClass, false);
document.removeEventListener("webkitAnimationEnd", anchorHighlight._clearBtnActiveClass,
false);
}
enable();
}(document, window, ns));
/*global window, ns, define */
(function (window, document, ns) {
"use strict";
var PI = Math.PI,
cos = Math.cos,
sin = Math.sin,
SVGNS = "http://www.w3.org/2000/svg",
objectUtils = ns.util.object,
classes = {
polar: "ui-polar",
animated: "ui-animated"
},
defaultsArc = {
x: 180,
y: 180,
r: 170,
arcStart: 0,
arcEnd: 90,
width: 5,
color: "black",
animation: false,
linecap: "butt",
referenceDegree: 0
},
defaultsRadius = {
x: 180,
y: 180,
r: 170,
degrees: 0,
length: 180,
direction: "in",
width: 5,
color: "black"
},
defaultsText = {
x: 180,
y: 180,
text: "Text",
position: "middle",
color: "white"
},
defaultsCircle = {
x: 180,
y: 180,
r: 170,
color: "white"
},
polar;
/**
* Calculate polar coords to cartesian
* @param {number} centerX
* @param {number} centerY
* @param {number} radius
* @param {number} angleInDegrees
* @return {{x: number, y: number}}
*/
function polarToCartesian(centerX, centerY, radius, angleInDegrees) {
var angleInRadians = angleInDegrees * PI / 180.0;
return {
x: centerX + (radius * sin(angleInRadians)),
y: centerY - (radius * cos(angleInRadians))
};
}
/**
* Create description of path for arc
* @param {number} x
* @param {number} y
* @param {number} radius
* @param {number} startAngle Angle in degrees where arc starts
* @param {number} endAngle Angle in degrees where arc ends
* @return {string}
*/
function describeArc(x, y, radius, startAngle, endAngle) {
var start = polarToCartesian(x, y, radius, endAngle),
end = polarToCartesian(x, y, radius, startAngle),
arcSweep = endAngle - startAngle <= 180 ? "0" : "1",
clockWise = 0;
return [
"M", start.x, start.y,
"A", radius, radius, 0, arcSweep, clockWise, end.x, end.y
].join(" ");
}
function addPath(svg, options) {
var path = document.createElementNS(SVGNS, "path");
path.setAttribute("class", options.classes);
path.setAttribute("fill", "none");
path.setAttribute("stroke", options.color);
path.setAttribute("stroke-width", options.width);
path.setAttribute("d", describeArc(options.x, options.y, options.r,
options.referenceDegree + options.arcStart, options.referenceDegree + options.arcEnd));
path.setAttribute("data-initial-degree", options.referenceDegree);
path.setAttribute("stroke-linecap", options.linecap);
svg.appendChild(path);
}
function addAnimation(element, options) {
var style = element.style,
value = options.x + "px " + options.y + "px",
degrees = (options.referenceDegree + options.arcStart) || options.degrees;
// phantom not support classList on SVG
if (element.classList) {
// add class for transition
element.classList.add(classes.animated);
}
// set transform
style.webkitTransformOrigin = value;
style.mozTransformOrigin = value;
style.transformOrigin = value;
value = "rotate(" + degrees + "deg)";
style.webkitTransform = value;
style.mozTransform = value;
style.transform = value;
}
function addRadius(svg, options) {
var line = document.createElementNS(SVGNS, "line"),
positionStart,
positionEnd;
line.setAttribute("class", options.classes);
line.setAttribute("stroke", options.color);
line.setAttribute("stroke-width", options.width);
if (options.direction === "out") {
positionStart = polarToCartesian(options.x, options.y, options.r, options.degrees);
positionEnd = polarToCartesian(options.x, options.y, options.r - options.length,
options.degrees);
} else {
positionStart = polarToCartesian(options.x, options.y, options.r - options.length,
options.degrees);
positionEnd = polarToCartesian(options.x, options.y, options.r, options.degrees);
}
line.setAttribute("x1", positionStart.x);
line.setAttribute("y1", positionStart.y);
line.setAttribute("x2", positionEnd.x);
line.setAttribute("y2", positionEnd.y);
svg.appendChild(line);
return line;
}
function addText(svg, options) {
var text = document.createElementNS(SVGNS, "text");
text.setAttribute("x", options.x);
text.setAttribute("y", options.y);
text.setAttribute("text-anchor", options.position);
text.setAttribute("fill", options.color);
text.setAttribute("transform", options.transform);
text.textContent = options.text;
svg.appendChild(text);
}
function addCircle(svg, options) {
var circle = document.createElementNS(SVGNS, "circle");
circle.setAttribute("stroke", options.color);
circle.setAttribute("stroke-width", options.width);
circle.setAttribute("cx", options.x);
circle.setAttribute("cy", options.y);
circle.setAttribute("r", options.r);
circle.setAttribute("fill", options.fill);
svg.appendChild(circle);
return circle;
}
function updatePathPosition(path, options) {
var reference;
if (options.animation) {
addAnimation(path, options);
} else {
if (path) {
reference = parseInt(path.getAttribute("data-initial-degree"), 10) || options.referenceDegree;
path.setAttribute("data-initial-degree", reference);
path.setAttribute("d", describeArc(options.x, options.y, options.r,
reference + options.arcStart, reference + options.arcEnd));
}
}
}
function updateLinePosition(line, options) {
var positionStart,
positionEnd;
if (options.animation) {
addAnimation(line, options);
} else {
if (line) {
positionStart = polarToCartesian(options.x, options.y, options.r, options.degrees);
positionEnd = polarToCartesian(options.x, options.y, options.r - options.length, options.degrees);
line.setAttribute("x1", positionStart.x);
line.setAttribute("y1", positionStart.y);
line.setAttribute("x2", positionEnd.x);
line.setAttribute("y2", positionEnd.y);
}
}
}
polar = {
default: {
arc: defaultsArc,
radius: defaultsRadius,
text: defaultsText
},
classes: classes,
polarToCartesian: polarToCartesian,
/**
* creates SVG element
* @method createSVG
* @member ns.util.polar
* @param {HTMLElement} element
* @return {SVGElement}
* @static
*/
createSVG: function (element) {
var svg = document.createElementNS(SVGNS, "svg");
// phantom not support classList on SVG
if (svg.classList) {
// add class to svg element
svg.classList.add(classes.polar);
}
// if element is set, add svg as child node
if (element) {
element.appendChild(svg);
}
return svg;
},
/**
* draw arc on the svg element
* @method addArc
* @member ns.util.polar
* @param {SVGElement} svg
* @param {Object} options
* @return {SVGElement}
* @static
*/
addArc: function (svg, options) {
// read or create new svg
svg = svg || this.createSVG();
// set options
options = objectUtils.merge({}, defaultsArc, options || {});
// add path with arc
addPath(svg, options);
return svg;
},
/**
* draw radius on the svg element
* @method addRadius
* @member ns.util.polar
* @param {SVGElement} svg
* @param {Object} options
* @return {SVGElement}
* @static
*/
addRadius: function (svg, options) {
// read or create new svg
svg = svg || this.createSVG();
// add path with radius
options = objectUtils.merge({}, defaultsRadius, options || {});
return addRadius(svg, options);
},
/**
* draw text on the svg element
* @method addText
* @member ns.util.polar
* @param {SVGElement} svg
* @param {Object} options
* @return {SVGElement}
* @static
*/
addText: function (svg, options) {
// read or create new svg
svg = svg || this.createSVG();
// add path with radius
options = objectUtils.merge({}, defaultsText, options || {});
addText(svg, options);
return svg;
},
/**
* updatePosition for path or for line drawings in svg
* @method updatePosition
* @member ns.util.polar
* @param {SVGElement} svg
* @param {string} selector
* @param {Object} options
* @static
*/
updatePosition: function (svg, selector, options) {
var path = svg && svg.querySelector("path" + selector),
line;
if (path) {
// set options
options = objectUtils.merge({}, defaultsArc, options || {});
updatePathPosition(path, options);
} else {
line = svg && svg.querySelector("line" + selector);
if (line) {
updateLinePosition(line, options);
}
}
},
/**
* draw circle on the svg element
* @method addCircle
* @member ns.util.polar
* @param {SVGElement} svg
* @param {Object} options
* @return {SVGElement}
* @static
*/
addCircle: function (svg, options) {
var self = this;
// read or create svg
svg = svg || self.createSVG();
options = objectUtils.merge({}, defaultsCircle, options || {});
addCircle(svg, options);
return svg;
}
};
ns.util.polar = polar;
}(window, window.document, ns));
/* global requestAnimationFrame, define, ns, Math */
/**
* # JS base scrolling tool
*
* This enable fast scrolling on element
*
* @class ns.util.scrolling
*/
(function (document, window, ns) {
"use strict";
var eventUtil = ns.event,
polarUtil = ns.util.polar,
classes = {
circular: "scrolling-circular",
direction: "scrolling-direction",
scrollbar: "scrolling-scrollbar",
path: "scrolling-path",
thumb: "scrolling-scrollthumb",
fadeIn: "fade-in"
},
bounceBack = false,
EVENTS = {
SCROLL_BEFORE_START: "beforeScrollStart",
SCROLL_START: "scrollStart",
SCROLL_END: "scrollEnd",
SCROLL_FLICK: "flick",
SCROLL: "scroll"
},
// 1px line space from screen edge
RADIUS = 174,
// position when was last touch start
startPosition = 0,
// current state of scroll position
scrollPosition = 0,
lastScrollPosition = 0,
moveToPosition = 0,
lastRenderedPosition = 0,
lastTime = Date.now(),
elementStyle = null,
maxScrollPosition = 0,
// scrolling element
scrollingElement = null,
childElement = null,
// cache of previous overflow style to revert after disable
previousOverflow = "",
// cache abs function
abs = Math.abs,
// inform that is touched
isTouch = false,
isScrollableTarget = false,
// direction of scrolling, 0 - mean Y, 1 - mean X
direction = 0,
// cache of round function
round = Math.round,
// cache max function
max = Math.max,
min = Math.min,
// Circular scrollbar config
CIRCULAR_SCROLL_BAR_SIZE = 60, // degrees
CIRCULAR_SCROLL_MIN_THUMB_SIZE = 6,
// Scrollbar is placed after scrolled element
// that's why normal css values cannot be applied
// margin needs to be subtracted from position
SCROLL_MARGIN = 11,
// ScrollBar variables
scrollBar = null,
scrollThumb = null,
scrollBarPosition = 0,
maxScrollBarPosition = 0,
circularScrollBar = ns.support.shape.circle,
circularScrollThumbSize = CIRCULAR_SCROLL_MIN_THUMB_SIZE,
svgScrollBar = null,
scrollBarTimeout = null,
fromAPI = false,
virtualMode = false,
snapSize = null,
requestAnimationFrame = window.requestAnimationFrame || window.webkitRequestAnimationFrame;
/**
* Shows scrollbar using fadeIn class and sets timeout to hide it when not used
*/
function fadeInScrollBar() {
if (scrollBar) {
clearTimeout(scrollBarTimeout);
scrollBar.classList.add(classes.fadeIn);
scrollBarTimeout = setTimeout(function () {
if (scrollBar) {
scrollBar.classList.remove(classes.fadeIn);
}
}, 2000);
}
}
/**
* Check that current target is inside scrolling element
* @param {HTMLElement} target
* @return {boolean}
*/
function detectTarget(target) {
while (target && target !== document) {
if (target === scrollingElement) {
return true;
}
target = target.parentElement;
}
return false;
}
/**
* Handler for touchstart event
* @param {Event} event
*/
function touchStart(event) {
var touches = event.touches,
touch = touches[0];
isScrollableTarget = detectTarget(event.target);
// is is only one touch
if (isScrollableTarget && touches.length === 1) {
// save current touch point
startPosition = direction ? touch.clientX : touch.clientY;
// save current time for calculate acceleration on touchend
lastTime = Date.now();
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_BEFORE_START, {
scrollLeft: direction ? -scrollPosition : 0,
scrollTop: direction ? 0 : -scrollPosition,
fromAPI: fromAPI
});
}
}
function touchMoveMain(event) {
var touches = event.touches,
touch = touches[0],
// get current position in correct direction
clientPosition = direction ? touch.clientX : touch.clientY,
scrollLeft = 0,
scrollTop = 0;
fromAPI = false;
// calculate difference between touch start and current position
lastScrollPosition = clientPosition - startPosition;
if (!bounceBack) {
// normalize value to be in bound [0, maxScroll]
if (scrollPosition + lastScrollPosition > 0) {
lastScrollPosition = -scrollPosition;
}
if (scrollPosition + lastScrollPosition < -maxScrollPosition) {
lastScrollPosition = -maxScrollPosition - scrollPosition;
}
}
if (direction) {
scrollLeft = -(scrollPosition + lastScrollPosition);
} else {
scrollTop = -(scrollPosition + lastScrollPosition);
}
// trigger event scroll start if it is the first touch move
if (!isTouch) {
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_START, {
scrollLeft: scrollLeft,
scrollTop: scrollTop,
fromAPI: fromAPI
});
}
// trigger event scroll
eventUtil.trigger(scrollingElement, EVENTS.SCROLL, {
scrollLeft: scrollLeft,
scrollTop: scrollTop,
inBounds: (scrollPosition + lastScrollPosition >= -maxScrollPosition) &&
(scrollPosition + lastScrollPosition <= 0),
fromAPI: fromAPI
});
fadeInScrollBar();
}
/**
* Handler for touchmove event
* @param {Event} event
*/
function touchMove(event) {
var touches = event.touches;
// if touch start was on scrolled element
if (isScrollableTarget) {
// if is only one touch
if (touches.length === 1) {
touchMoveMain(event);
}
// if this is first touch move
if (!isTouch) {
// we need start request loop
isTouch = true;
}
requestAnimationFrame(render);
}
}
function touchEndCalculateSpeed(inBounds) {
var diffTime = Date.now() - lastTime;
if (inBounds && abs(lastScrollPosition / diffTime) > 1) {
// if it was fast move, we start animation of scrolling after touch end
moveToPosition = max(min(round(scrollPosition + 1000 * lastScrollPosition / diffTime),
0), -maxScrollPosition);
if (snapSize) {
moveToPosition = snapSize * round(moveToPosition / snapSize);
}
if (abs(lastScrollPosition / diffTime) > 1) {
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_FLICK, {
scrollLeft: direction ? -moveToPosition : 0,
scrollTop: direction ? 0 : -moveToPosition,
fromAPI: fromAPI
});
}
requestAnimationFrame(moveTo);
} else {
// touch move was slow
if (snapSize) {
moveToPosition = snapSize * round(scrollPosition / snapSize);
requestAnimationFrame(moveTo);
}
isTouch = false;
}
}
function touchEndCalculatePosition(inBounds) {
if (bounceBack) {
if (!inBounds) {
// if it was fast move, we start animation of scrolling after touch end
if (scrollPosition > 0) {
moveToPosition = 0;
} else {
moveToPosition = -maxScrollPosition;
}
requestAnimationFrame(moveTo);
}
} else {
// normalize value to be in bound [0, maxScroll]
if (scrollPosition < -maxScrollPosition) {
scrollPosition = -maxScrollPosition;
}
if (scrollPosition > 0) {
scrollPosition = 0;
}
}
}
function touchEndTriggerEvents(details) {
eventUtil.trigger(scrollingElement, EVENTS.SCROLL, details);
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_END, details);
}
/**
* Handler for touchend event
*/
function touchEnd() {
var inBounds,
scrollLeft = 0,
scrollTop = 0;
// only if the event touchmove was noticed before
if (isTouch) {
// update state of scrolling
scrollPosition += lastScrollPosition;
inBounds = (scrollPosition >= -maxScrollPosition) && (scrollPosition <= 0);
// calculate speed of touch move
touchEndCalculateSpeed(inBounds);
touchEndCalculatePosition(inBounds);
if (direction) {
scrollLeft = -(scrollPosition);
} else {
scrollTop = -(scrollPosition);
}
lastScrollPosition = 0;
// trigger event scroll
touchEndTriggerEvents({
scrollLeft: scrollLeft,
scrollTop: scrollTop,
inBounds: inBounds,
fromAPI: fromAPI
});
fadeInScrollBar();
// we stop scrolling
isScrollableTarget = false;
requestAnimationFrame(render);
}
}
/**
* Handler for rotary event
* @param {Event} event
*/
function rotary(event) {
var eventDirection = event.detail && event.detail.direction;
// update position by snapSize
if (eventDirection === "CW") {
moveToPosition -= snapSize || 50;
} else {
moveToPosition += snapSize || 50;
}
if (snapSize) {
moveToPosition = snapSize * round(moveToPosition / snapSize);
}
if (moveToPosition < -maxScrollPosition) {
moveToPosition = -maxScrollPosition;
}
if (moveToPosition > 0) {
moveToPosition = 0;
}
requestAnimationFrame(moveTo);
requestAnimationFrame(render);
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_START, {
scrollLeft: direction ? -(moveToPosition) : 0,
scrollTop: direction ? 0 : -(moveToPosition),
fromAPI: false
});
event.stopImmediatePropagation();
}
function moveToCalculatePosition() {
var diffPosition = moveToPosition - scrollPosition,
// get absolute value
absDiffPosition = abs(diffPosition);
if (absDiffPosition > 10) {
// we move 10% of difference
scrollPosition = round(scrollPosition + diffPosition / 10);
requestAnimationFrame(moveTo);
} else if (absDiffPosition > 2) {
// else if is difference < 10 then we move 50%
scrollPosition = round(scrollPosition + diffPosition / 2);
requestAnimationFrame(moveTo);
} else {
// if difference is <=2 then we move to end value and finish loop
scrollPosition = moveToPosition;
}
if (!bounceBack) {
// normalize scroll value
if (scrollPosition < -maxScrollPosition) {
scrollPosition = -maxScrollPosition;
}
if (scrollPosition > 0) {
scrollPosition = 0;
}
}
}
/**
* Loop function to calculate state in animation after touchend
*/
function moveTo() {
// calculate difference between current position and expected scroll end
var scrollLeft = 0,
scrollTop = 0;
// if difference is big
if (scrollingElement) {
moveToCalculatePosition();
if (direction) {
scrollLeft = -scrollPosition;
} else {
scrollTop = -scrollPosition;
}
// trigger event scroll
eventUtil.trigger(scrollingElement, EVENTS.SCROLL, {
scrollLeft: scrollLeft,
scrollTop: scrollTop,
inBounds: (scrollPosition >= -maxScrollPosition) && (scrollPosition <= 0),
fromAPI: fromAPI
});
if (!isTouch) {
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_END, {
scrollLeft: scrollLeft,
scrollTop: scrollTop,
fromAPI: fromAPI
});
}
fadeInScrollBar();
}
}
function renderScrollbar() {
if (circularScrollBar) {
polarUtil.updatePosition(svgScrollBar, "." + classes.thumb, {
arcStart: scrollBarPosition,
arcEnd: scrollBarPosition + circularScrollThumbSize,
r: RADIUS
});
} else {
if (scrollThumb) {
if (direction) {
scrollThumb.style.transform = "translate(" + scrollBarPosition + "px, 0)";
} else {
scrollThumb.style.transform = "translate(0, " + scrollBarPosition + "px)";
}
}
}
}
/**
* Render loop on request animation frame
*/
function render() {
// calculate ne position of scrolling as sum of last scrolling state + move
var newRenderedPosition = scrollPosition + lastScrollPosition;
// is position was changed
if (newRenderedPosition !== lastRenderedPosition) {
// we update styles
lastRenderedPosition = newRenderedPosition;
if (-newRenderedPosition < maxScrollPosition) {
scrollBarPosition = -newRenderedPosition / maxScrollPosition * maxScrollBarPosition;
} else {
scrollBarPosition = maxScrollBarPosition;
}
if (scrollBarPosition < 0) {
scrollBarPosition = 0;
}
if (!virtualMode && elementStyle) {
elementStyle.transform = direction ?
"translate(" + lastRenderedPosition + "px, 0)" :
"translate(0, " + lastRenderedPosition + "px)";
}
renderScrollbar();
requestAnimationFrame(render);
}
}
function initPosition() {
// init internal variables
startPosition = 0;
scrollPosition = 0;
scrollBarPosition = 0;
lastScrollPosition = 0;
moveToPosition = 0;
lastRenderedPosition = 0;
lastTime = Date.now();
}
/**
* Enable JS scrolling on element
* @method enable
* @param {HTMLElement} element element for scrolling
* @param {"x"|"y"} [setDirection="y"] direction of scrolling
* @param {boolean} setVirtualMode if is set to true then send event without scroll element
* @member ns.util.scrolling
*/
function enable(element, setDirection, setVirtualMode) {
var parentRectangle,
contentRectangle;
virtualMode = setVirtualMode;
bounceBack = false;
snapSize = false;
if (scrollingElement) {
ns.warn("Scrolling exist on another element, first call disable method");
} else {
// detect direction
direction = (setDirection === "x") ? 1 : 0;
// we are creating a container to position transform
childElement = document.createElement("div");
// ... and appending all children to it
while (element.firstElementChild) {
childElement.appendChild(element.firstElementChild);
}
element.appendChild(childElement);
// setting scrolling element
scrollingElement = element;
// calculate maxScroll
parentRectangle = element.getBoundingClientRect();
contentRectangle = childElement.getBoundingClientRect();
// Max scroll position is determined by size of the content - clip window size
if (direction) {
maxScrollPosition = round(contentRectangle.width - parentRectangle.width);
} else {
maxScrollPosition = round(contentRectangle.height - parentRectangle.height);
}
// cache style element
elementStyle = childElement.style;
initPosition();
// cache current overflow value to restore in disable
previousOverflow = window.getComputedStyle(element).getPropertyValue("overflow");
// set overflow hidden
element.style.overflow = "hidden";
// add event listeners
document.addEventListener("touchstart", touchStart, false);
document.addEventListener("touchmove", touchMove, false);
document.addEventListener("touchend", touchEnd, false);
window.addEventListener("rotarydetent", rotary, true);
}
}
/**
* @method disable
* @member ns.util.scrolling
*/
function disable() {
disableScrollBar();
// clear event listeners
document.removeEventListener("touchstart", touchStart, false);
document.removeEventListener("touchmove", touchMove, false);
document.removeEventListener("touchend", touchEnd, false);
window.removeEventListener("rotarydetent", rotary, true);
// after changed page and removed it this element can not exists
if (scrollingElement) {
scrollingElement.style.overflow = previousOverflow;
}
elementStyle = null;
scrollingElement = null;
childElement = null;
svgScrollBar = null;
}
function enableScrollBarCircular() {
var arcStartPoint = direction ? 0 : 90;
scrollBar.classList.add(classes.circular);
svgScrollBar = polarUtil.createSVG();
// create background
polarUtil.addArc(svgScrollBar, {
arcStart: arcStartPoint - (CIRCULAR_SCROLL_BAR_SIZE / 2),
arcEnd: arcStartPoint + (CIRCULAR_SCROLL_BAR_SIZE / 2),
classes: classes.path,
width: 10,
r: RADIUS,
linecap: "round"
});
// create thumb
polarUtil.addArc(svgScrollBar, {
referenceDegree: arcStartPoint - (CIRCULAR_SCROLL_BAR_SIZE / 2),
arcStart: 0,
arcEnd: circularScrollThumbSize,
classes: classes.thumb,
width: 10,
r: RADIUS,
linecap: "round"
});
scrollBar.appendChild(svgScrollBar);
scrollingElement.parentElement.insertBefore(scrollBar, scrollingElement.nextSibling);
}
function enableScrollBarRectangular(scrollBarStyle) {
var boundingRect,
childElementRect,
scrollThumbStyle,
scrollBarWidth = 0,
scrollBarHeight = 0;
scrollBar.classList.add(classes.direction + "-" + (direction ? "x" : "y"));
scrollThumb = document.createElement("div");
scrollThumbStyle = scrollThumb.style;
scrollThumb.classList.add(classes.thumb);
boundingRect = scrollingElement.getBoundingClientRect();
childElementRect = childElement.getBoundingClientRect();
if (direction) {
scrollBarWidth = (boundingRect.width - (2 * SCROLL_MARGIN));
scrollBarStyle.width = scrollBarWidth + "px";
scrollBarStyle.left = (boundingRect.left + SCROLL_MARGIN) + "px";
scrollThumbStyle.transform = "translate3d(" + scrollBarPosition + "px,0,0)";
// Calculate size of the thumb (only useful when enabling after content has size > 0)
scrollThumbStyle.width = (scrollBarWidth / childElementRect.width * scrollBarWidth) +
"px";
} else {
scrollBarHeight = (boundingRect.height - (2 * SCROLL_MARGIN));
scrollBarStyle.height = scrollBarHeight + "px";
scrollBarStyle.top = (boundingRect.top + SCROLL_MARGIN) + "px";
scrollThumbStyle.transform = "translate3d(0," + scrollBarPosition + "px,0)";
// Calculate size of the thumb (only useful when enabling after content has size > 0)
scrollThumbStyle.height = (scrollBarHeight / childElementRect.height * scrollBarHeight) +
"px";
}
scrollBar.appendChild(scrollThumb);
scrollingElement.parentElement.insertBefore(scrollBar, scrollingElement.nextSibling);
// Get max scrollbar position after appending
if (direction) {
maxScrollBarPosition = scrollBarWidth - scrollThumb.getBoundingClientRect().width;
} else {
maxScrollBarPosition = scrollBarHeight - scrollThumb.getBoundingClientRect().height;
}
}
function enableScrollBar() {
scrollBar = document.createElement("div");
scrollBar.classList.add(classes.scrollbar);
if (circularScrollBar) {
enableScrollBarCircular();
} else {
enableScrollBarRectangular(scrollBar.style);
}
}
function disableScrollBar() {
if (scrollBar) {
scrollBar.parentElement.removeChild(scrollBar);
scrollBar = null;
scrollThumb = null;
}
}
/**
* Scroll to give position
* @method scrollTo
* @param {number} value
* @member ns.util.scrolling
*/
function scrollTo(value) {
moveToPosition = value;
fromAPI = true;
eventUtil.trigger(scrollingElement, EVENTS.SCROLL_BEFORE_START, {
scrollLeft: direction ? -scrollPosition : 0,
scrollTop: direction ? 0 : -scrollPosition,
fromAPI: fromAPI
});
requestAnimationFrame(moveTo);
render();
}
/**
* Return scroll position
* @method getScrollPosition
* @member ns.util.scrolling
*/
function getScrollPosition() {
return -scrollPosition;
}
/**
* Return max scroll position
* @method getMaxScroll
* @member ns.util.scrolling
*/
function getMaxScroll() {
return maxScrollPosition;
}
ns.util.scrolling = {
getScrollPosition: getScrollPosition,
enable: enable,
disable: disable,
enableScrollBar: enableScrollBar,
disableScrollBar: disableScrollBar,
scrollTo: scrollTo,
/**
* Return true is given element is current scrolling element
* @method isElement
* @param {HTMLElement} element element to check
* @return {boolean}
* @member ns.util.scrolling
*/
isElement: function (element) {
return scrollingElement === element;
},
/**
* Update max scrolling position
* @method setMaxScroll
* @param {number} maxValue
* @member ns.util.scrolling
*/
setMaxScroll: function (maxValue) {
var boundingRect = scrollingElement.getBoundingClientRect(),
directionDimension = direction ? "width" : "height",
directionSize = boundingRect[directionDimension],
tempMaxPosition = max(maxValue - directionSize, 0);
// Change size of thumb only when necessary
if (tempMaxPosition !== maxScrollPosition) {
maxScrollPosition = tempMaxPosition || Number.POSITIVE_INFINITY;
if (scrollBar) {
if (circularScrollBar) {
// Calculate new thumb size based on max scrollbar size
circularScrollThumbSize = max((directionSize / (maxScrollPosition + directionSize)) *
CIRCULAR_SCROLL_BAR_SIZE, CIRCULAR_SCROLL_MIN_THUMB_SIZE);
maxScrollBarPosition = CIRCULAR_SCROLL_BAR_SIZE - circularScrollThumbSize;
polarUtil.updatePosition(svgScrollBar, "." + classes.thumb, {
arcStart: scrollBarPosition,
arcEnd: scrollBarPosition + circularScrollThumbSize,
r: RADIUS
});
} else {
directionSize -= 2 * SCROLL_MARGIN;
scrollThumb.style[directionDimension] =
(directionSize / (maxScrollPosition + directionSize) * directionSize) + "px";
// Cannot use direct value from style here because CSS may override the minimum
// size of thumb here
maxScrollBarPosition = directionSize -
scrollThumb.getBoundingClientRect()[directionDimension];
}
}
}
},
getMaxScroll: getMaxScroll,
setSnapSize: function (setSnapSize) {
snapSize = setSnapSize;
if (snapSize) {
maxScrollPosition = snapSize * round(maxScrollPosition / snapSize);
}
},
setBounceBack: function (setBounceBack) {
bounceBack = setBounceBack;
}
};
}(document, window, ns));
/* global define, ns */
/**
* #Scrolling by rotary event
*
* Tool to enable scrolling by rotary event.
*
* ##How tu use
*
* @example
* <div class="ui-page" id="page>
* <div class="ui-content">
* Long content to scroll
* </div>
* <script>
* var page = document.getElementById("page");
* page.addEventListener("pagebeforeshow", function (event) {
* tau.util.rotaryScrolling.enable(event.target.firstElementChild);
* });
* page.addEventListener("pagehide", function () {
* tau.util.rotaryScrolling.disable();
* });
* </script>
* </div>
*
* @class ns.util.rotaryScrolling
*/
(function (document, window, ns) {
"use strict";
var rotaryScrolling = {},
element = null,
/**
* Scroll step
* @type {number}
*/
scrollStep = 40;
/**
* Handler for rotary event
* @param {Event} event Event object
*/
function rotaryDetentHandler(event) {
if (event.detail.direction === "CW") {
element.scrollTop += scrollStep;
} else {
element.scrollTop -= scrollStep;
}
}
/**
* Enable Rotary event scrolling
* @param {HTMLElement} newElement Base element to scroll
* @param {number} newScrollDiff Value of scroll step
* @method enable
* @memberof ns.util.rotaryScrolling
*/
function enable(newElement, newScrollDiff) {
element = newElement;
if (newScrollDiff) {
scrollStep = newScrollDiff;
}
document.addEventListener("rotarydetent", rotaryDetentHandler);
}
/**
* Disable rotary event scrolling
* @method disable
* @memberof ns.util.rotaryScrolling
*/
function disable() {
scrollStep = 40;
document.removeEventListener("rotarydetent", rotaryDetentHandler);
}
/**
* Get value of step which is changed in each rotate
* @method getScrollStep
* @memberof ns.util.rotaryScrolling
* @return {number}
*/
function getScrollStep() {
return scrollStep;
}
/**
* Set value of step which is changed in each rotate
* @param {number} newScrollStep New value of scroll step
* @method setScrollStep
* @memberof ns.util.rotaryScrolling
*/
function setScrollStep(newScrollStep) {
scrollStep = newScrollStep;
}
rotaryScrolling.enable = enable;
rotaryScrolling.disable = disable;
rotaryScrolling.setScrollStep = setScrollStep;
rotaryScrolling.getScrollStep = getScrollStep;
ns.util.rotaryScrolling = rotaryScrolling;
}(document, window, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns */
/**
* #Date Utility
* Object supports work with date and time
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @class ns.util.date
*/
(function (ns) {
"use strict";
var timeRegex = /([\-0-9.]*)(ms|s)?/i,
date = {
/**
* Convert string time length to miliseconds
* Note: this was implemented only for animation package
* and the string input should be conforming to css <time>
* unit definition (ref: https://developer.mozilla.org/en-US/docs/Web/CSS/time)
* If a different format or more functionality needs to be implemented, please
* change this function and usage cases in animation package accordingly
* @method convertToMiliseconds
* @param {string} string
* @return {number}
* @static
* @member ns.util.date
*/
convertToMiliseconds: function (string) {
var parsed = string.match(timeRegex),
miliseconds = 0,
parsedNumber;
if (parsed.length === 3) {
parsedNumber = parseFloat(parsed[1]) || 0;
if (parsed[2] === "ms") {
miliseconds = parsedNumber;
} else if (parsed[2] === "s") {
miliseconds = parsedNumber * 1000;
}
}
return miliseconds;
}
};
ns.util.date = date;
}(ns));
/*global window, define, ns, HTMLElement, HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement, HTMLButtonElement */
/*
* Copyright (c) 2010 - 2014 Samsung Electronics Co., Ltd.
* License : MIT License V2
*/
/*
* #Namespace For Widgets
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @class ns.widget
*/
(function (document) {
"use strict";
var engine = ns.engine,
registeredTags = {},
registerQueue = {};
function defineCustomElement(event) {
var name = event.detail.name,
BaseElement = event.detail.BaseElement || HTMLElement,
CustomWidgetProto = Object.create(BaseElement.prototype),
//define types on elements defined by is selector
controlTypes = ["search", "text", "slider", "checkbox", "radio", "button"],
//define if to use elements with is attribute
lowerName = name.toLowerCase(),
tagName = "tau-" + lowerName,
extendTo = "";
switch (BaseElement) {
case HTMLInputElement :
extendTo = "input";
break;
case HTMLSelectElement :
extendTo = "select";
break;
case HTMLTextAreaElement :
extendTo = "textarea";
break;
case HTMLButtonElement :
extendTo = "button";
break;
}
CustomWidgetProto._tauName = name;
CustomWidgetProto.createdCallback = function () {
var self = this,
//needs to be extended for elements which will be extended by "is" attribute
//it should contain the type in the name like "search" in 'tau-inputsearch'
itemText = self.getAttribute("is");
if (itemText) {
[].some.call(controlTypes, function (item) {
// if element is a control then set the proper type
if (itemText && itemText.indexOf(item) !== -1) {
switch (item) {
case "slider":
//force proper type as cannot extract this from name
self.type = "range";
break;
default:
// omit textarea elements since it has a readonly prop "type"
if (self.tagName.toLowerCase() !== "textarea") {
self.type = item;
}
break;
}
return true;
}
});
}
self._tauWidget = engine.instanceWidget(self, self._tauName);
};
CustomWidgetProto.attributeChangedCallback = function (attrName, oldVal, newVal) {
var tauWidget = this._tauWidget;
if (tauWidget) {
if (attrName === "value") {
tauWidget.value(newVal);
} else if (tauWidget.options && tauWidget.options[attrName] !== undefined) {
if (newVal === "false") {
newVal = false;
}
if (newVal === "true") {
newVal = true;
}
tauWidget.option(attrName, newVal);
tauWidget.refresh();
}
}
};
CustomWidgetProto.attachedCallback = function () {
if (typeof this._tauWidget.onAttach === "function") {
this._tauWidget.onAttach();
}
};
registerQueue[tagName] = (extendTo !== "") ?
{extends: extendTo, prototype: CustomWidgetProto} :
{prototype: CustomWidgetProto};
}
document.addEventListener("tauinit", function () {
Object.keys(registerQueue).forEach(function (tagName) {
if (registeredTags[tagName]) {
ns.warn(tagName + " already registered");
} else {
registeredTags[tagName] = document.registerElement(tagName, registerQueue[tagName]);
}
});
});
if (typeof document.registerElement === "function" && ns.getConfig("registerCustomElements", true)) {
document.addEventListener("widgetdefined", defineCustomElement);
}
}(window.document));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global define, ns */
/**
* #Button
* Shows a control that can be used to generate an action event.
*
* The button component shows on the screen a control that you can use to generate an action event
* when it is pressed and released. The component is coded with standard HTML anchor and input
* elements.
*
* The following table describes the supported button classes.
*
* ## Default selectors
* The button widget shows a control on the screen that you can use to generate an action event
* when it is pressed and released.
* This widget is coded with standard HTML anchor and input elements.
*
* Default selector for buttons is class *ui-btn*
*
* ### HTML Examples
*
* #### Standard button
* To add a button widget to the application, use the following code:
*
* @example
* <button type="button" class="ui-btn">Button</button>
* <a href="#" class="ui-btn">Button</a>
* <input type="button" class="ui-btn" value="Button" />
*
* #### Inline button
*
* @example
* <input type="button" class="ui-btn ui-inline" value="Button" />
*
* #### Multiline text button
*
* @example
* <a href="#" class="ui-btn ui-multiline ui-inline">A Button<br />Icon</a>
*
* ## Options
*
* ### Icons
* Buttons can contains icons
*
* Creates an icon button in the header area is permitted but in content or footer area creating
* icon are not supported.
*
* To use menu icon in header add class *ui-more* to the button element:
*
* @example
* <button class="ui-btn ui-more ui-icon-overflow">More Options</button>
*
* Samsung Wearable Web UI Framework supports 3 icon css styles:
*
* - ui-icon-detail
* - ui-icon-overflow
* - ui-icon-selectall
*
* ### Disabled
*
* If you want to make disabled button, add attribute *disabled* in button tag:
*
* @example
* <button class="ui-btn" disabled="disabled">Button disabled</button>
*
* ### Inline
*
* If you want to make inline button, add class *ui-inline* to button element:
*
* @example
* <button class="ui-btn ui-inline">Inline button</button>
*
* ### Multiline
*
* If you want to make multiline text button, add *ui-multiline* class
*
* @example
* <button class="ui-btn ui-multiline">Multiline button</button>
*
* ### Color theme
*
* To optimize color support for the Samsung Wearable, the following styles below are supported:
*
* <table>
* <tr>
* <th>Class</th>
* <th>Default</th>
* <th>Press</th>
* <th>Disable</th>
* </tr>
* <tr>
* <td>ui-color-red</td>
* <td>#ce2302</td>
* <td>#dd654e</td>
* <td>#3d0a0a</td>
* </tr>
* <tr>
* <td>ui-color-orange</td>
* <td>#ed8600</td>
* <td>#f0aa56</td>
* <td>#462805</td>
* </tr>
* <tr>
* <td>ui-color-green</td>
* <td>#64a323</td>
* <td>#92be5e</td>
* <td>#1e3108</td>
* </tr>
* </table>
*
* ### Button Group
*
* You can group buttons in columns or rows. The following table lists the supported button column
* and row classes.
*
* <table>
* <tr>
* <th>Class</th>
* <th>Description</th>
* </tr>
* <tr>
* <td>ui-grid-col-1</td>
* <td>Defines the button column width as 100% of the screen.</td>
* </tr>
* <tr>
* <td>ui-grid-col-2</td>
* <td>Defines the button column width as 50% of the screen.</td>
* </tr>
* <tr>
* <td>ui-grid-col-3</td>
* <td>Defines the button column width as 33% of the screen.</td>
* </tr>
* <tr>
* <td>ui-grid-row</td>
* <td>Arranges the buttons in a row.</td>
* </tr>
* </table>
*
* To implement the button groups, use the following code:
*
* #### For columns:
*
* @example
* <div class="ui-grid-col-3" style="height:76px">
* <button type="button" class="ui-btn">Button Circle</button>
* <a href="#" class="ui-btn ui-color-red" >A Button Circle</a>
* <input type="button" class="ui-btn ui-color-orange" value="Input Button Circle" />
* </div>
*
* #### For rows:
*
* @example
* <div class="ui-grid-row">
* <button type="button" class="ui-btn">Button Circle</button>
* <a href="#" class="ui-btn ui-color-red" >A Button Circle</a>
* <input type="button" class="ui-btn ui-color-orange" value="Input Button Circle" />
* </div>
*
* @since 2.0
* @class ns.widget.core.Button
* @component-selector button, [data-role="button"], .ui-btn, input[type="button"]
* @component-type standalone-component
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
/**
* Create instance of widget
* @constructor
* @member ns.widget.core.Button
*/
utilDOM = ns.util.DOM,
classes = {
/**
* Standard button
* @style ui-btn
* @member ns.widget.core.Button
*/
BTN: "ui-btn",
/**
* Disabled button
* @style ui-state-disabled
* @member ns.widget.core.Button
*/
DISABLED: "ui-state-disabled",
INLINE: "ui-inline",
BTN_ICON: "ui-btn-icon",
ICON_PREFIX: "ui-icon-",
BTN_CIRCLE: "ui-btn-circle",
BTN_NOBG: "ui-btn-nobg",
BTN_ICON_ONLY: "ui-btn-icon-only",
BTN_TEXT_LIGHT: "ui-btn-text-light",
BTN_TEXT_DARK: "ui-btn-text-dark",
/**
* Change background color of button to red
* @style ui-color-red
* @preview <span style="background-color: red;">&nbsp;</span>
* @member ns.widget.core.Button
*/
/**
* Button for header
* @style ui-more
* @member ns.widget.core.Button
*/
/**
* Button more for header
* @style ui-icon-overflow
* @member ns.widget.core.Button
*/
/**
* Button details for header
* @style ui-icon-detail
* @member ns.widget.core.Button
*/
/**
* Button select all for header
* @style ui-icon-selectall
* @member ns.widget.core.Button
*/
/**
* Icon only style
* @style ui-btn-icon-only
* @member ns.widget.core.Button
*/
BTN_ICON_POSITION_PREFIX: "ui-btn-icon-",
BTN_ICON_MIDDLE: "ui-btn-icon-middle"
},
Button = function () {
var self = this;
self.options = {};
self._classesPrefix = classes.BTN + "-";
},
buttonStyle = {
CIRCLE: "circle",
TEXTLIGHT: "light",
TEXTDARK: "dark",
NOBG: "nobg",
ICON_MIDDLE: "icon-middle"
},
prototype = new BaseWidget();
Button.classes = classes;
Button.prototype = prototype;
/**
* Configure button
* @method _configure
* @protected
* @member ns.widget.core.Button
*/
prototype._configure = function () {
/**
* Object with default options
* @property {Object} options
* @property {boolean} [options.inline=false] If is set true then button has inline style
* @property {?string} [options.icon=null] Set icon class name for button
* @property {boolean} [options.disabled=false] Disable button if is set to true
* @property {"left"|"right"|"button"|"top"} [options.iconpos="left"] Set icon position
* @member ns.widget.core.Button
* @static
*/
/**
* "circle" Make circle button
* "nobg" Make button without background
* @property {null|"circle"|"nobg"} [options.style=null] Set style of button
* @member ns.widget.core.Button
* @static
*/
this.options = {
// common options
inline: false, //url
icon: null,
disabled: false,
// mobile options
style: null,
iconpos: "left",
size: null,
middle: false
};
};
/**
* Set style option
* @method _setStyle
* @param {HTMLElement} element
* @param {string} style
* @protected
* @member ns.widget.core.Button
*/
prototype._setStyle = function (element, style) {
var options = this.options,
buttonClassList = element.classList,
change = false;
style = style || options.style;
switch (style) {
case buttonStyle.CIRCLE:
buttonClassList.remove(classes.BTN_NOBG);
buttonClassList.add(classes.BTN_CIRCLE);
change = true;
break;
case buttonStyle.NOBG:
buttonClassList.remove(classes.BTN_CIRCLE);
buttonClassList.add(classes.BTN_NOBG);
change = true;
break;
case buttonStyle.TEXTLIGHT:
buttonClassList.add(classes.BTN_TEXT_LIGHT);
change = true;
break;
case buttonStyle.TEXTDARK:
buttonClassList.add(classes.BTN_TEXT_DARK);
change = true;
break;
default:
}
if (change) {
options.style = style;
}
};
/**
* Set inline option
* @method _setInline
* @param {HTMLElement} element
* @param {boolean} inline
* @protected
* @member ns.widget.core.Button
*/
prototype._setInline = function (element, inline) {
var options = this.options;
inline = inline || options.inline;
if (inline) {
element.classList.add(classes.INLINE);
options.inline = inline;
}
};
/**
* Set icon option
* @method _setIcon
* @param {HTMLElement} element
* @param {string} icon
* @protected
* @member ns.widget.core.Button
*/
prototype._setIcon = function (element, icon) {
var self = this,
classList = element.classList,
options = self.options,
styles = {},
urlIcon,
iconCSSRule = self._iconCSSRule;
icon = icon || options.icon;
options.icon = icon;
if (icon) {
classList.add(classes.BTN_ICON);
if (icon.indexOf(".") === -1) {
classList.add(classes.ICON_PREFIX + icon);
self._setTitleForIcon(element);
if (iconCSSRule) {
utilDOM.removeCSSRule(iconCSSRule);
}
} else {
// if icon is file path
urlIcon = "url(\"" + icon + "\")";
styles["-webkit-mask-image"] = urlIcon;
styles["mask-image"] = urlIcon;
self._iconCSSRule = utilDOM.setStylesForPseudoClass("#" + element.id, "after", styles);
}
} else {
if (iconCSSRule) {
utilDOM.removeCSSRule(iconCSSRule);
}
}
};
/**
* Set iconpos option
* @method _setIconpos
* @param {HTMLElement} element
* @param {string} iconpos
* @protected
* @member ns.widget.core.Button
*/
prototype._setIconpos = function (element, iconpos) {
var options = this.options,
style = options.style,
innerTextLength = element.textContent.length || (element.value ? element.value.length : 0);
iconpos = iconpos || options.iconpos;
if (options.icon && style !== buttonStyle.CIRCLE && style !== buttonStyle.NOBG) {
if (innerTextLength > 0) {
element.classList.add(classes.BTN_ICON_POSITION_PREFIX + iconpos);
} else {
element.classList.add(classes.BTN_ICON_ONLY);
}
options.iconpos = iconpos;
}
};
/**
* Set title for button without showing text
* @method _setTitleForIcon
* @param {HTMLElement|HTMLInputElement|HTMLButtonElement} element
* @protected
* @member ns.widget.core.Button
*/
prototype._setTitleForIcon = function (element) {
var options = this.options,
buttonText = element.textContent;
// Add title to element if button not has text.
if (options.iconpos === "notext" && !element.getAttribute("title")) {
element.setAttribute("title", buttonText);
ns.warn("iconpos='notext' is deprecated.");
}
};
/**
* Sets button to disabled if element.disabled or element.disabled property is true,
* or class is set to ui-state-disabled
* @method _setDisabled
* @param {HTMLElement} element
* @param {boolean} state
* @protected
*/
prototype._setDisabled = function (element, state) {
var self = this,
options = self.options,
buttonClassList = element.classList;
if (state === true || options.disabled === true || element.disabled ||
buttonClassList.contains(classes.DISABLED)) {
options.disabled = true;
self._disable(element);
} else {
options.disabled = false;
}
};
/**
* Build Button
* @method _build
* @protected
* @param {HTMLElement} element
* @return {HTMLElement}
* @member ns.widget.core.Button
*/
prototype._build = function (element) {
var self = this,
buttonClassList = element.classList;
if (!buttonClassList.contains(classes.BTN)) {
buttonClassList.add(classes.BTN);
}
self._setStyle(element);
self._setInline(element);
self._setIconpos(element);
self._setIcon(element);
self._setSize(element);
self._setDisabled(element);
return element;
};
/**
* Refresh structure
* @method _refresh
* @protected
* @member ns.widget.core.Button
*/
prototype._refresh = function () {
var self = this,
element = this.element;
self._setStyle(element);
self._setInline(element);
self._setIconpos(element);
self._setIcon(element);
self._setSize(element);
self._setDisabled(element);
return null;
};
/**
* Get value of button
* @method _getValue
* @protected
* @member ns.widget.core.Button
*/
prototype._getValue = function () {
return this.element.textContent;
};
/**
* Set size of button
* @method _setSize
* @param {HTMLElement} element
* @param {string|number} value
* @protected
* @member ns.widget.core.Button
*/
prototype._setSize = function (element, value) {
var style = element.style,
options = this.options,
size = parseInt(value || options.size, 10);
if (size < 32) {
size = 32;
}
if (size > 230) {
size = 230;
}
style.height = size + "px";
style.width = size + "px";
};
/**
* Set value of button
* @method _setValue
* @param {string} value
* @protected
* @member ns.widget.core.Button
*/
prototype._setValue = function (value) {
this.element.textContent = value;
};
/**
* Enable button
* @method _enable
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Button
*/
prototype._enable = function (element) {
var self = this,
options = self.options;
if (element) {
if (element.tagName.toLowerCase() === "button") {
element.disabled = false;
}
if (!this.isCustomElement) {
element.removeAttribute("disabled");
}
element.classList.remove(classes.DISABLED);
options.disabled = false;
}
};
/**
* Disable button
* @method _disable
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Button
*/
prototype._disable = function (element) {
var options = this.options;
if (element) {
if (element.tagName.toLowerCase() === "button") {
element.disabled = true;
}
if (!this.isCustomElement) {
element.setAttribute("disabled", "disabled");
}
element.classList.add(classes.DISABLED);
options.disabled = true;
}
};
ns.widget.core.Button = Button;
engine.defineWidget(
"Button",
"button, [data-role='button'], .ui-btn, input[type='button']",
[],
Button,
"core"
);
engine.defineWidget(
"inputButton",
"",
[],
Button,
"core",
false,
false,
HTMLInputElement
);
engine.defineWidget(
"formButton",
"",
[],
Button,
"core",
false,
false,
HTMLButtonElement
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Checkbox
* Checkbox component changes the default browser checkboxes to a form more adapted to the mobile
* environment.
*
* @since 2.4
* @class ns.widget.core.Checkbox
* @extends ns.widget.BaseWidget
*/
/*jslint nomen: true, plusplus: true */
/**
* #Checkbox
*
* ## HTML examples
*
* ### Basic use
* @example template
* <input type="checkbox"/>
*
* ### Checkbox with label
* @example tau-checkbox
* <input type="checkbox" name="${5:mycheck}" id="${3:check-test}" checked="${2:checked}"/>\n<label for="${4:check-test}">${1:Checkbox}</label>
*
* @class ns.widget.core.Checkbox
* @component-selector input[type="checkbox"]:not(.ui-slider-switch-input):not([data-role="toggleswitch"]):not(.ui-toggleswitch):not(.ui-switch-input), input.ui-checkbox
* @component-type standalone-component
* @component-attachable true
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
Checkbox = function () {
this.element = null;
},
classes = {
checkbox: "ui-checkbox"
},
prototype = new BaseWidget();
Checkbox.prototype = prototype;
/**
* Build Checkbox widget
* @method _build
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Checkbox
* @instance
*/
prototype._build = function (element) {
if (element.getAttribute("type") === "checkbox") {
element.classList.add(classes.checkbox);
}
return element;
};
/**
* Returns the value of checkbox
* @method _getValue
* @member ns.widget.core.Checkbox
* @return {?string}
* @protected
*/
prototype._getValue = function () {
return this.element.value;
};
/**
* Set value to the checkbox
* @method _setValue
* @param {string} value
* @member ns.widget.core.Checkbox
* @return {ns.widget.core.Checkbox}
* @protected
*/
prototype._setValue = function (value) {
this.element.value = value;
};
// definition
ns.widget.core.Checkbox = Checkbox;
engine.defineWidget(
"Checkbox",
"input[type='checkbox']:not(.ui-slider-switch-input):not([data-role='toggleswitch'])" +
":not(.ui-toggleswitch):not(.ui-toggle-switch), input.ui-checkbox",
[],
Checkbox,
"core",
false,
false,
HTMLInputElement
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Radio
*
* @example template tau-radio
* <input type="radio"/>
*
* @class ns.widget.core.Radio
* @component-selector input[type=radio]
* @component-type standalone-component
* @since 2.4
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
Radio = function () {
this.element = null;
},
classes = {
radio: "ui-radio"
},
prototype = new BaseWidget();
Radio.prototype = prototype;
/**
* Build Radio widget
* @method _build
* @param {HTMLElement} element
* @protected
* @member ns.widget.Radio
* @instance
*/
prototype._build = function (element) {
if (element.getAttribute("type") === "radio") {
element.classList.add(classes.radio);
}
return element;
};
/**
* Returns the value of radio
* @method _getValue
* @member ns.widget.Radio
* @return {?string}
* @protected
*/
prototype._getValue = function () {
return this.element.value;
};
/**
* Set value to the radio
* @method _setValue
* @param {string} value
* @member ns.widget.Radio
* @return {ns.widget.Radio}
* @protected
*/
prototype._setValue = function (value) {
this.element.value = value;
};
// definition
ns.widget.core.Radio = Radio;
engine.defineWidget(
"Radio",
"input[type='radio'], input.ui-radio",
[],
Radio,
"core",
false,
false,
HTMLInputElement
);
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global window, define */
/* eslint-disable no-console */
/**
* #Core namespace
* Object contains main framework methods.
* @class ns
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function (document, console) {
"use strict";
var idNumberCounter = 0,
currentDate = +new Date(),
slice = [].slice,
rootNamespace = "",
fileName = "",
infoForLog = function (args) {
var dateNow = new Date();
args.unshift("[" + rootNamespace + "][" + dateNow.toLocaleString() + "]");
},
ns = window.ns || window.tau || {},
nsConfig = window.nsConfig || window.tauConfig || {};
ns.info = ns.info || {
profile: "custom"
};
ns.tauPerf = ns.tauPerf || {};
window.ns = ns;
window.nsConfig = nsConfig;
window.tau = ns;
window.tauConfig = nsConfig;
rootNamespace = nsConfig.rootNamespace;
fileName = nsConfig.fileName;
/**
* Return unique id
* @method getUniqueId
* @static
* @return {string}
* @member ns
*/
ns.getUniqueId = function () {
return rootNamespace + "-" + ns.getNumberUniqueId() + "-" + currentDate;
};
/**
* Return unique id
* @method getNumberUniqueId
* @static
* @return {number}
* @member ns
*/
ns.getNumberUniqueId = function () {
return idNumberCounter++;
};
/**
* logs supplied messages/arguments
* @method log
* @static
* @member ns
*/
ns.log = function () {
var args = slice.call(arguments);
infoForLog(args);
if (console) {
console.log.apply(console, args);
}
};
/**
* logs supplied messages/arguments ad marks it as warning
* @method warn
* @static
* @member ns
*/
ns.warn = function () {
var args = slice.call(arguments);
infoForLog(args);
if (console) {
console.warn.apply(console, args);
}
};
/**
* logs supplied messages/arguments and marks it as error
* @method error
* @static
* @member ns
*/
ns.error = function () {
var args = slice.call(arguments);
infoForLog(args);
if (console) {
console.error.apply(console, args);
}
};
/**
* get from nsConfig
* @method getConfig
* @param {string} key
* @param {*} [defaultValue] value returned when config is not set
* @return {*}
* @static
* @member ns
*/
ns.getConfig = function (key, defaultValue) {
return nsConfig[key] === undefined ? defaultValue : nsConfig[key];
};
/**
* set in nsConfig
* @method setConfig
* @param {string} key
* @param {*} value
* @param {boolean} [asDefault=false] value should be treated as default (doesn't overwrites
* the config[key] if it already exists)
* @static
* @member ns
*/
ns.setConfig = function (key, value, asDefault) {
if (!asDefault || nsConfig[key] === undefined) {
nsConfig[key] = value;
}
};
/**
* Return path for framework script file.
* @method getFrameworkPath
* @return {?string}
* @member ns
*/
ns.getFrameworkPath = function () {
var scripts = document.getElementsByTagName("script"),
countScripts = scripts.length,
i,
url,
arrayUrl,
count;
for (i = 0; i < countScripts; i++) {
url = scripts[i].src;
arrayUrl = url.split("/");
count = arrayUrl.length;
if (arrayUrl[count - 1] === fileName + ".js" ||
arrayUrl[count - 1] === fileName + ".min.js") {
return arrayUrl.slice(0, count - 1).join("/");
}
}
return null;
};
}(window.document, window.console));
/*global window, ns, define, XMLHttpRequest, console, Blob */
/*jslint nomen: true, browser: true, plusplus: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Utilities
*
* The Tizen Advanced UI (TAU) framework provides utilities for easy-developing
* and fully replaceable with jQuery method. When user using these DOM and
* selector methods, it provide more light logic and it proves performance
* of web app. The following table displays the utilities provided by the
* TAU framework.
*
* @class ns.util
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var currentFrame = null,
util = ns.util || {},
// frames callbacks which should be run in next request animation frame
waitingFrames = [],
slice = [].slice,
// inform that loop was added to request animation frame callback
loopWork = false;
/**
* Function which is use as workaround when any type of request animation frame not exists
* @param {Function} callback
* @method _requestAnimationFrameOnSetTimeout
* @static
* @member ns.util
* @protected
*/
util._requestAnimationFrameOnSetTimeout = function (callback) {
currentFrame = window.setTimeout(callback.bind(callback, +new Date()), 1000 / 60);
};
/**
* Function which support every request animation frame.
* @method _loop
* @protected
* @static
* @member ns.util
*/
util._loop = function () {
var loopWaitingFrames = slice.call(waitingFrames),
currentFrameFunction = loopWaitingFrames.shift(),
loopTime = performance.now();
waitingFrames = [];
while (currentFrameFunction) {
currentFrameFunction();
if (performance.now() - loopTime < 15) {
currentFrameFunction = loopWaitingFrames.shift();
} else {
currentFrameFunction = null;
}
}
if (loopWaitingFrames.length || waitingFrames.length) {
waitingFrames.unshift.apply(waitingFrames, loopWaitingFrames);
util.windowRequestAnimationFrame(util._loop);
} else {
loopWork = false;
}
};
/**
* Find browser prefixed request animation frame function.
* @method _getRequestAnimationFrame
* @protected
* @static
* @member ns.util
*/
util._getRequestAnimationFrame = function () {
return (window.requestAnimationFrame ||
window.webkitRequestAnimationFrame ||
window.mozRequestAnimationFrame ||
window.oRequestAnimationFrame ||
window.msRequestAnimationFrame ||
util._requestAnimationFrameOnSetTimeout).bind(window);
};
/**
* Original requestAnimationFrame from object window.
* @method windowRequestAnimationFrame
* @static
* @member ns.util
*/
util.windowRequestAnimationFrame = util._getRequestAnimationFrame();
/**
* Special requestAnimationFrame function which add functions to queue of callbacks
* @method requestAnimationFrame
* @static
* @member ns.util
*/
util.requestAnimationFrame = function (callback) {
waitingFrames.push(callback);
if (!loopWork) {
util.windowRequestAnimationFrame(util._loop);
loopWork = true;
}
};
util._cancelAnimationFrameOnSetTimeout = function () {
// probably wont work if there is any more than 1
// active animationFrame but we are trying anyway
window.clearTimeout(currentFrame);
};
util._getCancelAnimationFrame = function () {
return (window.cancelAnimationFrame ||
window.webkitCancelAnimationFrame ||
window.mozCancelAnimationFrame ||
window.oCancelAnimationFrame ||
window.msCancelAnimationFrame ||
util._cancelAnimationFrameOnSetTimeout).bind(window);
};
util.cancelAnimationFrame = util._getCancelAnimationFrame();
/**
* fetchSync retrieves a text document synchronously, returns null on error
* @param {string} url
* @param {=string} [mime=""] Mime type of the resource
* @return {string|null}
* @static
* @member ns.util
*/
function fetchSync(url, mime) {
var xhr = new XMLHttpRequest(),
status;
xhr.open("get", url, false);
if (mime) {
xhr.overrideMimeType(mime);
}
xhr.send();
if (xhr.readyState === 4) {
status = xhr.status;
if (status === 200 || (status === 0 && xhr.responseText)) {
return xhr.responseText;
}
}
return null;
}
util.fetchSync = fetchSync;
/**
* Removes all script tags with src attribute from document and returns them
* @param {HTMLElement} container
* @return {Array.<HTMLElement>}
* @protected
* @static
* @member ns.util
*/
function removeExternalScripts(container) {
var scripts = slice.call(container.querySelectorAll("script[src]")),
i = scripts.length,
script;
while (--i >= 0) {
script = scripts[i];
script.parentNode.removeChild(script);
}
return scripts;
}
util._removeExternalScripts = removeExternalScripts;
/**
* Evaluates code, reason for a function is for an atomic call to evaluate code
* since most browsers fail to optimize functions with try-catch blocks, so this
* minimizes the effect, returns the function to run
* @param {string} code
* @return {Function}
* @static
* @member ns.util
*/
function safeEvalWrap(code) {
return function () {
try {
window.eval(code);
} catch (e) {
if (e.stack) {
ns.error(e.stack);
} else if (e.name && e.message) {
ns.error(e.name, e.message);
} else {
ns.error(e);
}
}
};
}
util.safeEvalWrap = safeEvalWrap;
/**
* Calls functions in supplied queue (array)
* @param {Array.<Function>} functionQueue
* @static
* @member ns.util
*/
function batchCall(functionQueue) {
var i,
length = functionQueue.length;
for (i = 0; i < length; ++i) {
functionQueue[i]();
}
}
util.batchCall = batchCall;
/**
* Creates new script elements for scripts gathered from a different document
* instance, blocks asynchronous evaluation (by renaming src attribute) and
* returns an array of functions to run to evaluate those scripts
* @param {Array.<HTMLElement>} scripts
* @param {HTMLElement} container
* @return {Array.<Function>}
* @protected
* @static
* @member ns.util
*/
function createScriptsSync(scripts, container) {
var scriptElement,
scriptBody,
i,
length,
queue = [];
// proper order of execution
for (i = 0, length = scripts.length; i < length; ++i) {
scriptBody = util.fetchSync(scripts[i].src, "text/plain");
if (scriptBody) {
scriptElement = document.adoptNode(scripts[i]);
scriptElement.setAttribute("data-src", scripts[i].src);
scriptElement.removeAttribute("src"); // block evaluation
queue.push(util.safeEvalWrap(scriptBody));
if (container) {
container.appendChild(scriptElement);
}
}
}
return queue;
}
util._createScriptsSync = createScriptsSync;
/**
* Method make asynchronous call of function
* @method async
* @inheritdoc #requestAnimationFrame
* @member ns.util
* @static
*/
util.async = util.requestAnimationFrame;
/**
* Appends element from different document instance to current document in the
* container element and evaluates scripts (synchronously)
* @param {HTMLElement} element
* @param {HTMLElement} container
* @return {HTMLElement}
* @method importEvaluateAndAppendElement
* @member ns.util
* @static
*/
util.importEvaluateAndAppendElement = function (element, container) {
var externalScriptsQueue =
util._createScriptsSync(util._removeExternalScripts(element), element),
newNode = document.importNode(element, true);
container.appendChild(newNode); // append and eval inline
util.batchCall(externalScriptsQueue);
return newNode;
};
/**
* Checks if specified string is a number or not
* @method isNumber
* @param {string} query
* @return {boolean}
* @member ns.util
* @static
*/
util.isNumber = function (query) {
var parsed = parseFloat(query);
return !isNaN(parsed) && isFinite(parsed);
};
/**
* Reappear script tags to DOM structure to correct run script
* @method runScript
* @param {string} baseUrl
* @param {HTMLScriptElement} script
* @member ns.util
* @deprecated 2.3
*/
util.runScript = function (baseUrl, script) {
var newScript = document.createElement("script"),
scriptData,
i,
scriptAttributes = slice.call(script.attributes),
src = script.getAttribute("src"),
attribute,
status;
// 'src' may become null when none src attribute is set
if (src !== null) {
src = util.path.makeUrlAbsolute(src, baseUrl);
}
//Copy script tag attributes
i = scriptAttributes.length;
while (--i >= 0) {
attribute = scriptAttributes[i];
if (attribute.name !== "src") {
newScript.setAttribute(attribute.name, attribute.value);
} else {
newScript.setAttribute("data-src", attribute.value);
}
}
if (src) {
scriptData = util.fetchSync(src, "text/plain");
} else {
scriptData = script.textContent;
}
if (scriptData) {
// add the returned content to a newly created script tag
newScript.src = window.URL.createObjectURL(new Blob([scriptData], {type: "text/javascript"}));
newScript.textContent = scriptData; // for compatibility with some libs ex. template systems
}
script.parentNode.replaceChild(newScript, script);
};
ns.util = util;
}(window, window.document, ns));
/*global define*/
(function () {
"use strict";
/*eslint-disable*/
/**
* BezierEasing - use bezier curve for transition easing function
* by Gaëtan Renaudeau 2014 - 2015 MIT License
*
* Credits: is based on Firefox's nsSMILKeySpline.cpp
* Usage:
* var spline = BezierEasing([ 0.25, 0.1, 0.25, 1.0 ])
* spline.get(x) => returns the easing value | x must be in [0, 1] range
*
* @class utils.BezierCurve
*/
// These values are established by empiricism with tests (tradeoff: performance VS precision)
var NEWTON_ITERATIONS = 4;
var NEWTON_MIN_SLOPE = 0.001;
var SUBDIVISION_PRECISION = 0.0000001;
var SUBDIVISION_MAX_ITERATIONS = 10;
var kSplineTableSize = 11;
var kSampleStepSize = 1.0 / (kSplineTableSize - 1.0);
var float32ArraySupported = typeof Float32Array === "function";
/**
*
* @param aA1
* @param aA2
* @returns {number}
*/
function a (aA1, aA2) {
return 1.0 - 3.0 * aA2 + 3.0 * aA1;
}
/**
*
* @param aA1
* @param aA2
* @returns {number}
*/
function b (aA1, aA2) {
return 3.0 * aA2 - 6.0 * aA1;
}
/**
*
* @param aA1
* @returns {number}
*/
function c (aA1) {
return 3.0 * aA1;
}
/**
* Returns x(t) given t, x1, and x2, or y(t) given t, y1, and y2.
* @param aT
* @param aA1
* @param aA2
* @returns {number}
*/
function calcBezier (aT, aA1, aA2) {
return ((a(aA1, aA2)*aT + b(aA1, aA2))*aT + c(aA1))*aT;
}
/**
* Returns dx/dt given t, x1, and x2, or dy/dt given t, y1, and y2.
* @param aT
* @param aA1
* @param aA2
* @returns {*}
*/
function getSlope (aT, aA1, aA2) {
return 3.0 * a(aA1, aA2)*aT*aT + 2.0 * b(aA1, aA2) * aT + c(aA1);
}
/**
*
* @param aX
* @param aA
* @param aB
* @param mX1
* @param mX2
* @returns {*}
*/
function binarySubdivide (aX, aA, aB, mX1, mX2) {
var currentX, currentT, i = 0;
do {
currentT = aA + (aB - aA) / 2.0;
currentX = calcBezier(currentT, mX1, mX2) - aX;
if (currentX > 0.0) {
aB = currentT;
} else {
aA = currentT;
}
} while (Math.abs(currentX) > SUBDIVISION_PRECISION && ++i < SUBDIVISION_MAX_ITERATIONS);
return currentT;
}
/**
*
* @param aX
* @param aGuessT
* @param mX1
* @param mX2
* @returns {*}
*/
function newtonRaphsonIterate (aX, aGuessT, mX1, mX2) {
for (var i = 0; i < NEWTON_ITERATIONS; ++i) {
var currentSlope = getSlope(aGuessT, mX1, mX2);
if (currentSlope === 0.0) {
return aGuessT;
}
var currentX = calcBezier(aGuessT, mX1, mX2) - aX;
aGuessT -= currentX / currentSlope;
}
return aGuessT;
}
function validateArguments(points) {
if (!points || points.length !== 4) {
throw new Error("BezierEasing: points must contains 4 values");
}
for (var i = 0; i < 4; ++i) {
if (typeof points[i] !== "number" || isNaN(points[i]) || !isFinite(points[i])) {
throw new Error("BezierEasing: points should be integers.");
}
}
if (points[0] < 0 || points[0] > 1 || points[2] < 0 || points[2] > 1) {
throw new Error("BezierEasing x values must be in [0, 1] range.");
}
}
/**
* points is an array of [ mX1, mY1, mX2, mY2 ]
* @param points
* @param _b
* @param _c
* @param _d
* @returns {BezierEasing}
* @constructor
*/
function BezierEasing (points, _b, _c, _d) {
if (arguments.length === 4) {
return new BezierEasing([points, _b, _c, _d]);
}
if (!(this instanceof BezierEasing)) {
return new BezierEasing(points);
}
validateArguments(points);
this._str = "BezierEasing(" + points + ")";
this._css = "cubic-bezier(" + points + ")";
this._p = points;
this._mSampleValues = float32ArraySupported ? new Float32Array(kSplineTableSize) : [];
this._precomputed = false;
this.get = this.get.bind(this);
return this;
}
BezierEasing.prototype = {
/**
*
* @param x
* @returns {*}
*/
get: function (x) {
var mX1 = this._p[0],
mY1 = this._p[1],
mX2 = this._p[2],
mY2 = this._p[3];
if (!this._precomputed) {
this._precompute();
}
if (mX1 === mY1 && mX2 === mY2) {
return x;
} // linear
// Because JavaScript number are imprecise, we should guarantee the extremes are right.
if (x <= 0) {
return 0;
}
if (x >= 1) {
return 1;
}
return calcBezier(this._getTForX(x), mY1, mY2);
},
/**
*
* @private
*/
_precompute: function () {
var mX1 = this._p[0],
mY1 = this._p[1],
mX2 = this._p[2],
mY2 = this._p[3];
this._precomputed = true;
if (mX1 !== mY1 || mX2 !== mY2) {
this._calcSampleValues();
}
},
/**
*
* @private
*/
_calcSampleValues: function () {
var mX1 = this._p[0],
mX2 = this._p[2];
for (var i = 0; i < kSplineTableSize; ++i) {
this._mSampleValues[i] = calcBezier(i * kSampleStepSize, mX1, mX2);
}
},
/**
* getTForX chose the fastest heuristic to determine the percentage value precisely from a
* given X projection.
* @param aX
* @returns {*}
* @private
*/
_getTForX: function (aX) {
var mX1 = this._p[0],
mX2 = this._p[2],
mSampleValues = this._mSampleValues;
var intervalStart = 0.0;
var currentSample = 1;
var lastSample = kSplineTableSize - 1;
for (; currentSample !== lastSample && mSampleValues[currentSample] <= aX;
++currentSample) {
intervalStart += kSampleStepSize;
}
--currentSample;
// Interpolate to provide an initial guess for t
var dist = (aX - mSampleValues[currentSample]) / (mSampleValues[currentSample+1] -
mSampleValues[currentSample]);
var guessForT = intervalStart + dist * kSampleStepSize;
var initialSlope = getSlope(guessForT, mX1, mX2);
if (initialSlope >= NEWTON_MIN_SLOPE) {
return newtonRaphsonIterate(aX, guessForT, mX1, mX2);
} else if (initialSlope === 0.0) {
return guessForT;
} else {
return binarySubdivide(aX, intervalStart, intervalStart + kSampleStepSize, mX1, mX2);
}
}
};
// CSS mapping
BezierEasing.css = {
ease: BezierEasing.ease = new BezierEasing(0.25, 0.1, 0.25, 1.0),
easeIn: BezierEasing.easeIn = new BezierEasing(0.42, 0.0, 1.00, 1.0),
easeOut: BezierEasing.easeOut = new BezierEasing(0.00, 0.0, 0.58, 1.0),
easeInOut: BezierEasing.easeInOut = new BezierEasing(0.42, 0.0, 0.58, 1.0)
};
if (ns && ns.util) {
ns.util.bezierCurve = BezierEasing;
}
}());
/* global requestAnimationFrame, define, ns */
/**
* Main file of applications, which connect other parts
*/
// then we can load plugins for libraries and application
(function (window, document, ns) {
"use strict";
var utils = ns.util,
requestAnimationFrame = utils.requestAnimationFrame,
/**
* Util to change value of object property in given time
* @class Animation
*/
Animate = function (object) {
var self = this;
self._object = object;
self._animate = {
chain: [],
chainIndex: 0
};
// This is used to keep track of elapsed time of paused animation
self._pausedTimeDiff = null;
self._animateConfig = null;
},
linear = function (x, a, b) {
a = (a === undefined) ? 1 : a;
b = (b === undefined) ? 0 : b;
return x * (a || 0) + (b || 0);
},
inverseTiming = function (x) {
return 1 - x;
},
prototype = {};
utils.bezierCurve = utils.bezierCurve || bezierCurve;
Animate.prototype = prototype;
Animate.timing = {
linear: linear,
ease: utils.bezierCurve.ease.get,
easeInOut: utils.bezierCurve.easeInOut.get
};
function firstDefined() {
var args = [].slice.call(arguments),
i = 0,
length = args.length,
arg;
for (; i < length; i++) {
arg = args[i];
if (arg !== undefined) {
return arg;
}
}
return null;
}
prototype.destroy = function () {
var self = this;
self._object = null;
self._animate = null;
self._animateConfig = null;
};
function calculateSteps(option, currentPoint) {
var percent,
step,
steps = option.steps,
from = option.from,
to = null,
percentStart = 0,
percentStop = 100,
floatPoint;
for (percent in steps) {
if (steps.hasOwnProperty(percent)) {
step = steps[percent];
floatPoint = percent / 100;
if (currentPoint >= floatPoint) {
from = step;
percentStart = floatPoint;
} else if (to === null) {
to = step;
percentStop = floatPoint;
}
}
}
return from + (currentPoint - percentStart) / (percentStop - percentStart) *
(to - from);
}
function eachOption(config, animateConfig, option) {
var propertyObject,
from,
steps = option.steps || config.steps;
option.duration = firstDefined(option.duration, config.duration);
option.delay = firstDefined(option.delay, config.delay, 0);
propertyObject = firstDefined(option.object, this._object);
option.simpleProperty = option.property;
option.property.split(".").forEach(function (property) {
if (typeof propertyObject[property] === "object" && propertyObject[property] !== null) {
propertyObject = propertyObject[property];
option.propertyObject = propertyObject;
} else {
option.simpleProperty = property;
}
});
option.propertyObject = propertyObject;
if (steps) {
option.calculate = calculateSteps.bind(null, option);
steps[0] = firstDefined(steps[0], option.from, propertyObject[option.simpleProperty]);
option.from = steps["0"];
option.to = firstDefined(steps["100"], option.to);
option.diff = 0;
option.current = steps[0];
option.direction = option.from < option.to ? 1 : -1;
} else {
option.calculate = option.calculate || linear;
from = firstDefined(option.from, propertyObject[option.simpleProperty]);
option.from = from;
option.diff = (option.to - from);
option.current = from;
option.direction = from < option.to ? 1 : -1;
}
// calculate value change in full time
option.startTime = Date.now() + option.delay;
if (this._pausedTimeDiff) {
option.startTime = Date.now() - this._pausedTimeDiff;
this._pausedTimeDiff = 0;
}
// save last time of recalculate options
option.lastCalculationTime = option.startTime;
// set timing function
option.timing = firstDefined(option.timing, config.timing, linear);
animateConfig.push(option);
}
prototype._initAnimate = function () {
var self = this,
animateConfig = [],
options = self._animate.chain[self._animate.chainIndex++];
if (options) {
options.forEach(eachOption.bind(self, self._config, animateConfig));
self._animateConfig = animateConfig;
} else {
self._animateConfig = null;
}
};
function animateLoopCallback(self, copiedArgs) {
if (self._animate) {
self._animate.chain = [].slice.call(copiedArgs);
self.start();
}
}
function animateRevertCallback(self, copiedArgs) {
var chain = [].slice.call(copiedArgs),
newChain = [];
chain.forEach(function (options) {
newChain.unshift(options);
options.forEach(function (option) {
option.timing = inverseTiming;
});
});
self._animate.chain = newChain;
self._animate.callback = null;
self.start();
}
/**
* Set animate
* @param {Object...} options list of animations configs
* @return {Animate}
*/
prototype.set = function (options) {
var self = this,
config,
// converts arguments to array
args = [].slice.call(arguments),
copiedArgs;
// we get last argument
config = args.pop();
if (!Array.isArray(config)) {
// if last arguments is object then we use it as global animation config
self._animate.config = config;
} else {
// otherwise this is description of one animation loop and back to args array
args.push(config);
config = null;
}
self._config = config;
// copy array to be sure that we have new reference objects
copiedArgs = [].slice.call(args);
if (config) {
if (config.loop) {
// when animation is in loop then we create callback on animation and to restart animation
self._animate.callback = animateLoopCallback.bind(null, self, copiedArgs);
} else if (config.withRevert) {
self._animate.callback = animateRevertCallback.bind(null, self, copiedArgs);
} else {
// otherwise we use callback from options
self._animate.callback = options.callback || config.callback;
}
}
// cache options in object
self._animate.chain = args;
return self;
};
/**
* Start animation
* @param {Function} [callback] function called after finish animation
*/
prototype.start = function (callback) {
var self = this;
// init animate options
self._initAnimate();
// setting callback function
callback = self._animate.callback || callback;
if (self._animate.chainIndex < self._animate.chain.length) {
// if we have many animations in chain that we set callback
// to start next animation from chain after finish current
// animation
self._animationTimeout = self._calculateAnimate.bind(self, self.start.bind(self, callback));
} else {
self._animationTimeout = self._calculateAnimate.bind(self, callback);
}
self._calculateAnimate(callback);
return self;
};
/**
* Stop animations
*/
prototype.stop = function () {
var self = this;
// reset index of animations chain
self._animate.chainIndex = 0;
// reset current animation config
self._animateConfig = null;
// clear timeout
self._animationTimeout = null;
return self;
};
prototype.pause = function () {
var self = this;
if (self._animateConfig) {
self._pausedTimeDiff = Date.now() - self._animateConfig[0].startTime;
self.stop();
}
};
function calculateOption(option, time) {
var timeDiff,
current;
if (option && option.startTime < time) {
// if option is not delayed
timeDiff = time - option.startTime;
if (timeDiff >= option.duration) {
// if current is bigger then end we finish loop and we take next animate from chain
timeDiff = option.duration;
if (option.callback) {
option.callback();
}
}
current = option.calculate(option.timing(timeDiff / option.duration),
option.diff, option.from, option.current);
if (current !== null) {
option.current = current;
// we set next calculation time
option.propertyObject[option.simpleProperty] = option.current;
if (timeDiff >= option.duration) {
// inform about remove animation config
return 2;
}
// inform widget about redraw
return 1;
}
if (timeDiff >= option.duration) {
// inform about remove animation config
return 2;
}
}
return 0;
}
/**
* Method called in loop to calculate current state of animation
* @param {Function} callback
* @private
*/
prototype._calculateAnimate = function (callback) {
var self = this,
// current animation config
animateConfig = self._animateConfig,
// number of animations which is not finished
notFinishedAnimationsCount,
// flag inform that redraw is necessary
redraw = false,
i = 0,
length,
time = Date.now(),
calculatedOption;
if (animateConfig) {
notFinishedAnimationsCount = animateConfig.length;
length = animateConfig.length;
// calculating options changed in animation
while (i < length) {
calculatedOption = calculateOption(animateConfig[i], time);
if (calculatedOption === 2) {
notFinishedAnimationsCount--;
// remove current config and recalculate loop arguments
animateConfig.splice(i, 1);
length--;
i--;
redraw = true;
} else if (calculatedOption === 1) {
redraw = true;
}
i++;
}
// redraw is necessary
if (redraw && self._tickFunction) {
self._tickFunction(self._object);
}
if (notFinishedAnimationsCount) {
// setting next loop state
if (self._animationTimeout) {
requestAnimationFrame(self._animationTimeout);
}
} else {
// Animation state can be change to "stopped"
self.stop();
// animation is finished
if (callback) {
callback();
}
}
}
};
/**
* Set function which will be called after animation change property of object
* @param {Function} tickFunction
* @return {Animation}
*/
prototype.tick = function (tickFunction) {
var oldTickFunction = this._tickFunction;
if (oldTickFunction) {
this._tickFunction = function (object) {
oldTickFunction(object);
tickFunction(object);
};
} else {
this._tickFunction = tickFunction;
}
return this;
};
utils.Animate = Animate;
}(window, window.document, ns));
/*global window, define, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Marquee
* Shows a component which moves left and right.
*
* It makes <div> element with text move horizontally like legacy <marquee> tag
*
* ## Make Marquee Element
* If you want to use Marquee widget, you have to declare below attributes in <div> element and make
* Marquee widget in JS code.
* To use a Marquee widget in your application, use the following code:
*
* @example
* <div class="ui-content">
* <ul class="ui-listview">
* <li><div class="ui-marquee" id="marquee">Marquee widget code sample</div></li>
* </ul>
* </div>
* <script>
* var marqueeEl = document.getElementById("marquee"),
* marqueeWidget = new tau.widget.Marquee(marqueeEl,
* {marqueeStyle: "scroll", delay: "3000"});
* </script>
*
* @author Heeju Joo <heeju.joo@samsung.com>
* @class ns.widget.core.Marquee
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
/**
* Alias for class ns.engine
* @property {ns.engine} engine
* @member ns.widget.core.Marquee
* @private
*/
engine = ns.engine,
/**
* Alias for class ns.util.object
* @property {Object} objectUtils
* @member ns.widget.core.Marquee
* @private
*/
objectUtils = ns.util.object,
Animation = ns.util.Animate,
states = {
RUNNING: "running",
STOPPED: "stopped",
IDLE: "idle"
},
Marquee = function () {
this.options = objectUtils.copy(Marquee.defaults);
// event callbacks
this._callbacks = {};
},
prototype = new BaseWidget(),
CLASSES_PREFIX = "ui-marquee",
eventType = {
/**
* Triggered when the marquee animation end.
* @event marqueeend
* @member ns.widget.core.Marquee
*/
MARQUEE_START: "marqueestart",
MARQUEE_END: "marqueeend",
MARQUEE_STOPPED: "marqueestopped"
},
/**
* Dictionary for CSS class of marquee play state
* @property {Object} classes
* @member ns.widget.core.Marquee
* @static
*/
classes = {
MARQUEE_CONTENT: CLASSES_PREFIX + "-content",
MARQUEE_GRADIENT: CLASSES_PREFIX + "-gradient",
MARQUEE_ELLIPSIS: CLASSES_PREFIX + "-ellipsis",
ANIMATION_RUNNING: CLASSES_PREFIX + "-anim-running",
ANIMATION_STOPPED: CLASSES_PREFIX + "-anim-stopped",
ANIMATION_IDLE: CLASSES_PREFIX + "-anim-idle"
},
/**
* Dictionary for marquee style
*/
style = {
SCROLL: "scroll",
SLIDE: "slide",
ALTERNATE: "alternate",
ENDTOEND: "endToEnd"
},
ellipsisEffect = {
GRADIENT: "gradient",
ELLIPSIS: "ellipsis",
NONE: "none"
},
round100 = function (value) {
return Math.round(value * 100) / 100;
},
/**
* Options for widget
* @property {Object} options
* @property {string|"slide"|"scroll"|"alternate"} [options.marqueeStyle="slide"] Sets the
* default style for the marquee
* @property {number} [options.speed=60] Sets the speed(px/sec) for the marquee
* @property {number|"infinite"} [options.iteration=1] Sets the iteration count number for
* marquee
* @property {number} [options.delay=2000] Sets the delay(ms) for marquee
* @property {"linear"|"ease"|"ease-in"|"ease-out"|"cubic-bezier(n,n,n,n)"}
* [options.timingFunction="linear"] Sets the timing function for marquee
* @property {"gradient"|"ellipsis"|"none"} [options.ellipsisEffect="gradient"] Sets the
* end-effect(gradient) of marquee
* @property {boolean} [options.autoRun=true] Sets the status of autoRun
* @member ns.widget.core.Marquee
* @static
*/
defaults = {
marqueeStyle: style.SLIDE,
speed: 60,
iteration: 1,
currentIteration: 1,
delay: 0,
timingFunction: "linear",
ellipsisEffect: ellipsisEffect.GRADIENT,
runOnlyOnEllipsisText: true,
animation: states.STOPPED,
autoRun: true
},
GRADIENTS = {
LEFT: "-webkit-linear-gradient(left, transparent 0, rgb(255, 255, 255) 15%," +
" rgb(255, 255, 255) 100%)",
BOTH: "-webkit-linear-gradient(left, transparent 0, rgb(255, 255, 255)" +
" 15%, rgb(255, 255, 255) 85%, transparent 100%",
RIGHT: "-webkit-linear-gradient(left, rgb(255, 255, 255) 0, rgb(255," +
" 255, 255) 85%, transparent 100%)"
};
Marquee.classes = classes;
Marquee.defaults = defaults;
prototype._calculateTranslateFunctions = {
scroll: function (self, state, diff, from, current) {
var value = from + state * diff,
returnValue;
returnValue = "translateX(-" + round100(value) + "px)";
if (current === returnValue) {
return null;
}
return returnValue;
},
slide: function (self, state, diff, from, current) {
var stateDOM = self._stateDOM,
containerWidth = stateDOM.offsetWidth,
textWidth = stateDOM.children[0].offsetWidth,
value,
returnValue;
value = state * (textWidth - containerWidth);
returnValue = "translateX(-" + round100(value) + "px)";
if (current === returnValue) {
return null;
}
return returnValue;
},
alternate: function (self, state, diff, from, current) {
var stateDOM = self._stateDOM,
containerWidth = stateDOM.offsetWidth,
textWidth = stateDOM.children[0].offsetWidth,
value = from + state * diff,
returnValue;
if (value > textWidth / 2) {
value = textWidth - (value - textWidth / 2) * 2;
} else {
value *= 2;
}
value = value / textWidth * (textWidth - containerWidth);
returnValue = "translateX(-" + round100(value) + "px)";
if (current === returnValue) {
return null;
}
return returnValue;
},
endToEnd: function (self, state, diff, from, current) {
var stateDOM = self._stateDOM,
textWidth = stateDOM.children[0].offsetWidth,
containerWidth = stateDOM.offsetWidth,
value,
returnValue;
value = state * (textWidth + containerWidth);
if (value > textWidth) {
value = containerWidth - value + textWidth;
} else {
value = -value;
}
returnValue = "translateX(" + round100(value) + "px)";
if (current === returnValue) {
return null;
}
return returnValue;
}
};
prototype._calculateEndToEndGradient = function (state, diff, from, current) {
var self = this,
stateDOM = self._stateDOM,
textWidth = stateDOM.children[0].offsetWidth,
containerWidth = stateDOM.offsetWidth,
returnTimeFrame = (textWidth / (textWidth + containerWidth)),
returnValue;
if (state > returnTimeFrame) {
returnValue = GRADIENTS.RIGHT;
} else if (state > 0) {
returnValue = GRADIENTS.BOTH;
} else {
returnValue = GRADIENTS.LEFT;
}
if (current === returnValue) {
return null;
}
return returnValue;
};
prototype._calculateStandardGradient = function (state, diff, from, current) {
var returnValue;
if (state === 1) {
returnValue = GRADIENTS.LEFT;
} else if (state > 0) {
returnValue = GRADIENTS.BOTH;
} else {
returnValue = GRADIENTS.RIGHT;
}
if (current === returnValue) {
return null;
}
return returnValue;
};
/**
* Build Marquee DOM
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.core.Marquee
*/
prototype._build = function (element) {
var marqueeInnerElement = element.querySelector("." + classes.MARQUEE_CONTENT);
if (!marqueeInnerElement) {
marqueeInnerElement = document.createElement("div");
while (element.hasChildNodes()) {
marqueeInnerElement.appendChild(element.removeChild(element.firstChild));
}
marqueeInnerElement.classList.add(classes.MARQUEE_CONTENT);
element.appendChild(marqueeInnerElement);
}
return element;
};
prototype._initStateDOMstructure = function () {
this._stateDOM = {
classList: [],
offsetWidth: null,
style: {
webkitMaskImage: null
},
children: [
{
offsetWidth: null,
style: {
webkitTransform: null
}
}
]
};
};
prototype._initAnimation = function () {
var self = this,
stateDOM = self._stateDOM,
stateDOMfirstChild = stateDOM.children[0],
width = stateDOMfirstChild.offsetWidth,
animation = new Animation({}),
state = {
hasEllipsisText: (width > 0),
animation: [{
object: stateDOMfirstChild.style,
property: "webkitTransform",
calculate: self._calculateTranslateFunctions.scroll.bind(null, self),
from: 0,
to: width
}, {
object: stateDOM.style,
calculate: self._calculateStandardGradient.bind(self),
property: "webkitMaskImage",
from: 0,
to: 1
}],
animationConfig: {
duration: width / self.options.speed * 1000,
timing: Animation.timing.linear
}
};
self.state = state;
animation.tick(self._render.bind(self, true));
self._animation = animation;
};
/**
* Init Marquee Style
* @method _init
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.core.Marquee
*/
prototype._init = function (element) {
var self = this;
self._initStateDOMstructure();
self._initDOMstate();
self._initAnimation();
self.option(self.options);
return element;
};
prototype._setEllipsisEffect = function (element, value) {
return this._togglePrefixedClass(this._stateDOM, CLASSES_PREFIX + "-", value);
};
prototype._updateDuration = function () {
var self = this,
stateDOM = self._stateDOM,
state = self.state,
firstChild = stateDOM.children[0],
width = firstChild.offsetWidth,
dWidth = width - stateDOM.offsetWidth,
animationConfig = state.animationConfig;
animationConfig.duration = (dWidth > 0) ?
width / self.options.speed * 1000 :
0;
self._animation.set(state.animation, animationConfig);
};
prototype._setSpeed = function (element, value) {
var self = this;
self.options.speed = parseInt(value, 10);
self._updateDuration();
return false;
};
function animationIterationCallback(self) {
var animation = self._animation,
state = self.state;
if (self.options.currentIteration++ < self.options.iteration) {
animation.set(state.animation, state.animationConfig);
animation.stop();
animation.start();
} else {
self.options.animation = states.STOPPED;
self.trigger(eventType.MARQUEE_END);
}
}
prototype._setIteration = function (element, value) {
var self = this,
state = self.state,
animationConfig = state.animationConfig;
if (value === "infinite") {
animationConfig.loop = true;
animationConfig.callback = function () {
self.options.animation = states.STOPPED;
self.trigger.bind(self, eventType.MARQUEE_END);
};
} else {
value = parseInt(value, 10);
self.options.currentIteration = 1;
animationConfig.loop = false;
animationConfig.callback = animationIterationCallback.bind(null, self);
}
self._animation.set(state.animation, animationConfig);
self.options.loop = value;
return false;
};
prototype._setDelay = function (element, value) {
var self = this,
state = self.state,
animationConfig = state.animationConfig;
value = parseInt(value, 10);
animationConfig.delay = value;
self._animation.set(state.animation, animationConfig);
self.options.delay = value;
return false;
};
prototype._setTimingFunction = function (element, value) {
var self = this,
state = self.state,
animationConfig = state.animationConfig;
animationConfig.timing = Animation.timing[value];
self._animation.set(state.animation, animationConfig);
self.options.timing = value;
return false;
};
prototype._setAutoRun = function (element, value) {
if (value) {
this.start();
}
return false;
};
prototype._setAnimation = function (element, value) {
var self = this,
animation = self._animation,
stateDOM = self._stateDOM,
options = self.options,
width = stateDOM.children[0].offsetWidth - stateDOM.offsetWidth,
runOnlyOnEllipsisText = options.runOnlyOnEllipsisText;
if (value !== options.animation) {
if (value === states.RUNNING) {
if ((runOnlyOnEllipsisText && width) || (!runOnlyOnEllipsisText)) {
self.options.currentIteration = 1;
animation.start();
self.trigger(eventType.MARQUEE_START);
}
} else {
animation.pause();
self.trigger(eventType.MARQUEE_STOPPED);
}
options.animation = value;
}
return false;
};
prototype._setMarqueeStyle = function (element, value) {
var self = this,
animation = self.state.animation;
animation[0].calculate = self._calculateTranslateFunctions[value].bind(null, self);
if (value === "endToEnd") {
animation[1].calculate = self._calculateEndToEndGradient.bind(self);
} else {
animation[1].calculate = self._calculateStandardGradient.bind(self);
}
self.options.marqueeStyle = value;
return false;
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.core.Marquee
*/
prototype._destroy = function () {
var self = this;
self.state = null;
self._stateDOM = null;
self._animation.destroy();
self._animation = null;
};
/**
* Start Marquee animation
*
* #####Running example in pure JavaScript:
*
* @example
* <div class="ui-marquee" id="marquee">
* <p>MarqueeTEST TEST message TEST for marquee</p>
* </div>
* <script>
* var marqueeWidget = tau.widget.Marquee(document.getElementById("marquee"));
* marqueeWidget.start();
* </script>
*
* @method start
* @member ns.widget.core.Marquee
*/
prototype.start = function () {
this.option("animation", "running");
};
/**
* Pause Marquee animation
*
* #####Running example in pure JavaScript:
* @example
* <div class="ui-marquee" id="marquee">
* <p>MarqueeTEST TEST message TEST for marquee</p>
* </div>
* <script>
* var marqueeWidget = tau.widget.Marquee(document.getElementById("marquee"));
* marqueeWidget.stop();
* </script>
*
* @method stop
* @member ns.widget.core.Marquee
*/
prototype.stop = function () {
var self = this,
animation = self._animation;
animation.pause();
this.option("animation", "stopped");
};
/**
* Reset Marquee animation
*
* #####Running example in pure JavaScript:
* @example
* <div class="ui-marquee" id="marquee">
* <p>MarqueeTEST TEST message TEST for marquee</p>
* </div>
* <script>
* var marqueeWidget = tau.widget.Marquee(document.getElementById("marquee"));
* marqueeWidget.reset();
* </script>
*
* @method reset
* @member ns.widget.core.Marquee
*/
prototype.reset = function () {
var self = this,
stateDOM = self._stateDOM;
this.option("animation", "stopped");
stateDOM.style.webkitMaskImage = GRADIENTS.RIGHT;
stateDOM.children[0].style.webkitTransform = "translateX(0)";
self._render();
};
Marquee.prototype = prototype;
ns.widget.core.Marquee = Marquee;
engine.defineWidget(
"Marquee",
".ui-marquee",
["start", "stop", "reset"],
Marquee,
"core"
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (ns) {
"use strict";
ns.widget.core.viewswitcher = ns.widget.core.viewswitcher || {};
}(ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #ViewSwitcher animation namespace
*
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
* @class ns.widget.core.ViewSwitcher.animation
* @internal
*/
(function (window, ns) {
"use strict";
/** @namespace ns.widget.wearable */
ns.widget.core.viewswitcher.animation = ns.widget.core.viewswitcher.animation || {};
}(window, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Animation Interface
* Interface for animation for used viewswitcher
* @class ns.widget.core.viewswitcher.animation.interface
* @internal
*/
(function (document, ns) {
"use strict";
ns.widget.core.viewswitcher.animation.interface = {
/**
* Init views position
* @method initPosition
* @static
* @member ns.widget.core.viewswitcher.animation.interface
*/
initPosition: function (/* views array, active index */) {
},
/**
* Animate views
* @method animate
* @static
* @member ns.widget.core.viewswitcher.animation.interface
*/
animate: function (/* views array, active index, position */) {
},
/**
* Reset views position
* @method resetPosition
* @static
* @member ns.widget.core.viewswitcher.animation.interface
*/
resetPosition: function (/* views array, active index */) {
}
};
}(window.document, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Animation carousel
*
* carousel is animation type of ViewSwitcher
*
* @class ns.widget.core.ViewSwitcher.animation.carousel
* @extends ns.widget.core.ViewSwitcher.animation.interface
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
* @internal
*/
(function (document, ns) {
"use strict";
var object = ns.util.object,
utilDOM = ns.util.DOM,
animation = ns.widget.core.viewswitcher.animation,
animationInterface = animation.interface,
DEFAULT = {
PERSPECTIVE: 280,
ZINDEX_TOP: 3,
ZINDEX_MIDDLE: 2,
ZINDEX_BOTTOM: 1,
DIM_LEVEL: 6
},
options = {
useDim: true,
dimLevel: DEFAULT.DIM_LEVEL
},
classes = {
CAROUSEL: "ui-view-carousel",
CAROUSEL_ACTIVE: "ui-view-carousel-active",
CAROUSEL_LEFT: "ui-view-carousel-left",
CAROUSEL_RIGHT: "ui-view-carousel-right",
CAROUSEL_DIM: "ui-view-carousel-dim"
};
function translate(element, x, y, z, duration) {
if (duration) {
utilDOM.setPrefixedStyle(element, "transition", utilDOM.getPrefixedValue("transform " + duration / 1000 + "s ease-out"));
}
utilDOM.setPrefixedStyle(element, "transform", "translate3d(" + x + "px, " + y + "px, " + z + "px)");
}
function resetStyle(element) {
element.style.left = "";
element.style.right = "";
element.style.zIndex = DEFAULT.ZINDEX_MIDDLE;
element.style.transform = "translateZ(" + -element.parentNode.offsetWidth / 2 + "px)";
element.style.webkitTransform = "translateZ(" + -element.parentNode.offsetWidth / 2 + "px)";
}
animation.carousel = object.merge({}, animationInterface, {
/**
* Init views position
* @method initPosition
* @param {Array} views array
* @param {number} index
* @static
* @member ns.widget.core.ViewSwitcher.animation.interface
*/
initPosition: function (views, index) {
var viewSwitcher = views[0].parentNode,
vsOffsetWidth = viewSwitcher.offsetWidth,
dimElement,
i,
len;
viewSwitcher.classList.add(classes.CAROUSEL);
viewSwitcher.style.webkitPerspective = DEFAULT.PERSPECTIVE;
if (options.useDim) {
len = views.length;
for (i = 0; i < len; i++) {
dimElement = document.createElement("DIV");
dimElement.classList.add(classes.CAROUSEL_DIM);
views[i].appendChild(dimElement);
}
}
views[index].classList.add(classes.CAROUSEL_ACTIVE);
if (index > 0) {
views[index - 1].classList.add(classes.CAROUSEL_LEFT);
views[index - 1].style.transform = "translateZ(" + -vsOffsetWidth / 2 + "px)";
}
if (index < views.length - 1) {
views[index + 1].classList.add(classes.CAROUSEL_RIGHT);
views[index + 1].style.transform = "translateZ(" + -vsOffsetWidth / 2 + "px)";
}
},
/**
* Animate views
* @method animate
* @param {Array} views array
* @param {number} index
* @param {number} position [0 - 100 or -100 - 0]
* @static
* @member ns.widget.core.ViewSwitcher.animation.interface
*/
animate: function (views, index, position) {
var viewSwitcher = views[0].parentNode,
vsWidth = viewSwitcher.offsetWidth,
vsHalfWidth = vsWidth / 2,
left = index > 0 ? views[index - 1] : undefined,
right = index < views.length - 1 ? views[index + 1] : undefined,
active = views[index],
ex = position / 100 * vsWidth,
halfEx = ex / 2,
centerPosition = (vsHalfWidth - active.offsetWidth / 2),
adjPosition = (centerPosition / (vsHalfWidth * 0.6)),
absEx = Math.abs(ex),
absPosition = Math.abs(position),
mark = position < 0 ? 1 : -1,
edge = vsHalfWidth * 0.2 * mark,
// edgeDeltaX -> -mark * (2 * (0.8 * vsHalfWidth)) - halfEx
edgeDeltaX = -mark * 1.6 * vsHalfWidth - halfEx,
minusDeltaX = -vsHalfWidth - halfEx,
plusDeltaX = -vsHalfWidth + halfEx,
hidingDeltaX = -halfEx * 0.2,
prev,
next,
beforePrev,
afterNext;
active.style.left = (vsWidth - active.offsetWidth) / 2 + "px";
active.style.zIndex = DEFAULT.ZINDEX_TOP;
next = ex < 0 ? right : left;
afterNext = ex < 0 ? (next && next.nextElementSibling) : (next && next.previousElementSibling);
prev = ex < 0 ? left : right;
beforePrev = ex < 0 ? (prev && prev.previousElementSibling) : (prev && prev.nextElementSibling);
if (next) {
if (absEx < vsWidth * 0.2) {
next.style.zIndex = DEFAULT.ZINDEX_MIDDLE;
translate(next, -halfEx * adjPosition, 0, ex < 0 ? minusDeltaX : plusDeltaX);
} else {
active.style.zIndex = DEFAULT.ZINDEX_MIDDLE;
next.style.zIndex = DEFAULT.ZINDEX_TOP;
translate(next, (2 * edge + halfEx) * adjPosition, 0, ex < 0 ? minusDeltaX : plusDeltaX);
}
if (afterNext) {
afterNext.classList.add(ex < 0 ? classes.CAROUSEL_RIGHT : classes.CAROUSEL_LEFT);
translate(afterNext, (ex < 0 ? minusDeltaX : -plusDeltaX) * 0.6, 0, -vsWidth - halfEx * mark);
}
}
if (prev) {
if (beforePrev) {
beforePrev.classList.remove(ex < 0 ? classes.CAROUSEL_LEFT : classes.CAROUSEL_RIGHT);
}
prev.style.zIndex = DEFAULT.ZINDEX_BOTTOM;
translate(prev, hidingDeltaX, 0, ex < 0 ? plusDeltaX : minusDeltaX);
}
if (absEx < vsWidth * 0.8) {
translate(active, halfEx * adjPosition, 0, halfEx * mark);
} else {
translate(active, edgeDeltaX * adjPosition, 0, halfEx * mark);
}
if (options.useDim) {
active.querySelector("." + classes.CAROUSEL_DIM).style.opacity = absPosition * options.dimLevel / 1000;
if (next) {
next.querySelector("." + classes.CAROUSEL_DIM).style.opacity = options.dimLevel / 10 * (1 - absPosition / 100);
}
}
},
/**
* Reset views position
* @method resetPosition
* @param {Array} views array
* @param {number} index active index
* @static
* @member ns.widget.core.ViewSwitcher.animation.interface
*/
resetPosition: function (views, index) {
var viewSwitcher = views[0].parentNode,
active = views[index],
rightElements = viewSwitcher.querySelectorAll("." + classes.CAROUSEL_RIGHT),
leftElements = viewSwitcher.querySelectorAll("." + classes.CAROUSEL_LEFT),
i,
len;
viewSwitcher.querySelector("." + classes.CAROUSEL_ACTIVE).classList.remove(classes.CAROUSEL_ACTIVE);
active.classList.add(classes.CAROUSEL_ACTIVE);
active.style.transform = "";
active.style.webkitTransform = "";
len = rightElements.length;
for (i = 0; i < len; i++) {
rightElements[i].classList.remove(classes.CAROUSEL_RIGHT);
}
if (index < views.length - 1) {
views[index + 1].classList.add(classes.CAROUSEL_RIGHT);
resetStyle(views[index + 1]);
}
len = leftElements.length;
for (i = 0; i < len; i++) {
leftElements[i].classList.remove(classes.CAROUSEL_LEFT);
}
if (index > 0) {
views[index - 1].classList.add(classes.CAROUSEL_LEFT);
resetStyle(views[index - 1]);
}
}
});
animation.carousel.options = options;
}(window.document, ns));
/*global window, ns, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #ViewSwitcher
* Shows a viewswitcher that controls each view elements.
*
* ViewSwitcher component is controller for each view elements is changing position.
* This component managed to animation, views position, events and get/set active view index.
* If you want to change the view as various animating, you should wrap views as the ViewSwitcher element then
* ViewSwitcher would set views position and start to manage to gesture event.
*
* ##Set and Get the active index
* You can set or get the active index as the setActiveIndex() and getActiveIndex()
*
* @class ns.widget.core.viewswitcher.ViewSwitcher
* @extends ns.widget.BaseWidget
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (document, ns) {
"use strict";
/**
* @property {Object} Widget Alias for {@link ns.widget.BaseWidget}
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @private
* @static
*/
var BaseWidget = ns.widget.BaseWidget,
events = ns.event,
engine = ns.engine,
utilsObject = ns.util.object,
Gesture = ns.event.gesture,
cancelAnimationFrame = ns.util.cancelAnimationFrame,
requestAnimationFrame = ns.util.requestAnimationFrame,
/**
* Default values
*/
DEFAULT = {
ACTIVE_INDEX: 0,
ANIMATION_TYPE: "carousel",
ANIMATION_SPEED: 30,
ANIMATION_TIMING_FUNCTION: "ease-out"
},
/**
* ViewSwitcher triggered some customEvents
* viewchangestart : This event has been triggered when view changing started.
* viewchangeend : This event has been triggered when view changing ended.
* viewchange: This event has been triggered when view changing complete to user.
*/
EVENT_TYPE = {
CHANGE_START: "viewchangestart",
CHANGE_END: "viewchangeend",
CHANGE: "viewchange"
},
/**
* ViewSwitcher constructor
* @method ViewSwitcher
*/
ViewSwitcher = function () {
var self = this;
self.options = {};
self._ui = {};
},
/**
* Dictionary object containing commonly used widget classes
* @property {Object} classes
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @private
* @static
* @readonly
*/
classes = {
VIEW: "ui-view",
VIEW_ACTIVE: "ui-view-active",
ANIMATION_TYPE: "ui-animation-"
},
/**
* {Object} ViewSwitcher widget prototype
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @private
* @static
*/
prototype = new BaseWidget();
ViewSwitcher.prototype = prototype;
ViewSwitcher.classes = classes;
/**
* Configure of ViewSwitcher component
* @method _configure
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._configure = function () {
var self = this;
/**
* ViewSwitcher containing some options
* @property {number} ViewSwitcher default active index (Default is 0)
* @property {string} ViewSwitcher animation type (Default is "carousel")
* @property {number} ViewSwitcher animation speed (Default is 18)
*/
self.options = utilsObject.merge(self.options, {
active: DEFAULT.ACTIVE_INDEX,
animationType: DEFAULT.ANIMATION_TYPE,
animationSpeed: DEFAULT.ANIMATION_SPEED
});
};
/**
* Build structure of ViewSwitcher component
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement} Returns built element
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._build = function (element) {
var self = this,
ui = self._ui;
ui._views = element.querySelectorAll("." + classes.VIEW);
return element;
};
/**
* Initialization of ViewSwitcher component
* @method _init
* @param {HTMLElement} element
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._init = function (element) {
var self = this;
self._elementOffsetWidth = element.offsetWidth;
self._initPosition();
return element;
};
/**
* Init position of Views inner ViewSwitcher
* @method _initPosition
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._initPosition = function () {
var self = this,
views = self._ui._views,
options = self.options,
activeIndex = self._getActiveIndex();
self._type = ns.widget.core.viewswitcher.animation[options.animationType];
self._type.initPosition(views, activeIndex);
self._activeIndex = activeIndex;
};
/**
* Get the active index as view has the "ui-view-active" or not
* @method _getActiveIndex
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._getActiveIndex = function () {
var self = this,
ui = self._ui,
views = ui._views,
i,
len;
len = views.length;
for (i = 0; i < len; i++) {
if (views[i].classList.contains(classes.VIEW_ACTIVE)) {
return i;
}
}
return self.options.active;
};
/**
* Binds events to a ViewSwitcher component
* @method _bindEvents
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._bindEvents = function () {
var self = this,
element = self.element;
events.enableGesture(
element,
new events.gesture.Drag({
blockVertical: true,
threshold: 0
}),
new events.gesture.Swipe({
orientation: Gesture.Orientation.HORIZONTAL
})
);
events.on(element, "drag dragstart dragend swipe", self, false);
};
/**
* Handle events
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.viewswitcher.ViewSwitcher
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "drag":
self._onDrag(event);
break;
case "dragstart":
self._onDragStart(event);
break;
case "dragend":
case "swipe":
self._onDragEnd(event);
break;
}
};
/**
* Drag event handler
* @method _onDrag
* @param {Event} event
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._onDrag = function (event) {
var self = this,
direction = event.detail.direction,
ex = event.detail.estimatedDeltaX,
deltaX = ex / self._elementOffsetWidth * 100,
ui = self._ui,
active = ui._views[self._activeIndex];
if ((direction === "left" && !active.nextElementSibling) || (direction === "right" && !active.previousElementSibling)) {
return;
}
if (self._dragging && !self._isAnimating && Math.abs(deltaX) < 100) {
self._type.animate(ui._views, self._activeIndex, deltaX);
self._triggerChange(deltaX);
}
};
/**
* DragStart event handler
* @method _onDragStart
* @param {Event} event
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._onDragStart = function (event) {
var self = this,
direction = event.detail.direction,
ui = self._ui,
active = ui._views[self._activeIndex];
if ((direction === "left" && !active.nextElementSibling) || (direction === "right" && !active.previousElementSibling) || self._dragging) {
return;
}
self._dragging = true;
};
/**
* DragEnd event handler
* @method _onDragEnd
* @param {Event} event
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._onDragEnd = function (event) {
var self = this,
ui = self._ui,
active = ui._views[self._activeIndex],
direction = event.detail.direction,
estimatedDeltaX = event.detail.estimatedDeltaX;
if (!self._dragging ||
self._isAnimating ||
(direction === "left" && !active.nextElementSibling) ||
(direction === "right" && !active.previousElementSibling)) {
return;
}
self._lastDirection = direction;
if (event.type === "dragend" && Math.abs(estimatedDeltaX) < self._elementOffsetWidth / 2) {
direction = "backward";
}
self.trigger(EVENT_TYPE.CHANGE_START);
self._requestFrame(estimatedDeltaX, direction);
};
prototype._triggerChange = function (estimatedDeltaX) {
var self = this,
absEx = Math.abs(estimatedDeltaX);
if (absEx > 50 && !self._changed) {
self.trigger(EVENT_TYPE.CHANGE, {
index: self._activeIndex + (estimatedDeltaX < 0 ? 1 : -1)
});
self._changed = true;
} else if (absEx < 50 && self._changed) {
self.trigger(EVENT_TYPE.CHANGE, {
index: self._activeIndex
});
self._changed = false;
}
};
/**
* Animate views as the requestAnimationFrame.
* @method _requestFrame
* @param {number} estimatedDeltaX
* @param {string} direction
* @param {string} animationTiming timing type (ease-out|linear)
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._requestFrame = function (estimatedDeltaX, direction, animationTiming) {
var self = this,
elementOffsetWidth = self._elementOffsetWidth,
animationTimingFunction = animationTiming ? animationTiming : DEFAULT.ANIMATION_TIMING_FUNCTION,
isStop = false,
lastDirection = self._lastDirection,
ui = self._ui,
ex = estimatedDeltaX,
deltaX = ex / elementOffsetWidth * 100,
animationFrame = self._animationFrame,
validDirection,
stopPosition,
mark;
if (direction === "backward") {
validDirection = lastDirection === "left" ? "right" : "left";
if (lastDirection === "left" && ex > 0 || lastDirection === "right" && ex < 0) {
isStop = true;
stopPosition = 0;
}
} else {
validDirection = direction;
if (Math.abs(ex) > elementOffsetWidth) {
isStop = true;
stopPosition = 100;
}
}
mark = validDirection === "left" ? -1 : 1;
if (isStop) {
self._type.animate(ui._views, self._activeIndex, stopPosition * mark);
cancelAnimationFrame(animationFrame);
if (direction !== "backward") {
ui._views[self._activeIndex].classList.remove(classes.VIEW_ACTIVE);
self._activeIndex = self._activeIndex - mark;
self._type.resetPosition(ui._views, self._activeIndex);
ui._views[self._activeIndex].classList.add(classes.VIEW_ACTIVE);
}
self._dragging = false;
self._isAnimating = false;
self._changed = false;
self.trigger(EVENT_TYPE.CHANGE_END);
return;
}
self._type.animate(ui._views, self._activeIndex, deltaX);
self._triggerChange(deltaX);
self._isAnimating = true;
if (animationTimingFunction === "ease-out") {
if (Math.abs(ex) > elementOffsetWidth * 0.95) {
ex = ex + mark;
} else {
ex = ex + self.options.animationSpeed * mark;
}
} else if (animationTimingFunction === "linear") {
ex = ex + self.options.animationSpeed * mark;
}
self._animationFrame = requestAnimationFrame(self._requestFrame.bind(self, ex, direction, animationTiming));
};
/**
* Set the active view
* @method setActiveIndex
* @param {number} index
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @public
*/
prototype.setActiveIndex = function (index) {
var self = this,
latestActiveIndex = self._activeIndex,
interval = latestActiveIndex - index,
direction,
i,
len;
if (!self._isAnimating && index < self._ui._views.length && index >= 0) {
self._lastDeltaX = 0;
if (interval < 0) {
direction = "left";
} else {
direction = "right";
}
len = Math.abs(interval);
self._lastDirection = direction;
for (i = 0; i < len; i++) {
self.trigger(EVENT_TYPE.CHANGE_START);
self._requestFrame(0, direction, "linear");
}
}
};
/**
* Get the active view index
* @method getActiveIndex
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @public
*/
prototype.getActiveIndex = function () {
return this._activeIndex;
};
/**
* Destroys ViewSwitcher widget
* @method _destroy
* @member ns.widget.core.viewswitcher.ViewSwitcher
* @protected
*/
prototype._destroy = function () {
var element = this.element;
events.disableGesture(element);
events.off(element, "drag dragstart dragend", this, false);
this.options = null;
this._ui = null;
};
ns.widget.core.viewswitcher.ViewSwitcher = ViewSwitcher;
engine.defineWidget(
"ViewSwitcher",
"[data-role='viewSwitcher'], .ui-view-switcher",
[
"setActiveIndex",
"getActiveIndex"
],
ViewSwitcher
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Page Indicator
* PageIndicator component presents as a dot-typed indicator.
*
* @since 2.4
* @class ns.widget.core.PageIndicator
* @component-selector [data-role="page-indicator"], .ui-page-indicator
* @component-type standalone-component
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
PageIndicator = function () {
var self = this;
self._activeIndex = null;
self.options = {};
},
classes = {
indicator: "ui-page-indicator",
indicatorActive: "ui-page-indicator-active",
indicatorItem: "ui-page-indicator-item",
indicatorDashed: "ui-page-indicator-dashed",
linearIndicator: "ui-page-indicator-linear",
circularIndicator: "ui-page-indicator-circular"
},
maxDots = {
IN_CIRCLE: 60,
IN_LINEAR: 5
},
layoutType = {
LINEAR: "linear",
CIRCULAR: "circular"
},
DISTANCE_FROM_EDGE = 8,
prototype = new BaseWidget();
PageIndicator.classes = classes;
prototype._configure = function () {
/**
* Options for widget.
* @property {Object} options
* @property {number} [options.maxPage=null] Maximum number of dots(pages) in indicator.
* @property {number} [options.numberOfPages=null] Number of pages to be linked to PageIndicator.
* @property {string} [options.layout="linear"] Layout type of page indicator.
* @property {number} [options.intervalAngle=6] angle between each dot in page indicator.
* @property {string} [options.style="dashed"] style of the page indicator "dotted" "dashed"
* @member ns.widget.core.PageIndicator
*/
this.options = {
maxPage: null,
numberOfPages: null,
layout: "linear",
intervalAngle: 6,
style: "dashed"
};
};
/**
* Build PageIndicator
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._build = function (element) {
var self = this,
options = self.options;
self._createIndicator(element);
if (options.layout === layoutType.CIRCULAR) {
self._circularPositioning(element);
}
if (options.style === "dashed") {
element.classList.add(classes.indicatorDashed);
}
return element;
};
/**
* Create HTML elements for PageIndicator
* @method _createIndicator
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._createIndicator = function (element) {
var self = this,
i,
len,
maxPage,
span,
numberOfPages = self.options.numberOfPages;
if (numberOfPages === null) {
ns.error("build error: numberOfPages is null");
return;
}
self.options.layout = self.options.layout.toLowerCase();
if (self.options.layout === layoutType.CIRCULAR) {
element.classList.remove(classes.linearIndicator);
element.classList.add(classes.circularIndicator);
} else {
element.classList.remove(classes.circularIndicator);
element.classList.add(classes.linearIndicator);
}
maxPage = self._getMaxPage();
len = numberOfPages < maxPage ? numberOfPages : maxPage;
for (i = 0; i < len; i++) {
span = document.createElement("span");
span.classList.add(classes.indicatorItem);
element.appendChild(span);
}
};
/**
* Make circular positioned indicator
* @method _circularPositioning
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._circularPositioning = function (element) {
var self = this,
items = element.children,
numberOfDots = items.length,
intervalAngle = self.options.intervalAngle - "0",
translatePixel,
style,
i;
translatePixel = element.offsetWidth / 2 - DISTANCE_FROM_EDGE;
for (i = 0; i < numberOfDots; i++) {
style = "rotate(" + (i * intervalAngle - 90 - (numberOfDots - 1) * intervalAngle * 0.5) + "deg) translate(" +
translatePixel + "px) ";
items[i].style.transform = style;
}
};
/**
* Return maximum number of dots(pages) in indicator
* @method _getMaxPage
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._getMaxPage = function () {
var self = this,
options = self.options,
maxPage;
if (options.layout === layoutType.CIRCULAR) {
maxPage = options.maxPage || maxDots.IN_CIRCLE;
} else {
maxPage = options.maxPage || maxDots.IN_LINEAR;
}
return maxPage;
};
/**
* Remove contents of HTML elements for PageIndicator
* @method _removeIndicator
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._removeIndicator = function (element) {
element.textContent = "";
};
/**
* This method sets a dot to active state.
* @method setActive
* @param {number} position index to be active state.
* @member ns.widget.core.PageIndicator
*/
prototype.setActive = function (position) {
var self = this,
dotIndex = position,
elPageIndicatorItems = self.element.children,
maxPage,
numberOfPages = parseInt(self.options.numberOfPages, 10),
middle,
numberOfCentralDotPages = 0,
indicatorActive = classes.indicatorActive,
previousActive;
if (position === null || position === undefined) {
return;
}
self._activeIndex = position;
maxPage = self._getMaxPage();
middle = window.parseInt(maxPage / 2, 10);
if (numberOfPages > maxPage) {
numberOfCentralDotPages = numberOfPages - maxPage;
} else if (isNaN(numberOfPages)) {
ns.error("setActive error: numberOfPages is not a number");
return;
} else if (numberOfPages === 0) {
return;
}
previousActive = self.element.querySelector("." + indicatorActive);
if (previousActive) {
previousActive.classList.remove(indicatorActive);
}
if ((middle < position) && (position <= (middle + numberOfCentralDotPages))) {
dotIndex = middle;
} else if (position > (middle + numberOfCentralDotPages)) {
dotIndex = position - numberOfCentralDotPages;
}
elPageIndicatorItems[dotIndex].classList.add(indicatorActive);
};
/**
* Refresh widget structure
* @method _refresh
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._refresh = function () {
var self = this,
element = self.element;
self._removeIndicator(element);
self._createIndicator(element);
if (self.options.layout === layoutType.CIRCULAR) {
self._circularPositioning(element);
}
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.core.PageIndicator
*/
prototype._destroy = function () {
this._removeIndicator(this.element);
};
PageIndicator.prototype = prototype;
ns.widget.core.PageIndicator = PageIndicator;
engine.defineWidget(
"PageIndicator",
"[data-role='page-indicator'], .ui-page-indicator",
["setActive"],
PageIndicator,
"core"
);
}(window.document, ns));
/*global ns, window, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Gesture Utilities
* Contains helper function to gesture support.
* @class ns.event.gesture.utils
*/
(function (ns, Math) {
"use strict";
/**
* Local alias for {@link ns.event.gesture}
* @property {Object}
* @member ns.event.gesture.utils
* @private
* @static
*/
var gesture = ns.event.gesture;
gesture.utils = {
/**
* Get center from array of touches
* @method getCenter
* @param {Event[]} touches description
* @member ns.event.gesture.utils
* @return {Object} position
* @return {number} return.clientX position X
* @return {number} return.clientY position Y
*/
getCenter: function (touches) {
var valuesX = [],
valuesY = [];
[].forEach.call(touches, function (touch) {
// I prefer clientX because it ignore the scrolling position
valuesX.push(!isNaN(touch.clientX) ? touch.clientX : touch.pageX);
valuesY.push(!isNaN(touch.clientY) ? touch.clientY : touch.pageY);
});
return {
clientX: (Math.min.apply(Math, valuesX) + Math.max.apply(Math, valuesX)) / 2,
clientY: (Math.min.apply(Math, valuesY) + Math.max.apply(Math, valuesY)) / 2
};
},
/**
* Get velocity
* @method getVelocity
* @param {number} deltaTime Delta of time
* @param {number} deltaX Position change on x axis
* @param {number} deltaY Position change on y axis
* @return {Object} velocity
* @return {number} return.x velocity on X axis
* @return {number} return.y velocity on Y axis
* @member ns.event.gesture.utils
*/
getVelocity: function (deltaTime, deltaX, deltaY) {
return {
x: Math.abs(deltaX / deltaTime) || 0,
y: Math.abs(deltaY / deltaTime) || 0
};
},
/**
* Get angel between position of two touches
* @method getAngle
* @param {Event} touch1 first touch
* @param {Event} touch2 second touch
* @return {number} angel (deg)
* @member ns.event.gesture.utils
*/
getAngle: function (touch1, touch2) {
var y = touch2.clientY - touch1.clientY,
x = touch2.clientX - touch1.clientX;
return Math.atan2(y, x) * 180 / Math.PI;
},
/**
* Get direction indicated by position of two touches
* @method getDirection
* @param {Event} touch1 first touch
* @param {Event} touch2 second touch
* @return {ns.event.gesture.Direction.LEFT|ns.event.gesture.Direction.RIGHT|ns.event.gesture.Direction.UP|ns.event.gesture.Direction.DOWN}
* @member ns.event.gesture.utils
*/
getDirection: function (touch1, touch2) {
var x = Math.abs(touch1.clientX - touch2.clientX),
y = Math.abs(touch1.clientY - touch2.clientY);
if (x >= y) {
return touch1.clientX - touch2.clientX > 0 ? gesture.Direction.LEFT : gesture.Direction.RIGHT;
}
return touch1.clientY - touch2.clientY > 0 ? gesture.Direction.UP : gesture.Direction.DOWN;
},
/**
* Get distance indicated by position of two touches
* @method getDistance
* @param {Event} touch1 first touch
* @param {Event} touch2 second touch
* @return {number} distance
* @member ns.event.gesture.utils
*/
getDistance: function (touch1, touch2) {
var x = touch2.clientX - touch1.clientX,
y = touch2.clientY - touch1.clientY;
return Math.sqrt((x * x) + (y * y));
},
/**
* Get scale indicated by position of the first and the last touch
* @method getScale
* @param {Event} start start touch
* @param {Event} end end touch
* @return {number} scale
* @member ns.event.gesture.utils
*/
getScale: function (start, end) {
// need two fingers...
if (start.length >= 2 && end.length >= 2) {
return this.getDistance(end[0], end[1]) / this.getDistance(start[0], start[1]);
}
return 1;
},
/**
* Get value of rotation indicated by position
* of the first and the last touch
* @method getRotation
* @param {Event} start start touch
* @param {Event} end end touch
* @return {number} angle (deg)
* @member ns.event.gesture.utils
*/
getRotation: function (start, end) {
// need two fingers
if (start.length >= 2 && end.length >= 2) {
return this.getAngle(end[1], end[0]) -
this.getAngle(start[1], start[0]);
}
return 0;
},
/**
* Check if the direction is vertical
* @method isVertical
* @param {ns.event.gesture.Direction.LEFT|ns.event.gesture.Direction.RIGHT|ns.event.gesture.Direction.UP|ns.event.gesture.Direction.DOWN} direction start touch
* @return {boolean}
* @member ns.event.gesture.utils
*/
isVertical: function (direction) {
return direction === gesture.Direction.UP || direction === gesture.Direction.DOWN;
},
/**
* Check if the direction is horizontal
* @method isHorizontal
* @param {ns.event.gesture.Direction.LEFT|ns.event.gesture.Direction.RIGHT|ns.event.gesture.Direction.UP|ns.event.gesture.Direction.DOWN} direction start touch
* @return {boolean}
* @member ns.event.gesture.utils
*/
isHorizontal: function (direction) {
return direction === gesture.Direction.LEFT || direction === gesture.Direction.RIGHT;
},
/**
* Check if the direction is horizontal
* @method getOrientation
* @param {ns.event.gesture.Direction.LEFT|ns.event.gesture.Direction.RIGHT|ns.event.gesture.Direction.UP|ns.event.gesture.Direction.DOWN} direction
* @return {boolean}
* @member ns.event.gesture.utils
*/
getOrientation: function (direction) {
return this.isVertical(direction) ? gesture.Orientation.VERTICAL : gesture.Orientation.HORIZONTAL;
}
};
}(ns, window.Math));
/*global ns, window, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Gesture.Detector class
* Base class for create detectors in gestures.
*
* @class ns.event.gesture.Detector
*/
(function (ns) {
"use strict";
var gesture = ns.event.gesture,
objectMerge = ns.util.object.merge,
Detector = function (strategy, sender) {
this.sender = sender;
this.strategy = strategy.create();
this.name = this.strategy.name;
this.index = this.strategy.index || 100;
this.options = this.strategy.options || {};
};
/**
* Start of gesture detection of given type
* @method detect
* @param {string} gestureEvent
* @return {Object}
* @member ns.event.gesture.Detector
*/
Detector.prototype.detect = function (gestureEvent) {
return this.strategy.handler(gestureEvent, this.sender, this.strategy.options);
};
Detector.Sender = {
sendEvent: function () {
// Empty function for creating interface
}
};
/**
* Create plugin namespace.
* @property {Object} plugin
* @member ns.event.gesture.Detector
*/
Detector.plugin = {};
/**
* Methods creates plugin
* @method create
* @param {Object} gestureHandler
* @return {ns.event.gesture.Detector} gestureHandler
* @member ns.event.gesture.Detector.plugin
*/
Detector.plugin.create = function (gestureHandler) {
var detector;
if (!gestureHandler.types) {
gestureHandler.types = [gestureHandler.name];
}
detector = function (options) {
this.options = objectMerge({}, gestureHandler.defaults, options);
};
detector.prototype.create = function () {
return objectMerge({
options: this.options
}, gestureHandler);
};
Detector.plugin[gestureHandler.name] = detector;
return detector;
};
// definition
gesture.Detector = Detector;
}(ns));
/*global ns, window, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # Gesture Plugin: drag
* Plugin enables drag event.
*
* @class ns.event.gesture.Drag
*/
(function (ns, window, tizen) {
"use strict";
/**
* Local alias for {@link ns.event.gesture}
* @property {Object}
* @member ns.event.gesture.Drag
* @private
* @static
*/
var gesture = ns.event.gesture,
/**
* Local alias for {@link ns.event.gesture.Detector}
* @property {Object}
* @member ns.event.gesture.Drag
* @private
* @static
*/
gestureUtils = gesture.utils,
Detector = gesture.Detector,
/**
* Alias for method {@link ns.util.object.merge}
* @property {Function} merge
* @member ns.event.gesture.Drag
* @private
* @static
*/
merge = ns.util.object.merge,
eventNames = {
start: "dragstart",
drag: "drag",
end: "dragend",
cancel: "dragcancel",
prepare: "dragprepare"
},
// TODO UA test will move to support.
isTizenWebkit2Browser = !!window.navigator.userAgent.match(/tizen/i) && (function () {
var result = true,
version;
if (tizen && tizen.systeminfo && tizen.systeminfo.getCapability) {
try {
version = tizen.systeminfo.getCapability("http://tizen.org/feature/platform.version");
return version < "3.0";
} catch (error) {
ns.error("Error name: " + error.name + ", message: " + error.message);
}
}
return result;
})(),
isChromeBrowser = window.navigator.userAgent.indexOf("Chrome") > -1,
RESULTS = gesture.Result,
Drag = Detector.plugin.create({
/**
* Gesture name
* @property {string} [name="drag"]
* @member ns.event.gesture.Drag
*/
name: "drag",
/**
* Gesture Index
* @property {number} [index=500]
* @member ns.event.gesture.Drag
*/
index: 500,
/**
* Default values for drag gesture
* @property {Object} defaults
* @property {boolean} [defaults.blockHorizontal=false]
* @property {boolean} [defaults.blockVertical=false]
* @property {number} [defaults.threshold=20]
* @property {number} [defaults.delay=0]
* @member ns.event.gesture.Drag
*/
defaults: {
blockHorizontal: false,
blockVertical: false,
threshold: 20,
delay: 0
},
/**
* Triggered
* @property {boolean} [isTriggered=false]
* @member ns.event.gesture.Drag
*/
isTriggered: false,
/**
* Handler for drag gesture
* @method handler
* @param {Event} gestureEvent gesture event
* @param {Object} sender event's sender
* @param {Object} options options
* @return {number}
* @member ns.event.gesture.Drag
*/
handler: function (gestureEvent, sender, options) {
var newGestureEvent,
threshold = options.threshold,
result = RESULTS.PENDING,
direction = gestureEvent.direction;
if (!this.isTriggered && gestureEvent.eventType === gesture.Event.MOVE) {
if (Math.abs(gestureEvent.deltaX) < threshold && Math.abs(gestureEvent.deltaY) < threshold) {
// Branching statement for specifying Tizen 2.X and Tizen 3.0
if (isChromeBrowser) {
gestureEvent.preventDefault();
}
return RESULTS.PENDING;
}
if (options.delay && gestureEvent.deltaTime < options.delay) {
if (!isTizenWebkit2Browser) {
gestureEvent.preventDefault();
}
return RESULTS.PENDING;
}
if (options.blockHorizontal && gestureUtils.isHorizontal(gestureEvent.direction) ||
options.blockVertical && gestureUtils.isVertical(gestureEvent.direction)) {
return RESULTS.FINISHED;
}
this.fixedStartPointX = 0;
this.fixedStartPointY = 0;
if (gestureUtils.isHorizontal(gestureEvent.direction)) {
this.fixedStartPointX = (gestureEvent.deltaX < 0 ? 1 : -1) * threshold;
} else {
this.fixedStartPointY = (gestureEvent.deltaY < 0 ? 1 : -1) * threshold;
}
}
if (options.blockHorizontal) {
direction = gestureEvent.deltaY < 0 ? gesture.Direction.UP : gesture.Direction.DOWN;
}
if (options.blockVertical) {
direction = gestureEvent.deltaX < 0 ? gesture.Direction.LEFT : gesture.Direction.RIGHT;
}
newGestureEvent = merge({}, gestureEvent, {
deltaX: gestureEvent.deltaX + this.fixedStartPointX,
deltaY: gestureEvent.deltaY + this.fixedStartPointY,
estimatedDeltaX: gestureEvent.estimatedDeltaX + this.fixedStartPointX,
estimatedDeltaY: gestureEvent.estimatedDeltaY + this.fixedStartPointY,
direction: direction
});
switch (newGestureEvent.eventType) {
case gesture.Event.START:
this.isTriggered = false;
if (sender.sendEvent(eventNames.prepare, newGestureEvent) === false) {
result = RESULTS.FINISHED;
}
break;
case gesture.Event.MOVE:
if (!this.isTriggered && sender.sendEvent(eventNames.start, newGestureEvent) === false) {
newGestureEvent.preventDefault();
}
result = sender.sendEvent(eventNames.drag, newGestureEvent) ? RESULTS.RUNNING : RESULTS.FINISHED;
if (result === false) {
newGestureEvent.preventDefault();
}
this.isTriggered = true;
break;
case gesture.Event.BLOCKED:
case gesture.Event.END:
result = RESULTS.FINISHED;
if (this.isTriggered) {
if (sender.sendEvent(eventNames.end, newGestureEvent) === false) {
newGestureEvent.preventDefault();
}
this.isTriggered = false;
}
break;
case gesture.Event.CANCEL:
result = RESULTS.FINISHED;
if (this.isTriggered) {
if (sender.sendEvent(eventNames.cancel, newGestureEvent) === false) {
newGestureEvent.preventDefault();
}
this.isTriggered = false;
}
break;
}
return result;
}
});
ns.event.gesture.Drag = Drag;
}(ns, window, window.tizen));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Scroller namespace
* Namespace contains classes and objects connected with scroller widget.
* @class ns.widget.core.scroller
* @internal
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (window, ns) {
"use strict";
ns.widget.core.scroller = ns.widget.core.scroller || {};
}(window, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* #Effect namespace
* Namespace with effects for scroller widget.
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @internal
* @class ns.widget.core.scroller.effect
*/
(function (window, ns) {
"use strict";
ns.widget.core.scroller.effect = ns.widget.core.scroller.effect || {};
}(window, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Bouncing effect
* Bouncing effect for scroller widget.
* @class ns.widget.core.scroller.effect.Bouncing
* @internal
* @since 2.3
*/
(function (document, ns) {
"use strict";
// scroller.start event trigger when user try to move scroller
var utilsObject = ns.util.object,
selectors = ns.util.selectors,
Bouncing = function (scrollerElement, options) {
var self = this;
self._orientation = null;
self._maxValue = null;
self._container = null;
self._minEffectElement = null;
self._maxEffectElement = null;
self.options = utilsObject.merge({}, Bouncing.defaults, {scrollEndEffectArea: ns.getConfig("scrollEndEffectArea", Bouncing.defaults.scrollEndEffectArea)});
/**
* target element for bouncing effect
* @property {HTMLElement} targetElement
* @member ns.widget.core.scroller.effect.Bouncing
*/
self._targetElement = null;
self._isShow = false;
self._isDrag = false;
self._isShowAnimating = false;
self._isHideAnimating = false;
self._create(scrollerElement, options);
},
Orientation = {
VERTICAL: "vertical",
HORIZONTAL: "horizontal"
},
endEffectAreaType = {
content: "content",
screen: "screen"
},
defaults = {
duration: 500,
scrollEndEffectArea: "content"
},
classes = {
bouncingEffect: "ui-scrollbar-bouncing-effect",
page: "ui-page",
left: "ui-left",
right: "ui-right",
top: "ui-top",
bottom: "ui-bottom",
hide: "ui-hide",
show: "ui-show"
};
Bouncing.Orientation = Orientation;
Bouncing.defaults = defaults;
Bouncing.prototype = {
_create: function (scrollerElement, options) {
var self = this;
if (self.options.scrollEndEffectArea === endEffectAreaType.content) {
self._container = scrollerElement;
} else {
self._container = selectors.getClosestByClass(scrollerElement, classes.page);
}
self._orientation = options.orientation;
self._maxValue = self._getValue(options.maxScrollX, options.maxScrollY);
self._initLayout();
},
_initLayout: function () {
var self = this,
minElement = self._minEffectElement = document.createElement("DIV"),
maxElement = self._maxEffectElement = document.createElement("DIV"),
className = classes.bouncingEffect;
if (self._orientation === Orientation.HORIZONTAL) {
minElement.className = className + " " + classes.left;
maxElement.className = className + " " + classes.right;
} else {
minElement.className = className + " " + classes.top;
maxElement.className = className + " " + classes.bottom;
}
self._container.appendChild(minElement);
self._container.appendChild(maxElement);
minElement.addEventListener("animationEnd", this);
minElement.addEventListener("webkitAnimationEnd", this);
minElement.addEventListener("mozAnimationEnd", this);
minElement.addEventListener("msAnimationEnd", this);
minElement.addEventListener("oAnimationEnd", this);
maxElement.addEventListener("animationEnd", this);
maxElement.addEventListener("webkitAnimationEnd", this);
maxElement.addEventListener("mozAnimationEnd", this);
maxElement.addEventListener("msAnimationEnd", this);
maxElement.addEventListener("oAnimationEnd", this);
},
/**
* ...
* @method drag
* @param {number} x
* @param {number} y
* @member ns.widget.core.scroller.effect.Bouncing
*/
drag: function (x, y) {
this._isDrag = true;
this._checkAndShow(x, y);
},
/**
* ...
* @method dragEnd
* @member ns.widget.core.scroller.effect.Bouncing
*/
dragEnd: function () {
var self = this;
if (self._isShow && !self._isShowAnimating && !self._isHideAnimating) {
self._beginHide();
}
self._isDrag = false;
},
/**
* Shows effect.
* @method show
* @member ns.widget.core.scroller.effect.Bouncing
*/
show: function () {
var self = this;
if (self._targetElement) {
self._isShow = true;
self._beginShow();
}
},
/**
* Hides effect.
* @method hide
* @member ns.widget.core.scroller.effect.Bouncing
*/
hide: function () {
var self = this;
if (self._isShow) {
self._minEffectElement.style.display = "none";
self._maxEffectElement.style.display = "none";
self._targetElement.classList.remove(classes.hide);
self._targetElement.classList.remove(classes.show);
}
self._isShow = false;
self._isShowAnimating = false;
self._isHideAnimating = false;
self._targetElement = null;
},
_checkAndShow: function (x, y) {
var self = this,
val = self._getValue(x, y);
if (!self._isShow) {
if (val >= 0) {
self._targetElement = self._minEffectElement;
self.show();
} else if (val <= self._maxValue) {
self._targetElement = self._maxEffectElement;
self.show();
}
} else if (self._isShow && !self._isDrag && !self._isShowAnimating && !self._isHideAnimating) {
self._beginHide();
}
},
_getValue: function (x, y) {
return this._orientation === Orientation.HORIZONTAL ? x : y;
},
_beginShow: function () {
var self = this;
if (!self._targetElement || self._isShowAnimating) {
return;
}
self._targetElement.style.display = "block";
self._targetElement.classList.remove(classes.hide);
self._targetElement.classList.add(classes.show);
self._isShowAnimating = true;
self._isHideAnimating = false;
},
_finishShow: function () {
var self = this;
self._isShowAnimating = false;
if (!self._isDrag) {
self._targetElement.classList.remove(classes.show);
self._beginHide();
}
},
_beginHide: function () {
var self = this;
if (self._isHideAnimating) {
return;
}
self._targetElement.classList.remove(classes.show);
self._targetElement.classList.add(classes.hide);
self._isHideAnimating = true;
self._isShowAnimating = false;
},
_finishHide: function () {
var self = this;
self._isHideAnimating = false;
self._targetElement.classList.remove(classes.hide);
self.hide();
self._checkAndShow();
},
/**
* Supports events.
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.scroller.effect.Bouncing
*/
handleEvent: function (event) {
if (event.type.toLowerCase().indexOf("animationend") > -1 && event.animationName.charAt(0) !== "-") {
if (this._isShowAnimating) {
this._finishShow();
} else if (this._isHideAnimating) {
this._finishHide();
}
}
},
/**
* Destroys effect.
* @method destroy
* @member ns.widget.core.scroller.effect.Bouncing
*/
destroy: function () {
var self = this,
maxEffectElement = this._maxEffectElement,
minEffectElement = this._minEffectElement;
minEffectElement.removeEventListener("animationEnd", this);
minEffectElement.removeEventListener("webkitAnimationEnd", this);
minEffectElement.removeEventListener("mozAnimationEnd", this);
minEffectElement.removeEventListener("msAnimationEnd", this);
minEffectElement.removeEventListener("oAnimationEnd", this);
maxEffectElement.removeEventListener("animationEnd", this);
maxEffectElement.removeEventListener("webkitAnimationEnd", this);
maxEffectElement.removeEventListener("mozAnimationEnd", this);
maxEffectElement.removeEventListener("msAnimationEnd", this);
maxEffectElement.removeEventListener("oAnimationEnd", this);
self._container.removeChild(minEffectElement);
self._container.removeChild(maxEffectElement);
self._container = null;
self._minEffectElement = null;
self._maxEffectElement = null;
self._targetElement = null;
self._isShow = null;
self._orientation = null;
self._maxValue = null;
}
};
ns.widget.core.scroller.effect.Bouncing = Bouncing;
}(window.document, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Scroller Widget
* Widget creates scroller on content.
* @class ns.widget.core.scroller.Scroller
* @since 2.3
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
// scroller.start event trigger when user try to move scroller
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
utilsObject = ns.util.object,
utilsEvents = ns.event,
prototype = new BaseWidget(),
EffectBouncing = ns.widget.core.scroller.effect.Bouncing,
eventType = {
/**
* event trigger when scroller start
* @event scrollstart
*/
START: "scrollstart",
/**
* event trigger when scroller move
* @event scrollmove
*/
MOVE: "scrollmove",
/**
* event trigger when scroller end
* @event scrollend
*/
END: "scrollend",
/**
* event trigger when scroll is cancel
* @event scrollcancel
*/
CANCEL: "scrollcancel"
},
/*
* this option is related operation of scroll bar.
* the value is true, scroll bar is shown during touching screen even if content doesn't scroll.
* the value is false, scroll bar disappear when there is no movement of the scroll bar.
*/
_keepShowingScrollbarOnTouch = false,
Scroller = function () {
};
Scroller.Orientation = {
VERTICAL: "vertical",
HORIZONTAL: "horizontal"
};
Scroller.EventType = eventType;
prototype._build = function (element) {
if (element.children.length !== 1) {
ns.error("[Scroller] Scroller should have only one child.");
} else {
this.scroller = element.children[0];
this.scrollerStyle = this.scroller.style;
this.bouncingEffect = null;
this.scrollbar = null;
this.scrollerWidth = 0;
this.scrollerHeight = 0;
this.scrollerOffsetX = 0;
this.scrollerOffsetY = 0;
this.maxScrollX = 0;
this.maxScrollY = 0;
this.startScrollerOffsetX = 0;
this.startScrollerOffsetY = 0;
this.orientation = null;
this.enabled = true;
this.scrolled = false;
this.dragging = false;
this.scrollCanceled = false;
}
return element;
};
prototype._configure = function () {
/**
* @property {Object} options Options for widget
* @property {number} [options.scrollDelay=0]
* @property {number} [options.threshold=10]
* @property {""|"bar"|"tab"} [options.scrollbar=""]
* @property {boolean} [options.useBouncingEffect=true]
* @property {"vertical"|"horizontal"} [options.orientation="vertical"]
* @member ns.widget.core.Scroller
*/
this.options = utilsObject.merge({}, this.options, {
scrollDelay: 0,
threshold: 30,
scrollbar: "",
useBouncingEffect: true,
orientation: "vertical" // vertical or horizontal,
});
};
prototype._init = function (element) {
var scroller = null,
options = this.options,
scrollerChildren = null,
elementStyle = element.style,
scrollerStyle = null,
elementHalfWidth = element.offsetWidth / 2,
elementHalfHeight = element.offsetHeight / 2;
scroller = element.children[0];
this.scroller = scroller;
scrollerStyle = scroller.style,
this.scrollerStyle = scrollerStyle;
scrollerChildren = scroller.children;
this.orientation = this.orientation ||
(options.orientation === "horizontal" ? Scroller.Orientation.HORIZONTAL : Scroller.Orientation.VERTICAL);
this.scrollerWidth = scroller.offsetWidth;
this.scrollerHeight = scroller.offsetHeight;
if (scrollerChildren.length) {
this.maxScrollX = elementHalfWidth - this.scrollerWidth + scrollerChildren[scrollerChildren.length - 1].offsetWidth / 2;
this.maxScrollY = elementHalfHeight - this.scrollerHeight + scrollerChildren[scrollerChildren.length - 1].offsetHeight / 2;
this.minScrollX = elementHalfWidth - scrollerChildren[0].offsetWidth / 2;
this.minScrollY = elementHalfHeight - scrollerChildren[0].offsetHeight / 2;
} else {
this.maxScrollY = 360;
this.minScrollY = 0;
}
this.scrolled = false;
this.touching = true;
this.scrollCanceled = false;
if (this.orientation === Scroller.Orientation.HORIZONTAL) {
this.maxScrollY = 0;
} else {
this.maxScrollX = 0;
}
elementStyle.overflow = "hidden";
elementStyle.position = "relative";
scrollerStyle.position = "absolute";
scrollerStyle.top = "0px";
scrollerStyle.left = "0px";
scrollerStyle.width = this.scrollerWidth + "px";
scrollerStyle.height = this.scrollerHeight + "px";
this._initScrollbar();
this._initBouncingEffect();
return element;
};
prototype._initScrollbar = function () {
var type = this.options.scrollbar,
scrollbarType;
if (type) {
scrollbarType = ns.widget.core.scroller.scrollbar.type[type];
if (scrollbarType) {
this.scrollbar = engine.instanceWidget(this.element, "ScrollBar", {
type: scrollbarType,
orientation: this.orientation
});
}
}
};
prototype._initBouncingEffect = function () {
var o = this.options;
if (o.useBouncingEffect) {
this.bouncingEffect = new EffectBouncing(this.element, {
maxScrollX: this.maxScrollX,
maxScrollY: this.maxScrollY,
orientation: this.orientation
});
}
};
prototype._resetLayout = function () {
var elementStyle = this.element.style,
scrollerStyle = this.scrollerStyle;
elementStyle.overflow = "";
elementStyle.position = "";
elementStyle.overflow = "hidden";
elementStyle.position = "relative";
if (scrollerStyle) {
scrollerStyle.position = "";
scrollerStyle.top = "";
scrollerStyle.left = "";
scrollerStyle.width = "";
scrollerStyle.height = "";
scrollerStyle["-webkit-transform"] = "";
scrollerStyle["-moz-transition"] = "";
scrollerStyle["-ms-transition"] = "";
scrollerStyle["-o-transition"] = "";
scrollerStyle["transition"] = "";
}
};
prototype._bindEvents = function () {
ns.event.enableGesture(
this.scroller,
new ns.event.gesture.Drag({
threshold: this.options.threshold,
delay: this.options.scrollDelay,
blockVertical: this.orientation === Scroller.Orientation.HORIZONTAL,
blockHorizontal: this.orientation === Scroller.Orientation.VERTICAL
})
);
utilsEvents.on(this.scroller, "drag dragstart dragend dragcancel", this);
window.addEventListener("resize", this);
};
prototype._unbindEvents = function () {
if (this.scroller) {
ns.event.disableGesture(this.scroller);
utilsEvents.off(this.scroller, "drag dragstart dragend dragcancel", this);
window.removeEventListener("resize", this);
}
};
/* jshint -W086 */
prototype.handleEvent = function (event) {
switch (event.type) {
case "dragstart":
this._start(event);
break;
case "drag":
this._move(event);
break;
case "dragend":
this._end(event);
break;
case "dragcancel":
this._cancel(event);
break;
case "resize":
this.refresh();
break;
}
};
prototype._refresh = function () {
this._unbindEvents();
this._clear();
this._init(this.element);
this._bindEvents();
};
/**
* Scrolls to new position.
* @method scrollTo
* @param {number} x
* @param {number} y
* @param {number} duration
* @member ns.widget.core.scroller.Scroller
*/
prototype.scrollTo = function (x, y, duration) {
this._translate(x, y, duration);
this._translateScrollbar(x, y, duration);
};
prototype._translate = function (x, y, duration) {
var translate,
transition = {
normal: "none",
webkit: "none",
moz: "none",
ms: "none",
o: "none"
},
scrollerStyle = this.scrollerStyle;
if (duration) {
transition.normal = "transform " + duration / 1000 + "s ease-out";
transition.webkit = "-webkit-transform " + duration / 1000 + "s ease-out";
transition.moz = "-moz-transform " + duration / 1000 + "s ease-out";
transition.ms = "-ms-transform " + duration / 1000 + "s ease-out";
transition.o = "-o-transform " + duration / 1000 + "s ease-out";
}
translate = "translate3d(" + x + "px," + y + "px, 0)";
scrollerStyle["-webkit-transform"] =
scrollerStyle["-moz-transform"] =
scrollerStyle["-ms-transform"] =
scrollerStyle["-o-transform"] =
scrollerStyle.transform = translate;
scrollerStyle.transition = transition.normal;
scrollerStyle["-webkit-transition"] = transition.webkit;
scrollerStyle["-moz-transition"] = transition.moz;
scrollerStyle["-ms-transition"] = transition.ms;
scrollerStyle["-o-transition"] = transition.o;
this.scrollerOffsetX = window.parseInt(x, 10);
this.scrollerOffsetY = window.parseInt(y, 10);
};
prototype._translateScrollbar = function (x, y, duration, autoHidden) {
if (!this.scrollbar) {
return;
}
this.scrollbar.translate(this.orientation === Scroller.Orientation.HORIZONTAL ? -x : -y, duration, autoHidden);
};
prototype._start = function () {
var self = this;
self.scrolled = false;
self.dragging = true;
self.scrollCanceled = false;
self.startScrollerOffsetX = self.scrollerOffsetX;
self.startScrollerOffsetY = self.scrollerOffsetY;
};
prototype._move = function (event) {
var newX = this.startScrollerOffsetX,
newY = this.startScrollerOffsetY,
autoHide = !_keepShowingScrollbarOnTouch;
if (!this.enabled || this.scrollCanceled || !this.dragging) {
return;
}
if (this.orientation === Scroller.Orientation.HORIZONTAL) {
newX += event.detail.estimatedDeltaX;
} else {
newY += event.detail.estimatedDeltaY;
}
if (newX > this.minScrollX || newX < this.maxScrollX) {
newX = newX > this.minScrollX ? this.minScrollX : this.maxScrollX;
}
if (newY > this.minScrollY || newY < this.maxScrollY) {
newY = newY > this.minScrollY ? this.minScrollY : this.maxScrollY;
}
if (newX !== this.scrollerOffsetX || newY !== this.scrollerOffsetY) {
if (!this.scrolled) {
this.trigger(eventType.START);
}
this.scrolled = true;
this._translate(newX, newY);
this._translateScrollbar(newX, newY, 0, autoHide);
// TODO to dispatch move event is too expansive. it is better to use callback.
this.trigger(eventType.MOVE);
if (this.bouncingEffect) {
this.bouncingEffect.hide();
}
} else {
if (this.bouncingEffect) {
this.bouncingEffect.drag(newX, newY);
}
this._translateScrollbar(newX, newY, 0, autoHide);
}
};
prototype._end = function () {
if (this.dragging) {
// bouncing effect
if (this.bouncingEffect) {
this.bouncingEffect.dragEnd();
}
if (this.scrollbar) {
this.scrollbar.end();
}
this._endScroll();
this.dragging = false;
}
};
prototype._endScroll = function () {
if (this.scrolled) {
this.trigger(eventType.END);
}
this.scrolled = false;
};
/**
* Cancels scroll.
* @method _cancel
* @protected
* @member ns.widget.core.scroller.Scroller
*/
prototype._cancel = function () {
this.scrollCanceled = true;
if (this.scrolled) {
this._translate(this.startScrollerOffsetX, this.startScrollerOffsetY);
this._translateScrollbar(this.startScrollerOffsetX, this.startScrollerOffsetY);
this.trigger(eventType.CANCEL);
}
if (this.scrollbar) {
this.scrollbar.end();
}
this.scrolled = false;
this.dragging = false;
};
prototype._clear = function () {
this.scrolled = false;
this.scrollCanceled = false;
this._resetLayout();
this._clearScrollbar();
this._clearBouncingEffect();
};
prototype._clearScrollbar = function () {
if (this.scrollbar) {
this.scrollbar.destroy();
}
this.scrollbar = null;
};
prototype._clearBouncingEffect = function () {
if (this.bouncingEffect) {
this.bouncingEffect.destroy();
}
this.bouncingEffect = null;
};
prototype._disable = function () {
this.enabled = false;
};
prototype._enable = function () {
this.enabled = true;
};
prototype._destroy = function () {
this._unbindEvents();
this._clear();
this.scrollerStyle = null;
this.scroller = null;
};
Scroller.prototype = prototype;
ns.widget.core.scroller.Scroller = Scroller;
engine.defineWidget(
"Scroller",
".scroller",
["scrollTo", "cancel"],
Scroller
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* #Scrollbar namespace
* Namespace with scrollbar for scroller widget.
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @class ns.widget.core.scroller.scrollbar
*/
(function (window, ns) {
"use strict";
ns.widget.core.scroller.scrollbar = ns.widget.core.scroller.scrollbar || {};
}(window, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* #type namespace
* Namespace with types of scroll bars..
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @class ns.widget.core.scroller.scrollbar.type
* @internal
*/
(function (window, ns) {
"use strict";
/** @namespace ns.widget.core */
ns.widget.core.scroller.scrollbar.type = ns.widget.core.scroller.scrollbar.type || {};
}(window, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Type Interface
* Interface for types used in scroll bar widget.
* @class ns.widget.core.scroller.scrollbar.type.interface
*/
(function (document, ns) {
"use strict";
// scroller.start event trigger when user try to move scroller
ns.widget.core.scroller.scrollbar.type.interface = {
/**
* Inserts elements end decorate.
* @method insertAndDecorate
* @static
* @member ns.widget.core.scroller.scrollbar.type.interface
*/
setScrollbarLayout: function (/* options */) {
},
/**
* Removes element.
* @method remove
* @static
* @member ns.widget.core.scroller.scrollbar.type.interface
*/
remove: function (/* options */) {
},
/**
* ...
* @method start
* @static
* @member ns.widget.core.scroller.scrollbar.type.interface
*/
start: function (/* scrollbarElement, barElement */) {
},
/**
* ...
* @method end
* @static
* @member ns.widget.core.scroller.scrollbar.type.interface
*/
end: function (/* scrollbarElement, barElement */) {
},
/**
* ...
* @method offset
* @static
* @member ns.widget.core.scroller.scrollbar.type.interface
*/
offset: function (/* orientation, offset */) {
}
};
}(window.document, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Bar Type
* Bar type support for scroll bar widget.
* @class ns.widget.core.scroller.scrollbar.type.bar
* @extends ns.widget.core.scroller.scrollbar.type.interface
*/
(function (document, ns) {
"use strict";
// scroller.start event trigger when user try to move scroller
var utilsObject = ns.util.object,
type = ns.widget.core.scroller.scrollbar.type,
typeInterface = type.interface,
Scroller = ns.widget.core.scroller.Scroller;
type.bar = utilsObject.merge({}, typeInterface, {
options: {
animationDuration: 500
},
/**
* @method setScrollbar
* @param viewLayout
* @param firstChildLayout
* @param clipLayout
* @static
* @member ns.widget.core.scroller.scrollbar.type.bar
*/
setScrollbar: function (viewLayout, firstChildLayout, clipLayout) {
this._viewLayout = viewLayout;
this._clipLayout = clipLayout;
this._firstChildLayout = firstChildLayout;
this._ratio = clipLayout / firstChildLayout;
},
/**
* @method getScrollbarSize
* @return {number} scrollbar size
* @static
* @member ns.widget.core.scroller.scrollbar.type.bar
*/
getScrollbarSize: function () {
return this._firstChildLayout / this._viewLayout * this._firstChildLayout * this._ratio;
},
/**
* @method offset
* @param {string} orientation
* @param {number} offset
* @static
* @member ns.widget.core.scroller.scrollbar.type.bar
*/
offset: function (orientation, offset) {
var x,
y;
offset = offset * this._clipLayout / this._viewLayout;
if (orientation === Scroller.Orientation.VERTICAL) {
x = 0;
y = offset;
} else {
x = offset;
y = 0;
}
return {
x: x,
y: y
};
},
/**
* @method start
* @param {HTMLElement} scrollbarElement
* @static
* @member ns.widget.core.scroller.scrollbar.type.bar
*/
start: function (scrollbarElement/*, barElement */) {
var style = scrollbarElement.style,
duration = this.options.animationDuration;
style["-webkit-transition"] =
style["-moz-transition"] =
style["-ms-transition"] =
style["-o-transition"] =
style.transition = "opacity " + duration / 1000 + "s ease";
style.opacity = 1;
},
/**
* @method end
* @param {HTMLElement} scrollbarElement
* @static
* @member ns.widget.core.scroller.scrollbar.type.bar
*/
end: function (scrollbarElement) {
var style = scrollbarElement.style,
duration = this.options.animationDuration;
style["-webkit-transition"] =
style["-moz-transition"] =
style["-ms-transition"] =
style["-o-transition"] =
style.transition = "opacity " + duration / 1000 + "s ease";
style.opacity = 0;
}
});
}(window.document, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Tab Type
* Tab type support for scroll bar widget.
* @class ns.widget.core.scroller.scrollbar.type.tab
* @extends ns.widget.core.scroller.scrollbar.type.interface
*/
(function (document, ns) {
"use strict";
// scroller.start event trigger when user try to move scroller
var utilsObject = ns.util.object,
type = ns.widget.core.scroller.scrollbar.type,
typeInterface = type.interface,
Scroller = ns.widget.core.scroller.Scroller;
type.tab = utilsObject.merge({}, typeInterface, {
options: {
wrapperClass: "ui-scrollbar-tab-type",
barClass: "ui-scrollbar-indicator",
margin: 1
},
/**
* ...
* @method insertAndDecorate
* @param {Object} data
* @static
* @member ns.widget.core.scroller.scrollbar.type.tab
*/
insertAndDecorate: function (data) {
var scrollbarElement = data.wrapper,
barElement = data.bar,
container = data.container,
clip = data.clip,
sections = data.sections,
orientation = data.orientation,
margin = this.options.margin,
clipWidth = clip.offsetWidth,
clipHeight = clip.offsetHeight,
containerWidth = container.offsetWidth,
containerHeight = container.offsetHeight,
clipSize = orientation === Scroller.Orientation.VERTICAL ? clipHeight : clipWidth,
containerSize = orientation === Scroller.Orientation.VERTICAL ? containerHeight : containerWidth,
sectionSize = clipSize / containerSize,
height,
barHeight,
i,
len;
this.containerSize = containerWidth;
this.maxScrollOffset = clipSize - containerSize;
this.scrollZoomRate = containerWidth / clipSize;
this.barSize = window.parseInt((containerWidth - margin * 2 * (sectionSize - 1)) / sectionSize);
scrollbarElement.className = this.options.wrapperClass;
barElement.className = this.options.barClass;
barElement.style.width = this.barSize + "px";
barElement.style.left = "0px";
container.insertBefore(scrollbarElement, clip);
// reset page container and section layout.
barHeight = barElement.offsetHeight;
height = clipHeight - barHeight;
clip.style.height = height + "px";
if (sections && sections.length) {
for (i = 0, len = sections.length; i < len; i++) {
sections[i].style.height = height + "px";
}
}
},
/**
* ...
* @method remove
* @param {Object} data
* @static
* @member ns.widget.core.scroller.scrollbar.type.tab
*/
remove: function (data) {
var scrollbarElement = data.wrapper,
container = data.container;
if (container && scrollbarElement) {
container.removeChild(scrollbarElement);
}
},
/**
* ...
* @method offset
* @param {string} orientation
* @param {number} offset
* @static
* @member ns.widget.core.scroller.scrollbar.type.tab
*/
offset: function (orientation, offset) {
return {
x: offset === 0 ? -1 :
offset === this.maxScrollOffset ? this.containerSize - this.barSize - this.options.margin : offset * this.scrollZoomRate,
y: 0
};
}
});
}(window.document, ns));
/*global window, define, Event, console, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Scroll Bar Widget
* Widget creates scroll bar.
* @class ns.widget.core.scroller.scrollbar.ScrollBar
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
// scroller.start event trigger when user try to move scroller
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
prototype = new BaseWidget(),
utilsObject = ns.util.object,
selectors = ns.util.selectors,
Page = ns.widget.core.Page,
Classes = {
wrapperClass: "ui-scrollbar-bar-type",
barClass: "ui-scrollbar-indicator",
orientationClass: "ui-scrollbar-",
page: Page.classes.uiPage
},
Scroller = ns.widget.core.scroller.Scroller,
ScrollerScrollBar = function () {
this.wrapper = null;
this.barElement = null;
this.container = null;
this.view = null;
this.options = {};
this.type = null;
this.maxScroll = null;
this.started = false;
this.displayDelayTimeoutId = null;
this.lastScrollPosition = 0;
};
prototype._build = function (scrollElement) {
this.clip = scrollElement;
this.view = scrollElement.children[0];
this.firstChild = this.view.children[0];
return scrollElement;
};
prototype._configure = function () {
/**
* @property {Object} options Options for widget
* @property {boolean} [options.type=false]
* @property {number} [options.displayDelay=700]
* @property {"vertical"|"horizontal"} [options.orientation="vertical"]
* @member ns.widget.core.scroller.scrollbar.ScrollBar
*/
this.options = utilsObject.merge({}, this.options, {
type: false,
displayDelay: 700,
orientation: Scroller.Orientation.VERTICAL
});
};
prototype._init = function (scrollElement) {
this.clip = scrollElement;
this.view = scrollElement.children[0];
this.firstChild = this.view.children[0];
this.type = this.options.type;
if (!this.type) {
return;
}
this._createScrollbar();
};
prototype._bindEvents = function () {
document.addEventListener("visibilitychange", this);
};
prototype._createScrollbar = function () {
var orientation = this.options.orientation,
wrapper = document.createElement("DIV"),
bar = document.createElement("span"),
view = this.view,
clip = this.clip,
firstChild = this.firstChild,
type = this.type;
clip.appendChild(wrapper);
wrapper.appendChild(bar);
wrapper.classList.add(Classes.wrapperClass);
bar.className = Classes.barClass;
if (orientation === Scroller.Orientation.HORIZONTAL) {
type.setScrollbar(view.offsetWidth, firstChild.offsetWidth, clip.offsetWidth);
bar.style.width = type.getScrollbarSize() + "px";
wrapper.classList.add(Classes.orientationClass + "horizontal");
} else {
type.setScrollbar(view.offsetHeight, firstChild.offsetHeight, clip.offsetHeight);
bar.style.height = type.getScrollbarSize() + "px";
wrapper.classList.add(Classes.orientationClass + "vertical");
}
this.wrapper = wrapper;
this.barElement = bar;
};
prototype._removeScrollbar = function () {
this.clip.removeChild(this.wrapper);
this.wrapper = null;
this.barElement = null;
};
prototype._refresh = function () {
var self = this;
self._clear();
self._init();
self.translate(self.lastScrollPosition);
};
/**
* Translates widget.
* @method translate
* @param {number} offset
* @param {number} duration
* @param {boolean} autoHidden
* @member ns.widget.core.scroller.scrollbar.ScrollBar
*/
prototype.translate = function (offset, duration, autoHidden) {
var orientation = this.options.orientation,
translate,
transition = {
normal: "none",
webkit: "none",
moz: "none",
ms: "none",
o: "none"
},
barStyle,
endDelay;
if (!this.wrapper || !this.type || this.lastScrollPosition === offset) {
return;
}
autoHidden = autoHidden !== false;
this.lastScrollPosition = offset;
offset = this.type.offset(orientation, offset);
barStyle = this.barElement.style;
if (duration) {
transition.normal = "transform " + duration / 1000 + "s ease-out";
transition.webkit = "-webkit-transform " + duration / 1000 + "s ease-out";
transition.moz = "-moz-transform " + duration / 1000 + "s ease-out";
transition.ms = "-ms-transform " + duration / 1000 + "s ease-out";
transition.o = "-o-transform " + duration / 1000 + "s ease-out";
}
translate = "translate3d(" + offset.x + "px," + offset.y + "px, 0)";
barStyle["-webkit-transform"] =
barStyle["-moz-transform"] =
barStyle["-ms-transform"] =
barStyle["-o-transform"] =
barStyle.transform = translate;
barStyle["-webkit-transition"] = transition.webkit;
barStyle["-moz-transition"] = transition.moz;
barStyle["-ms-transition"] = transition.ms;
barStyle["-o-transition"] = transition.o;
barStyle.transition = transition.normal;
if (!this.started) {
this._start();
}
if (this.displayDelayTimeoutId !== null) {
window.clearTimeout(this.displayDelayTimeoutId);
this.displayDelayTimeoutId = null;
}
if (autoHidden) {
endDelay = (duration || 0) + this.options.displayDelay;
this.displayDelayTimeoutId = window.setTimeout(this._end.bind(this), endDelay);
}
};
prototype.end = function () {
if (!this.displayDelayTimeoutId) {
this.displayDelayTimeoutId = window.setTimeout(this._end.bind(this), this.options.displayDelay);
}
};
prototype._start = function () {
this.type.start(this.wrapper, this.barElement);
this.started = true;
};
prototype._end = function () {
this.started = false;
this.displayDelayTimeoutId = null;
if (this.type) {
this.type.end(this.wrapper, this.barElement);
}
};
/**
* Supports events.
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.scroller.scrollbar.ScrollBar
*/
prototype.handleEvent = function (event) {
var page;
switch (event.type) {
case "visibilitychange":
page = selectors.getClosestBySelector(this.clip, "." + Classes.page);
if (document.visibilityState === "visible" && page === ns.activePage) {
this.refresh();
}
break;
}
};
prototype._clear = function () {
this._removeScrollbar();
this.started = false;
this.type = null;
this.barElement = null;
this.displayDelayTimeoutId = null;
};
prototype._destroy = function () {
this._clear();
document.removeEventListener("visibilitychange", this);
this.options = null;
this.clip = null;
this.view = null;
};
ScrollerScrollBar.prototype = prototype;
ns.widget.core.scroller.scrollbar.ScrollBar = ScrollerScrollBar;
engine.defineWidget(
"ScrollBar",
"",
["translate"],
ScrollerScrollBar
);
}(window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Grid Utility
* Object helps creating grids.
* @class ns.util.grid
*/
(function (ns) {
"use strict";
/**
* Local alias for ns.util.selectors
* @property {Object} selectors Alias for {@link ns.util.selectors}
* @member ns.util.grid
* @static
* @private
*/
var selectors = ns.util.selectors,
/**
* Alias to Array.slice method
* @method slice
* @member ns.util.grid
* @private
* @static
*/
slice = [].slice,
/**
* grid types
* @property {Array} gridTypes
* @member ns.util.grid
* @static
* @private
*/
gridTypes = [
null,
"solo", //1
"a", //2
"b", //3
"c", //4
"d" //5
];
/**
* Add classes on the matched elements
* @method setClassOnMatches
* @param {HTMLElementCollection} elements
* @param {string} selector
* @param {string} className
* @private
* @member ns.util.grid
* @static
*/
function setClassOnMatches(elements, selector, className) {
elements.forEach(function (item) {
if (selectors.matchesSelector(item, selector)) {
item.classList.add(className);
}
});
}
ns.util.grid = {
/**
* make css grid
* @method makeGrid
* @param {HTMLElement} element
* @param {?string} [gridType="a"]
* @static
* @member ns.util.grid
*/
makeGrid: function (element, gridType) {
var gridClassList = element.classList,
kids = slice.call(element.children),
iterator;
if (!gridType) {
gridType = gridTypes[kids.length];
if (!gridType) {
//if gridType is not defined in gritTypes
//make it grid type "a""
gridType = "a";
iterator = 2;
gridClassList.add("ui-grid-duo");
}
}
if (!iterator) {
//jquery grid doesn't care if someone gives non-existing gridType
iterator = gridTypes.indexOf(gridType);
}
gridClassList.add("ui-grid-" + gridType);
setClassOnMatches(kids, ":nth-child(" + iterator + "n+1)", "ui-block-a");
if (iterator > 1) {
setClassOnMatches(kids, ":nth-child(" + iterator + "n+2)", "ui-block-b");
}
if (iterator > 2) {
setClassOnMatches(kids, ":nth-child(" + iterator + "n+3)", "ui-block-c");
}
if (iterator > 3) {
setClassOnMatches(kids, ":nth-child(" + iterator + "n+4)", "ui-block-d");
}
if (iterator > 4) {
setClassOnMatches(kids, ":nth-child(" + iterator + "n+5)", "ui-block-e");
}
}
};
}(ns));
/*global window, ns, define */
/*jslint nomen: true, plusplus: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Easing Utility
* Utility calculates time function for animations.
* @class ns.util.easing
*/
(function (ns) {
"use strict";
ns.util.easing = {
/**
* Performs cubit out easing calculations based on time
* @method cubicOut
* @member ns.util.easing
* @param {number} currentTime
* @param {number} startValue
* @param {number} changeInValue
* @param {number} duration
* @return {number}
* @static
*/
cubicOut: function (currentTime, startValue, changeInValue, duration) {
currentTime /= duration;
currentTime--;
return changeInValue * (currentTime * currentTime * currentTime + 1) + startValue;
},
/**
* Performs quad easing out calculations based on time
* @method easeOutQuad
* @member ns.util.easing
* @param {number} currentTime
* @param {number} startValue
* @param {number} changeInValue
* @param {number} duration
* @return {number}
* @static
*/
easeOutQuad: function (currentTime, startValue, changeInValue, duration) {
return -changeInValue * (currentTime /= duration) * (currentTime - 2) + startValue;
},
/**
* Performs sine easing out calculations based on time
* The easing functions can be compared on: https://easings.net
* @method easeOutSine
* @member ns.util.easing
* @param {number} currentTime
* @param {number} startValue
* @param {number} changeInValue
* @param {number} duration
* @return {number}
* @static
*/
easeOutSine: function (currentTime, startValue, changeInValue, duration) {
return changeInValue * Math.sin(currentTime / duration * (Math.PI / 2)) + startValue;
},
/**
* Performs out expo easing calculations based on time
* @method easeOutExpo
* @member ns.util.easing
* @param {number} currentTime
* @param {number} startValue
* @param {number} changeInValue
* @param {number} duration
* @return {number}
* @static
*/
easeOutExpo: function (currentTime, startValue, changeInValue, duration) {
return (currentTime === duration) ?
startValue + changeInValue :
changeInValue * (-Math.pow(2, -10 * currentTime / duration) + 1) +
startValue;
},
/**
* Performs out linear calculations based on time
* @method linear
* @member ns.util.easing
* @param {number} currentTime
* @param {number} startValue
* @param {number} changeInValue
* @param {number} duration
* @return {number}
* @static
*/
linear: function (currentTime, startValue, changeInValue, duration) {
return startValue + changeInValue * currentTime / duration;
}
};
}(ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Event orientationchange
* Namespace to support orientationchange event
* @class ns.event.orientationchange
*/
/**
* Event orientationchange
* @event orientationchange
* @member ns.event.orientationchange
*/
(function (window, document, ns) {
"use strict";
var body = document.body,
eventUtils = ns.event,
eventType = ns.engine.eventType,
orientationchange = {
/**
* Window alias
* @property {Window} window
* @member ns.event.orientationchange
* @static
* @protected
*/
_window: window,
/**
* Informs about support orientation change event.
* @property {boolean} supported
* @member ns.event.orientationchange
*/
supported: (window.orientation !== undefined) && (window.onorientationchange !== undefined),
/**
* List of properties copied to event details object
* @property {Array} properties
* @member ns.event.orientationchange
* @static
*/
properties: ["orientation"],
/**
* Chosen orientation
* @property {Window} [orientation=portrait]
* @member ns.event.orientationchange
* @protected
* @static
*/
_orientation: "portrait"
},
detectOrientationByDimensions = function (omitCustomEvent) {
var win = orientationchange._window,
width = win.innerWidth,
height = win.innerHeight;
if (win.screen) {
width = win.screen.availWidth;
height = win.screen.availHeight;
}
if (width > height) {
orientationchange._orientation = "landscape";
} else {
orientationchange._orientation = "portrait";
}
if (!omitCustomEvent) {
eventUtils.trigger(window, "orientationchange", {"orientation": orientationchange._orientation});
}
},
checkReportedOrientation = function () {
if (orientationchange._window.orientation) {
switch (orientationchange._window.orientation) {
case 90:
case -90:
orientationchange._orientation = "portrait";
break;
default:
orientationchange._orientation = "landscape";
break;
}
} else {
detectOrientationByDimensions(true);
}
},
matchMediaHandler = function (mediaQueryList, omitEvent) {
if (mediaQueryList.matches) {
orientationchange._orientation = "portrait";
} else {
orientationchange._orientation = "landscape";
}
if (!omitEvent) { // this was added explicit for testing
eventUtils.trigger(window, "orientationchange", {"orientation": orientationchange._orientation});
}
},
portraitMatchMediaQueryList = null;
/**
* Returns current orientation.
* @method getOrientation
* @return {"landscape"|"portrait"}
* @member ns.event.orientationchange
* @static
*/
orientationchange.getOrientation = function () {
return orientationchange._orientation;
};
/**
* Triggers event orientationchange on element
* @method trigger
* @param {HTMLElement} element
* @member ns.event.orientationchange
* @static
*/
orientationchange.trigger = function (element) {
eventUtils.trigger(element, "orientationchange", {"orientation": orientationchange._orientation});
};
/**
* Unbinds events
* @member ns.event.orientationchange
* @static
*/
orientationchange.unbind = function () {
window.removeEventListener("orientationchange", checkReportedOrientation, false);
body.removeEventListener("throttledresize", detectOrientationByDimensions, false);
document.removeEventListener(eventType.DESTROY, orientationchange.unbind, false);
};
/**
* Performs orientation detection
* @member ns.event.orientationchange
* @static
*/
orientationchange.detect = function () {
if (orientationchange.supported) {
window.addEventListener("orientationchange", checkReportedOrientation, false);
checkReportedOrientation();
// try media queries
} else {
if (orientationchange._window.matchMedia) {
portraitMatchMediaQueryList = orientationchange._window.matchMedia("(orientation: portrait)");
if (portraitMatchMediaQueryList.matches) {
orientationchange._orientation = "portrait";
} else {
orientationchange._orientation = "landscape";
}
portraitMatchMediaQueryList.addListener(matchMediaHandler);
} else {
body.addEventListener("throttledresize", detectOrientationByDimensions, false);
detectOrientationByDimensions();
}
}
};
document.addEventListener(eventType.DESTROY, orientationchange.unbind, false);
orientationchange.detect();
ns.event.orientationchange = orientationchange;
}(window, window.document, ns));
/*global window, define, ns*/
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # ScrollView Widget
* Widgets allows for creating scrollable panes, lists, etc.
*
* ## Default selectors
* All elements with _data-role=content attribute or _.ui-scrollview
* css class will be changed to ScrollView widgets, unless they specify
* _data-scroll=none attribute.
*
* ### HTML Examples
*
* #### Data attribute
*
* @example
* <div data-role="page">
* <div data-role="content"><!-- this will become scrollview //-->
* content data
* </div>
* </div>
*
* #### CSS Class
*
* @example
* <div data-role="page">
* <div class="ui-content"><!-- this will become scrollview //-->
* content data
* </div>
* </div>
*
* ## Manual constructor
*
* To create the widget manually you can use 2 different APIs, the TAU
* API or jQuery API.
*
* ### Create scrollview by TAU API
*
* @example
* <div data-role="page" id="myPage">
* <div data-role="content">
* page content
* </div>
* </div>
* <script>
* var page = tau.widget.Page(document.getElementById("myPage")),
* scrollview = tau.widget.Scrollview(page.ui.content);
* </script>
*
* ### Create scrollview using jQuery API
*
* @example
* <div data-role="page" id="myPage">
* <div data-role="content">
* page content
* </div>
* </div>
* <script>
* $("#myPage > div[data-role='content']").scrollview();
* </script>
*
* ## Options for Scrollview widget
*
* Options can be set using data-* attributes or by passing them to
* the constructor.
*
* There is also a method **option** for changing them after widget
* creation.
*
* jQuery mobile format is also supported.
*
* ## Scroll
*
* This options specifies of a content element should become Scrollview
* widget.
*
* You can change this by all available methods for changing options.
*
* ### By data-scroll attribute
*
* @example
* <div data-role="page">
* <div data-role="content" data-scroll="none">
* content
* </div>
* </div>
*
* ### By config passed to constructor
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content">
* content
* </div>
* </div>
* <script>
* var contentElement = document.querySelector(".myPageClass > div[data-role=content]");
* tau.widget.Scrollview(contentElement, {
* "scroll": false
* });
* </script>
*
* ### By using jQuery API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content">
* content
* </div>
* </div>
* <script>
* $(".myPageClass > div[data-role='content']").scrollview({
* "scroll": false
* });
* </script>
*
* ## ScrollJumps
*
* Scroll jumps are small buttons which allow the user to quickly
* scroll to top or left
*
* You can change this by all available methods for changing options.
*
* ### By data-scroll-jump
*
* @example
* <div data-role="page">
* <div data-role="content" data-scroll-jump="true">
* content
* </div>
* </div>
*
* ### By config passed to constructor
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content">
* content
* </div>
* </div>
* <script>
* var contentElement = document.querySelector(".myPageClass > div[data-role=content]");
* tau.widget.Scrollview(contentElement, {
* "scrollJump": true
* });
* </script>
*
* ### By using jQuery API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content">
* content
* </div>
* </div>
* <script>
* $(".myPageClass > div[data-role='content']").scrollview({
* "scrollJump": true
* });
* </script>
*
* ## Methods
*
* Page methods can be called trough 2 APIs: TAU API and jQuery API
* (jQuery mobile-like API)
*
* @class ns.widget.core.Scrollview
* @extends ns.widget.BaseWidget
*
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Grzegorz Osimowicz <g.osimowicz@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Hyunkook Cho <hk0713.cho@samsung.com>
* @author Junhyeon Lee <juneh.lee@samsung.com>
*/
/**
* Triggered when scrolling operation starts
* @event scrollstart
* @member ns.widget.core.Scrollview
*/
/**
* Triggered when scroll is being updated
* @event scrollupdate
* @member ns.widget.core.Scrollview
*/
/**
* Triggered when scrolling stops
* @event scrollstop
* @member ns.widget.core.Scrollview
*/
(function (window, document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
util = ns.util,
easingUtils = ns.util.easing,
eventUtils = ns.event,
DOMUtils = ns.util.DOM,
selectors = ns.util.selectors,
currentTransition = null,
Page = ns.widget.core.Page,
pageClass = Page.classes.uiPage,
pageActiveClass = Page.classes.uiPageActive,
pageEvents = Page.events,
Scrollview = function () {
var self = this,
ui;
/**
* @property {Object} _scrollState Scrollview internal state object
* @property {Function} _scrollState.currentTransition Instance transition function
* @readonly
*/
self._scrollState = {
currentTransition: null
};
/**
* @property {number} scrollDuration The time length of the scroll animation
* @member ns.widget.core.Scrollview
*/
self.scrollDuration = 300;
self.scrollviewSetHeight = false;
/**
* Scrollview options
* @property {Object} options
* @property {string} [options.scroll='y'] Scroll direction
* @property {boolean} [options.scrollJump=false] Scroll jump buttons flag
* @member ns.widget.core.Scrollview
*/
self.options = {
scroll: "y",
scrollJump: false,
scrollIndicator: false
};
/**
* Dictionary for holding internal DOM elements
* @property {Object} ui
* @property {HTMLElement} ui.view The main view element
* @property {HTMLElement} ui.page The main page element
* @property {HTMLElement} ui.jumpHorizontalButton Jump left button
* @property {HTMLElement} ui.jumpVerticalButton Jump top button
* @member ns.widget.core.Scrollview
* @readonly
*/
ui = self._ui || {};
ui.view = null;
ui.page = null;
ui.jumpHorizontalButton = null;
ui.jumpVerticalButton = null;
self._ui = ui;
/**
* Dictionary for holding internal listeners
* @property {Object} _callbacks
* @property {Function} _callbacks.repositionJumps Refresh jumps listener
* @property {Function} _callbacks.jumpTop Top jump button click callback
* @property {Function} _callbacks.jumpLeft Left jump button click callback
* @member ns.widget.core.Scrollview
* @protected
* @readonly
*/
self._callbacks = {
repositionJumps: null,
jumpTop: null,
jumpBottom: null
};
self._timers = {
scrollIndicatorHide: null
};
},
/**
* Dictionary for scrollview css classes
* @property {Object} classes
* @property {string} [classes.view='ui-scrollview-view'] View main class
* @property {string} [classes.clip='ui-scrollview-clip'] Clip main class
* @property {string} [classes.jumpTop='ui-scroll-jump-top-bg'] Jump top button background
* @property {string} [classes.jumpLeft='ui-scroll-jump-left-bg'] Jump bottom button background
* @member ns.widget.core.Scrollview
* @static
* @readonly
*/
classes = {
view: "ui-scrollview-view",
clip: "ui-scrollview-clip",
jumpTop: "ui-scroll-jump-top-bg",
jumpLeft: "ui-scroll-jump-left-bg",
indicatorTop: "ui-overflow-indicator-top",
indicatorBottom: "ui-overflow-indicator-bottom",
indicatorTopShown: "ui-scrollindicator-top",
indicatorBottomShown: "ui-scrollindicator-bottom",
indicatorLeftShown: "ui-scrollindicator-left",
indicatorRightShown: "ui-scrollindicator-right"
};
// Changes static position to relative
// @param {HTMLElement} view
function makePositioned(view) {
if (DOMUtils.getCSSProperty(view, "position") === "static") {
view.style.position = "relative";
} else {
view.style.position = "absolute";
}
}
// Translation animation loop
// @param {Object} state Scrollview instance state
// @param {HTMLElement} element
// @param {number} startTime
// @param {number} startX
// @param {number} startY
// @param {number} translateX
// @param {number} translateY
// @param {number} endX
// @param {number} endY
// @param {number} duration
function translateTransition(state, element, startTime, startX, startY, translateX, translateY, endX, endY, duration) {
var timestamp = (new Date()).getTime() - startTime,
newX = parseInt(easingUtils.cubicOut(timestamp, startX, translateX, duration), 10),
newY = parseInt(easingUtils.cubicOut(timestamp, startY, translateY, duration), 10);
if (element.scrollLeft !== endX) {
element.scrollLeft = newX;
}
if (element.scrollTop !== endY) {
element.scrollTop = newY;
}
if ((newX !== endX || newY !== endY) &&
(newX >= 0 && newY >= 0) &&
state.currentTransition) {
util.requestAnimationFrame(state.currentTransition);
} else {
state.currentTransition = null;
}
}
// Translates scroll position directly or with an animation
// if duration is specified
// @param {Object} state Scrollview instance state
// @param {HTMLElement} element
// @param {number} x
// @param {number} y
// @param {number=} [duration]
function translate(state, element, x, y, duration) {
if (duration) {
state.currentTransition = translateTransition.bind(
null,
state,
element,
(new Date()).getTime(),
element.scrollLeft,
element.scrollTop,
x,
y,
element.scrollLeft + x,
element.scrollTop + y,
duration
);
util.requestAnimationFrame(state.currentTransition);
} else {
if (x) {
element.scrollLeft = element.scrollLeft + x;
}
if (y) {
element.scrollTop = element.scrollTop + y;
}
}
}
// Refresh jumpTop jumpLeft buttons
// @param {ns.widget.core.Scrollview} self
function repositionJumps(self) {
var ui = self._ui,
horizontalJumpButton = ui.jumpHorizontalButton,
verticalJumpButton = ui.jumpVerticalButton,
offsets = horizontalJumpButton || verticalJumpButton ? DOMUtils.getElementOffset(self.element) : null; // don't calc when not used
if (horizontalJumpButton) {
horizontalJumpButton.style.left = offsets.left + "px";
}
if (verticalJumpButton) {
verticalJumpButton.style.top = offsets.top + "px";
}
}
Scrollview.classes = classes;
Scrollview.prototype = new BaseWidget();
/**
* Builds the widget
* @param {HTMLElement} element
* @return {HTMLElement}
* @method _build
* @protected
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype._build = function (element) {
//@TODO wrap element's content with external function
var self = this,
ui = self._ui,
view = selectors.getChildrenByClass(element, classes.view)[0] || document.createElement("div"),
clipStyle = element.style,
node,
child = element.firstChild,
options = self.options,
direction = options.scroll,
jumpButton,
jumpBackground;
view.className = classes.view;
while (child) {
node = child;
child = child.nextSibling;
if (view !== node) {
view.appendChild(node);
}
}
if (view.parentNode !== element) {
element.appendChild(view);
}
// setting view style
makePositioned(view);
element.classList.add(classes.clip);
// Adding ui-content class for the proper styling with CE
element.classList.add("ui-content");
switch (direction) {
case "x":
clipStyle.overflowX = "scroll";
break;
case "xy":
clipStyle.overflow = "scroll";
break;
default:
clipStyle.overflowY = "auto";
break;
}
if (options.scrollJump) {
if (direction.indexOf("x") > -1) {
jumpBackground = document.createElement("div");
jumpBackground.className = classes.jumpLeft;
jumpButton = document.createElement("div");
jumpBackground.appendChild(jumpButton);
element.appendChild(jumpBackground);
engine.instanceWidget(
jumpButton,
"Button",
{
"icon": "scrollleft",
"style": "box"
}
);
ui.jumpHorizontalButton = jumpBackground;
}
if (direction.indexOf("y") > -1) {
jumpBackground = document.createElement("div");
jumpBackground.className = classes.jumpTop;
jumpButton = document.createElement("div");
jumpBackground.appendChild(jumpButton);
element.appendChild(jumpBackground);
engine.instanceWidget(
jumpButton,
"Button",
{
"icon": "scrolltop",
"style": "box"
}
);
ui.jumpVerticalButton = jumpBackground;
}
}
ui.view = view;
// add scroll indicators
if (options.scrollIndicator) {
self._addOverflowIndicator(element);
}
return element;
};
/**
* Inits widget
* @method _init
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype._init = function (element) {
var ui = this._ui,
page = ui.page;
if (!ui.view) {
ui.view = selectors.getChildrenByClass(element, classes.view)[0];
}
if (!page) {
page = selectors.getClosestByClass(element, pageClass);
if (page) {
ui.page = page;
if (page.classList.contains(pageActiveClass) && this.options.scrollJump) {
repositionJumps(this);
}
}
}
};
/**
* Adds overflow indicators
* @param {HTMLElement} clip
* @method _addOverflowIndicator
* @protected
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype._addOverflowIndicator = function (clip) {
clip.insertAdjacentHTML("beforeend",
"<div class='" + classes.indicatorTop + "'></div><div class='" + classes.indicatorBottom + "'></div>");
};
/**
* Clear classes and styles of indicators
* @param {HTMLElement} element
* @method clearIndicator
* @private
* @member ns.widget.core.Scrollview
*/
function clearIndicator(element) {
var clipClasses = element.classList,
topIndicator = selectors.getChildrenByClass(element, classes.indicatorTop)[0],
bottomIndicator = selectors.getChildrenByClass(element, classes.indicatorBottom)[0];
clipClasses.remove(classes.indicatorTopShown);
clipClasses.remove(classes.indicatorBottomShown);
clipClasses.remove(classes.indicatorRightShown);
clipClasses.remove(classes.indicatorLeftShown);
topIndicator.style = "";
bottomIndicator.style = "";
}
/**
* Set top and bottom indicators
* @param {HTMLElement} clip
* @param {Object} options
* @method setTopAndBottomIndicators
* @private
* @member ns.widget.core.Scrollview
*/
function setTopAndBottomIndicators(clip, options) {
var topIndicator = selectors.getChildrenByClass(clip, classes.indicatorTop)[0],
bottomIndicator = selectors.getChildrenByClass(clip, classes.indicatorBottom)[0],
style;
// set top indicator
if (topIndicator) {
style = topIndicator.style;
style.width = options.width + "px";
style.top = options.clipTop + "px";
style.backgroundColor = options.color;
}
if (bottomIndicator) {
// set bottom indicator
style = bottomIndicator.style;
style.width = options.width + "px";
style.top = options.clipTop + options.clipHeight - DOMUtils.getElementHeight(bottomIndicator) + "px";
style.backgroundColor = options.color;
}
}
/**
* Show scroll indicators.
* @method _showScrollIndicator
* @protected
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype._showScrollIndicator = function () {
var self = this,
clip = self.element,
view = self._ui.view,
scrollTop = clip.scrollTop,
clipHeight = DOMUtils.getElementHeight(clip),
clipOffset = DOMUtils.getElementOffset(clip),
viewHeight = DOMUtils.getElementHeight(view),
viewWidth = DOMUtils.getElementWidth(view),
viewOffset = DOMUtils.getElementOffset(view);
clearIndicator(clip);
switch (self.options.scroll) {
case "x":
case "xy":
// @todo
break;
default:
setTopAndBottomIndicators(clip, {
clipTop: clipOffset.top,
clipHeight: clipHeight,
width: viewWidth,
color: window.getComputedStyle(clip).backgroundColor
});
if (viewOffset.top - scrollTop < clipOffset.top) {
// the top is not visible
clip.classList.add(classes.indicatorTopShown);
}
if (viewOffset.top - scrollTop + viewHeight > clipOffset.top + clipHeight) {
// the bottom is not visible
clip.classList.add(classes.indicatorBottomShown);
}
}
};
/**
* Hide scroll indicators.
* @method _hideScrollIndicator
* @protected
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype._hideScrollIndicator = function () {
var self = this,
timers = self._timers,
timer = timers.scrollIndicatorHide;
if (timer) {
window.clearTimeout(timer);
}
timers.scrollIndicatorHide = window.setTimeout(function () {
clearIndicator(self.element);
}, 1500);
};
/**
* Scrolls to specified position
*
* This method give possibility to scroll on Scrollview widget form JS interface of widget.
*
* <mobile>
* On mobile profile you can use method in jQuery style.
* </mobile>
*
* If duration is set then scroll will be animated in given time period.
*
* <wearable>
* On wearable profile Scrollview widget isn't build automatically. Before using method scrollTo, you need
* create widget on content of page.
* </wearable>
* ### Example usage with TAU API
*
* @example mobile wearable
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* </div>
* </div>
* <script>
* var scrollview = tau.widget.Scrollview(document.querySelector(".myPageClass > div[data-role=content]"));
* scrollview.scrollTo(0, 200, 1000); // scroll to 200px vertical with 1s animation
* </script>
*
* ### Example usage with jQuery API
*
* @example mobile
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* </div>
* </div>
* <script>
* var element = $(".myPageClass > div[data-role=content]"));
* element.scrollview();
* element.scrollview("scrollTo", 0, 200, 1000); // scroll to 200px vertical with 1s animation
* </script>
*
* @param {number} x
* @param {number} y
* @param {number=} [duration]
* @method scrollTo
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype.scrollTo = function (x, y, duration) {
var element = this.element;
this.translateTo(x - element.scrollLeft, y - element.scrollTop, duration);
};
/**
* Translates the scroll to specified position
*
* ### Example usage with TAU API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* </div>
* </div>
* <script>
* var scrollview = tau.widget.Scrollview(document.querySelector(".myPageClass > div[data-role=content]"));
* scrollview.translateTo(0, 200, 1000); // scroll forward 200px in vertical direction with 1s animation
* </script>
*
* ### Example usage with jQuery API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* </div>
* </div>
* <script>
* var element = $(".myPageClass > div[data-role=content]"));
* element.scrollview();
* element.scrollview("translateTo", 0, 200, 1000); // scroll forward 200px in vertical direction with 1s animation
* </script>
*
* @param {number} x
* @param {number} y
* @param {number=} [duration]
* @method translateTo
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype.translateTo = function (x, y, duration) {
translate(this._scrollState, this.element, x, y, duration);
};
/**
* Ensures that specified element is visible in the
* clip area
*
* ### Example usage with TAU API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* <div class="testElementClass">some data</div>
* </div>
* </div>
* <script>
* var scrollview = tau.widget.Scrollview(document.querySelector(".myPageClass > div[data-role=content]")),
* testElement = document.querySelector(".testElementClass");
* scrollview.ensureElementIsVisible(testElement);
* </script>
*
* ### Example usage with jQuery API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* <div class="testElementClass">some data</div>
* </div>
* </div>
* <script>
* var element = $(".myPageClass > div[data-role=content]")),
* testElement = $(".testElementClass");
* element.scrollview();
* element.scrollview("ensureElementIsVisible", testElement);
* </script>
*
* @param {HTMLElement} element
* @method ensureElementIsVisible
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype.ensureElementIsVisible = function (element) {
var clip = this.element,
clipHeight = DOMUtils.getElementHeight(clip),
clipWidth = DOMUtils.getElementWidth(clip),
clipTop = 0,
clipBottom = clipHeight,
elementHeight = DOMUtils.getElementHeight(element),
elementWidth = DOMUtils.getElementWidth(element),
elementTop = 0,
elementBottom,
elementFits = clipHeight >= elementHeight && clipWidth >= elementWidth,
anchor,
anchorPositionX,
anchorPositionY,
parent,
findPositionAnchor = function (input) {
var id = input.getAttribute("id"),
tagName = input.tagName.toLowerCase();
if (id && ["input", "textarea", "button"].indexOf(tagName) > -1) {
return input.parentNode.querySelector("label[for=" + id + "]");
}
},
_true = true;
parent = element.parentNode;
while (parent && parent !== clip) {
elementTop += parent.offsetTop;
//elementLeft += parent.offsetLeft;
parent = parent.parentNode;
}
elementBottom = elementTop + elementHeight;
//elementRight = elementLeft + elementWidth;
/* C1) element fits in view is inside clip area
* C2) element visible only at top; eg. partly visible textarea
* C3) element visible only at bottom
* C4) element fits in view but its visible only at top
* C5) element fits in view but its visible only at bottom
*/
switch (_true) {
case elementFits && clipTop < elementTop && clipBottom > elementBottom:
case clipTop < elementTop && elementTop < clipBottom && clipBottom < elementBottom:
case clipTop > elementTop && clipBottom > elementBottom:
// (1) pass, element position is ok
// (2, 3) pass, we cant do anything, if we move the scroll the user could lost view of
// something he scrolled to
break;
case elementFits && clipTop < elementTop && clipBottom < elementBottom:
case elementFits && clipTop > elementTop && clipBottom > elementBottom:
case elementFits: // element fits in view but is not visible
this.centerToElement(element);
break;
default: // element is not visible
anchor = findPositionAnchor(element);
if (!anchor) {
anchor = element;
}
anchorPositionX = anchor.offsetLeft + DOMUtils.getCSSProperty(anchor, "margin-left", 0, "integer");
anchorPositionY = anchor.offsetTop + DOMUtils.getCSSProperty(anchor, "margin-top", 0, "integer");
parent = anchor.parentNode;
while (parent && parent !== clip) {
anchorPositionX += parent.offsetLeft;
anchorPositionY += parent.offsetTop;
parent = parent.parentNode;
}
this.scrollTo(anchorPositionX, anchorPositionY, this.scrollDuration);
break;
}
};
/**
* Centers specified element in the clip area
*
* ### Example usage with TAU API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* <div class="testElementClass">some data</div>
* </div>
* </div>
* <script>
* var scrollview = tau.widget.Scrollview(document.querySelector(".myPageClass > div[data-role=content]")),
* testElement = document.querySelector(".testElementClass");
* scrollview.centerToElement(testElement);
* </script>
*
* ### Example usage with jQuery API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* <div class="testElementClass">some data</div>
* </div>
* </div>
* <script>
* var element = $(".myPageClass > div[data-role=content]")),
* testElement = $(".testElementClass");
* element.scrollview();
* element.scrollview("centerToElement", testElement);
* </script>
*
* @param {HTMLElement} element
* @method centerToElement
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype.centerToElement = function (element) {
var clip = this.element,
deltaX = parseInt(DOMUtils.getElementWidth(clip) / 2 - DOMUtils.getElementWidth(element) / 2, 10),
deltaY = parseInt(DOMUtils.getElementHeight(clip) / 2 - DOMUtils.getElementHeight(element) / 2, 10),
elementPositionX = element.offsetLeft,
elementPositionY = element.offsetTop,
parent = element.parentNode;
while (parent && parent !== clip) {
elementPositionX += parent.offsetLeft + DOMUtils.getCSSProperty(parent, "margin-left", 0, "integer");
elementPositionY += parent.offsetTop + DOMUtils.getCSSProperty(parent, "margin-top", 0, "integer");
parent = parent.parentNode;
}
this.scrollTo(elementPositionX - deltaX, elementPositionY - deltaY, this.scrollDuration);
};
/**
* Returns scroll current position
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* </div>
* </div>
* <script>
* var scrollview = tau.widget.Scrollview(document.querySelector(".myPageClass > div[data-role=content]")),
* currentPosition = scrollview.getScrollPosition();
* </script>
*
* ### Example usage with jQuery API
*
* @example
* <div class="myPageClass" data-role="page">
* <div data-role="content" data-scroll="y">
* content
* </div>
* </div>
* <script>
* var element = $(".myPageClass > div[data-role=content]")),
* position;
* element.scrollview();
* position = element.scrollview("getScrollPosition");
* </script>
*
* @return {Object}
* @method getScrollPosition
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype.getScrollPosition = function () {
var element = this.element;
return {
"x": element.scrollLeft,
"y": element.scrollTop
};
};
/**
* Binds scrollview events
* @method _bindEvents
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.Scrollview
*/
Scrollview.prototype._bindEvents = function (element) {
var scrollTimer = null,
notifyScrolled = function () {
eventUtils.trigger(element, "scrollstop");
window.clearTimeout(scrollTimer);
scrollTimer = null;
},
self = this,
//FIXME there should be some other way to get parent container
ui = self._ui,
page = ui.page,
jumpTop = ui.jumpVerticalButton,
jumpLeft = ui.jumpHorizontalButton,
repositionJumpsCallback,
jumpTopCallback,
jumpLeftCallback,
callbacks = self._callbacks;
if (page) {
if (this.options.scrollJump) {
repositionJumpsCallback = repositionJumps.bind(null, this);
jumpTopCallback = function () {
self.scrollTo(element.scrollLeft, 0, 250);
};
jumpLeftCallback = function () {
self.scrollTo(0, element.scrollTop, 250);
};
page.addEventListener(pageEvents.SHOW, repositionJumpsCallback, false);
if (jumpTop) {
jumpTop.firstChild.addEventListener("vclick", jumpTopCallback, false);
}
if (jumpLeft) {
jumpLeft.firstChild.addEventListener("vclick", jumpLeftCallback, false);
}
callbacks.repositionJumps = repositionJumpsCallback;
callbacks.jumpTop = jumpTopCallback;
callbacks.jumpLeft = jumpLeftCallback;
}
element.addEventListener("scroll", function () {
if (scrollTimer) {
window.clearTimeout(scrollTimer);
} else {
eventUtils.trigger(element, "scrollstart");
}
scrollTimer = window.setTimeout(notifyScrolled, 100);
eventUtils.trigger(element, "scrollupdate");
}, false);
document.addEventListener("vmousedown", function () {
if (currentTransition) {
currentTransition = null;
}
}, false);
if (self.options.scrollIndicator) {
callbacks.scrollUpdate = self._showScrollIndicator.bind(self);
element.addEventListener("scrollupdate", callbacks.scrollUpdate, false);
callbacks.scrollStop = self._hideScrollIndicator.bind(self);
element.addEventListener("scrollstop", callbacks.scrollStop, false);
}
}
};
Scrollview.prototype._destroy = function () {
var self = this,
element = self.element,
ui = self._ui,
page = ui.page,
scrollJump = this.options.scrollJump,
jumpTop = ui.jumpVerticalButton,
jumpLeft = ui.jumpHorizontalButton,
callbacks = self._callbacks,
repositionJumpsCallback = callbacks.repositionJumps,
jumpTopCallback = callbacks.jumpTop,
jumpLeftCallback = callbacks.jumpLeft;
if (scrollJump) {
if (page && repositionJumpsCallback) {
page.removeEventListener(pageEvents.SHOW, repositionJumpsCallback, false);
}
if (jumpTop && jumpTopCallback) {
jumpTop.firstChild.removeEventListener("vclick", jumpTopCallback, false);
}
if (jumpLeft && jumpLeftCallback) {
jumpLeft.firstChild.removeEventListener("vclick", jumpLeftCallback, false);
}
}
if (self.options.scrollIndicator) {
element.removeEventListener("scrollupdate", callbacks.scrollUpdate, false);
}
if (self._timers.scrollIndicatorHide) {
window.clearTimeout(self._timers.scrollIndicatorHide);
}
};
ns.widget.core.Scrollview = Scrollview;
}(window, window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* @class ns.widget.mobile.Tab
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
events = ns.event,
Tab = function () {
},
/**
* Object with class dictionary
* @property {Object} classes
* @static
* @member ns.widget.mobile.Tab
* @readonly
*/
classes = {},
CustomEvent = {
TAB_CHANGE: "tabchange"
},
prototype = new BaseWidget();
Tab.prototype = prototype;
Tab.classes = classes;
/**
* Set the active tab
* @method setActive
* @param {number} index of the tab
* @public
* @member ns.widget.mobile.Tab
*/
prototype._setActive = function (index) {
var element = this.element;
events.trigger(element, CustomEvent.TAB_CHANGE, {
active: index
});
};
/**
* Set the active tab
* @method setActive
* @param {number} index of the tab
* @public
* @member ns.widget.mobile.Tab
*/
prototype.setActive = function (index) {
this._setActive(index);
};
/**
* Get the active tab
* @method setActive
* @public
* @member ns.widget.mobile.Tab
*/
prototype._getActive = function () {
return this.options.active;
};
/**
* Get the active tab
* @method setActive
* @public
* @member ns.widget.mobile.Tab
*/
prototype.getActive = function () {
return this._getActive();
};
ns.widget.core.Tab = Tab;
engine.defineWidget(
"Tab",
"",
["setActive", "getActive"],
Tab,
"tizen"
);
}(window.document, ns));
/*global window, ns, define, Event, console */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #TabIndicator Widget
* Widget create tabs indicator.
* @class ns.widget.core.TabIndicator
* @since 2.3
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var Tab = ns.widget.core.Tab,
engine = ns.engine,
object = ns.util.object,
TabIndicator = function () {
this.tabSize = 0;
this.width = 0;
},
TabPrototype = Tab.prototype,
prototype = new Tab();
TabIndicator.prototype = prototype;
prototype._init = function (element) {
var o = this.options;
this.width = element.offsetWidth;
element.classList.add(o.wrapperClass);
};
prototype._configure = function () {
/**
* @property {Object} options Options for widget
* @property {number} [options.margin=2]
* @property {boolean} [options.triggerEvent=false]
* @property {string} [options.wrapperClass="ui-tab-indicator]
* @property {string} [options.itemClass="ui-tab-item"]
* @property {string} [options.activeClass="ui-tab-active"]
* @member ns.widget.core.TabIndicator
*/
object.merge(this.options, {
margin: 4,
triggerEvent: false,
wrapperClass: "ui-tab-indicator",
itemClass: "ui-tab-item",
activeClass: "ui-tab-active",
active: 0
});
};
prototype._createIndicator = function () {
var o = this.options,
wrap = document.createDocumentFragment(),
widthTable = [],
margin = o.margin,
i = 0,
len = this.tabSize,
width = this.width - margin * (len - 1),
std = Math.floor(width / len),
remain = width % len,
span,
offset = 0;
for (i = 0; i < len; i++) {
widthTable[i] = std;
}
for (i = Math.floor((len - remain) / 2); remain > 0; i++, remain--) {
widthTable[i] += 1;
}
for (i = 0; i < len; i++) {
span = document.createElement("span");
span.classList.add(o.itemClass);
span.style.width = widthTable[i] + "px";
span.style.left = offset + "px";
offset += widthTable[i] + margin;
if (i === o.active) {
span.classList.add(o.activeClass);
}
wrap.appendChild(span);
}
this.element.appendChild(wrap);
};
prototype._removeIndicator = function () {
this.element.innerHTML = "";
};
prototype._refresh = function () {
this._removeIndicator();
this._createIndicator();
};
/**
* @method setActive
* @param {number} index
* @member ns.widget.core.TabIndicator
*/
prototype._setActive = function (index) {
var o = this.options,
nodes = this.element.children;
o.active = index;
[].forEach.call(nodes, function (element) {
element.classList.remove(o.activeClass);
});
if (index < nodes.length) {
nodes[index].classList.add(o.activeClass);
TabPrototype._setActive.call(this, index);
}
};
/**
* @method setSize
* @param {number} size
* @member ns.widget.core.TabIndicator
*/
prototype.setSize = function (size) {
var needRefresh = this.tabSize !== size;
this.tabSize = size;
if (needRefresh) {
this.refresh();
}
};
prototype._destroy = function () {
var o = this.options;
this._removeIndicator();
this.element.classList.remove(o.wrapperClass);
};
ns.widget.core.TabIndicator = TabIndicator;
engine.defineWidget(
"TabIndicator",
".ui-tab",
["setActive", "getActive", "setSize"],
TabIndicator
);
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns*/
/**
* # Section Changer
* Section changer component provides an application architecture, which has multiple sections on one page.
*
* The section changer widget provides an application architecture, which has
* multiple sections on a page and enables scrolling through the *section* elements.
*
* ## Manual constructor
*
* @example template tau-section-changer
* <div class="ui-section-changer">
* <div>
* <section style="text-align:center"><span>${1:Section 1}</span></section>
* <section style="text-align:center"><span>${2:Section 2}</span></section>
* </div>
* </div>
*
*
* @example
* <div id="hasSectionchangerPage" class="ui-page">
* <header class="ui-header">
* <h2 class="ui-title">SectionChanger</h2>
* </header>
* <div id="sectionchanger" class="ui-content">
* <!--Section changer has only one child-->
* <div>
* <section>
* <h3>LEFT1 PAGE</h3>
* </section>
* <section class="ui-section-active">
* <h3>MAIN PAGE</h3>
* </section>
* <section>
* <h3>RIGHT1 PAGE</h3>
* </section>
* </div>
* </div>
* </div>
* <script>
* (function () {
* var page = document.getElementById("hasSectionchangerPage"),
* element = document.getElementById("sectionchanger"),
* sectionChanger;
*
* page.addEventListener("pageshow", function () {
* // Create the SectionChanger object
* sectionChanger = new tau.SectionChanger(element, {
* circular: true,
* orientation: "horizontal",
* useBouncingEffect: true
* });
* });
*
* page.addEventListener("pagehide", function () {
* // Release the object
* sectionChanger.destroy();
* });
* })();
* </script>
*
* ## Handling Events
*
* To handle section changer events, use the following code:
*
* @example
* <script>
* (function () {
* var changer = document.getElementById("sectionchanger");
* changer.addEventListener("sectionchange", function (event) {
* console.debug(event.detail.active + " section is active.");
* });
* })();
* </script>
*
* @class ns.widget.core.SectionChanger
* @since 2.4
* @component-selector [data-role="section-changer"], .ui-section-changer
* @component-type container-component
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var Scroller = ns.widget.core.scroller.Scroller,
gesture = ns.event.gesture,
Orientation = gesture.Orientation,
engine = ns.engine,
utilsObject = ns.util.object,
utilsEvents = ns.event,
eventType = ns.util.object.merge({
/**
* Triggered when the section is changed.
* @event sectionchange
* @member ns.widget.core.SectionChanger
*/
CHANGE: "sectionchange"
}, Scroller.EventType),
classes = {
uiSectionChanger: "ui-section-changer"
};
function SectionChanger() {
this.options = {};
}
function calculateCustomLayout(direction, elements, lastIndex) {
var elementsLength = elements.length,
length = lastIndex !== undefined ? lastIndex : elementsLength,
result = 0,
i = 0;
if (length > elementsLength) {
length = elementsLength;
}
for (i; i < length; i++) {
result += direction === Orientation.HORIZONTAL ? elements[i].offsetWidth : elements[i].offsetHeight;
}
return result;
}
function calculateCenter(direction, elements, index) {
var result = calculateCustomLayout(direction, elements, index + 1),
element = elements[index];
if (element) {
result -= direction === Orientation.HORIZONTAL ? element.offsetWidth / 2 : element.offsetHeight / 2;
}
return result;
}
utilsObject.inherit(SectionChanger, Scroller, {
_build: function (element) {
var self = this,
options = self.options,
offsetHeight;
self.tabIndicatorElement = null;
self.tabIndicator = null;
self.sections = null;
self.sectionPositions = [];
self.activeIndex = 0;
self.beforeIndex = 0;
self._super(element);
element.classList.add(classes.uiSectionChanger);
self.scroller.style.position = "absolute";
offsetHeight = element.offsetHeight;
if (offsetHeight === 0) {
offsetHeight = element.parentNode.offsetHeight;
element.style.height = offsetHeight + "px";
}
self._sectionChangerWidth = element.offsetWidth;
self._sectionChangerHeight = offsetHeight;
self._sectionChangerHalfWidth = self._sectionChangerWidth / 2;
self._sectionChangerHalfHeight = self._sectionChangerHeight / 2;
self.orientation = options.orientation === "horizontal" ? Orientation.HORIZONTAL : Orientation.VERTICAL;
return element;
},
_configure: function () {
this._super();
/**
* Options for widget
* @property {Object} options
* @property {"horizontal"|"vertical"} [options.orientation="horizontal"] Sets the section changer orientation:
* @property {boolean} [options.circular=false] Presents the sections in a circular scroll fashion.
* @property {boolean} [options.useBouncingEffect=false] Shows a scroll end effect on the scroll edge.
* @property {string} [options.items="section"] Defines the section element selector.
* @property {string} [options.activeClass="ui-section-active"] Specifies the CSS classes which define the active section element. Add the specified class (ui-section-active) to a *section* element to indicate which section must be shown first. By default, the first section is shown first.
* @property {boolean} [options.fillContent=true] declare to section tag width to fill content or not.
* @member ns.widget.core.SectionChanger
*/
this.options = utilsObject.merge(this.options, {
items: "section",
activeClass: "ui-section-active",
circular: false,
animate: true,
animateDuration: 100,
orientation: "horizontal",
changeThreshold: -1,
useTab: false,
fillContent: true
});
},
_init: function (element) {
var self = this,
options = self.options,
scroller = self.scroller,
sectionLength,
i,
className;
if (options.scrollbar === "tab") {
options.scrollbar = false;
options.useTab = true;
}
self.sections = typeof options.items === "string" ?
scroller.querySelectorAll(options.items) :
options.items;
sectionLength = self.sections.length;
if (options.circular && sectionLength < 3) {
ns.error("[SectionChanger] if you use circular option, you must have at least three sections.");
} else {
for (i = 0; i < sectionLength; i++) {
className = self.sections[i].className;
if (className && className.indexOf(options.activeClass) > -1) {
self.activeIndex = i;
}
self.sectionPositions[i] = i;
}
self._prepareLayout();
self._initLayout();
self._super(element);
self._repositionSections(true);
self.setActiveSection(self.activeIndex);
// set correct options values.
if (!options.animate) {
options.animateDuration = 0;
}
if (options.changeThreshold < 0) {
options.changeThreshold = self._sectionChangerHalfWidth;
}
}
return element;
},
_prepareLayout: function () {
var o = this.options,
sectionLength = this.sections.length,
width = this._sectionChangerWidth,
height = this._sectionChangerHeight,
orientation = this.orientation,
scrollerStyle = this.scroller.style,
tabHeight;
if (o.useTab) {
this._initTabIndicator();
tabHeight = this.tabIndicatorElement.offsetHeight;
height -= tabHeight;
this._sectionChangerHalfHeight = height / 2;
this.element.style.height = height + "px";
this._sectionChangerHeight = height;
}
if (orientation === Orientation.HORIZONTAL) {
scrollerStyle.width = (o.fillContent ? width * sectionLength : calculateCustomLayout(orientation, this.sections)) + "px";
scrollerStyle.height = height + "px"; //set Scroller width
} else {
scrollerStyle.width = width + "px"; //set Scroller width
scrollerStyle.height = (o.fillContent ? height * sectionLength : calculateCustomLayout(orientation, this.sections)) + "px";
}
},
_initLayout: function () {
var sectionStyle,
left = 0,
top = 0,
i,
sectionLength;
//section element has absolute position
for (i = 0, sectionLength = this.sections.length; i < sectionLength; i++) {
//Each section set initialize left position
sectionStyle = this.sections[i].style;
sectionStyle.position = "absolute";
if (this.options.fillContent) {
sectionStyle.width = this._sectionChangerWidth + "px";
sectionStyle.height = this._sectionChangerHeight + "px";
}
if (this.orientation === Orientation.HORIZONTAL) {
top = 0;
left = calculateCustomLayout(this.orientation, this.sections, i);
} else {
top = calculateCustomLayout(this.orientation, this.sections, i);
left = 0;
}
sectionStyle.top = top + "px";
sectionStyle.left = left + "px";
}
},
_initBouncingEffect: function () {
var o = this.options;
if (!o.circular) {
this._super();
}
},
_translateScrollbar: function (x, y, duration, autoHidden) {
var self = this,
offset,
scrollbar = self.scrollbar;
if (scrollbar) {
if (self.orientation === Orientation.HORIZONTAL) {
offset = -x + self.minScrollX;
} else {
offset = -y + self.minScrollY;
}
scrollbar.translate(offset, duration, autoHidden);
}
},
_translateScrollbarWithPageIndex: function (pageIndex, duration) {
var offset;
if (!this.scrollbar) {
return;
}
offset = calculateCustomLayout(this.orientation, this.sections, this.activeIndex);
this.scrollbar.translate(offset, duration);
},
_initTabIndicator: function () {
var self = this,
tabElement = document.createElement("div"),
element = self.element,
tabIndicator = null;
self.tabIndicatorElement = tabElement;
element.parentNode.insertBefore(tabElement, element);
tabIndicator = new engine.instanceWidget(tabElement, "TabIndicator");
self.tabIndicator = tabIndicator;
tabIndicator.setSize(self.sections.length);
tabIndicator.setActive(self.activeIndex);
self.tabIndicatorHandler = function (event) {
this.tabIndicator.setActive(event.detail.active);
}.bind(self);
element.addEventListener(eventType.CHANGE, self.tabIndicatorHandler, false);
},
_clearTabIndicator: function () {
if (this.tabIndicator) {
this.element.parentNode.removeChild(this.tabIndicatorElement);
this.element.removeEventListener(eventType.CHANGE, this.tabIndicatorHandler, false);
this.tabIndicator.destroy();
this.tabIndicator = null;
this.tabIndicatorElement = null;
this.tabIndicatorHandler = null;
}
},
_resetLayout: function () {
var //scrollerStyle = this.scroller.style,
sectionStyle,
i,
sectionLength;
//scrollerStyle.width = "";
//scrollerStyle.height = "";
//this.scroller || this.scroller._resetLayout();
for (i = 0, sectionLength = this.sections.length; i < sectionLength; i++) {
sectionStyle = this.sections[i].style;
sectionStyle.position = "";
sectionStyle.width = "";
sectionStyle.height = "";
sectionStyle.top = "";
sectionStyle.left = "";
}
this._super();
},
_bindEvents: function () {
var self = this;
self._super();
ns.event.enableGesture(
self.scroller,
new ns.event.gesture.Swipe({
orientation: self.orientation === Orientation.HORIZONTAL ?
gesture.Orientation.HORIZONTAL :
gesture.Orientation.VERTICAL
})
);
utilsEvents.on(self.scroller,
"swipe transitionEnd webkitTransitionEnd mozTransitionEnd msTransitionEnd oTransitionEnd", self);
document.addEventListener("rotarydetent", self, true);
},
_unbindEvents: function () {
var self = this;
self._super();
if (self.scroller) {
ns.event.disableGesture(self.scroller);
utilsEvents.off(self.scroller,
"swipe transitionEnd webkitTransitionEnd mozTransitionEnd msTransitionEnd oTransitionEnd", self);
}
document.removeEventListener("rotarydetent", self, true);
},
/**
* This method manages events.
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.SectionChanger
*/
handleEvent: function (event) {
this._super(event);
switch (event.type) {
case "swipe":
case "rotarydetent" :
this._change(event);
break;
case "webkitTransitionEnd":
case "mozTransitionEnd":
case "msTransitionEnd":
case "oTransitionEnd":
case "transitionEnd":
if (event.target === this.scroller) {
this._endScroll();
}
break;
}
},
_notifyChangedSection: function (index) {
var activeClass = this.options.activeClass,
sectionLength = this.sections.length,
i = 0,
section;
for (i = 0; i < sectionLength; i++) {
section = this.sections[i];
section.classList.remove(activeClass);
if (i === this.activeIndex) {
section.classList.add(activeClass);
}
}
this.trigger(eventType.CHANGE, {
active: index
});
},
/**
* Changes the currently active section element.
* @method setActiveSection
* @param {number} index
* @param {number} duration For smooth scrolling,
* the duration parameter must be in milliseconds.
* @param {number} [direct=false]
* @member ns.widget.core.SectionChanger
*/
setActiveSection: function (index, duration, direct) {
var position = this.sectionPositions[index],
scrollbarDuration = duration,
oldActiveIndex = this.activeIndex,
newX = 0,
newY = 0;
if (this.orientation === Orientation.HORIZONTAL) {
newX = this._sectionChangerHalfWidth - calculateCenter(this.orientation, this.sections, position);
} else {
newY = this._sectionChangerHalfHeight - calculateCenter(this.orientation, this.sections, position);
}
if (this.beforeIndex - index > 1 || this.beforeIndex - index < -1) {
scrollbarDuration = 0;
}
this.activeIndex = index;
this.beforeIndex = this.activeIndex;
if (newX !== this.scrollerOffsetX || newY !== this.scrollerOffsetY) {
if (direct !== false) {
this.trigger(eventType.START);
this.scrolled = true;
}
this._translate(newX, newY, duration);
this._translateScrollbarWithPageIndex(index, scrollbarDuration);
} else {
this._endScroll();
}
// notify changed section.
if (this.activeIndex !== oldActiveIndex) {
this._notifyChangedSection(this.activeIndex);
}
},
/**
* Gets the currently active section element's index.
* @method getActiveSectionIndex
* @return {number}
* @member ns.widget.core.SectionChanger
*/
getActiveSectionIndex: function () {
return this.activeIndex;
},
_start: function (e) {
this._super(e);
this.beforeIndex = this.activeIndex;
},
_move: function (event) {
var self = this,
changeThreshold = self.options.changeThreshold,
delta = self.orientation === Orientation.HORIZONTAL ? event.detail.deltaX : event.detail.deltaY,
oldActiveIndex = self.activeIndex,
beforeIndex = self.beforeIndex;
self._super(event);
if (self.scrolled) {
if (delta > changeThreshold) {
self.activeIndex = self._calculateIndex(beforeIndex - 1);
} else if (delta < -changeThreshold) {
self.activeIndex = self._calculateIndex(beforeIndex + 1);
} else {
self.activeIndex = beforeIndex;
}
// notify changed section.
if (self.activeIndex !== oldActiveIndex) {
self._notifyChangedSection(self.activeIndex);
}
}
},
_end: function () {
var self = this;
if (self.scrollbar) {
self.scrollbar.end();
}
if (self.enabled && !self.scrollCanceled && self.dragging) {
// bouncing effect
if (self.bouncingEffect) {
self.bouncingEffect.dragEnd();
}
self.setActiveSection(self.activeIndex, self.options.animateDuration, false);
self.dragging = false;
}
},
_change: function (event) {
var self = this,
direction = event.detail.direction,
offset = direction === gesture.Direction.UP || direction === gesture.Direction.LEFT || direction === "CW" ? 1 : -1,
newIndex = self._calculateIndex(self.beforeIndex + offset);
if (self.enabled && !self.scrollCanceled) {
// bouncing effect
if (self.bouncingEffect) {
self.bouncingEffect.dragEnd();
}
if (self.activeIndex !== newIndex) {
self.activeIndex = newIndex;
self._notifyChangedSection(newIndex);
}
self.setActiveSection(newIndex, self.options.animateDuration, false);
self.dragging = false;
}
},
_endScroll: function () {
if (!this.enabled || !this.scrolled || this.scrollCanceled) {
return;
}
this._repositionSections();
this._super();
},
_repositionSections: function (init) {
// if developer set circular option is true, this method used when webkitTransitionEnd event fired
var self = this,
sections = self.sections,
activeIndex = self.activeIndex,
orientation = self.orientation,
isHorizontal = orientation === Orientation.HORIZONTAL,
sectionLength = sections.length,
curPosition = self.sectionPositions[activeIndex],
centerPosition = Math.floor(sectionLength / 2),
circular = self.options.circular,
centerX = 0,
centerY = 0,
i,
sectionStyle,
sIdx,
top,
left,
newX,
newY;
if (isHorizontal) {
newX = -(calculateCenter(orientation, sections, (circular ? centerPosition : activeIndex)));
newY = 0;
} else {
newX = 0;
newY = -(calculateCenter(orientation, sections, (circular ? centerPosition : activeIndex)));
}
self._translateScrollbarWithPageIndex(activeIndex);
if (init || (curPosition === 0 || curPosition === sectionLength - 1)) {
if (isHorizontal) {
centerX = self._sectionChangerHalfWidth + newX;
} else {
centerY = self._sectionChangerHalfHeight + newY;
}
self._translate(centerX, centerY);
if (circular) {
for (i = 0; i < sectionLength; i++) {
sIdx = (sectionLength + activeIndex - centerPosition + i) % sectionLength;
sectionStyle = sections[sIdx].style;
self.sectionPositions[sIdx] = i;
if (isHorizontal) {
top = 0;
left = calculateCustomLayout(orientation, sections, i);
} else {
top = calculateCustomLayout(orientation, sections, i);
left = 0;
}
sectionStyle.top = top + "px";
sectionStyle.left = left + "px";
}
}
}
},
_calculateIndex: function (newIndex) {
var sectionLength = this.sections.length;
if (this.options.circular) {
newIndex = (sectionLength + newIndex) % sectionLength;
} else {
newIndex = newIndex < 0 ? 0 : (newIndex > sectionLength - 1 ? sectionLength - 1 : newIndex);
}
return newIndex;
},
_clear: function () {
this._clearTabIndicator();
this._super();
this.sectionPositions.length = 0;
},
_destroy: function () {
var element = this.element;
// clear dimensions set in _build
element.style.height = null;
element.style.width = null;
this._super();
}
});
ns.widget.core.SectionChanger = SectionChanger;
engine.defineWidget(
"SectionChanger",
"[data-role='section-changer'], .ui-section-changer",
["getActiveSectionIndex", "setActiveSection"],
SectionChanger
);
}(window.document, ns));
/*global window, define, ns, screen */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, white: true, plusplus: true*/
(function (document, ns) {
"use strict";
/**
* @property {Object} Widget Alias for {@link ns.widget.BaseWidget}
* @member ns.widget.core.VirtualListview
* @private
* @static
*/
var BaseWidget = ns.widget.BaseWidget,
// Constants definition
/**
* Defines index of scroll `{@link ns.widget.core.VirtualListview#_scroll}.direction`
* @property {number} SCROLL_NONE
* to retrieve if user is not scrolling
* @private
* @static
* @member ns.widget.core.VirtualListview
*/
selectors = ns.util.selectors,
// Scrolling util is responsible for support touches and calculate scrolling position after touch
// In Virtual List we use scrolling in virtual model which is responsible for calculate touches, send event
// but don't render scrolled element. For rendering is responsible only Virtual List
utilScrolling = ns.util.scrolling,
circularScreen = ns.support.shape.circle,
SimpleVirtualList = function () {
var self = this;
self.options = {
dataLength: 0,
listItemUpdater: null,
scrollElement: null,
orientation: "vertical",
snap: false,
edgeEffect: circularScreen ? null : defaultEdgeEffect,
infinite: false
};
self._ui = {
edgeEffect: null,
scrollview: null
};
self._scrollBegin = 0;
self._elementsMap = [];
self._itemSize = 0;
self._numberOfItems = 5;
self._edgeEffectGradientSize = 0;
},
abs = Math.abs,
min = Math.min,
floor = Math.floor,
filter = Array.prototype.filter,
prototype = new BaseWidget(),
// Current color from changeable style
// @TODO change to dynamic color
EDGE_EFFECT_COLOR = "rgba(61, 185, 204, {1})",
classes = {
uiVirtualListContainer: "ui-virtual-list-container",
edgeEffect: "ui-virtual-list-edge-effect"
};
SimpleVirtualList.classes = classes;
/**
* Effect for edge scrolling on rectangular screens
* @param {number} positionDiff difference from edge to current scroll
* @param {string} orientation `vertical` or `horizontal`
* @param {string} edge `start` or `end` depending on orientation
* @param {number} rawPosition current scroll position
* @param {number} widgetInstance current widget instance
* @return {number}
*/
function defaultEdgeEffect(positionDiff, orientation, edge, rawPosition, widgetInstance) {
var ui = widgetInstance._ui,
edgeEffectElement = ui.edgeEffect || ui.scrollview.querySelector("." + classes.edgeEffect),
edgeEffectStyle = edgeEffectElement.style,
gradientSize = min(abs(positionDiff / 8) - 1, 10);
if (orientation === "vertical") {
edgeEffectStyle.top = (edge === "start") ? "0" : "auto";
edgeEffectStyle.bottom = (edge === "start") ? "auto" : "0";
} else {
edgeEffectStyle.left = (edge === "start") ? "0" : "auto";
edgeEffectStyle.right = (edge === "start") ? "auto" : "0";
}
// Saved reference to later avoid unnecessary style manipulations
widgetInstance._edgeEffectGradientSize = gradientSize;
edgeEffectStyle.boxShadow = "0 0 0 " + gradientSize + "px " + EDGE_EFFECT_COLOR.replace("{1}", 0.5) + "," +
"0 0 0 " + (gradientSize * 2) + "px " + EDGE_EFFECT_COLOR.replace("{1}", 0.4) + "," +
"0 0 0 " + (gradientSize * 3) + "px " + EDGE_EFFECT_COLOR.replace("{1}", 0.3) + "," +
"0 0 0 " + (gradientSize * 4) + "px " + EDGE_EFFECT_COLOR.replace("{1}", 0.2) + "," +
"0 0 0 " + (gradientSize * 5) + "px " + EDGE_EFFECT_COLOR.replace("{1}", 0.1) + "";
return 0;
}
function setupScrollview(element) {
return selectors.getClosestByClass(element, "ui-scroller") || element.parentElement;
}
function getScrollView(options, element) {
var scrollview = null;
if (options.scrollElement) {
if (typeof options.scrollElement === "string") {
scrollview = selectors.getClosestBySelector(element, "." + options.scrollElement);
} else {
scrollview = options.scrollElement;
}
}
if (!scrollview) {
scrollview = setupScrollview(element);
}
return scrollview;
}
prototype._build = function (element) {
var self = this,
ui = self._ui,
classes = SimpleVirtualList.classes,
options = self.options,
scrollview,
orientation;
//Prepare element
element.classList.add(classes.uiVirtualListContainer);
//Set orientation, default vertical scrolling is allowed
orientation = options.orientation.toLowerCase() === "horizontal" ? "horizontal" : "vertical";
scrollview = getScrollView(options, element);
ui.scrollview = scrollview;
options.orientation = orientation;
return element;
};
prototype._buildList = function () {
var self = this,
listItem,
ui = self._ui,
scrollviewWidget,
options = self.options,
scrollview = self._ui.scrollview,
sizeProperty = options.orientation === "vertical" ? "height" : "width",
list = self.element,
childElementType = (list.tagName === "UL" || list.tagName === "OL") ? "li" : "div",
numberOfItems = self._numberOfItems,
content = selectors.getClosestBySelector(list, ".ui-content").getBoundingClientRect(),
elementRect = null,
i,
scrollInitSize = [].reduce.call(scrollview.children, function (previousValue, currentNode) {
return previousValue + currentNode.getBoundingClientRect()[sizeProperty];
}, 0),
circle = ns.support.shape.circle;
scrollviewWidget = ns.engine.getBinding(selectors.getClosestBySelector(list,
".ui-page"), "Scrollview");
if (scrollviewWidget) {
scrollviewWidget.option("bouncingEffect", false);
self._scrollviewWidget = scrollviewWidget;
options.edgeEffect = function (positionDiff, orientation, edge) {
scrollviewWidget.showBouncingEffect(edge);
};
}
if (options.dataLength < numberOfItems) {
numberOfItems = options.dataLength;
}
for (i = 0; i < numberOfItems; ++i) {
listItem = document.createElement(childElementType);
self._updateListItem(listItem, i);
list.appendChild(listItem);
elementRect = self.element.getBoundingClientRect();
if (elementRect[sizeProperty] < content[sizeProperty]) {
numberOfItems++;
}
}
if (options.snap && circle) {
self._snapListviewWidget = ns.engine.instanceWidget(list, "SnapListview", options.snap);
}
elementRect = self.element.getBoundingClientRect();
self._itemSize = numberOfItems > 0 ? Math.round(elementRect[sizeProperty] / numberOfItems) : 0;
self._numberOfItems = numberOfItems;
self._containerSize = content[sizeProperty];
self._numberOfVisibleElements = Math.ceil(content[sizeProperty] / self._itemSize);
utilScrolling.enable(scrollview, options.orientation === "horizontal" ? "x" : "y", true);
if (options.infinite) {
utilScrolling.setMaxScroll(null);
} else {
utilScrolling.enableScrollBar();
if (scrollview.classList.contains("ui-scroller")) {
utilScrolling.setMaxScroll((options.dataLength + 1) * self._itemSize + scrollInitSize);
} else {
utilScrolling.setMaxScroll(options.dataLength * self._itemSize);
}
}
if (options.snap && circle) {
utilScrolling.setSnapSize(self._itemSize);
}
// Add default edge effect
// @TODO consider changing to :after and :before
if (options.edgeEffect === defaultEdgeEffect) {
ui.edgeEffect = document.createElement("div");
ui.edgeEffect.classList.add(classes.edgeEffect, "orientation-" + options.orientation);
ui.scrollview.appendChild(ui.edgeEffect);
}
utilScrolling.setBounceBack(true);
};
prototype._updateListItem = function (element, index) {
element.setAttribute("data-index", index);
this.options.listItemUpdater(element, index);
};
prototype._refresh = function () {
var self = this;
self._buildList();
if (self._snapListviewWidget) {
self._snapListviewWidget.refresh();
}
self.trigger("draw");
};
prototype.draw = function () {
this.refresh();
};
prototype.scrollTo = function (position) {
utilScrolling.scrollTo(-position);
};
prototype.scrollToIndex = function (index) {
this.scrollTo(Math.floor(this._itemSize * index));
};
function filterElement(index, element) {
return element.getAttribute("data-index") === "" + index;
}
function filterNextElement(nextIndex, element, index) {
return index > nextIndex;
}
function filterFreeElements(map, element) {
return map.indexOf(element) === -1;
}
function _updateList(self, event) {
var list = self.element,
itemSize = self._itemSize,
options = self.options,
beginProperty = options.orientation === "vertical" ? "scrollTop" : "scrollLeft",
scrollBegin = event.detail && event.detail[beginProperty],
ui = self._ui,
scrollChildStyle = ui.scrollview.firstElementChild.style,
fromIndex = 0,
dataLength = options.dataLength,
map = [],
freeElements,
numberOfItems = self._numberOfItems,
i = 0,
infinite = options.infinite,
currentIndex = 0,
listItem,
correction = 0,
scroll = {
scrollTop: 0,
scrollLeft: 0
},
inBoundsDiff = 0,
nextElement,
j = 0;
if (options.edgeEffect) {
if (!event.detail.inBounds) {
inBoundsDiff = scrollBegin < 0 ? scrollBegin : (scrollBegin + self._containerSize) - (options.dataLength * self._itemSize);
scrollBegin = scrollBegin - inBoundsDiff + options.edgeEffect(inBoundsDiff, // position diff
options.orientation, // orientation
(scrollBegin < 0) ? "start" : "end", // edge
scrollBegin, // raw position
self);
} else if (self._edgeEffectGradientSize > 0) {
// In some rare cases gradient in default edge effect may stay greater than 0
// eg. fast flicking down and up without touchend
(ui.edgeEffect || ui.scrollview.querySelector("." + classes.edgeEffect)).style.boxShadow = "none";
self._edgeEffectGradientSize = 0;
} else {
if (self._scrollviewWidget) {
self._scrollviewWidget.hideBouncingEffect();
}
}
}
if (scrollBegin !== undefined) {
self._scrollBegin = scrollBegin;
currentIndex = floor(scrollBegin / self._itemSize);
if (currentIndex !== floor(self._scrollBeginPrev / self._itemSize) && currentIndex >= 0) {
if (scrollBegin < self._itemSize) {
fromIndex = 0;
correction = 0;
} else if (currentIndex > (dataLength - numberOfItems) && !infinite) {
fromIndex = dataLength - numberOfItems;
correction = itemSize * (currentIndex - fromIndex);
} else {
fromIndex = currentIndex - 1;
correction = itemSize;
}
// Get elements which are currently presented
for (i = fromIndex; i < fromIndex + numberOfItems; ++i) {
map[i - fromIndex] = filter.call(list.children, filterElement.bind(null, i % dataLength))[0];
}
// Get elements that should be changed
freeElements = filter.call(list.children, filterFreeElements.bind(null, map));
for (i = fromIndex + numberOfItems - 1; i >= fromIndex; --i) {
j = i % dataLength;
if ((i >= 0 && i < dataLength) || infinite) {
// if checked element is not presented
if (!map[i - fromIndex]) {
// get first free element
listItem = freeElements.shift();
map[i - fromIndex] = listItem;
self._updateListItem(listItem, j);
// Get the desired position for the element
if (i - fromIndex === numberOfItems - 1 || (j < fromIndex && (scrollBegin > self._scrollBeginPrev))) {
list.appendChild(listItem);
} else {
nextElement = map.filter(filterNextElement.bind(null, i - fromIndex))[0];
if (!nextElement) {
list.insertBefore(listItem, list.firstElementChild);
} else {
list.insertBefore(listItem, nextElement);
}
}
}
}
}
scroll[beginProperty] = correction + scrollBegin % self._itemSize;
} else {
// If we are somewhere in the middle of the list
if (scrollBegin >= 0) {
if (scrollBegin < self._itemSize) {
scroll[beginProperty] = scrollBegin % itemSize;
} else if (currentIndex > (dataLength - numberOfItems) && (!infinite)) {
fromIndex = dataLength - numberOfItems;
correction = itemSize * (currentIndex - fromIndex);
scroll[beginProperty] = correction + scrollBegin % itemSize;
} else {
scroll[beginProperty] = itemSize + scrollBegin % itemSize;
}
} else {
// In case we scroll to content before the list
scroll[beginProperty] = scrollBegin;
}
}
scrollChildStyle.webkitTransform = "translate(" + (-scroll.scrollLeft) + "px, " + (-scroll.scrollTop) + "px)";
self._scrollBeginPrev = scrollBegin;
if (self._snapListviewWidget) {
self._snapListviewWidget.refresh();
}
}
}
prototype._bindEvents = function () {
var scrollEventBound = _updateList.bind(null, this),
scrollview = this._ui.scrollview;
if (scrollview) {
scrollview.addEventListener("scroll", scrollEventBound, false);
this._scrollEventBound = scrollEventBound;
}
};
prototype._destroy = function () {
utilScrolling.disable();
};
prototype.setListItemUpdater = function (updateFunction) {
this.options.listItemUpdater = updateFunction;
this.refresh();
};
SimpleVirtualList.prototype = prototype;
ns.engine.defineWidget(
"VirtualListviewSimple",
// empty selector because widget require manual build
"",
["draw", "setListItemUpdater", "scrollTo", "scrollToIndex"],
SimpleVirtualList,
"",
true
);
ns.widget.core.VirtualListviewSimple = SimpleVirtualList;
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define, NodeList, HTMLCollection */
/*
* @author Jadwiga Sosnowska <j.sosnowska@partner.samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Maciej Moczulski <m.moczulski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var /**
* @property {number} [containerCounter=0]
* @member ns.util.DOM
* @private
* @static
*/
containerCounter = 0,
/**
* Alias to Array.slice method
* @method slice
* @member ns.util.DOM
* @private
* @static
*/
slice = [].slice,
DOM = ns.util.DOM,
contentRegex = /(\$\{content\})/gi;
/**
* Checks if element was converted via WebComponentsJS,
* this will return false if WC support is native
* @param {HTMLElement} node
* @return {boolean}
* @static
* @member ns.util.DOM
*/
function isNodeWebComponentPolyfilled(node) {
var keys;
if (!node) {
return false;
}
// hacks
keys = Object.keys(node).join(":");
return (keys.indexOf("__impl") > -1 || keys.indexOf("__upgraded__") > -1 ||
keys.indexOf("__attached__") > -1);
}
/**
* Returns wrapped element which was normal HTML element
* by WebComponent polyfill
* @param {HTMLElement} element
* @return {?HTMLElement}
* @member ns.util.DOM
* @static
*/
function wrapWebComponentPolyfill(element) {
var wrap = window.ShadowDOMPolyfill && window.ShadowDOMPolyfill.wrap;
if (element && wrap) {
return wrap(element);
}
return element;
}
/**
* Returns normal element which was wrapped
* by WebComponent polyfill
* @param {HTMLElement} element
* @return {?HTMLElement}
* @member ns.util.DOM
* @static
*/
function unwrapWebComponentPolyfill(element) {
var unwrap = window.ShadowDOMPolyfill && window.ShadowDOMPolyfill.unwrap;
if (element && unwrap) {
return unwrap(element);
}
ns.error("Unwrap method not available");
return element;
}
/**
* Creates a selector for given node
* @param {HTMLElement} node
* @return {string}
* @member ns.util.DOM
* @method getNodeSelector
*/
function getNodeSelector(node) {
var attributes = node.attributes,
attributeLength = attributes.length,
attr,
i = 0,
selector = node.tagName.toLowerCase();
for (; i < attributeLength; ++i) {
attr = attributes.item(i);
selector += "[" + attr.name + "=\"" + attr.value + "\"]";
}
return selector;
}
/**
* Creates selector path (node and its parents) for given node
* @param {HTMLElement} node
* @return {string}
* @member ns.util.DOM
* @method getNodeSelectorPath
*/
function getNodeSelectorPath(node) {
var path = getNodeSelector(node),
parent = node.parentNode;
while (parent) {
path = getNodeSelector(parent) + ">" + path;
parent = parent.parentNode;
if (parent === document) {
parent = null;
}
}
return path;
}
DOM.getNodeSelector = getNodeSelector;
DOM.getNodeSelectorPath = getNodeSelectorPath;
/**
* Compares a node to another node
* note: this is needed because of broken WebComponents node wrapping
* @param {HTMLElement} nodeA
* @param {HTMLElement} nodeB
* @return {boolean}
* @member ns.util.DOM
* @method isNodeEqual
*/
DOM.isNodeEqual = function (nodeA, nodeB) {
var nodeAPolyfilled,
nodeBPolyfilled,
foundNodeA = nodeA,
foundNodeB = nodeB,
unwrap = (window.ShadowDOMPolyfill && window.ShadowDOMPolyfill.unwrap); // hack
if (nodeA === null || nodeB === null) {
return false;
} else {
nodeAPolyfilled = isNodeWebComponentPolyfilled(nodeA);
nodeBPolyfilled = isNodeWebComponentPolyfilled(nodeB);
}
if (nodeAPolyfilled) {
if (unwrap) {
foundNodeA = unwrap(nodeA);
} else {
foundNodeA = document.querySelector(getNodeSelectorPath(nodeA));
}
}
if (nodeBPolyfilled) {
if (unwrap) {
foundNodeB = unwrap(nodeB);
} else {
foundNodeB = document.querySelector(getNodeSelectorPath(nodeB));
}
}
return foundNodeA === foundNodeB;
};
/**
* Checks if element was converted via WebComponentsJS,
* this will return false if WC support is native
* @method isNodeWebComponentPolyfilled
* @param {HTMLElement} node
* @return {boolean}
* @static
* @member ns.util.DOM
*/
DOM.isNodeWebComponentPolyfilled = isNodeWebComponentPolyfilled;
DOM.unwrapWebComponentPolyfill = unwrapWebComponentPolyfill;
DOM.wrapWebComponentPolyfill = wrapWebComponentPolyfill;
DOM.isElement = function (element) {
var raw = element;
if (!raw) {
return false;
}
// Dirty hack for bogus WebComponent polyfill
if (typeof raw.localName === "string" && raw.localName.length > 0) {
return true;
}
if (!(element instanceof Element)) {
if (isNodeWebComponentPolyfilled(element)) {
raw = unwrapWebComponentPolyfill(element);
}
}
return raw instanceof Element;
};
/**
* Appends node or array-like node list array to context
* @method appendNodes
* @member ns.util.DOM
* @param {HTMLElement} context
* @param {HTMLElement|HTMLCollection|NodeList|Array} elements
* @return {HTMLElement|Array|null}
* @static
* @throws {string}
*/
DOM.appendNodes = function (context, elements) {
var i,
length,
arrayElements;
if (context) {
if (elements instanceof Array || elements instanceof NodeList ||
elements instanceof HTMLCollection) {
arrayElements = slice.call(elements);
for (i = 0, length = arrayElements.length; i < length; i += 1) {
context.appendChild(arrayElements[i]);
}
} else {
context.appendChild(elements);
arrayElements = elements;
}
return arrayElements;
}
throw "Context empty!";
};
/**
* Replaces context with node or array-like node list
* @method replaceWithNodes
* @member ns.util.DOM
* @param {HTMLElement} context
* @param {HTMLElement|HTMLCollection|NodeList|Array} elements
* @return {HTMLElement|Array|null}
* @static
*/
DOM.replaceWithNodes = function (context, elements) {
var returnElements;
if (elements instanceof Array || elements instanceof NodeList ||
elements instanceof HTMLCollection) {
returnElements = this.insertNodesBefore(context, elements);
context.parentNode.removeChild(context);
} else {
context.parentNode.replaceChild(elements, context);
returnElements = elements;
}
return returnElements;
};
/**
* Remove all children
* @method removeAllChildren
* @member ns.util.DOM
* @param {HTMLElement} context
* @static
*/
DOM.removeAllChildren = function (context) {
context.innerHTML = "";
};
/**
* Inserts node or array-like node list before context
* @method insertNodesBefore
* @member ns.util.DOM
* @param {HTMLElement} context
* @param {HTMLElement|HTMLCollection|NodeList|Array} elements
* @return {HTMLElement|Array|null}
* @static
* @throws {string}
*/
DOM.insertNodesBefore = function (context, elements) {
var i,
length,
parent,
returnElements;
if (context) {
parent = context.parentNode;
if (elements instanceof Array || elements instanceof NodeList ||
elements instanceof HTMLCollection) {
returnElements = slice.call(elements);
for (i = 0, length = returnElements.length; i < length; ++i) {
parent.insertBefore(returnElements[i], context);
}
} else {
parent.insertBefore(elements, context);
returnElements = elements;
}
return returnElements;
}
throw "Context empty!";
};
/**
* Inserts node after context
* @method insertNodeAfter
* @member ns.util.DOM
* @param {HTMLElement} context
* @param {HTMLElement} element
* @return {HTMLElement}
* @static
* @throws {string}
*/
DOM.insertNodeAfter = function (context, element) {
if (context) {
context.parentNode.insertBefore(element, context.nextSibling);
return element;
}
throw "Context empty!";
};
/**
* Remove all children of node.
* @param {Node} fragment
*/
function cleanFragment(fragment) {
// clean up
while (fragment.firstChild) {
fragment.removeChild(fragment.firstChild);
}
}
/**
* Move nodes from one node to another.
* @param {Node} fromNode
* @param {Node} toNode
*/
function moveChildren(fromNode, toNode) {
// move the nodes
while (fromNode.firstChild) {
toNode.appendChild(fromNode.firstChild);
}
}
/**
* Prepare container for filling template
* @param {Node} fragment
* @param {string} html
* @return {{container: *, contentFlag: boolean}}
*/
function prepareContainer(fragment, html) {
var container = document.createElement("div"),
contentFlag = false;
fragment.appendChild(container);
container.innerHTML = html.replace(contentRegex, function () {
contentFlag = true;
return "<span id='temp-container-" + (++containerCounter) + "'></span>";
});
return {
container: container,
contentFlag: contentFlag
};
}
/**
* Wraps element or array-like node list in html markup
* @method wrapInHTML
* @param {HTMLElement|NodeList|HTMLCollection|Array} elements
* @param {string} html
* @return {HTMLElement|NodeList|Array} wrapped element
* @member ns.util.DOM
* @static
*/
DOM.wrapInHTML = function (elements, html) {
var fragment = document.createDocumentFragment(),
fragment2 = document.createDocumentFragment(),
elementsLen = elements.length,
//if elements is nodeList, retrieve parentNode of first node
originalParentNode = elementsLen ? elements[0].parentNode : elements.parentNode,
next = elementsLen ? elements[elementsLen - 1].nextSibling : elements.nextSibling,
innerContainer,
resultElements,
containerData;
containerData = prepareContainer(fragment, html);
if (containerData.contentFlag === true) {
innerContainer = containerData.container.querySelector("span#temp-container-" +
containerCounter);
resultElements = this.replaceWithNodes(innerContainer, elements);
} else {
innerContainer = containerData.container.children[0];
resultElements = this.appendNodes(innerContainer || containerData.container, elements);
}
moveChildren(fragment.firstChild, fragment2);
cleanFragment(fragment);
if (originalParentNode) {
originalParentNode.insertBefore(fragment2, next);
} else {
cleanFragment(fragment2);
}
return resultElements;
};
}(window, window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Wearable UI Components
* The Tizen Wearable Web UI framework provides rich Tizen Wearable UI Components that are optimized for the Tizen
* Wearable Web application. You can use the UI Components for:
*
* - CSS animation
* - Rendering
*
* The following table displays the UI Components provided by the Tizen Wearable Web UI framework.
*
* @class ns.widget.wearable
* @seeMore https://developer.tizen.org/dev-guide/2.2.1/org.tizen.web.uiwidget.apireference/html/web_ui_framework.htm
* "Web UI Framework Reference"
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (window, ns) {
"use strict";
ns.widget.wearable = ns.widget.wearable || {};
}(window, ns));
/*global window, define, ns*/
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # ScrollView Widget
* Widgets allows for creating scrollable panes, lists, etc.
*
* ## Manual constructor
*
* To create the widget manually you can use APIs,
*
* ### Create scrollview by TAU API
*
*@example
* <div data-role="page" id="myPage">
* </div>
* <script>
* var page = tau.widget.Page(document.getElementById("myPage")),
* scrollview = tau.widget.Scrollview("myPage");
* </script>
*
* ## Options for Scrollview widget
*
* Options can be set using data-* attributes or by passing them to
* the constructor.
*
* There is also a method **option** for changing them after widget
* creation.
*
* @author Maciej Moczulski <m.moczulski@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
/**
* Alias for {@link ns.engine}
* @property {Object} engine
* @member ns.widget.wearable.Page
* @private
* @static
*/
utilsEvents = ns.event,
engine = ns.engine,
/**
* Alias for {@link ns.util}
* @property {Object} util
* @member ns.widget.wearable.Page
* @private
* @static
*/
util = ns.util,
scrolling = util.scrolling,
/**
* Alias for {@link ns.util.DOM}
* @property {Object} doms
* @member ns.widget.wearable.Page
* @private
* @static
*/
DOM = util.DOM,
/**
* Alias for {@link ns.util.selectors}
* @property {Object} selectors
* @member ns.widget.wearable.Page
* @private
* @static
*/
selectors = util.selectors,
/**
* Alias for {@link ns.util.object}
* @property {Object} object
* @member ns.widget.wearable.Page
* @private
* @static
*/
scrollBarType = {
CIRCLE: "tizen-circular-scrollbar"
},
EffectBouncing = ns.widget.core.scroller.effect.Bouncing,
Scrollview = function () {
this.options = {
bouncingEffect: true
};
},
/**
* Dictionary for page related css class names
* @property {Object} classes
* @member ns.widget.core.Page
* @static
* @readonly
*/
classes = {
uiHeader: "ui-header",
uiContent: "ui-content",
uiPageScroll: "ui-scroll-on",
uiScroller: "ui-scroller"
},
prototype = new BaseWidget();
prototype._build = function (element) {
var pageScrollSelector = classes.uiPageScroll,
children = [].slice.call(element.children),
scroller,
content,
fragment;
element.classList.add(pageScrollSelector);
scroller = document.createElement("div");
scroller.classList.add(classes.uiScroller);
fragment = document.createDocumentFragment();
children.forEach(function (value) {
if (selectors.matchesSelector(value, ".ui-header:not(.ui-fixed), .ui-content, .ui-footer:not(.ui-fixed)")) {
fragment.appendChild(value);
}
});
if (element.children.length > 0 && element.children[0].classList.contains(classes.uiHeader)) {
DOM.insertNodeAfter(element.children[0], scroller);
} else {
element.insertBefore(scroller, element.firstChild);
}
scroller.appendChild(fragment);
if (ns.support.shape.circle) {
if (scroller) {
scroller.setAttribute(scrollBarType.CIRCLE, "");
}
content = element.querySelector("." + classes.uiContent);
if (content) {
content.setAttribute(scrollBarType.CIRCLE, "");
}
}
this.scroller = scroller;
return element;
};
prototype._setBouncingEffect = function (element, value) {
var self = this,
scroller = self.scroller;
if (value) {
ns.event.enableGesture(
scroller,
new ns.event.gesture.Drag({
threshold: 30,
delay: self.options.scrollDelay,
blockVertical: self.orientation === EffectBouncing.Orientation.HORIZONTAL,
blockHorizontal: self.orientation === EffectBouncing.Orientation.VERTICAL
})
);
utilsEvents.on(scroller, "drag dragstart dragend", self);
} else {
ns.event.disableGesture(scroller);
utilsEvents.off(scroller, "drag dragstart dragend", self);
}
};
prototype._init = function () {
var self = this,
scroller = self.scroller;
self.maxScrollX = 0;
self.maxScrollY = 0;
if (scroller) {
self.maxScrollY = scroller.scrollHeight - window.innerHeight;
}
self.minScrollX = 0;
self.minScrollY = 0;
self.bouncingEffect = new EffectBouncing(self.element, {
maxScrollX: self.maxScrollX,
maxScrollY: self.maxScrollY,
orientation: "vertical"
});
self.scrollerOffsetX = 0;
self.scrollerOffsetY = 0;
self._setBouncingEffect(self.element, self.options.bouncingEffect);
};
prototype._start = function () {
var self = this;
self.scrolled = false;
self.dragging = true;
self.scrollCanceled = false;
self.startScrollerOffsetX = self.scrollerOffsetX;
self.startScrollerOffsetY = self.scrollerOffsetY;
};
prototype._end = function () {
if (this.dragging) {
// bouncing effect
if (this.bouncingEffect) {
this.bouncingEffect.dragEnd();
}
this.dragging = false;
}
};
prototype.showBouncingEffect = function (place) {
var bouncingEffect = this.bouncingEffect;
if (place === "end") {
bouncingEffect.drag(0, -this.scroller.getBoundingClientRect().height);
} else {
bouncingEffect.drag(0, 0);
}
};
prototype.hideBouncingEffect = function () {
var bouncingEffect = this.bouncingEffect;
if (bouncingEffect) {
bouncingEffect.dragEnd();
}
};
/* jshint -W086 */
prototype.handleEvent = function (event) {
switch (event.type) {
case "dragstart":
this._start(event);
break;
case "drag":
this._move(event);
break;
case "dragend":
this._end(event);
break;
}
};
prototype._move = function (event) {
var self = this,
scroller = self.scroller,
newX = self.startScrollerOffsetX,
newY = self.startScrollerOffsetY,
scrollTop,
maxScrollY,
deltaY = event.detail.deltaY,
bouncingEffect = self.bouncingEffect;
if (scrolling.isElement(scroller)) {
scrollTop = scrolling.getScrollPosition();
maxScrollY = scrolling.getMaxScroll();
} else {
scrollTop = scroller.scrollTop;
maxScrollY = self.maxScrollY;
}
if ((scrollTop === 0 && deltaY > 0) ||
(scrollTop === maxScrollY && deltaY < 0)) {
if (bouncingEffect) {
bouncingEffect.drag(0, -scrollTop);
}
}
self.scrollerOffsetX = newX;
self.scrollerOffsetY = newY;
};
Scrollview.prototype = prototype;
ns.widget.wearable.Scrollview = Scrollview;
engine.defineWidget(
"Scrollview",
"",
[],
Scrollview
);
}(window, window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Popup Widget
* Shows a pop-up window.
*
* The popup widget shows in the middle of the screen a list of items in a pop-up window.
* It automatically optimizes the pop-up window size within the screen. The following table
* describes the supported popup classes.
*
* ## Default selectors
* All elements with class *ui-popup* will be become popup widgets.
*
* The pop-up window can contain a header, content, and footer area like the page element.
*
* To open a pop-up window from a link, use the data-rel attribute in HTML markup as in the
* following code:
*
* @example
* <a href="#popup" class="ui-btn" data-rel="popup">Open popup when clicking this element.</a>
*
* The following table shows examples of various types of popups.
*
* The popup contains header, content and footer area
*
* ###HTML Examples
*
* #### Basic popup with header, content, footer
*
* @example
* <div class="ui-page">
* <div class="ui-popup">
* <div class="ui-popup-header">Power saving mode</div>
* <div class="ui-popup-content">
* Turning on Power
* saving mode will
* limit the maximum
* per
* </div>
* <div class="ui-popup-footer">
* <button id="cancel" class="ui-btn">Cancel</button>
* </div>
* </div>
* </div>
*
* #### Popup with 2 buttons in the footer
*
* @example
* <div id="2btnPopup" class="ui-popup">
* <div class="ui-popup-header">Delete</div>
* <div class="ui-popup-content">
* Delete the image?
* </div>
* <div class="ui-popup-footer ui-grid-col-2">
* <button id="2btnPopup-cancel" class="ui-btn">Cancel</button>
* <button id="2btnPopup-ok" class="ui-btn">OK</button>
* </div>
* </div>
*
* #### Popup with checkbox/radio
*
* If you want make popup with list checkbox(or radio) just include checkbox (radio) to popup and
* add class *ui-popup-checkbox-label* to popup element.
*
* @example
* <div id="listBoxPopup" class="ui-popup">
* <div class="ui-popup-header">When?</div>
* <div class="ui-popup-content" style="height:243px; overflow-y:scroll">
* <ul class="ui-listview">
* <li>
* <label for="check-1" class="ui-popup-checkbox-label">Yesterday</label>
* <input type="checkbox" name="checkSet" id="check-1" />
* </li>
* <li>
* <label for="check-2" class="ui-popup-checkbox-label">Today</label>
* <input type="checkbox" name="checkSet" id="check-2" />
* </li>
* <li>
* <label for="check-3" class="ui-popup-checkbox-label">Tomorrow</label>
* <input type="checkbox" name="checkSet" id="check-3" />
* </li>
* </ul>
* <ul class="ui-listview">
* <li>
* <label for="radio-1" class="ui-popup-radio-label">Mandatory</label>
* <input type="radio" name="radioSet" id="radio-1" />
* </li>
* <li>
* <label for="radio-2" class="ui-popup-radio-label">Optional</label>
* <input type="radio" name="radioSet" id="radio-2" />
* </li>
* </ul>
* </div>
* <div class="ui-popup-footer">
* <button id="listBoxPopup-close" class="ui-btn">Close</button>
* </div>
* </div>
* </div>
*
* #### Popup with no header and footer
*
* @example
* <div id="listNoTitleNoBtnPopup" class="ui-popup">
* <div class="ui-popup-content" style="height:294px; overflow-y:scroll">
* <ul class="ui-listview">
* <li><a href="">Ringtones 1</a></li>
* <li><a href="">Ringtones 2</a></li>
* <li><a href="">Ringtones 3</a></li>
* </ul>
* </div>
* </div>
*
* #### Toast popup
*
* @example
* <div id="PopupToast" class="ui-popup ui-popup-toast">
* <div class="ui-popup-content">Saving contacts to sim on Samsung</div>
* </div>
*
* ### Create Option popup
*
* Popup inherits value of option positionTo from property data-position-to set in link.
*
* @example
* <!--definition of link, which opens popup and sets its position-->
* <a href="#popupOptionText" data-rel="popup" data-position-to="origin">Text</a>
* <!--definition of popup, which inherits property position from link-->
* <div id="popupOptionText" class="ui-popup">
* <div class="ui-popup-content">
* <ul class="ui-listview">
* <li><a href="#">Option 1</a></li>
* <li><a href="#">Option 2</a></li>
* <li><a href="#">Option 3</a></li>
* <li><a href="#">Option 4</a></li>
* </ul>
* </div>
* </div>
*
* ### Opening and closing popup
*
* To open popup from "a" link using html markup, use the following code:
*
* @example
* <div class="ui-page">
* <header class="ui-header">
* <h2 class="ui-title">Call menu</h2>
* </header>
* <div class="ui-content">
* <a href="#popup" class="ui-btn" data-rel="popup" >Open Popup</a>
* </div>
*
* <div id="popup" class="ui-popup">
* <div class="ui-popup-header">Power saving mode</div>
* <div class="ui-popup-content">
* Turning on Power
* saving mode will
* limit the maximum
* per
* </div>
* <div class="ui-popup-footer">
* <button id="cancel" class="ui-btn">Cancel</button>
* </div>
* </div>
*
* To open the popup widget from JavaScript use method *tau.openPopup(to)*
*
* @example
* tau.openPopup("popup")
*
* To close the popup widget from JavaScript use method *tau.openPopup(to)*
*
* @example
* tau.closePopup("popup")
*
* To find the currently active popup, use the ui-popup-active class.
*
* To bind the popup to a button, use the following code:
*
* @example
* <!--HTML code-->
* <div id="1btnPopup" class="ui-popup">
* <div class="ui-popup-header">Power saving mode</div>
* <div class="ui-popup-content">
* </div>
* <div class="ui-popup-footer">
* <button id="1btnPopup-cancel" class="ui-btn">Cancel</button>
* </div>
* </div>
* <script>
* // Popup opens with button click
* var button = document.getElementById("button");
* button.addEventListener("click", function() {
* tau.openPopup("#1btnPopup");
* });
*
* // Popup closes with Cancel button click
* document.getElementById("1btnPopup-cancel").addEventListener("click", function() {
* tau.closePopup();
* });
* </script>
*
* ## Manual constructor
* For manual creation of popup widget you can use constructor of widget from **tau** namespace:
*
* @example
* var popupElement = document.getElementById("popup"),
* popup = tau.widget.popup(buttonElement);
*
* Constructor has one require parameter **element** which are base **HTMLElement** to create
* widget. We recommend get this element by method *document.getElementById*.
*
* ## Options for Popup Widget
*
* Options for widget can be defined as _data-..._ attributes or give as parameter in constructor.
*
* You can change option for widget using method **option**.
*
* ## Methods
*
* To call method on widget you can use tau API:
*
* @example
* var popupElement = document.getElementById("popup"),
* popup = tau.widget.popup(buttonElement);
*
* popup.methodName(methodArgument1, methodArgument2, ...);
*
* ## Transitions
*
* By default, the framework doesn't apply transition. To set a custom transition effect, add the
* data-transition attribute to the link.
*
* @example
* <a href="index.html" data-rel="popup" data-transition="slideup">I will slide up</a>
*
* Global configuration:
*
* @example
* gear.ui.defaults.popupTransition = "slideup";
*
* ### Transitions list
*
* - **none** Default value, no transition.
* - **slideup** Makes the content of the pop-up slide up.
*
* ## Handling Popup Events
*
* To use popup events, use the following code:
*
* @example
* <!--Popup html code-->
* <div id="popup" class="ui-popup">
* <div class="ui-popup-header"></div>
* <div class="ui-popup-content"></div>
* </div>
* </div>
* <script>
* // Use popup events
* var popup = document.getElementById("popup");
* popup.addEventListener("popupbeforecreate", function() {
* // Implement code for popupbeforecreate event
* });
* </script>
*
* Full list of available events is in [events list section](#events-list).
*
* @author Hyunkook Cho <hk0713.cho@samsung.com>
* @class ns.widget.core.ContextPopup
* @extends ns.widget.core.Popup
* @component-selector [data-role="popup"], .ui-popup
*/
(function (window, document, ns) {
"use strict";
var Popup = ns.widget.core.Popup,
PopupPrototype = Popup.prototype,
engine = ns.engine,
objectUtils = ns.util.object,
domUtils = ns.util.DOM,
/**
* Object with default options
* @property {Object} defaults
* @property {string} [options.transition="none"] Sets the default transition for the popup.
* @property {string} [options.positionTo="window"] Sets the element relative to which the
* popup will be centered.
* @property {boolean} [options.dismissible=true] Sets whether to close popup when a popup
* is open to support the back button.
* @property {boolean} [options.overlay=true] Sets whether to show overlay when a popup is
* open.
* @property {string} [overlayClass=""] Sets the custom class for the popup background,
* which covers the entire window.
* @property {boolean} [options.history=true] Sets whether to alter the url when a popup
* is open to support the back button.
* @property {string} [options.arrow="l,t,r,b"] Sets directions of popup's arrow by
* priority ("l" for left, "t" for top,
* "r" for right, and "b" for bottom). The first one has the highest priority, the last one
* - the lowest. If you set arrow="t",
* then arrow will be placed at the top of popup container and the whole popup will be
* placed under clicked element.
* @property {string} [options.positionTo="window"] Sets the element relative to which
* the popup will be centered.
* @property {number} [options.distance=0] Sets the extra distance in px from clicked
* element.
* @property {HTMLElement|string} [options.link=null] Set the element or its id, under
* which popup should be placed.
* It only works with option positionTo="origin".
* @member ns.widget.core.ContextPopup
* @static
* @private
*/
defaults = {
arrow: "l,b,r,t",
positionTo: "window",
positionOriginCenter: false,
distance: 0,
link: null
},
ContextPopup = function () {
var self = this,
ui;
Popup.call(self);
// set options
self.options = objectUtils.merge(self.options, defaults);
// set ui
ui = self._ui || {};
ui.arrow = null;
self._ui = ui;
},
/**
* @property {Object} classes Dictionary for popup related css class names
* @member ns.widget.core.Popup
* @static
*/
CLASSES_PREFIX = "ui-popup",
classes = objectUtils.merge({}, Popup.classes, {
context: "ui-ctxpopup",
contextOverlay: "ui-ctxpopup-overlay",
arrow: "ui-arrow",
arrowDir: CLASSES_PREFIX + "-arrow-"
}),
/**
* @property {Object} events Dictionary for popup related events
* @member ns.widget.core.Popup
* @static
*/
/* eslint-disable camelcase */
// we can't change this in this moment because this is part of API
events = objectUtils.merge({}, Popup.events, {
before_position: "beforeposition"
}),
/* eslint-enable camelcase */
positionTypes = {
WINDOW: "window",
ORIGIN: "origin",
ABSOLUTE: "absolute"
},
prototype = new Popup();
ContextPopup.defaults = objectUtils.merge({}, Popup.defaults, defaults);
ContextPopup.classes = classes;
ContextPopup.events = events;
ContextPopup.positionTypes = positionTypes;
/**
* Build structure of Popup widget
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.core.Popup
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
arrow;
// build elements of popup
PopupPrototype._build.call(self, element);
// set class for element
element.classList.add(classes.popup);
// create arrow
arrow = document.createElement("div");
arrow.appendChild(document.createElement("span"));
arrow.classList.add(classes.arrow);
ui.arrow = arrow;
// add arrow to popup element
element.appendChild(arrow);
return element;
};
/**
* Init widget
* @method _init
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._init = function (element) {
var self = this,
ui = self._ui;
PopupPrototype._init.call(this, element);
ui.arrow = ui.arrow || element.querySelector("." + classes.arrow);
};
/**
* Layouting popup structure
* @method layout
* @member ns.widget.core.ContextPopup
* @param {HTMLElement} element
*/
prototype._layout = function (element) {
var self = this;
this._reposition();
PopupPrototype._layout.call(self, element);
};
/**
* Set position and size of popup.
* @method _reposition
* @param {Object} options
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._reposition = function (options) {
var self = this,
element = self.element,
ui = self._ui,
elementClassList = element.classList;
options = objectUtils.merge({}, self.options, options);
self.trigger(events.before_position, null, false);
elementClassList.add(classes.build);
// set height of content
self._setContentHeight();
// set class for contextpopup
if ((options.positionTo === "origin") && ui.overlay) {
ui.overlay.classList.add(classes.contextOverlay);
}
// set position of popup
self._placementCoords(options);
elementClassList.remove(classes.build);
};
/**
* Find the best position of context popup.
* @method findBestPosition
* @param {ns.widget.core.ContextPopup} self
* @param {HTMLElement} clickedElement
* @private
* @member ns.widget.core.ContextPopup
*/
function findBestPosition(self, clickedElement) {
var options = self.options,
arrowsPriority = options.arrow.split(","),
element = self.element,
windowWidth = window.innerWidth,
windowHeight = window.innerHeight,
popupWidth = domUtils.getElementWidth(element, "outer"),
popupHeight = domUtils.getElementHeight(element, "outer"),
// offset coordinates of clicked element
clickElementRect = clickedElement.getBoundingClientRect(),
clickElementOffsetX = clickElementRect.left,
clickElementOffsetY = clickElementRect.top,
// width of visible part of clicked element
clickElementOffsetWidth = Math.min(clickElementRect.width,
windowWidth - clickElementOffsetX),
// height of visible part of clicked element
clickElementOffsetHeight = Math.min(clickElementRect.height,
windowHeight - clickElementOffsetY),
// params for all types of popup
// "l" - popup with arrow on the left side, "r" - right, "b" - bottom, "t" - top
// dir - this letter is added as a suffix of class to popup's element
// fixedPositionField - specifies which coordinate is changed for this type of popup
// fixedPositionFactor - factor, which specifies if size should be added or subtracted
// size - available size, which is needed for this type of popup (width or height)
// max - maximum size of available place
params = {
"l": {
dir: "l", fixedPositionField: "x", fixedPositionFactor: 1,
size: popupWidth, max: clickElementOffsetX
},
"r": {
dir: "r", fixedPositionField: "x", fixedPositionFactor: -1,
size: popupWidth, max: windowWidth - clickElementOffsetX - clickElementOffsetWidth
},
"b": {
dir: "b", fixedPositionField: "y", fixedPositionFactor: -1,
size: popupHeight, max: clickElementOffsetY
},
"t": {
dir: "t", fixedPositionField: "y", fixedPositionFactor: 1,
size: popupHeight, max: windowHeight - clickElementOffsetY - clickElementOffsetHeight
}
},
bestDirection,
direction,
bestOffsetInfo;
// set value of bestDirection on the first possible type or top
bestDirection = params[arrowsPriority[0]] || params.t;
arrowsPriority.forEach(function (key) {
var param = params[key],
paramMax = param.max;
if (!direction) {
if (param.size < paramMax) {
direction = param;
} else if (paramMax > bestDirection.max) {
bestDirection = param;
}
}
});
if (!direction) {
direction = bestDirection;
if (direction.fixedPositionField === "x") {
popupWidth = direction.max;
} else {
popupHeight = direction.max;
}
}
// info about the best position without taking into account type of popup
bestOffsetInfo = {
x: clickElementOffsetX + clickElementOffsetWidth / 2 - popupWidth / 2,
y: clickElementOffsetY + clickElementOffsetHeight / 2 - popupHeight / 2,
w: popupWidth,
h: popupHeight,
dir: direction.dir
};
// check type of popup and correct value for "fixedPositionField" coordinate
bestOffsetInfo[direction.fixedPositionField] +=
(direction.fixedPositionField === "x" ?
(popupWidth + clickElementOffsetWidth) * direction.fixedPositionFactor :
(popupHeight + clickElementOffsetHeight) * direction.fixedPositionFactor) / 2 +
options.distance * direction.fixedPositionFactor;
// fix min/max position
bestOffsetInfo.x = bestOffsetInfo.x < 0 ? 0 : bestOffsetInfo.x + bestOffsetInfo.w > windowWidth ? windowWidth - bestOffsetInfo.w : bestOffsetInfo.x;
bestOffsetInfo.y = bestOffsetInfo.y < 0 ? 0 : bestOffsetInfo.y + bestOffsetInfo.h > windowHeight ? windowHeight - bestOffsetInfo.h : bestOffsetInfo.y;
return bestOffsetInfo;
}
/**
* Find the best position of arrow.
* @method adjustedPositionAndPlacementArrow
* @param {ns.widget.core.ContextPopup} self
* @param {Object} bestRectangle
* @param {number} x
* @param {number} y
* @private
* @member ns.widget.core.ContextPopup
*/
function adjustedPositionAndPlacementArrow(self, bestRectangle, x, y) {
var ui = self._ui,
wrapper = ui.wrapper,
arrow = ui.arrow,
popupElement = self.element,
arrowStyle = arrow.style,
windowWidth = window.innerWidth,
windowHeight = window.innerHeight,
wrapperRect = wrapper.getBoundingClientRect(),
arrowHalfWidth = arrow.offsetWidth / 2,
popupProperties = {
"padding-top": 0,
"padding-bottom": 0,
"padding-left": 0,
"padding-right": 0,
"border-top-width": 0,
"border-left-width": 0,
"box-sizing": null
},
wrapperProperties = {
"margin-top": 0,
"margin-bottom": 0,
"margin-left": 0,
"margin-right": 0,
"padding-top": 0,
"padding-bottom": 0,
"padding-left": 0,
"padding-right": 0
},
margins,
params = {
"t": {pos: x, min: "left", max: "right", posField: "x", valField: "w", styleField: "left"},
"b": {pos: x, min: "left", max: "right", posField: "x", valField: "w", styleField: "left"},
"l": {pos: y, min: "top", max: "bottom", posField: "y", valField: "h", styleField: "top"},
"r": {pos: y, min: "top", max: "bottom", posField: "y", valField: "h", styleField: "top"}
},
param = params[bestRectangle.dir],
surplus,
addPadding;
domUtils.extractCSSProperties(popupElement, popupProperties);
domUtils.extractCSSProperties(wrapper, wrapperProperties);
addPadding = popupProperties["box-sizing"] === "border-box";
margins = {
"t": popupProperties["padding-top"] + wrapperProperties["margin-top"] + wrapperProperties["padding-top"],
"b": popupProperties["padding-bottom"] + wrapperProperties["margin-bottom"] + wrapperProperties["padding-bottom"],
"l": popupProperties["padding-left"] + wrapperProperties["margin-left"] + wrapperProperties["padding-left"],
"r": popupProperties["padding-right"] + wrapperProperties["margin-right"] + wrapperProperties["padding-right"]
};
// value of coordinates of proper edge of wrapper
wrapperRect = {
// x-coordinate of left edge
left: margins.l + bestRectangle.x,
// x-coordinate of right edge
right: margins.l + wrapperRect.width + bestRectangle.x,
// y-coordinate of top edge
top: margins.t + bestRectangle.y,
// y-coordinate of bottom edge
bottom: wrapperRect.height + margins.t + bestRectangle.y
};
if (wrapperRect[param.min] > param.pos - arrowHalfWidth) {
surplus = bestRectangle[param.posField];
if (surplus > 0) {
bestRectangle[param.posField] = Math.max(param.pos - arrowHalfWidth, 0);
param.pos = bestRectangle[param.posField] + arrowHalfWidth;
} else {
param.pos = wrapperRect[param.min] + arrowHalfWidth;
}
} else if (wrapperRect[param.max] < param.pos + arrowHalfWidth) {
surplus = (param.valField === "w" ? windowWidth : windowHeight) -
(bestRectangle[param.posField] + bestRectangle[param.valField]);
if (surplus > 0) {
bestRectangle[param.posField] += Math.min(surplus, (param.pos + arrowHalfWidth) - wrapperRect[param.max]);
param.pos = bestRectangle[param.posField] + bestRectangle[param.valField] - arrowHalfWidth;
} else {
param.pos = wrapperRect[param.max] - arrowHalfWidth;
}
}
arrowStyle[param.styleField] = (param.pos - arrowHalfWidth - bestRectangle[param.posField] - (addPadding ? popupProperties["border-" + param.styleField + "-width"] : 0)) + "px";
return bestRectangle;
}
/**
* Set top, left and margin for popup's container.
* @method _placementCoordsWindow
* @param {HTMLElement} element
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._placementCoordsWindow = function (element) {
var elementStyle = element.style,
elementWidth = element.offsetWidth,
elementHeight = element.offsetHeight,
elementMarginTop = domUtils.getCSSProperty(element, "margin-top", 0, "float"),
elementMarginBottom = domUtils.getCSSProperty(element, "margin-bottom", 0, "float"),
elementTop = window.innerHeight - elementHeight - elementMarginTop - elementMarginBottom;
elementStyle.top = elementTop + "px";
elementStyle.left = "50%";
elementStyle.marginLeft = -(elementWidth / 2) + "px";
};
/**
* Set top, left and margin for popup's container.
* @method _placementCoordsAbsolute
* @param {HTMLElement} element
* @param {number} x
* @param {number} y
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._placementCoordsAbsolute = function (element, x, y) {
var elementStyle = element.style,
elementWidth = element.offsetWidth,
elementHeight = element.offsetHeight;
elementStyle.top = y + "px";
elementStyle.left = x + "px";
elementStyle.marginTop = -(elementHeight / 2) + "px";
elementStyle.marginLeft = -(elementWidth / 2) + "px";
};
/**
* Find clicked element.
* @method _findClickedElement
* @param {number} x
* @param {number} y
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._findClickedElement = function (x, y) {
return document.elementFromPoint(x, y);
};
/**
* Emulate position of event for clicked element.
* @method emulatePositionOfClick
* @param {string} bestDirection direction of arrow
* @param {HTMLElement} clickedElement
* @private
* @member ns.widget.core.ContextPopup
*/
function emulatePositionOfClick(bestDirection, clickedElement) {
var clickedElementRect = clickedElement.getBoundingClientRect(),
position = {};
switch (bestDirection) {
case "l":
// the arrow will be on the left edge of container, so x-coordinate
// should have value equals to the position of right edge of clicked element
position.x = clickedElementRect.right;
// y-coordinate should have value equals to the position of top edge of clicked
// element plus half of its height
position.y = clickedElementRect.top + clickedElementRect.height / 2;
break;
case "r":
// the arrow will be on the right edge of container
position.x = clickedElementRect.left;
position.y = clickedElementRect.top + clickedElementRect.height / 2;
break;
case "t":
// the arrow will be on the top edge of container
position.x = clickedElementRect.left + clickedElementRect.width / 2;
position.y = clickedElementRect.bottom;
break;
case "b":
// the arrow will be on the bottom edge of container
position.x = clickedElementRect.left + clickedElementRect.width / 2;
position.y = clickedElementRect.top;
break;
}
return position;
}
prototype._placementCoordsOrigin = function (clickedElement, options) {
var self = this,
element = self.element,
elementStyle = element.style,
elementClassList = element.classList,
x = options.x,
y = options.y,
bestRectangle,
emulatedPosition,
arrowType,
elementHeight;
elementClassList.add(classes.context);
elementHeight = element.offsetHeight;
bestRectangle = findBestPosition(self, clickedElement);
arrowType = bestRectangle.dir;
elementClassList.add(classes.arrowDir + arrowType);
self._ui.arrow.setAttribute("type", arrowType);
if ((typeof x !== "number" && typeof y !== "number") || self.options.positionOriginCenter) {
// if we found element, which was clicked, but the coordinates of event
// was not available, we have to count these coordinates to the center of proper edge of element.
emulatedPosition = emulatePositionOfClick(arrowType, clickedElement);
x = emulatedPosition.x;
y = emulatedPosition.y;
}
bestRectangle = adjustedPositionAndPlacementArrow(self, bestRectangle, x, y);
if (elementHeight > bestRectangle.h) {
self._setContentHeight(bestRectangle.h);
}
elementStyle.left = bestRectangle.x + "px";
elementStyle.top = bestRectangle.y + "px";
};
prototype._placementCoordsElement = function (clickedElement) {
var self = this,
element = self.element,
elementStyle = element.style,
bestRectangle,
elementHeight;
element.classList.add(classes.context);
elementHeight = element.offsetHeight;
bestRectangle = findBestPosition(self, clickedElement);
if (elementHeight > bestRectangle.h) {
self._setContentHeight(bestRectangle.h);
}
elementStyle.left = bestRectangle.x + "px";
elementStyle.top = bestRectangle.y + "px";
};
/**
* Find and set the best position for popup.
* @method _placementCoords
* @param {Object} options
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._placementCoords = function (options) {
var self = this,
positionTo = options.positionTo,
x = options.x,
y = options.y,
element = self.element,
clickedElement,
link;
switch (positionTo) {
case positionTypes.ORIGIN:
// if we know x-coord and y-coord, we open the popup with arrow
link = options.link;
if (link) {
if (typeof link === "string") {
clickedElement = document.getElementById(link);
} else if (typeof link === "object") {
clickedElement = link;
}
} else if (typeof x === "number" && typeof y === "number") {
clickedElement = self._findClickedElement(x, y);
}
if (clickedElement) {
self._placementCoordsOrigin(clickedElement, options);
return;
}
break;
case positionTypes.WINDOW:
self._placementCoordsWindow(element);
return;
case positionTypes.ABSOLUTE:
if (typeof x === "number" && typeof y === "number") {
self._placementCoordsAbsolute(element, x, y);
return;
}
break;
default:
// there is possible, that element or its id was given
if (typeof positionTo === "string") {
try {
clickedElement = document.querySelector(options.positionTo);
} catch (e) {
}
} else if (typeof positionTo === "object") {
clickedElement = positionTo;
}
if (clickedElement) {
self._placementCoordsElement(clickedElement, options);
return;
}
break;
}
// if there was problem with setting position of popup, we set its position to window
self._placementCoordsWindow(element);
};
/**
* Set height for popup's container.
* @method _setContentHeight
* @param {number} maxHeight
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._setContentHeight = function (maxHeight) {
var self = this,
element = self.element,
content = self._ui.content,
contentStyle,
contentHeight,
elementOffsetHeight;
if (content) {
contentStyle = content.style;
if (contentStyle.height || contentStyle.minHeight) {
contentStyle.height = "";
contentStyle.minHeight = "";
}
maxHeight = maxHeight || window.innerHeight;
contentHeight = content.offsetHeight;
elementOffsetHeight = element.offsetHeight;
if (elementOffsetHeight > maxHeight) {
contentHeight -= (elementOffsetHeight - maxHeight);
contentStyle.height = contentHeight + "px";
contentStyle.minHeight = contentHeight + "px";
}
}
};
/**
* Hide popup.
* @method _onHide
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._onHide = function () {
var self = this,
ui = self._ui,
element = self.element,
elementClassList = element.classList,
arrow = ui.arrow;
elementClassList.remove(classes.context);
["l", "r", "b", "t"].forEach(function (key) {
elementClassList.remove(classes.arrowDir + key);
});
// we remove styles for element, which are changed
// styles for container, header and footer are left unchanged
if (element) {
element.removeAttribute("style");
}
if (arrow) {
arrow.removeAttribute("style");
}
PopupPrototype._onHide.call(self);
};
/**
* Destroy popup.
* @method _destroy
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._destroy = function () {
var self = this,
ui = self._ui,
arrow = ui.arrow;
PopupPrototype._destroy.call(self);
if (arrow && arrow.parentNode) {
arrow.parentNode.removeChild(arrow);
}
ui.arrow = null;
};
/**
* Set new position for popup.
* @method reposition
* @param {Object} options
* @param {number} options.x
* @param {number} options.y
* @param {string} options.positionTo
* @member ns.widget.core.ContextPopup
*/
prototype.reposition = function (options) {
if (this._isActive()) {
this._reposition(options);
}
};
/**
* Refresh structure
* @method _refresh
* @protected
* @member ns.widget.core.ContextPopup
*/
prototype._refresh = function () {
if (this._isActive()) {
PopupPrototype._refresh.call(this);
this.reposition(this.options);
}
};
ContextPopup.prototype = prototype;
ns.widget.core.ContextPopup = ContextPopup;
engine.defineWidget(
"Popup",
"[data-role='popup'], .ui-popup",
[
"open",
"close",
"reposition"
],
ContextPopup,
"core",
true
);
// @remove
// THIS IS ONLY FOR COMPATIBILITY
ns.widget.popup = ns.widget.Popup;
}(window, window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2013 - 2014 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Popup Widget
* Shows a pop-up window.
*
* The popup widget shows in the middle of the screen a list of items in a pop-up window. It automatically optimizes the pop-up window size within the screen. The following table describes the supported popup classes.
*
* ## Default selectors
* All elements with class *ui-popup* will be become popup widgets.
*
* The pop-up window can contain a header, content, and footer area like the page element.
*
* To open a pop-up window from a link, use the data-rel attribute in HTML markup as in the following code:
*
* @example
* <a href="#popup" class="ui-btn" data-rel="popup">Open popup when clicking this element.</a>
*
* The following table shows examples of various types of popups.
*
* The popup contains header, content and footer area
*
* ###HTML Examples
*
* #### Basic popup with header, content, footer
*
* @example
* <div class="ui-page">
* <div class="ui-popup">
* <div class="ui-popup-header">Power saving mode</div>
* <div class="ui-popup-content">
* Turning on Power
* saving mode will
* limit the maximum
* per
* </div>
* <div class="ui-popup-footer">
* <button id="cancel" class="ui-btn">Cancel</button>
* </div>
* </div>
* </div>
*
* #### Popup with 2 buttons in the footer
*
* @example
* <div id="2btnPopup" class="ui-popup">
* <div class="ui-popup-header">Delete</div>
* <div class="ui-popup-content">
* Delete the image?
* </div>
* <div class="ui-popup-footer ui-grid-col-2">
* <button id="2btnPopup-cancel" class="ui-btn">Cancel</button>
* <button id="2btnPopup-ok" class="ui-btn">OK</button>
* </div>
* </div>
*
* #### Popup with checkbox/radio
*
* If you want make popup with list checkbox(or radio) just include checkbox (radio) to popup and add class *ui-popup-checkbox-label* to popup element.
*
* @example
* <div id="listBoxPopup" class="ui-popup">
* <div class="ui-popup-header">When?</div>
* <div class="ui-popup-content" style="height:243px; overflow-y:scroll">
* <ul class="ui-listview">
* <li>
* <label for="check-1" class="ui-popup-checkbox-label">Yesterday</label>
* <input type="checkbox" name="checkSet" id="check-1" />
* </li>
* <li>
* <label for="check-2" class="ui-popup-checkbox-label">Today</label>
* <input type="checkbox" name="checkSet" id="check-2" />
* </li>
* <li>
* <label for="check-3" class="ui-popup-checkbox-label">Tomorrow</label>
* <input type="checkbox" name="checkSet" id="check-3" />
* </li>
* </ul>
* <ul class="ui-listview">
* <li>
* <label for="radio-1" class="ui-popup-radio-label">Mandatory</label>
* <input type="radio" name="radioSet" id="radio-1" />
* </li>
* <li>
* <label for="radio-2" class="ui-popup-radio-label">Optional</label>
* <input type="radio" name="radioSet" id="radio-2" />
* </li>
* </ul>
* </div>
* <div class="ui-popup-footer">
* <button id="listBoxPopup-close" class="ui-btn">Close</button>
* </div>
* </div>
* </div>
*
* #### Popup with no header and footer
*
* @example
* <div id="listNoTitleNoBtnPopup" class="ui-popup">
* <div class="ui-popup-content" style="height:294px; overflow-y:scroll">
* <ul class="ui-listview">
* <li><a href="">Ringtones 1</a></li>
* <li><a href="">Ringtones 2</a></li>
* <li><a href="">Ringtones 3</a></li>
* </ul>
* </div>
* </div>
*
* #### Toast popup
*
* @example
* <div id="PopupToast" class="ui-popup ui-popup-toast">
* <div class="ui-popup-content">Saving contacts to sim on Samsung</div>
* </div>
*
* ### Create Option popup
*
* Popup inherits value of option positionTo from property data-position-to set in link.
*
* @example
* <!--definition of link, which opens popup and sets its position-->
* <a href="#popupOptionText" data-rel="popup" data-position-to="origin">Text</a>
* <!--definition of popup, which inherits property position from link-->
* <div id="popupOptionText" class="ui-popup">
* <div class="ui-popup-content">
* <ul class="ui-listview">
* <li><a href="#">Option 1</a></li>
* <li><a href="#">Option 2</a></li>
* <li><a href="#">Option 3</a></li>
* <li><a href="#">Option 4</a></li>
* </ul>
* </div>
* </div>
*
* ### Opening and closing popup
*
* To open popup from "a" link using html markup, use the following code:
*
* @example
* <div class="ui-page">
* <header class="ui-header">
* <h2 class="ui-title">Call menu</h2>
* </header>
* <div class="ui-content">
* <a href="#popup" class="ui-btn" data-rel="popup" >Open Popup</a>
* </div>
*
* <div id="popup" class="ui-popup">
* <div class="ui-popup-header">Power saving mode</div>
* <div class="ui-popup-content">
* Turning on Power
* saving mode will
* limit the maximum
* per
* </div>
* <div class="ui-popup-footer">
* <button id="cancel" class="ui-btn">Cancel</button>
* </div>
* </div>
*
* To open the popup widget from JavaScript use method *tau.openPopup(to)*
*
* @example
* tau.openPopup("popup")
*
* To close the popup widget from JavaScript use method *tau.openPopup(to)*
*
* @example
* tau.closePopup("popup")
*
* To find the currently active popup, use the ui-popup-active class.
*
* To bind the popup to a button, use the following code:
*
* @example
* <!--HTML code-->
* <div id="1btnPopup" class="ui-popup">
* <div class="ui-popup-header">Power saving mode</div>
* <div class="ui-popup-content">
* </div>
* <div class="ui-popup-footer">
* <button id="1btnPopup-cancel" class="ui-btn">Cancel</button>
* </div>
* </div>
* <script>
* // Popup opens with button click
* var button = document.getElementById("button");
* button.addEventListener("click", function() {
* tau.openPopup("#1btnPopup");
* });
*
* // Popup closes with Cancel button click
* document.getElementById("1btnPopup-cancel").addEventListener("click", function() {
* tau.closePopup();
* });
* </script>
*
* ## Manual constructor
* For manual creation of popup widget you can use constructor of widget from **tau** namespace:
*
* @example
* var popupElement = document.getElementById("popup"),
* popup = tau.widget.popup(buttonElement);
*
* Constructor has one require parameter **element** which are base **HTMLElement** to create widget. We recommend get this element by method *document.getElementById*.
*
* ## Options for Popup Widget
*
* Options for widget can be defined as _data-..._ attributes or give as parameter in constructor.
*
* You can change option for widget using method **option**.
*
* ## Methods
*
* To call method on widget you can use tau API:
*
* @example
* var popupElement = document.getElementById("popup"),
* popup = tau.widget.popup(buttonElement);
*
* popup.methodName(methodArgument1, methodArgument2, ...);
*
* ## Transitions
*
* By default, the framework doesn't apply transition. To set a custom transition effect, add the data-transition attribute to the link.
*
* @example
* <a href="index.html" data-rel="popup" data-transition="slideup">I\'ll slide up</a>
*
* Global configuration:
*
* @example
* gear.ui.defaults.popupTransition = "slideup";
*
* ### Transitions list
*
* - **none** Default value, no transition.
* - **slideup** Makes the content of the pop-up slide up.
*
* ## Handling Popup Events
*
* To use popup events, use the following code:
*
* @example
* <!--Popup html code-->
* <div id="popup" class="ui-popup">
* <div class="ui-popup-header"></div>
* <div class="ui-popup-content"></div>
* </div>
* </div>
* <script>
* // Use popup events
* var popup = document.getElementById("popup");
* popup.addEventListener("popupbeforecreate", function() {
* // Implement code for popupbeforecreate event
* });
* </script>
*
* Full list of available events is in [events list section](#events-list).
*
* @author Hyunkook Cho <hk0713.cho@samsung.com>
* @class ns.widget.wearable.Popup
* @component-selector [data-role="popup"], .ui-popup
* @component-type hiding-container-component
* @extends ns.widget.core.ContextPopup
*/
(function (window, document, ns) {
"use strict";
var CorePopup = ns.widget.core.ContextPopup,
CorePopupPrototype = CorePopup.prototype,
engine = ns.engine,
objectUtils = ns.util.object,
defaults = {
fullSize: false,
enablePopupScroll: false
},
classes = objectUtils.merge({}, CorePopup.classes, {
popupScroll: "ui-scroll-on",
fixed: "ui-fixed",
sideButton: "ui-side-button",
hasSideButtons: "ui-has-side-buttons",
toast: "ui-popup-toast",
ctx: "ui-ctxpopup"
}),
Popup = function () {
var self = this;
CorePopup.call(self);
self.options = objectUtils.merge(self.options, {
fullSize: ns.getConfig("popupFullSize", defaults.fullSize),
enablePopupScroll: ns.getConfig("enablePopupScroll", defaults.enablePopupScroll)
});
},
prototype = new CorePopup();
/**
* Layouting popup structure
* @method layout
* @param {HTMLElement} element
* @member ns.widget.wearable.Popup
*/
prototype._layout = function (element) {
var self = this,
elementClassList = element.classList,
ui = self._ui,
wrapper = ui.wrapper,
header = ui.header,
footer = ui.footer,
content = ui.content,
headerHeight = 0,
footerHeight = 0;
self._blockPageScroll();
CorePopupPrototype._layout.call(self, element);
if (self.options.enablePopupScroll === true) {
element.classList.add(classes.popupScroll);
} else {
element.classList.remove(classes.popupScroll);
}
if (elementClassList.contains(classes.popupScroll)) {
elementClassList.add(classes.build);
if (header) {
headerHeight = header.offsetHeight;
if (header.classList.contains(classes.fixed)) {
content.style.marginTop = headerHeight + "px";
}
}
if (footer) {
footerHeight = footer.offsetHeight;
if (footer.classList.contains(classes.fixed)) {
content.style.marginBottom = footerHeight + "px";
}
if (footer.classList.contains(classes.sideButton)) {
elementClassList.add(classes.hasSideButtons);
}
}
wrapper.style.height = Math.min(content.offsetHeight + headerHeight + footerHeight, element.offsetHeight) + "px";
elementClassList.remove(classes.build);
}
if (self.options.fullSize && !elementClassList.contains(classes.toast) && !elementClassList.contains(classes.ctx)) {
wrapper.style.height = window.innerHeight + "px";
}
};
/**
* Hide popup.
* @method _onHide
* @protected
* @member ns.widget.wearable.Popup
*/
prototype._onHide = function () {
var self = this,
ui = self._ui,
wrapper = ui.wrapper;
if (wrapper) {
wrapper.removeAttribute("style");
}
self._unblockPageScroll();
CorePopupPrototype._onHide.call(self);
};
prototype._blockPageScroll = function () {
var page = ns.widget.Page(this._ui.page);
if (page.getScroller) {
page.getScroller().style.overflow = "hidden";
}
};
prototype._unblockPageScroll = function () {
var page = ns.widget.Page(this._ui.page);
if (page.getScroller) {
page.getScroller().style.overflow = "";
}
};
Popup.prototype = prototype;
ns.widget.wearable.Popup = Popup;
engine.defineWidget(
"Popup",
"[data-role='popup'], .ui-popup",
[
"open",
"close",
"reposition"
],
Popup,
"wearable",
true
);
}(window, window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Drawer
* Shows a panel that in the sub-layout on the left or right edge of screen.
*
* ##Introduction
*
* The drawer component is a panel that the application's sub layout on the left or right edge of the screen.
* This component is hidden most of the time, but user can be opened as swipe gesture from the edge of the screen or click the element that is added event handler,
* handler has drawer.open() method.
*
* Note!
* We recommend to make handler element.
* Because if you didn't set the handler, handler was set page element automatically.
* If you really want to make handler as the page element, you should notice data-drag-edge or dragEdge option value
* because default value, '1', is whole area of handler element.
*
* ## HTML Examples
*
* @example
* <div id="drawerPage" class="ui-page">
* <header id="contentHeader" class="ui-header">
* <h2 class="ui-title">Drawer</h2>
* </header>
* <div id = "content" class="ui-content">
* Drawer
* </div>
*
* <!-- Drawer Handler -->
* <a id="drawerHandler" href="#Drawer" class="drawer-handler">Drawer Button</a>
* <!-- Drawer Widget -->
* <div id="drawer" class="ui-drawer" data-drawer-target="#drawerPage" data-position="left" data-enable="true" data-drag-edge="1">
* <header class="ui-header">
* <h2 class="ui-title">Left Drawer</h2>
* </header>
* <div class="ui-content">
* <p>CONTENT</p>
* </div>
* </div>
* </div>
*
* ## Manual constructor
*
* @example
* (function() {
* var handler = document.getElementById("drawerHandler"),
* page = document.getElementById("drawerPage"),
* drawerElement = document.querySelector(handler.getAttribute("href")),
* drawer = tau.widget.Drawer(drawerElement);
*
* page.addEventListener( "pagebeforeshow", function() {
* drawer.setDragHandler(handler);
* tau.event.on(handler, "mousedown touchstart", function(e) {
* switch (e.type) {
* case "touchstart":
* case "mousedown":
* // open drawer
* drawer.transition(60);
* }
* }, false);
* })();
*
* ##Drawer state
* Drawer has four state type.
* - "closed" - Drawer closed state.
* - "opened" - Drawer opened state.
* - "sliding" - Drawer is sliding state. This state does not mean that will operate open or close.
* - "settling" - drawer is settling state. 'Settle' means open or close status. So, this state means that drawer is animating for opened or closed state.
*
* ##Drawer positioning
* You can declare to drawer position manually. (Default is left)
*
* If you implement data-position attributes value is 'left', drawer appear from left side.
*
* @example
* <div class="ui-drawer" data-position="left" id="leftDrawer">
*
* - "left" - drawer appear from left side
* - "right" - drawer appear from right side
*
* ##Drawer targeting
* You can declare to drawer target manually. (Default is Page)
*
* If you implement data-drawer-target attribute value at CSS selector type, drawer widget will be appended to target.
*
* @example
* <div class="ui-drawer" data-drawer-target="#drawerPage">
*
* ##Drawer enable
* You can declare for whether drawer gesture used or not. (Default is true)
*
* If you implement data-enable attribute value is 'true', you can use the drawer widget.
* This option can be changed by 'enable' or 'disable' method.
*
* @example
* <div class="ui-drawer" data-enable="true">
*
* ##Drawer drag gesture start point
* You can declare to drag gesture start point. (Default is 1)
*
* If you implement data-drag-edge attribute value is '0.5', you can drag gesture start in target width * 0.5 width area.
*
* @example
* <div class="ui-drawer" data-drag-edge="1">
*
* @since 2.3
* @class ns.widget.wearable.Drawer
* @component-selector .ui-drawer
* @component-type standalone-component
* @extends ns.widget.core.Drawer
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (document, ns) {
"use strict";
var CoreDrawer = ns.widget.core.Drawer,
engine = ns.engine,
Drawer = function () {
var self = this;
CoreDrawer.call(self);
},
prototype = new CoreDrawer();
Drawer.prototype = prototype;
/**
* Configure Drawer widget
* @method _configure
* @protected
* @member ns.widget.wearable.Drawer
*/
prototype._configure = function () {
var self = this;
/**
* Widget options
* @property {number} [options.width=0] If you set width is 0, drawer width will set as the css style.
*/
self.options.width = 0;
};
/**
* Set Drawer drag handler.
* If developer use handler, drag event is bound at handler only.
*
* #####Running example in pure JavaScript:
*
* @example
* <!-- Drawer Handlers -->
* <a id="leftDrawerHandler" href="#leftDrawer" class="drawer-handler">Left Handler</a>
*
* <div id="leftDrawer" class="ui-drawer" data-drawer-target="#drawerSinglePage" data-position="left" data-enable="true" data-drag-edge="1">
* <header class="ui-header">
* <h2 class="ui-title">Left Drawer</h2>
* </header>
* <div id="leftClose" class="ui-content">
* <p>Click Close</p>
* </div>
* </div>
*
* <script>
* var handler = document.getElementById("leftDrawerHandler"),
* drawer = tau.widget.Drawer(document.querySelector(handler.getAttribute("href"));
*
* drawer.setDragHandler(handler);
* </script>
*
* @method setDragHandler
* @public
* @param {Element} element
* @member ns.widget.wearable.Drawer
*/
/**
* Transition Drawer widget.
* This method use only positive integer number.
*
* #####Running example in pure JavaScript:
*
* @example
* <!-- Drawer Handlers -->
* <a id="leftDrawerHandler" href="#leftDrawer" class="drawer-handler">Left Handler</a>
*
* <div id="leftDrawer" class="ui-drawer" data-drawer-target="#drawerSinglePage" data-position="left" data-enable="true" data-drag-edge="1">
* <header class="ui-header">
* <h2 class="ui-title">Left Drawer</h2>
* </header>
* <div id="leftClose" class="ui-content">
* <p>Click Close</p>
* </div>
* </div>
*
* <script>
* var handler = document.getElementById("leftDrawerHandler"),
* drawer = tau.widget.Drawer(document.querySelector(handler.getAttribute("href"));
*
* drawer.Transition(60);
* </script>
*
* @method transition
* @public
* @param {Integer} position
* @member ns.widget.wearable.Drawer
*/
/**
* Open Drawer widget.
*
* #####Running example in pure JavaScript:
*
* @example
* <!-- Drawer Handlers -->
* <a id="leftDrawerHandler" href="#leftDrawer" class="drawer-handler">Left Handler</a>
*
* <div id="leftDrawer" class="ui-drawer" data-drawer-target="#drawerSinglePage" data-position="left" data-enable="true" data-drag-edge="1">
* <header class="ui-header">
* <h2 class="ui-title">Left Drawer</h2>
* </header>
* <div id="leftClose" class="ui-content">
* <p>Click Close</p>
* </div>
* </div>
*
* <script>
* var handler = document.getElementById("leftDrawerHandler"),
* drawer = tau.widget.Drawer(document.querySelector(handler.getAttribute("href"));
*
* drawer.open();
* </script>
*
* @method open
* @public
* @member ns.widget.wearable.Drawer
*/
/**
* Close Drawer widget.
*
* @example
* <!-- Drawer Handlers -->
* <a id="leftDrawerHandler" href="#leftDrawer" class="drawer-handler">Left Handler</a>
*
* <div id="leftDrawer" class="ui-drawer" data-drawer-target="#drawerSinglePage" data-position="left" data-enable="true" data-drag-edge="1">
* <header class="ui-header">
* <h2 class="ui-title">Left Drawer</h2>
* </header>
* <div id="leftClose" class="ui-content">
* <p>Click Close</p>
* </div>
* </div>
*
* <script>
* var handler = document.getElementById("leftDrawerHandler"),
* drawer = tau.widget.Drawer(document.querySelector(handler.getAttribute("href"));
*
* drawer.close();
* </script>
*
* @method close
* @public
* @member ns.widget.wearable.Drawer
*/
/**
* Refresh Drawer widget.
* @method refresh
* @protected
* @member ns.widget.wearable.Drawer
*/
/**
* Get state of Drawer widget.
*
* @example
* <!-- Drawer Handlers -->
* <a id="leftDrawerHandler" href="#leftDrawer" class="drawer-handler">Left Handler</a>
*
* <div id="leftDrawer" class="ui-drawer" data-drawer-target="#drawerSinglePage" data-position="left" data-enable="true" data-drag-edge="1">
* <header class="ui-header">
* <h2 class="ui-title">Left Drawer</h2>
* </header>
* <div id="leftClose" class="ui-content">
* <p>Click Close</p>
* </div>
* </div>
*
* <script>
* var handler = document.getElementById("leftDrawerHandler"),
* drawer = tau.widget.Drawer(document.querySelector(handler.getAttribute("href")),
* state;
*
* state = drawer.getState();
* </script>
* @method getState
* @return {string} Drawer state {"closed"|"opened"|"sliding"|"settling"}
* @public
* @member ns.widget.wearable.Drawer
*/
ns.widget.wearable.Drawer = Drawer;
engine.defineWidget(
"Drawer",
".ui-drawer",
[
"transition",
"setDragHandler",
"open",
"close",
"isOpen",
"getState"
],
Drawer,
"wearable"
);
}(window.document, ns));
/*global ns, window, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Gesture.Manager class
* Main class controls all gestures.
* @class ns.event.gesture.Manager
*/
(function (ns, window, document) {
"use strict";
/**
* Local alias for {@link ns.event.gesture}
* @property {Object}
* @member ns.event.gesture.Manager
* @private
* @static
*/
var gesture = ns.event.gesture,
gestureUtils = gesture.utils,
utilObject = ns.util.object,
instance = null,
touchCheck = /touch/,
Manager = function () {
var self = this;
self.instances = [];
self.gestureDetectors = [];
self.runningDetectors = [];
self.detectorRequestedBlock = null;
self.unregisterBlockList = [];
self.gestureEvents = {};
self.velocity = null;
self._isReadyDetecting = false;
self._blockMouseEvent = false;
self.touchSupport = "ontouchstart" in window;
};
function sortInstances(a, b) {
if (a.index < b.index) {
return -1;
} else if (a.index > b.index) {
return 1;
}
return 0;
}
Manager.prototype = {
/**
* Bind start events
* @method _bindStartEvents
* @param {ns.event.gesture.Instance} _instance gesture instance
* @member ns.event.gesture.Manager
* @protected
*/
_bindStartEvents: function (_instance) {
var element = _instance.getElement();
if (this.touchSupport) {
element.addEventListener("touchstart", this, false);
} else {
element.addEventListener("mousedown", this, false);
}
},
/**
* Bind move, end and cancel events
* @method _bindEvents
* @member ns.event.gesture.Manager
* @protected
*/
_bindEvents: function () {
var self = this;
if (self.touchSupport) {
document.addEventListener("touchmove", self);
document.addEventListener("touchend", self);
document.addEventListener("touchcancel", self);
} else {
document.addEventListener("mousemove", self);
document.addEventListener("mouseup", self);
}
},
/**
* Unbind start events
* @method _unbindStartEvents
* @param {ns.event.gesture.Instance} _instance gesture instance
* @member ns.event.gesture.Manager
* @protected
*/
_unbindStartEvents: function (_instance) {
var element = _instance.getElement();
if (this.touchSupport) {
element.removeEventListener("touchstart", this, false);
} else {
element.removeEventListener("mousedown", this, false);
}
},
/**
* Unbind move, end and cancel events
* @method _bindEvents
* @member ns.event.gesture.Manager
* @protected
*/
_unbindEvents: function () {
var self = this;
if (self.touchSupport) {
document.removeEventListener("touchmove", self, false);
document.removeEventListener("touchend", self, false);
document.removeEventListener("touchcancel", self, false);
} else {
document.removeEventListener("mousemove", self, false);
document.removeEventListener("mouseup", self, false);
}
},
/**
* Detect that event should be processed by handleEvent
* @param {Event} event Input event object
* @return {null|string}
* @member ns.event.gesture.Manager
* @protected
*/
_detectEventType: function (event) {
var eventType = event.type;
if (eventType.match(touchCheck)) {
this._blockMouseEvent = true;
} else {
if (this._blockMouseEvent || event.which !== 1) {
return null;
}
}
return eventType;
},
/**
* Handle event
* @method handleEvent
* @param {Event} event
* @member ns.event.gesture.Manager
* @protected
*/
handleEvent: function (event) {
var self = this,
eventType = self._detectEventType(event);
switch (eventType) {
case "mousedown":
case "touchstart":
self._start(event);
break;
case "mousemove":
case "touchmove":
self._move(event);
break;
case "mouseup":
case "touchend":
self._end(event);
break;
case "touchcancel":
self._cancel(event);
break;
}
},
/**
* Handler for gesture start
* @method _start
* @param {Event} event
* @member ns.event.gesture.Manager
* @protected
*/
_start: function (event) {
var self = this,
element = event.currentTarget,
startEvent = {},
detectors = [];
if (!self._isReadyDetecting) {
self._resetDetecting();
self._bindEvents();
startEvent = self._createDefaultEventData(gesture.Event.START, event);
self.gestureEvents = {
start: startEvent,
last: startEvent
};
self.velocity = {
event: startEvent,
x: 0,
y: 0
};
startEvent = utilObject.fastMerge(startEvent,
self._createGestureEvent(gesture.Event.START, event));
self._isReadyDetecting = true;
}
self.instances.forEach(function (_instance) {
if (_instance.getElement() === element) {
detectors = detectors.concat(_instance.getGestureDetectors());
}
}, self);
detectors.sort(sortInstances);
self.gestureDetectors = self.gestureDetectors.concat(detectors);
self._detect(detectors, startEvent);
},
/**
* Handler for gesture move
* @method _move
* @param {Event} event
* @member ns.event.gesture.Manager
* @protected
*/
_move: function (event) {
var newEvent,
self = this;
if (self._isReadyDetecting) {
newEvent = self._createGestureEvent(gesture.Event.MOVE, event);
self._detect(self.gestureDetectors, newEvent);
self.gestureEvents.last = newEvent;
}
},
/**
* Handler for gesture end
* @method _end
* @param {Event} event
* @member ns.event.gesture.Manager
* @protected
*/
_end: function (event) {
var self = this,
newEvent = utilObject.merge(
{},
self.gestureEvents.last,
self._createDefaultEventData(gesture.Event.END, event)
);
if (newEvent.pointers.length === 0) {
self._detect(self.gestureDetectors, newEvent);
self.unregisterBlockList.forEach(function (_instance) {
this.unregister(_instance);
}, self);
self._resetDetecting();
self._blockMouseEvent = false;
}
},
/**
* Handler for gesture cancel
* @method _cancel
* @param {Event} event
* @member ns.event.gesture.Manager
* @protected
*/
_cancel: function (event) {
var self = this;
event = utilObject.merge(
{},
self.gestureEvents.last,
self._createDefaultEventData(gesture.Event.CANCEL, event)
);
self._detect(self.gestureDetectors, event);
self.unregisterBlockList.forEach(function (_instance) {
this.unregister(_instance);
}, self);
self._resetDetecting();
self._blockMouseEvent = false;
},
/**
* Detect gesture
* @method _detect
* @param {Array} detectors
* @param {Event} event
* @member ns.event.gesture.Manager
* @protected
*/
_detect: function (detectors, event) {
var self = this,
finishedDetectors = [];
detectors.forEach(function (detector) {
var result;
if (!self.detectorRequestedBlock) {
result = detector.detect(event);
if ((result & gesture.Result.RUNNING) &&
self.runningDetectors.indexOf(detector) < 0) {
self.runningDetectors.push(detector);
}
if (result & gesture.Result.FINISHED) {
finishedDetectors.push(detector);
}
if (result & gesture.Result.BLOCK) {
self.detectorRequestedBlock = detector;
}
}
});
// remove finished detectors.
finishedDetectors.forEach(function (detector) {
var idx = self.gestureDetectors.indexOf(detector);
if (idx > -1) {
self.gestureDetectors.splice(idx, 1);
}
idx = self.runningDetectors.indexOf(detector);
if (idx > -1) {
self.runningDetectors.splice(idx, 1);
}
});
// remove all detectors except the detector that return block result
if (self.detectorRequestedBlock) {
// send to cancel event.
self.runningDetectors.forEach(function (detector) {
var cancelEvent = utilObject.fastMerge({}, event);
cancelEvent.eventType = gesture.Event.BLOCKED;
detector.detect(cancelEvent);
});
self.runningDetectors.length = 0;
self.gestureDetectors.length = 0;
if (finishedDetectors.indexOf(self.detectorRequestedBlock) < 0) {
self.gestureDetectors.push(self.detectorRequestedBlock);
}
}
},
/**
* Reset of gesture manager detector
* @method _resetDetecting
* @member ns.event.gesture.Manager
* @protected
*/
_resetDetecting: function () {
var self = this;
self._isReadyDetecting = false;
self.gestureDetectors.length = 0;
self.runningDetectors.length = 0;
self.detectorRequestedBlock = null;
self.gestureEvents = {};
self.velocity = null;
self._unbindEvents();
},
/**
* Create default event data
* @method _createDefaultEventData
* @param {string} type event type
* @param {Event} event source event
* @return {Object} default event data
* @return {string} return.eventType
* @return {number} return.timeStamp
* @return {Touch} return.pointer
* @return {TouchList} return.pointers
* @return {Event} return.srcEvent
* @return {Function} return.preventDefault
* @return {Function} return.stopPropagation
* @member ns.event.gesture.Manager
* @protected
*/
_createDefaultEventData: function (type, event) {
var pointers = event.touches;
if (!pointers) {
if (event.type === "mouseup") {
pointers = [];
} else {
event.identifier = 1;
pointers = [event];
}
}
return {
eventType: type,
timeStamp: Date.now(),
pointer: pointers[0],
pointers: pointers,
srcEvent: event,
preventDefault: event.preventDefault.bind(event),
stopPropagation: event.stopPropagation.bind(event)
};
},
/**
* Create gesture event
* @method _createGestureEvent
* @param {string} type event type
* @param {Event} event source event
* @return {Object} gesture event consist from Event class and additional properties
* @return {number} return.deltaTime
* @return {number} return.deltaX
* @return {number} return.deltaY
* @return {number} return.velocityX
* @return {number} return.velocityY
* @return {number} return.estimatedX
* @return {number} return.estimatedY
* @return {number} return.estimatedDeltaX
* @return {number} return.estimatedDeltaY
* @return {number} return.distance
* @return {number} return.angle
* @return {number} return.direction
* @return {number} return.scale
* @return {number} return.rotation (deg)
* @return {Event} return.startEvent
* @return {Event} return.lastEvent
* @member ns.event.gesture.Manager
* @protected
*/
_createGestureEvent: function (type, event) {
var self = this,
defaultEvent = self._createDefaultEventData(type, event),
startEvent = self.gestureEvents.start,
lastEvent = self.gestureEvents.last,
velocity = self.velocity,
velocityEvent = velocity.event,
delta = {
time: defaultEvent.timeStamp - startEvent.timeStamp,
x: defaultEvent.pointer.clientX - startEvent.pointer.clientX,
y: defaultEvent.pointer.clientY - startEvent.pointer.clientY
},
deltaFromLast = {
x: defaultEvent.pointer.clientX - lastEvent.pointer.clientX,
y: defaultEvent.pointer.clientY - lastEvent.pointer.clientY
},
/* pause time threshold.util. tune the number to up if it is slow */
timeDifference = gesture.defaults.estimatedPointerTimeDifference,
estimated;
// reset start event for multi touch
if (startEvent && defaultEvent.pointers.length !== startEvent.pointers.length) {
startEvent.pointers = Array.prototype.slice.call(defaultEvent.pointers);
}
if (defaultEvent.timeStamp - velocityEvent.timeStamp >
gesture.defaults.updateVelocityInterval) {
utilObject.fastMerge(velocity, gestureUtils.getVelocity(
defaultEvent.timeStamp - velocityEvent.timeStamp,
defaultEvent.pointer.clientX - velocityEvent.pointer.clientX,
defaultEvent.pointer.clientY - velocityEvent.pointer.clientY
));
velocity.event = defaultEvent;
}
estimated = {
x: Math.round(defaultEvent.pointer.clientX +
(timeDifference * velocity.x * (deltaFromLast.x < 0 ? -1 : 1))),
y: Math.round(defaultEvent.pointer.clientY +
(timeDifference * velocity.y * (deltaFromLast.y < 0 ? -1 : 1)))
};
// Prevent that point goes back even though direction is not changed.
if ((deltaFromLast.x < 0 && estimated.x > lastEvent.estimatedX) ||
(deltaFromLast.x > 0 && estimated.x < lastEvent.estimatedX)) {
estimated.x = lastEvent.estimatedX;
}
if ((deltaFromLast.y < 0 && estimated.y > lastEvent.estimatedY) ||
(deltaFromLast.y > 0 && estimated.y < lastEvent.estimatedY)) {
estimated.y = lastEvent.estimatedY;
}
utilObject.fastMerge(defaultEvent, {
deltaTime: delta.time,
deltaX: delta.x,
deltaY: delta.y,
velocityX: velocity.x,
velocityY: velocity.y,
estimatedX: estimated.x,
estimatedY: estimated.y,
estimatedDeltaX: estimated.x - startEvent.pointer.clientX,
estimatedDeltaY: estimated.y - startEvent.pointer.clientY,
distance: gestureUtils.getDistance(startEvent.pointer, defaultEvent.pointer),
angle: gestureUtils.getAngle(startEvent.pointer, defaultEvent.pointer),
direction: gestureUtils.getDirection(startEvent.pointer, defaultEvent.pointer),
scale: gestureUtils.getScale(startEvent.pointers, defaultEvent.pointers),
rotation: gestureUtils.getRotation(startEvent.pointers, defaultEvent.pointers),
startEvent: startEvent,
lastEvent: lastEvent
});
return defaultEvent;
},
/**
* Register instance of gesture
* @method register
* @param {ns.event.gesture.Instance} instance gesture instance
* @member ns.event.gesture.Manager
*/
register: function (instance) {
var self = this,
idx = self.instances.indexOf(instance);
if (idx < 0) {
self.instances.push(instance);
self._bindStartEvents(instance);
}
},
/**
* Unregister instance of gesture
* @method unregister
* @param {ns.event.gesture.Instance} instance gesture instance
* @member ns.event.gesture.Manager
*/
unregister: function (instance) {
var idx,
self = this;
if (self.gestureDetectors.length) {
self.unregisterBlockList.push(instance);
} else {
idx = self.instances.indexOf(instance);
if (idx > -1) {
self.instances.splice(idx, 1);
self._unbindStartEvents(instance);
}
if (!self.instances.length) {
self._destroy();
}
}
},
/**
* Destroy instance of Manager
* @method _destroy
* @member ns.event.gesture.Manager
* @protected
*/
_destroy: function () {
var self = this;
self._resetDetecting();
self.instances.length = 0;
self.unregisterBlockList.length = 0;
self._blockMouseEvent = false;
instance = null;
}
};
Manager.getInstance = function () {
if (!instance) {
instance = new Manager();
}
return instance;
};
gesture.Manager = Manager;
}(ns, window, window.document));
/*global ns, window, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
(function (ns) {
"use strict";
/**
* Local alias for {@link ns.event.gesture}
* @property {Object}
* @member ns.event.gesture.Instance
* @private
* @static
*/
var gesture = ns.event.gesture,
/**
* Local alias for {@link ns.event.gesture.Detector}
* @property {Object}
* @member ns.event.gesture.Instance
* @private
* @static
*/
Detector = gesture.Detector,
/**
* Local alias for {@link ns.event.gesture.Manager}
* @property {Object}
* @member ns.event.gesture.Instance
* @private
* @static
*/
Manager = gesture.Manager,
/**
* Local alias for {@link ns.event}
* @property {Object}
* @member ns.event.gesture.Instance
* @private
* @static
*/
events = ns.event,
/**
* Alias for method {@link ns.util.object.merge}
* @property {Function} merge
* @member ns.event.gesture.Instance
* @private
* @static
*/
merge = ns.util.object.merge,
/**
* #Gesture.Instance class
* Creates instance of gesture manager on element.
* @param {HTMLElement} element
* @param {Object} options
* @class ns.event.gesture.Instance
*/
Instance = function (element, options) {
this.element = element;
this.eventDetectors = [];
this.options = merge({}, gesture.defaults, options);
this.gestureManager = Manager.getInstance();
this.eventSender = merge({}, Detector.Sender, {
sendEvent: this.trigger.bind(this)
});
};
Instance.prototype = {
/**
* Set options
* @method setOptions
* @param {Object} options options
* @return {ns.event.gesture.Instance}
* @member ns.event.gesture.Instance
*/
setOptions: function (options) {
merge(this.options, options);
return this;
},
/**
* Add detector
* @method addDetector
* @param {Object} detectorStrategy strategy
* @return {ns.event.gesture.Instance}
* @member ns.event.gesture.Instance
*/
addDetector: function (detectorStrategy) {
var detector = new Detector(detectorStrategy, this.eventSender),
alreadyHasDetector = !!this.eventDetectors.length;
this.eventDetectors.push(detector);
if (!!this.eventDetectors.length && !alreadyHasDetector) {
this.gestureManager.register(this);
}
return this;
},
/**
* Remove detector
* @method removeDetector
* @param {Object} detectorStrategy strategy
* @return {ns.event.gesture.Instance}
* @member ns.event.gesture.Instance
*/
removeDetector: function (detectorStrategy) {
var idx = this.eventDetectors.indexOf(detectorStrategy);
if (idx > -1) {
this.eventDetectors.splice(idx, 1);
}
if (!this.eventDetectors.length) {
this.gestureManager.unregister(this);
}
return this;
},
/**
* Triggers the gesture event
* @method trigger
* @param {string} gestureName gestureName name
* @param {Object} eventInfo data provided to event object
* @member ns.event.gesture.Instance
*/
trigger: function (gestureName, eventInfo) {
return events.trigger(this.element, gestureName, eventInfo, false);
},
/**
* Get HTML element assigned to gesture event instance
* @method getElement
* @member ns.event.gesture.Instance
*/
getElement: function () {
return this.element;
},
/**
* Get gesture event detectors assigned to instance
* @method getGestureDetectors
* @member ns.event.gesture.Instance
*/
getGestureDetectors: function () {
return this.eventDetectors;
},
/**
* Destroy instance
* @method destroy
* @member ns.event.gesture.Instance
*/
destroy: function () {
this.element = null;
this.eventHandlers = {};
this.gestureManager = null;
this.eventSender = null;
this.eventDetectors.length = 0;
}
};
gesture.Instance = Instance;
}(ns));
/*global window, define, ns */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Slider
* Slider component changes the range-type browser input to sliders.
*
* ##Default selectors
* In default all **INPUT** tags with type equals _range_ and _data-role=slider_ are changed to TAU sliders.
*
* ###HTML Examples
*
* @example
* <input type="range" name="slider-1" id="slider" value="60" min="0" max="100">
*
* ###Manual constructor
* For manual creation of slider widget you can use constructor of widget
*
* @example
* <input id="slider">
* <script>
* var sliderElement = document.getElementById("slider"),
* slider;
*
* slider = tau.widget.Slider(sliderElement);
*
* // You can make slider component for TizenSlider component name,
* // for example, tau.widget.TizenSlider(sliderElement).
* // But, TizenSlider component name will be deprecated since tizen 2.4
* // because we don't recommend this method.
* </script>
*
* @since 2.0
* @class ns.widget.core.Slider
* @extends ns.widget.BaseWidget
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (document, ns) {
"use strict";
/**
* @property {Object} Widget Alias for {@link ns.widget.BaseWidget}
* @member ns.widget.core.Drawer
* @private
* @static
*/
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
selectors = ns.util.selectors,
utilDOM = ns.util.DOM,
events = ns.event,
Gesture = ns.event.gesture,
COLORS = {
BACKGROUND: "rgba(145, 145, 145, 0.7)",
ACTIVE: "rgba(61, 185, 204, 1)",
WARNING_BG: "rgba(201, 133, 133, 1)",
WARNING: "rgba(255, 25, 25, 1)"
},
DEFAULT = {
HORIZONTAL: "horizontal"
},
Slider = function () {
var self = this;
/**
* Widget options
* @property {boolean} [options.type="normal"] Slider type. 'normal', 'center' or 'circle'
* @property {string} [options.orientation="horizontal"] Slider orientation. horizontal or vertical
* @property {boolean} [options.expand=false] Slider expand mode. true or false
**/
self.options = {
type: "normal",
orientation: DEFAULT.HORIZONTAL,
expand: false,
warning: false,
warningLevel: 0,
disabled: false
};
self._ui = {};
},
classes = {
SLIDER: "ui-slider",
SLIDER_HORIZONTAL: "ui-slider-horizontal",
SLIDER_VERTICAL: "ui-slider-vertical",
SLIDER_VALUE: "ui-slider-value",
SLIDER_HANDLER: "ui-slider-handler",
SLIDER_HANDLER_EXPAND: "ui-slider-handler-expand",
SLIDER_CENTER: "ui-slider-center",
SLIDER_HANDLER_ACTIVE: "ui-slider-handler-active",
SLIDER_WARNING: "ui-slider-warning",
SLIDER_DISABLED: "ui-disabled",
SLIDER_HANDLER_VALUE: "ui-slider-handler-value",
SLIDER_HANDLER_SMALL: "ui-slider-handler-small"
},
prototype = new BaseWidget();
Slider.prototype = prototype;
Slider.classes = classes;
/**
* Bind events
* @method bindEvents
* @param {Object} self
* @member ns.widget.core.Slider
* @private
* @static
*/
function bindEvents(self) {
var element = self._ui.barElement;
events.enableGesture(
element,
new Gesture.Drag({
orientation: self.options.orientation,
threshold: 0
})
);
events.on(element, "dragstart drag dragend dragcancel", self, false);
}
/**
* unBind events
* @method unbindEvents
* @param {Object} self
* @member ns.widget.core.Slider
* @private
* @static
*/
function unbindEvents(self) {
var element = self._ui.barElement;
events.disableGesture(element);
events.off(element, "dragstart drag dragend dragcancel", self, false);
}
/**
* Build structure of Slider component
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement} Returns built element
* @member ns.widget.core.Slider
* @protected
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
barElement = document.createElement("div"),
valueElement = document.createElement("div"),
handlerElement = document.createElement("div");
element.style.display = "none";
barElement.classList.add(classes.SLIDER);
valueElement.classList.add(classes.SLIDER_VALUE);
barElement.appendChild(valueElement);
handlerElement.classList.add(classes.SLIDER_HANDLER);
barElement.appendChild(handlerElement);
element.parentNode.appendChild(barElement);
ui.valueElement = valueElement;
ui.handlerElement = handlerElement;
ui.barElement = barElement;
return element;
};
/**
* init Slider component
* @method _init
* @param {HTMLElement} element
* @return {HTMLElement} Returns built element
* @member ns.widget.core.Slider
* @protected
*/
prototype._init = function (element) {
var self = this,
attrMin = parseFloat(element.getAttribute("min")),
attrMax = parseFloat(element.getAttribute("max")),
attrValue = parseFloat(element.getAttribute("value"));
self._min = attrMin ? attrMin : 0;
self._max = attrMax ? attrMax : 100;
self._minValue = self._min;
self._maxValue = self._max;
self._value = attrValue ? attrValue : parseFloat(self.element.value);
self._interval = self._max - self._min;
self._previousValue = self._value;
self._warningLevel = parseInt(self.options.warningLevel, 10);
self._setDisabled(element);
self._initLayout();
return element;
};
/**
* init layout of Slider component
* @method _initLayout
* @member ns.widget.core.Slider
* @protected
*/
prototype._initLayout = function () {
var self = this,
options = self.options,
ui = self._ui,
barElement = ui.barElement,
handlerElement = ui.handlerElement;
if (options.orientation === DEFAULT.HORIZONTAL) {
barElement.classList.remove(classes.SLIDER_VERTICAL);
barElement.classList.add(classes.SLIDER_HORIZONTAL);
} else {
barElement.classList.remove(classes.SLIDER_HORIZONTAL);
barElement.classList.add(classes.SLIDER_VERTICAL);
}
options.type === "center" ? barElement.classList.add(classes.SLIDER_CENTER) : barElement.classList.remove(classes.SLIDER_CENTER);
options.expand ? handlerElement.classList.add(classes.SLIDER_HANDLER_EXPAND) : handlerElement.classList.remove(classes.SLIDER_HANDLER_EXPAND);
self._barElementWidth = ui.barElement.offsetWidth;
if (self.options.orientation !== DEFAULT.HORIZONTAL) {
self._barElementHeight = ui.barElement.offsetHeight;
}
self._setValue(self._value);
self._setSliderColors(self._value);
};
/**
* Set value of Slider center mode
* @method _setCenterValue
* @param {number} value
* @member ns.widget.core.Slider
* @protected
*/
prototype._setCenterValue = function (value) {
var self = this,
ui = self._ui,
validValue,
valueElementValidStyle,
barElementLength,
center,
validStyle,
inValidStyle;
if (self.options.orientation === DEFAULT.HORIZONTAL) {
barElementLength = self._barElementWidth;
center = barElementLength / 2;
validValue = barElementLength * (value - self._min) / self._interval;
validStyle = validValue < center ? "right" : "left";
inValidStyle = validValue < center ? "left" : "right";
valueElementValidStyle = "width";
ui.handlerElement.style["left"] = validValue + "px";
} else {
barElementLength = self._barElementHeight;
center = barElementLength / 2;
validValue = barElementLength * (value - self._min) / self._interval;
validStyle = validValue < center ? "top" : "bottom";
inValidStyle = validValue < center ? "bottom" : "top";
valueElementValidStyle = "height";
ui.handlerElement.style["top"] = (barElementLength - validValue) + "px";
}
ui.valueElement.style[validStyle] = "50%";
ui.valueElement.style[inValidStyle] = "initial";
ui.valueElement.style[valueElementValidStyle] = Math.abs(center - validValue) + "px";
};
/**
* Set value of Slider normal mode
* @method _setNormalValue
* @param {number} value
* @member ns.widget.core.Slider
* @protected
*/
prototype._setNormalValue = function (value) {
var self = this,
ui = self._ui,
options = self.options,
barElementLength,
validValue;
if (options.orientation === DEFAULT.HORIZONTAL) {
barElementLength = self._barElementWidth;
validValue = barElementLength * (value - self._min) / self._interval;
ui.valueElement.style["width"] = validValue + "px";
ui.handlerElement.style["left"] = validValue + "px";
} else {
barElementLength = self._barElementHeight;
validValue = barElementLength * (value - self._min) / self._interval;
ui.valueElement.style["height"] = validValue + "px";
ui.handlerElement.style["top"] = (barElementLength - validValue) + "px";
}
};
/**
* Set value of Slider
* @method _setValue
* @param {number} value
* @member ns.widget.core.Slider
* @protected
*/
prototype._setValue = function (value) {
var self = this,
ui = self._ui,
options = self.options,
element = self.element,
floatValue,
expendedClasses;
self._previousValue = self.element.value;
if (value < self._min) {
value = self._min;
} else if (value > self._max) {
value = self._max;
}
floatValue = parseFloat(value);
if (options.type === "center") {
self._setCenterValue(value);
} else if (options.type === "normal") {
self._setNormalValue(value);
}
self._setHandlerStyle(value);
self._updateSliderColors(value);
if (self.options.expand) {
expendedClasses = classes.SLIDER_HANDLER_VALUE;
if (floatValue > 99 || floatValue < -10) {
expendedClasses += " " + classes.SLIDER_HANDLER_SMALL;
}
ui.handlerElement.innerHTML = "<span class=" + expendedClasses + ">" + floatValue + "</span>";
}
if (element.value - 0 !== floatValue) {
element.setAttribute("value", floatValue);
element.value = floatValue;
self._value = floatValue;
events.trigger(element, "input");
}
};
/**
* Set background as a gradient
* @param {HTMLElement} element
* @param {string} orientation
* @param {string} reverseOrientation
* @param {string} color1
* @param {string} level1
* @param {string} color2
* @param {string} level2
* @param {string} currentValue This param is added only because gradients do not work in proper way on Tizen
* @private
*/
function setBackground(element, orientation, reverseOrientation, color1, level1, color2, level2, currentValue) {
// gradients on Tizen do not work in proper way, so this condition is workaround
// if gradients work properly, this should be removed!
if (parseFloat(currentValue) > parseFloat(level1)) {
element.style.background = "-webkit-linear-gradient(" + reverseOrientation + "," +
color1 + " " + level1 + ", " + color2 + " " + level2 + ")";
} else {
element.style.background = color1;
}
}
/**
* Set warning level for slider
* @param {number} value
* @member ns.widget.core.Slider
* @protected
*/
prototype._setSliderColors = function (value) {
var self = this,
ui = self._ui,
barElement = ui.barElement,
sliderValueElement = ui.valueElement,
orientation,
reverseOrientation,
barLength,
warningLevel,
level;
if (self.options.type === "normal" && self.options.warning && value >= self._min && value <= self._max) {
if (self.options.orientation === DEFAULT.HORIZONTAL) {
orientation = "right";
reverseOrientation = "left";
barLength = self._barElementWidth;
} else {
orientation = "top";
reverseOrientation = "bottom";
barLength = self._barElementHeight;
}
warningLevel = barLength * self._warningLevel / (self._max - self._min) + "px";
level = barLength * value / (self._max - self._min) + "px";
// set background for value bar and slider bar
setBackground(sliderValueElement, orientation, reverseOrientation, COLORS.ACTIVE, warningLevel, COLORS.WARNING, warningLevel, level);
setBackground(barElement, orientation, reverseOrientation, COLORS.BACKGROUND, warningLevel, COLORS.WARNING_BG, warningLevel,
parseInt(warningLevel, 10) + 2);
} else {
// gradients on Tizen do not work in proper way, so this is workaround
// if gradients work properly, this should be removed!
sliderValueElement.style.background = COLORS.ACTIVE;
barElement.style.background = COLORS.BACKGROUND;
}
};
// gradients on Tizen do not work in proper way, so this is workaround
// if gradients work properly, this should be removed!
prototype._updateSliderColors = function (value) {
this._setSliderColors(value);
};
/**
* Set style for handler
* @param {number} value
* @member ns.widget.core.Slider
* @protected
*/
prototype._setHandlerStyle = function (value) {
var self = this;
if (self.options.warning) {
if (value >= self._warningLevel) {
self._ui.handlerElement.classList.add(classes.SLIDER_WARNING);
} else {
self._ui.handlerElement.classList.remove(classes.SLIDER_WARNING);
}
}
};
prototype._setDisabled = function (element) {
var self = this,
options = self.options;
if (options.disabled === true || element.disabled) {
self._disable(element);
} else {
self._enable(element);
}
};
prototype._enable = function (element) {
if (element) {
this.options.disabled = false;
if (this._ui.barElement) {
this._ui.barElement.classList.remove(classes.SLIDER_DISABLED);
}
}
};
prototype._disable = function (element) {
if (element) {
this.options.disabled = true;
if (this._ui.barElement) {
this._ui.barElement.classList.add(classes.SLIDER_DISABLED);
}
}
};
/**
* Bind events to Slider
* @method _bindEvents
* @member ns.widget.core.Slider
* @protected
*/
prototype._bindEvents = function () {
bindEvents(this);
};
/**
* Bind event handlers
* @method handleEvent
* @param {Event} event
* @member ns.widget.core.Slider
* @protected
*/
prototype.handleEvent = function (event) {
var self = this;
if (!this.options.disabled) {
switch (event.type) {
case "dragstart":
self._onDragstart(event);
break;
case "dragend":
case "dragcancel":
self._onDragend(event);
break;
case "drag":
self._onDrag(event);
break;
}
}
};
/**
* Drag event handler
* @method _onDrag
* @param {Event} event
* @member ns.widget.core.Slider
* @protected
*/
prototype._onDrag = function (event) {
var self = this,
ui = self._ui,
validPosition,
value;
if (self._active) {
validPosition = self.options.orientation === DEFAULT.HORIZONTAL ?
event.detail.estimatedX - ui.barElement.offsetLeft :
self._barElementHeight -
(event.detail.estimatedY - utilDOM.getElementOffset(ui.barElement).top + selectors.getScrollableParent(self.element).scrollTop),
value = self.options.orientation === DEFAULT.HORIZONTAL ?
self._interval * validPosition / self._barElementWidth :
self._interval * validPosition / self._barElementHeight;
value += self._min;
self._setValue(value);
}
};
/**
* DragStart event handler
* @method _onDragstart
* @param {Event} event
* @member ns.widget.core.Slider
* @protected
*/
prototype._onDragstart = function (event) {
var self = this,
ui = self._ui,
validPosition = self.options.orientation === DEFAULT.HORIZONTAL ?
event.detail.estimatedX - ui.barElement.offsetLeft :
self._barElementHeight -
(event.detail.estimatedY - utilDOM.getElementOffset(ui.barElement).top + selectors.getScrollableParent(self.element).scrollTop),
value = self.options.orientation === DEFAULT.HORIZONTAL ?
self._interval * validPosition / self._barElementWidth :
self._interval * validPosition / self._barElementHeight;
ui.handlerElement.classList.add(classes.SLIDER_HANDLER_ACTIVE);
value += self._min;
self._setValue(value);
self._active = true;
};
/**
* DragEnd event handler
* @method _onDragend
* @member ns.widget.core.Slider
* @protected
*/
prototype._onDragend = function () {
var self = this,
ui = self._ui;
ui.handlerElement.classList.remove(classes.SLIDER_HANDLER_ACTIVE);
self._active = false;
if (self._previousValue !== self.element.value) {
events.trigger(self.element, "change");
}
self._previousValue = self.element.value;
};
/**
* Refresh to Slider component
* @method refresh
* @member ns.widget.core.Slider
* @protected
*/
prototype.refresh = function () {
this._setDisabled(this.element);
this._initLayout();
};
/**
* Destroy Slider component
* @method _destroy
* @member ns.widget.core.Slider
* @protected
*/
prototype._destroy = function () {
var self = this,
barElement = self._ui.barElement;
unbindEvents(self);
barElement.parentNode.removeChild(barElement);
self._ui = null;
self._options = null;
};
ns.widget.core.Slider = Slider;
engine.defineWidget(
"Slider",
"input[data-role='slider'], input[type='range'], input[data-type='range']",
[
"value"
],
Slider,
"core"
);
}(window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true */
/**
* # Circle ProgressBar
* Shows a control that indicates the progress percentage of an on-going operation by circular shape.
*
* @class ns.widget.wearable.CircleProgressBar
* @component-type standalone-component
* @component-selector .ui-circle-progress, .ui-progress
* @since 2.3
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
utilDOM = ns.util.DOM,
utilObject = ns.util.object,
PI = Math.PI,
eventType = {
/**
* Triggered when value is changed.
* @event progresschange
* @member ns.widget.wearable.CircleProgressBar
*/
CHANGE: "progresschange"
},
defaultOptions = {
margin: 0,
endPoint: false,
bgcolor: "rgba(71,71,71,1)"
},
CircleProgressBar = function () {
var self = this,
ui = {};
self.options = utilObject.merge({}, defaultOptions, self.options);
ui.progressContainer = null;
ui.endPoint = null;
self._ui = ui;
self._maxValue = null;
self._minValue = null;
self._value = null;
},
prototype = new BaseWidget(),
CLASSES_PREFIX = "ui-progressbar",
classes = {
uiProgressbar: CLASSES_PREFIX,
uiProgressbarFull: CLASSES_PREFIX + "-full",
endPoint: CLASSES_PREFIX + "-end-point",
endPointActive: CLASSES_PREFIX + "-end-point-active",
endPointPressed: CLASSES_PREFIX + "-end-point-pressed"
},
selectors = {
progressContainer: "." + classes.uiProgressbar
},
size = {
FULL: "full",
LARGE: "large",
MEDIUM: "medium",
SMALL: "small"
};
CircleProgressBar.classes = classes;
/**
* Build structure of circle progress bar
* @param {ns.widget.wearable.CircleProgressBar} self
* @param {number} value
*/
function refreshProgressBar(self, value) {
var percentValue = (value - self._minValue) / (self._maxValue - self._minValue) * 100,
ui = self._ui,
size = self._size,
thickness = self.options.thickness,
canvasContext = ui.canvasContext,
endX = 30,
endY = 100,
to = 0,
bgcolor = self.options.bgcolor,
margin = parseInt(self.options.margin, 10);
// draw background circle
drawBackground(canvasContext, size, thickness, margin, bgcolor);
to = 2 * PI * (percentValue / 100) - 0.5 * PI;
if (percentValue === 100) {
// in case of 100% we have to change start angle
drawLine(canvasContext,
0,
2 * PI,
size,
thickness,
margin
);
} else if (percentValue > 0) {
// if percent is different 0 then we draw arc
drawLine(canvasContext,
1.5 * PI,
to,
size,
thickness,
margin
);
}
if (self.options.endPoint) {
endX = size + (size - margin - thickness / 2) * Math.cos(to);
endY = size + (size - margin - thickness / 2) * Math.sin(to);
moveSliderEndPoint(ui.endPoint, endX, endY);
}
}
/**
* Move slider end point on the end of the slider
*/
function moveSliderEndPoint(endPointElement, endX, endY) {
endPointElement.style.left = endX + "px";
endPointElement.style.top = endY + "px";
}
/**
* Calculate size of progressbar
* @param {ns.widget.wearable.CircleProgressBar} self
* @param {string} progressSize
*/
function setProgressBarSize(self, progressSize) {
var sizeToNumber = parseFloat(progressSize),
innerWidth = window.innerWidth,
ui = self._ui,
style = ui.progressContainer.style,
containerClassList = ui.progressContainer.classList,
canvas = ui.canvas,
numberSize = 0;
// clear additional classes
containerClassList.remove(classes.uiProgressbarFull);
if (!isNaN(sizeToNumber)) {
numberSize = sizeToNumber / 2;
} else {
switch (progressSize) {
case size.FULL:
numberSize = innerWidth / 2;
containerClassList.add(classes.uiProgressbarFull);
break;
case size.LARGE:
numberSize = 0.15625 * innerWidth;
break;
case size.MEDIUM:
numberSize = 0.13125 * innerWidth;
break;
case size.SMALL:
numberSize = 0.0875 * innerWidth;
break;
}
}
numberSize = Math.floor(numberSize);
self._size = numberSize;
style.width = (2 * numberSize) + "px";
style.height = (2 * numberSize) + "px";
canvas.width = (2 * numberSize);
canvas.height = (2 * numberSize);
}
/**
* Check options and convert to correct format
* @param {ns.widget.wearable.CircleProgressBar} self
* @param {Object} options
*/
function checkOptions(self, options) {
if (options.size) {
setProgressBarSize(self, options.size);
}
if (options.containerClassName) {
self._ui.progressContainer.classList.add(options.containerClassName);
}
if (options.endPoint) {
self._ui.endPoint.classList.add(classes.endPointActive);
} else {
self._ui.endPoint.classList.remove(classes.endPointActive);
}
if (options.pressed) {
self._ui.endPoint.classList.add(classes.endPointPressed);
} else {
self._ui.endPoint.classList.remove(classes.endPointPressed);
}
}
/**
* Calculate min, max and value
* @param {ns.widget.wearable.CircleProgressBar} self
*/
function prepareValues(self) {
var element = self.element,
value = 0;
self._maxValue = utilDOM.getNumberFromAttribute(element, "max", null, 100);
self._minValue = utilDOM.getNumberFromAttribute(element, "min", null, 0);
// max value must be positive number bigger than 0
if (self._maxValue <= self._minValue) {
ns.error("max value of progress must be positive number that bigger than zero!");
self._maxValue = 100;
}
value = utilDOM.getNumberFromAttribute(element, "value", null, (self._maxValue + self._minValue) / 2);
if (value > self._maxValue) {
value = self._maxValue;
} else if (value < self._minValue) {
value = self._minValue;
}
self._value = value;
utilDOM.setAttribute(element, "value", value);
}
prototype._configure = function (options) {
/**
* Options for widget
* @property {Object} options Options for widget
* @property {number} [options.thickness=8] Sets the border width of CircleProgressBar.
* @property {number|"full"|"large"|"medium"|"small"|null} [options.size="full"] Sets the size of CircleProgressBar.
* @property {?string} [options.containerClassName=null] Sets the class name of CircleProgressBar container.
* @member ns.widget.wearable.CircleProgressBar
*/
this.options = utilObject.merge({}, {
thickness: 8,
size: size.MEDIUM,
containerClassName: null,
type: "circle",
margin: 0,
bgcolor: "rgba(61, 185, 204, 0.4)",
endPoint: false,
pressed: false
}, options);
};
/**
* Draw background line
* @param {RenderingContext} canvasContext
* @param {number} size Radius of arc
* @param {number} thickness Thickness of line in pixels
*/
function drawBackground(canvasContext, size, thickness, margin, bgcolor) {
canvasContext.clearRect(0, 0, 2 * size, 2 * size);
canvasContext.strokeStyle = bgcolor;
canvasContext.lineWidth = thickness;
canvasContext.beginPath();
canvasContext.arc(size, size, size - margin - thickness / 2, 0, 2 * PI);
canvasContext.closePath();
canvasContext.stroke();
}
/**
* Draw foreground line
* @param {RenderingContext} canvasContext
* @param {number} from starting angle
* @param {number} to ending angle
* @param {number} size Radius of arc
* @param {number} thickness Thickness of line in pixels
*/
function drawLine(canvasContext, from, to, size, thickness, margin) {
canvasContext.strokeStyle = "rgba(55,161,237,1)";
canvasContext.lineWidth = thickness;
canvasContext.beginPath();
canvasContext.arc(size, size, size - margin - thickness / 2, from, to);
canvasContext.stroke();
}
/**
* Build CircleProgressBar
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.CircleProgressBar
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
progressElement = element,
progressbarContainer = document.createElement("div"),
canvas = document.createElement("canvas"),
canvasContext = canvas.getContext("2d"),
endPoint = document.createElement("div");
ui.progressContainer = progressbarContainer;
ui.endPoint = endPoint;
ui.canvasContext = canvasContext;
ui.canvas = canvas;
// set classNames of progressbar DOMs.
progressbarContainer.className = classes.uiProgressbar;
endPoint.className = classes.endPoint;
// set id for progress container using "container" prefix
progressbarContainer.id = progressElement.id ? progressElement.id + "-container" : "";
progressElement.parentNode.insertBefore(progressbarContainer, progressElement);
progressbarContainer.appendChild(canvas);
progressbarContainer.appendChild(endPoint);
return element;
};
/**
* Init CircleProgressBar
* @method _init
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.CircleProgressBar
*/
prototype._init = function (element) {
var self = this,
ui = self._ui,
elementParent = element.parentNode,
options = self.options;
ui.progressContainer = ui.progressContainer || elementParent.querySelector(selectors.progressContainer);
ui.endPoint = ui.endPoint || elementParent.querySelector("." + classes.endPoint);
prepareValues(self);
checkOptions(self, options);
refreshProgressBar(self, self._value);
return element;
};
/**
* Get or Set value of the widget
*
* Return element value or set the value.
*
* If method is called without argument then work as getter. If you add one argument then this argument is set
* as value of widget.
*
* @example
* <progress class="ui-circle-progress" id="circleprogress" max="20" value="2"></progress>
* <script>
* var progressbar = document.getElementById("circleprogress"),
* progressbarWidget = tau.widget.CircleProgressBar(progressbar),
*
* // return value in progress tag
* value = progressbarWidget.value();
*
* // sets the value for the progress
* progressbarWidget.value(15);
* </script>
* @method value
* @param {string|number|null} value New value to set
* @return {string} In get mode return element value
* @since 2.3
* @member ns.widget.wearable.CircleProgressBar
*/
/**
* Get value of Circle Progressbar
* @method _getValue
* @protected
* @return {number}
* @member ns.widget.wearable.CircleProgressBar
*/
prototype._getValue = function () {
return parseInt(this.element.getAttribute("value"), 10);
};
/**
* Set value of Circle Progressbar
* @method _setValue
* @param {string} inputValue
* @protected
* @member ns.widget.wearable.CircleProgressBar
*/
prototype._setValue = function (inputValue) {
var self = this,
value;
if (inputValue > self._maxValue) {
value = self._maxValue;
} else if (inputValue < self._minValue) {
value = self._minValue;
} else if (isNaN(inputValue)) {
value = self._minValue;
} else {
value = inputValue;
}
utilDOM.setAttribute(self.element, "value", value);
if (self._value !== value) {
self._value = value;
self.trigger(eventType.CHANGE);
}
refreshProgressBar(self, value);
};
/**
* Refresh structure
* @method _refresh
* @protected
* @member ns.widget.wearable.CircleProgressBar
*/
prototype._refresh = function () {
var self = this;
prepareValues(self);
checkOptions(self, self.options);
refreshProgressBar(self, self._value);
return null;
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.wearable.CircleProgressBar
*/
prototype._destroy = function () {
var self = this;
// remove utilDOM
self.element.parentNode.removeChild(self._ui.progressContainer);
// clear variables
self.element = null;
self._ui = null;
self._maxValue = null;
self._minValue = null;
self._value = null;
return null;
};
CircleProgressBar.prototype = prototype;
ns.widget.wearable.CircleProgressBar = CircleProgressBar;
engine.defineWidget(
"CircleProgressBar",
".ui-circle-progress",
[],
CircleProgressBar,
"wearable"
);
}(window.document, ns));
/*global window, ns, define */
/*jslint nomen: true */
/**
* # Slider Widget
* Wearable Slider component has two types, first is normal slider type another is circle slider type.
* Circle slider type has provided to rotary and touch event handling in component side.
* Circle slider type is default type.
*
* ## Default selectors
*
* To add a slider component to the application, use the following code:
*
* @example
* // Normal type
* <input id="circle" data-type="normal" name="circleSlider" type="range" value="20" min="0" max="100" />
*
* // OR Circle type
* <input id="circle" data-type="circle" name="circleSlider" type="range" value="20" min="0" max="100" />
*
* ## JavaScript API
*
* @class ns.widget.wearable.Slider
* @extends ns.widget.core.Slider
*/
(function (document, ns) {
"use strict";
var CoreSlider = ns.widget.core.Slider,
CoreSliderPrototype = CoreSlider.prototype,
CircleProgressBar = ns.widget.wearable.CircleProgressBar,
CircleProgressBarPrototype = CircleProgressBar.prototype,
shape = ns.support.shape,
engine = ns.engine,
events = ns.event,
utilObject = ns.util.object,
round = Math.round,
floor = Math.floor,
atan2 = Math.atan2,
PI = Math.PI,
PI2 = PI * 2,
PI2_5 = PI * 5 / 2,
Slider = function () {
var self = this;
CoreSlider.call(self);
self._step = 1;
self._middlePoint = {
x: 0,
y: 0
}
},
prototype = new CoreSlider(),
eventType = {
/**
* Triggered when the section is changed.
* @event change
* @member ns.widget.wearable.Slider
*/
CHANGE: "change"
},
PREFIX = "ui-slider",
classes = {
container: PREFIX + "-container",
titles: PREFIX + "-titles",
buttons: PREFIX + "-buttons",
plus: PREFIX + "-plus",
minus: PREFIX + "-minus",
number: PREFIX + "-number",
icon: PREFIX + "-icon",
title: PREFIX + "-title",
subtitle: PREFIX + "-subtitle"
},
slice = Array.prototype.slice;
Slider.prototype = prototype;
Slider.classes = classes;
/**
* Configure Slider widget
* @method _configure
* @protected
* @member ns.widget.wearable.Slider
*/
prototype._configure = function () {
var self = this,
options;
if (shape.circle) {
self.options = utilObject.merge({}, self.options, {
margin: 0,
endPoint: false,
bgcolor: "white",
pressed: false
});
CircleProgressBarPrototype._configure.call(self);
}
options = self.options;
/**
* Options for widget
* @property {Object} options Options for widget
* @property {number} [options.thickness=8] Sets the border width of CircleProgressBar.
* @property {number|"full"|"large"|"medium"|"small"|null} [options.size="full"] Sets the size of CircleProgressBar.
* @property {?string} [options.containerClassName=null] Sets the class name of CircleProgressBar container.
* @property {"circle"|"normal"} [options.type="circle"] Sets type of slider
* @property {number} [options.touchableWidth=50] In circle slider define size of touchable area on border
* @property {boolean} [options.buttons=false] Enable additional + / - buttons
* @property {string} [options.bgcolor="rgba(61, 185, 204, 0.4)"] Background color for inactive slider line
* @property {boolean} [options.endPoint=true] Indicator of current slider position
* @property {number} [options.margin=7] In circle slider define size of margin
* @member ns.widget.wearable.Slider
*/
options.size = "full";
options.touchableWidth = 50;
options.buttons = false;
options.bgcolor = "rgba(61, 185, 204, 0.4)";
options.endPoint = true;
options.margin = 7;
};
/**
* Build buttons for slider
* @method _buildButtons
* @protected
* @param {HTMLElement} element
* @member ns.widget.wearable.Slider
*/
prototype._buildButtons = function (element) {
var buttonsContainer = document.createElement("div");
buttonsContainer.classList.add(classes.buttons);
buttonsContainer.innerHTML = "<div class='" + classes.minus +
"'></div><div class='" + classes.number + "'></div><div class='" + classes.plus + "'></div>";
element.parentElement.insertBefore(buttonsContainer, element);
};
/**
* Build Slider widget
* @method _build
* @protected
* @param {HTMLElement} element
* @member ns.widget.wearable.Slider
*/
prototype._build = function (element) {
var self = this,
options = self.options,
parentElement = element.parentElement,
sliderElements = null,
container = null,
titles = null;
if (options.type === "circle") {
CircleProgressBar.call(this);
element.style.display = "none";
CircleProgressBarPrototype._build.call(self, element);
if (options.buttons) {
self._buildButtons(element);
}
sliderElements = slice.call(
parentElement.querySelectorAll("." + classes.icon + ", ." +
classes.title + ", ." + classes.subtitle + ", ." + classes.buttons));
if (sliderElements.length) {
container = document.createElement("div");
container.classList.add(classes.container);
sliderElements.forEach(container.appendChild.bind(container));
parentElement.appendChild(container);
sliderElements = slice.call(
parentElement.querySelectorAll("." + classes.subtitle + ", ." +
classes.title));
titles = document.createElement("div");
titles.classList.add(classes.titles);
sliderElements.forEach(titles.appendChild.bind(titles));
container.appendChild(titles);
self._ui.container = container;
}
} else {
CoreSliderPrototype._build.call(self, element);
}
return element;
};
/**
* Init Slider widget
* @method _init
* @protected
* @param {HTMLElement} element
* @member ns.widget.wearable.Slider
*/
prototype._init = function (element) {
var self = this,
options = self.options;
if (options.type === "circle") {
CircleProgressBarPrototype._init.call(self, element);
self._circleInit();
} else {
CoreSliderPrototype._init.call(self, element);
}
if (self._ui.container) {
self._ui.valueField = self._ui.container.querySelector("." + classes.number);
}
// init value and redraw
self.value(self._value);
return element;
};
/**
* Init Slider widget for circular type
* @method _circleInit
* @protected
* @member ns.widget.wearable.Slider
*/
prototype._circleInit = function () {
var self = this;
self._step = parseInt(self.element.getAttribute("step"), 10) || self._step || 1;
self._middlePoint.x = window.innerWidth / 2;
self._middlePoint.y = window.innerHeight / 2;
if (self._step < 1) {
self._step = 1;
} else if (self._step > self._maxValue - self._minValue) {
self._step = self._maxValue - self._minValue;
}
};
/**
* Bind events Slider widget
* @method _bindEvents
* @protected
* @member ns.widget.wearable.Slider
*/
prototype._bindEvents = function () {
var self = this,
options = self.options;
if (options.type === "circle") {
events.on(document, "rotarydetent touchstart touchmove touchend click", self, false);
} else {
CoreSliderPrototype._bindEvents.call(self);
}
};
/**
* Bind event handlers
* @method handleEvent
* @param {Event} event
* @member ns.widget.wearable.Slider
* @protected
*/
prototype.handleEvent = function (event) {
var self = this,
options = self.options;
if (options.type === "circle") {
switch (event.type) {
case "rotarydetent":
self._onRotary(event);
break;
case "touchstart":
case "touchmove":
case "touchend":
self._onTouch(event);
break;
case "click":
self._onClick(event);
break;
}
} else {
CoreSliderPrototype.handleEvent.call(self, event);
}
};
/**
* Rotarydetent event handler
* @method _onRotary
* @param {Event} event
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._onRotary = function (event) {
var self = this,
step = self._step,
value = self.value();
self.value(value + ((event.detail.direction === "CW") ? step : -step));
};
/**
* Touchstart handler
* @method _onTouch
* @param {Event} event
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._onTouch = function (event) {
var self = this,
pointer = event.changedTouches && event.changedTouches[0] || event,
clientX = pointer.clientX,
clientY = pointer.clientY,
isValid = self._isValidStartPosition(clientX, clientY);
if (isValid) {
event.preventDefault();
event.stopPropagation();
self._setValueByCoord(clientX, clientY);
}
if (self.options.endPoint) {
if (event.type === "touchstart") {
self.option("pressed", true);
} else if (event.type === "touchend") {
self.option("pressed", false);
}
}
};
/**
* Touchstart handler
* @method _onClick
* @param {Event} event
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._onClick = function (event) {
var self = this,
targetClassList = event.target.classList;
if (targetClassList.contains(classes.plus)) {
self.value(self.value() + self._step);
} else if (targetClassList.contains(classes.minus)) {
self.value(self.value() - self._step);
}
};
/**
* Set pressed options
* @method _setPressed
* @param {HTMLElement} element
* @param {*} value
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._setPressed = function (element, value) {
value = (value === "false") ? false : value;
if (this.options.pressed === !value) {
this.options.pressed = !!value;
// refresh
return true;
}
return false;
}
/**
* Check whether the click point is in valid area
* @method _isValidStartPosition
* @param {number} clientX
* @param {number} clientY
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._isValidStartPosition = function (clientX, clientY) {
var self = this,
middleX = self._middlePoint.x,
middleY = self._middlePoint.y,
minRadius = middleY - self.options.touchableWidth;
return ((clientY - middleY) * (clientY - middleY) + (clientX - middleX) * (clientX - middleX) > minRadius * minRadius);
};
/**
* Set value to slider
* @method _setValueByCoord
* @param {number} clientX
* @param {number} clientY
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._setValueByCoord = function (clientX, clientY) {
var self = this,
value;
value = self._convertCoordToValue(clientX, clientY);
if (value === 0 && clientX === self._middlePoint.x) {
if (CircleProgressBarPrototype._getValue.call(self) > (self._maxValue + self._minValue) / 2) {
value = self._maxValue;
}
}
self.value(value);
};
/**
* Convert from coordinate to slider value
* @method _convertCoordToValue
* @param {number} clientX
* @param {number} clientY
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._convertCoordToValue = function (clientX, clientY) {
return round(((atan2(clientY - this._middlePoint.y, clientX - this._middlePoint.x) + PI2_5) % PI2) / PI2 * (this._maxValue - this._minValue) + this._minValue);
};
/**
* Calibrate value using step option
* @method _calibrateValue
* @param {number} value
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._calibrateValue = function (value) {
var self = this,
step = self._step,
half = step / 2;
return floor((value - self._minValue + half) / step) * step + self._minValue;
};
/**
* Set slider value
* @method _setValue
* @param {number} value
* @member ns.widget.wearable.Slider
* @return {number|null}
* @public
*/
prototype._setValue = function (value) {
var self = this,
currentValue = self._value;
if (parseInt(value, 10) > self._maxValue) {
value = self._maxValue;
}
if (parseInt(value, 10) < self._minValue) {
value = self._minValue;
}
value = self._calibrateValue(value);
if (self.options.type === "circle") {
CircleProgressBarPrototype._setValue.call(self, value);
if (self._ui.valueField) {
self._ui.valueField.textContent = value;
}
if (value !== currentValue) {
self.trigger(eventType.CHANGE);
}
} else {
return CoreSliderPrototype._setValue.call(self, value);
}
};
/**
* Get slider value
* @method value
* @member ns.widget.wearable.Slider
* @return {number}
* @public
*/
prototype._getValue = function () {
var self = this;
if (self.options.type === "circle") {
return CircleProgressBarPrototype._getValue.call(self);
} else {
return CoreSliderPrototype._getValue.call(self);
}
};
/**
* Refresh Slider component
* @method refresh
* @member ns.widget.wearable.Slider
* @public
*/
prototype.refresh = function () {
var self = this,
options = self.options;
if (options.type === "circle") {
CircleProgressBarPrototype._refresh.call(self);
self._circleInit();
} else {
CoreSliderPrototype.refresh.call(self);
}
};
/**
* Destroy Slider component
* @method _destroy
* @member ns.widget.wearable.Slider
* @protected
*/
prototype._destroy = function () {
var self = this,
options = self.options;
if (options.type === "circle") {
events.off(document, "rotarydetent touchstart touchmove touchend click", self, false);
self.element.style.display = "inline-block";
CircleProgressBarPrototype._destroy.call(self);
self._ui = null;
self.options = null;
} else {
CoreSliderPrototype._destroy.call(self);
}
};
ns.widget.wearable.Slider = Slider;
engine.defineWidget(
"Slider",
"." + PREFIX,
[
"value"
],
Slider,
"wearable",
true
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Listview Widget
* Shows a list view.
*
* The list widget is used to display, for example, navigation data, results, and data entries. The following table describes the supported list classes.
*
* ## Default selectors
*
* Default selector for listview widget is class *ui-listview*.
*
* To add a list widget to the application, use the following code:
*
* ### List with basic items
*
* You can add a basic list widget as follows:
*
* @example template
* <ul class="ui-listview">
* <li><span>List Item</span></li>
* </ul>
*
* ### List with link items
*
* You can add a list widget with a link and press effect that allows the user to click each list item as follows:
*
* @example tau-listview-with-link
* <ul class="ui-listview">
* <li>
* <a href="#">List Item</a>
* </li>
* </ul>
*
* ## JavaScript API
*
* Listview widget hasn't JavaScript API.
*
* @class ns.widget.core.Listview
* @component-selector .ui-listview
* @components-constraint 'listitem'
* @component-type container-component
* @extends ns.widget.BaseWidget
*/
/**
* Listview with gradient background
* @style ui-colored-list
* @member ns.widget.core.Listview
* @mobile
*/
/**
* Enable snap list style
* @style ui-snap-listview
* @member ns.widget.core.Listview
* @wearable
*/
/**
*
* @style ui-snap-listview
* @member ns.widget.core.Listview
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
Listview = function () {
},
classes = {
LISTVIEW: "ui-listview",
DETAILS: "ui-details"
},
prototype = new BaseWidget();
Listview.classes = classes;
/**
* build Listview
* @method _build
* @private
* @param {HTMLElement} element
* @return {HTMLElement}
* @member ns.widget.core.Listview
*/
prototype._build = function (element) {
element.classList.add(classes.LISTVIEW);
return element;
};
Listview.prototype = prototype;
ns.widget.core.Listview = Listview;
engine.defineWidget(
"Listview",
"[data-role='listview'], .ui-listview",
[],
Listview,
"core"
);
}(window.document, ns));
/**
* # List Item
*
* You can add a basic list item as follows:
*
* @example template
* <li><span>List Item</span></li>
*
*
* @class ns.widget.core.ListItem
* @component-selector .ui-listview li
* @components-constraint 'text', 'image', 'checkbox', 'button', 'radio', 'toggleswitch', 'processing'
* @component-type container-component
* @extends ns.widget.BaseWidget
*/
/**
*
* @style ui-li-anchor
* @member ns.widget.core.ListItem
*/
/**
* Subtext for item
* @style li-text-sub
* @selector > *
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Subtext for item
* @style ui-li-sub-text
* @selector > *
* @member ns.widget.core.ListItem
* @wearable
*/
/**
* Item with button on the right
* @style li-has-right-btn
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* Item with circular button on the right
* @style li-has-right-circle-btn
* @selector
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Item with thumbnail on the left
* @style li-has-thumb
* @selector
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Thumbnail inside item
* @style li-thumb
* @selector .li-has-thumb > *
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Item with checkbox
* @style li-has-checkbox
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Item with radio button
* @style li-has-radio
* @selector
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Item with progressbar
* @style li-has-progress
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* Item with multiline
* @style li-has-multiline
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* Second subtext for multiline item positioned under the first one
* @style ui-text-sub2
* @selector .li-has-multiline > *
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* Subtext for multiline item positioned on the right
* @style ui-text-sub3
* @selector .li-has-multiline > *
* @member ns.widget.core.ListItem
* @mobile
*/
/**
* Item with 2 lines
* @style li-has-2line
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Item with 3 lines
* @style li-has-3-lines
* @mobile
* @member ns.widget.core.ListItem
*/
/**
*
* @style li-icon-sub
* @selector .li-text-sub > *
* @member ns.widget.core.ListItem
* @mobile
*/
/**
*
* @style li-icon-sub
* @selector .li-text-sub3 > *
* @member ns.widget.core.ListItem
* @mobile
*/
/**
*
* @style ui-li-static
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* Expandable item
* @style ui-expandable
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* Divider item
* @style ui-group-index
* @mobile
* @member ns.widget.core.ListItem
*/
/**
* List divider
* @style ui-listview-divider
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Marquee item
* @style ui-marquee
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Marquee item with blurry effect
* @style ui-marquee-gradient
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Item with action icon
* @style ui-li-has-action-icon
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Text for action item
* @style ui-action-text
* @selector .ui-li-has-action-icon > *
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Setting icon for action item
* @style ui-action-setting
* @selector .ui-li-has-action-icon > *
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Delete icon for action item
* @style ui-action-delete
* @selector .ui-li-has-action-icon > *
* @wearable
* @member ns.widget.core.ListItem
*/
/**
* Adding icon for action item
* @style ui-action-add
* @selector .ui-li-has-action-icon > *
* @wearable
* @member ns.widget.core.ListItem
*/
;
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
/*global window, define, ns, Math*/
/**
* #ArcListview Widget
*
* @class ns.widget.wearable.ArcListview
* @since 3.0
* @extends ns.widget.wearable.Listview
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function (document, ns) {
"use strict";
var nsWidget = ns.widget,
Listview = nsWidget.core.Listview,
Page = nsWidget.core.Page,
eventUtils = ns.event,
slice = [].slice,
// constants
ELLIPSIS_A = 333,
ELLIPSIS_B = 180,
SCREEN_HEIGHT = 360,
SCROLL_DURATION = 400,
MAX_SCROLL_DURATION = 1500,
MOMENTUM_VALUE = 15,
MOMENTUM_MAX_VALUE = 400,
// in ms
TOUCH_MOVE_TIME_THRESHOLD = 140,
// in px
TOUCH_MOVE_Y_THRESHOLD = 10,
// time of animation in skip animation mode, this is one animation frame and animation is
// invisible
ONE_FRAME_TIME = 40,
// half of screen height - center element height (112)
BOTTOM_MARGIN = (window.innerHeight - 112) / 2,
/**
* Alias for class {@link ns.engine}
* @property {Object} engine
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
engine = ns.engine,
/**
* Alias for class {@link ns.util}
* @property {Object} util
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
util = ns.util,
/**
* Alias for class {@link ns.util.selectors}
* @property {Object} selectorsUtil
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
selectorsUtil = util.selectors,
/**
* Alias for class {@link ns.util.easing.easeOutSine}
* @property {Object} timingFunction
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
timingFunction = util.easing.easeOutSine,
/**
* Alias for method {@link Math.round}
* @property {Function} round
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
round = Math.round,
/**
* Alias for method {@link Math.min}
* @property {Function} min
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
min = Math.min,
/**
* Alias for method {@link Math.max}
* @property {Function} max
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
max = Math.max,
/**
* Alias for method {@link Math.sqrt}
* @property {Function} sqrt
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
sqrt = Math.sqrt,
/**
* Alias for method {@link Math.abs}
* @property {Function} sqrt
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
abs = Math.abs,
/**
* Alias for method {@link ns.util.array}
* @property {Object} arrayUtil
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
arrayUtil = ns.util.array,
/**
* Alias for class ArcListview
* @method ArcListview
* @memberof ns.widget.wearable.ArcListview
* @protected
* @static
*/
ArcListview = function () {
var self = this;
/**
* Object with default options
* @property {Object} options
* @property {number} [options.ellipsisA] a parameter of ellipsis equation
* @property {number} [options.ellipsisB] b parameter of ellipsis equation
* @property {number} [options.selectedIndex=0] index current selected item begins from 0
* @property {number} [options.bouncingTimeout=1000] time when bound effect will be hidden
* @memberof ns.widget.wearable.ArcListview
*/
self.options = {
// selected index
selectedIndex: 0,
ellipsisA: ELLIPSIS_A,
ellipsisB: ELLIPSIS_B,
bouncingTimeout: 1000,
visibleItems: 3
};
// items table on start is empty
self._items = [];
// the end of scroll animation
self._scrollAnimationEnd = true;
// carousel of five elements
self._carousel = {
items: []
};
self._initializeState();
self._renderCallback = self._render.bind(this);
self._halfItemsCount = null;
self._rendering = false;
self._lastRenderRequest = 0;
self._carouselIndex = 0;
/**
* Cache for widget UI HTMLElements
* @property {Object} _ui
* @property {HTMLElement} _ui.selection element for indication of current selected item
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
self._ui = {
selection: null,
scroller: null
};
},
WIDGET_CLASS = "ui-arc-listview",
/**
* CSS Classes using in widget
*/
classes = {
WIDGET: WIDGET_CLASS,
PREFIX: WIDGET_CLASS + "-",
SELECTION: WIDGET_CLASS + "-selection",
SELECTION_SHOW: WIDGET_CLASS + "-selection-show",
CAROUSEL: WIDGET_CLASS + "-carousel",
CAROUSEL_ITEM: WIDGET_CLASS + "-carousel-item",
CAROUSEL_ITEM_SEPARATOR: WIDGET_CLASS + "-carousel-item-separator",
GROUP_INDEX: "ui-li-group-index",
DIVIDER: "ui-listview-divider",
FORCE_RELATIVE: "ui-force-relative-li-children",
LISTVIEW: "ui-listview",
SELECTED: "ui-arc-listview-selected"
},
events = {
CHANGE: "change"
},
selectors = {
PAGE: "." + Page.classes.uiPage,
POPUP: ".ui-popup",
SCROLLER: ".ui-scroller",
ITEMS: "." + WIDGET_CLASS + " > li",
SELECTION: "." + WIDGET_CLASS + "-selection",
TEXT_INPUT: "input[type='text']" +
", input[type='number']" +
", input[type='password']" +
", input[type='email']" +
", input[type='url']" +
", input[type='tel']" +
", input[type='search']"
},
prototype = new Listview(),
didScroll = false,
averageVelocity = 0,
sumTime = 0,
sumDistance = 0,
momentum = 0,
startTouchTime = 0,
lastTouchTime = 0,
factorsX = [],
lastTouchY = 0,
deltaTouchY = 0,
deltaSumTouchY = 0;
/**
* Create item object
* @return {Object}
*/
ArcListview.createItem = function () {
return {
element: null,
id: 0,
y: 0,
rect: null,
current: {
scale: -1
},
from: null,
to: null,
repaint: false
};
};
/**
* Pre calculation of factors for Y axis
* @param {number} a factor X axis for ellipsis (see VI guide)
* @param {number} b factor Y axis for ellipsis (see VI guide)
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
ArcListview.calcFactors = function (a, b) {
var i;
for (i = 0; i <= b; i++) {
factorsX[i] = sqrt(a * a * (1 - i * i / b / b)) / a;
}
return factorsX;
};
/**
* Initialize state
* @protected
*/
prototype._initializeState = function () {
/**
* Object with state of scroll animation
* @property {Object} _state
* @property {number} _state.startTime time of scroll animation start
* @property {number} _state.duration duration time of scroll animation
* @property {number} _state.progress current progress of scroll animation
* @property {Object} _state.scroll scroll state and animation objectives
* @property {number} _state.currentIndex current index of selected item
* @property {number} _state.toIndex item index as target for scroll end
* @property {Array} _state.items array of list items
* @property {Array} _state.separators array of items treated as separators
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
this._state = {
startTime: Date.now(),
duration: 0,
progress: 0,
scroll: {
current: 10,
from: null,
to: null
},
currentIndex: 0,
toIndex: 0,
items: [],
separators: []
};
};
function prepareParentStyle(parentElement, parentRect) {
var parentStyle = parentElement.style;
parentStyle.height = parentRect.height + "px";
parentStyle.position = "relative";
}
/**
* Set state for animation
* @protected
*/
prototype._setAnimatedItems = function () {
var self = this,
items = self._items,
id = 0,
itemElement = items[0],
item = null,
rect = null,
parentRect = null,
diffY = null,
scroller = self._ui.scroller,
state = self._state,
parentElement = itemElement.parentElement,
parentClassList = parentElement.classList;
// set parent size
parentRect = parentElement.getBoundingClientRect();
prepareParentStyle(parentElement, parentRect);
parentClassList.add(classes.FORCE_RELATIVE);
arrayUtil.forEach(items, function (itemElement, i) {
// add items to state
if (i >= 0 && !state.items[i] && itemElement !== undefined) {
rect = itemElement.getBoundingClientRect();
item = ArcListview.createItem();
if (itemElement.classList.contains(classes.GROUP_INDEX) || itemElement.classList.contains(classes.DIVIDER)) {
state.separators.push({
itemElement: item,
insertBefore: i - state.separators.length
});
} else {
state.items.push(item);
item.id = id;
id++;
}
item.element = itemElement;
item.y = round(rect.top + rect.height / 2 + scroller.scrollTop);
item.height = rect.height;
item.rect = rect;
if (diffY === null) {
diffY = rect.top - parentRect.top;
}
}
});
parentClassList.remove(classes.FORCE_RELATIVE);
arrayUtil.forEach(items, function (item) {
parentElement.removeChild(item);
});
};
/**
* Update scale
* @param {number} currentScroll
* @protected
*/
prototype._updateScale = function (currentScroll) {
var self = this,
state = self._state,
items = state.items,
toScale = 0,
y;
arrayUtil.forEach(items, function (item) {
if (item !== null) {
y = item.y;
if (item.id < state.currentIndex) {
y -= item.height / 4;
}
if (item.id > state.currentIndex) {
y += item.height / 4;
}
toScale = self._getScaleByY(y - SCREEN_HEIGHT / 2 - currentScroll);
if (item.current.scale !== toScale) {
item.from = item.from || {};
item.from.scale = item.current.scale;
item.to = item.to || {};
item.to.scale = toScale;
} else {
item.to = null;
}
}
});
};
function calcItem(item) {
if (item !== null && item.to !== null) {
item.current.scale = item.to.scale;
item.repaint = true;
}
}
/**
* Returns separator object if exists before item at given index
* @param {number} index index of element
* @protected
*/
prototype._getSeparatorBeforeListItem = function (index) {
var self = this,
state = self._state,
separators = state.separators,
i = 0,
length = separators.length;
for (; i < length; i++) {
if (separators[i].insertBefore === index) {
return separators[i];
}
if (separators[i].insertBefore > index) {
return null;
}
}
}
/**
* Calculate state
* @protected
*/
prototype._calc = function () {
var self = this,
state = self._state,
currentTime = Date.now(),
startTime = state.startTime,
deltaTime = currentTime - startTime,
scroll = state.scroll;
if (deltaTime >= state.duration) {
self._scrollAnimationEnd = true;
deltaTime = state.duration;
}
state.progress = (state.duration !== 0) ? deltaTime / state.duration : 1;
// scroll
if (scroll.to !== null) {
scroll.current = timingFunction(
state.progress,
scroll.from,
scroll.to - scroll.from,
1
);
if (self._scrollAnimationEnd) {
self.trigger(events.CHANGE, {
"selected": state.currentIndex
});
eventUtils.trigger(state.items[state.currentIndex].element, "selected");
state.toIndex = state.currentIndex;
scroll.to = null;
scroll.from = null;
}
}
self._updateScale(-1 * scroll.current);
// calculate items
arrayUtil.forEach(state.items, calcItem);
};
prototype._setBouncingTimeout = function () {
var self = this;
// hide after timeout
setTimeout(function () {
self._bouncingEffect.dragEnd();
}, self.options.bouncingTimeout);
};
/**
* Draw one item
* @param {Object} item
* @param {number} index
* @protected
*/
prototype._drawItem = function (item, index) {
var self = this,
carousel = self._carousel,
middleItemIndex = self._halfItemsCount + 1,
carouselItem,
carouselElement,
itemElement,
carouselItem,
carouselElement,
carouselSeparator,
upperSeparator,
lowerSeparator,
separatorElement,
nextCarouselItem,
nextCarouselSeparatorElement,
itemStyle,
currentIndex = self._carouselIndex;
if (item !== null) {
itemElement = item.element;
upperSeparator = self._getSeparatorBeforeListItem(index);
lowerSeparator = self._getSeparatorBeforeListItem(index + 1);
if (item.repaint) {
itemStyle = itemElement.style;
if (index - currentIndex < middleItemIndex &&
index - currentIndex > -middleItemIndex) {
carouselItem = carousel.items[index - currentIndex + middleItemIndex - 1];
if (carouselItem) {
carouselElement = carouselItem.carouselElement;
carouselSeparator = carouselItem.carouselSeparator;
if (itemElement.parentElement !== carouselElement) {
carouselElement.appendChild(itemElement);
}
if (upperSeparator) {
separatorElement = upperSeparator.itemElement.element;
while (carouselSeparator.firstChild) {
carouselSeparator.removeChild(carouselSeparator.firstChild);
}
carouselSeparator.appendChild(separatorElement);
} else if (carouselSeparator.firstChild) {
carouselSeparator.removeChild(carouselSeparator.firstChild);
}
nextCarouselItem = carousel.items[index - currentIndex + middleItemIndex];
if (nextCarouselItem) {
nextCarouselSeparatorElement = nextCarouselItem.carouselSeparator;
if (lowerSeparator) {
while (nextCarouselSeparatorElement.firstChild) {
nextCarouselSeparatorElement.removeChild(nextCarouselSeparatorElement.firstChild);
}
nextCarouselSeparatorElement.appendChild(lowerSeparator.itemElement.element);
} else if (nextCarouselSeparatorElement.firstChild) {
nextCarouselSeparatorElement.removeChild(nextCarouselSeparatorElement.firstChild);
}
}
}
}
itemStyle.transform = "translateY(-50%) scale3d(" + item.current.scale + "," + item.current.scale + "," + item.current.scale + ")";
itemStyle.opacity = item.current.scale * 1.15;
item.repaint = false;
} else {
if (itemElement.parentNode !== null && item.current.scale < 0.01) {
itemElement.parentNode.removeChild(itemElement);
}
}
}
};
/**
* Draw widget
* @method _draw
* @protected
* @memberof ns.widget.wearable.ArcListview
*/
prototype._draw = function () {
var self = this,
state = self._state,
items = state.items,
length = items.length,
i;
// change carousel item per 2 items
if (Math.abs(self._carouselIndex - state.currentIndex) >= 2) {
self._carouselIndex = state.currentIndex;
}
// draw items
for (i = 0; i < length; i++) {
self._drawItem(items[i], i);
}
self._carouselUpdate(state.currentIndex);
// scroller update
self._ui.scroller.scrollTop = -1 * state.scroll.current;
};
/**
* Update positions of items
* @param {number} currentIndex
* @protected
*/
prototype._carouselUpdate = function (currentIndex) {
var self = this,
carousel = self._carousel,
state = self._state,
halfItemsCount = self._halfItemsCount,
item,
len,
i,
index,
separatorTop,
carouselItemElement,
carouselItemUpperSeparatorElement,
top;
// change carousel item per 2 items
if (Math.abs(self._carouselIndex - currentIndex) >= 2) {
self._carouselIndex = currentIndex;
}
for (i = -halfItemsCount, len = halfItemsCount; i <= len; i++) {
index = self._carouselIndex + i;
item = state.items[index];
carouselItemElement = carousel.items[i + halfItemsCount].carouselElement;
carouselItemUpperSeparatorElement = carousel.items[i + halfItemsCount].carouselSeparator;
if (item !== undefined) {
top = (state.scroll.current + item.y - item.height / 2);
separatorTop = (carouselItemUpperSeparatorElement.childElementCount) ? top - (item.height + carouselItemUpperSeparatorElement.offsetHeight) / 2 : 0;
} else {
top = 0;
separatorTop = 0;
}
carouselItemElement.style.transform = "translateY(" + top + "px)";
carouselItemUpperSeparatorElement.style.transform = "translateY(" + separatorTop + "px)";
}
};
/**
* Render widget
* @method _render
* @protected
* @memberof ns.widget.wearable.ArcListview
*/
prototype._render = function () {
var self = this,
state = self._state;
self._calc();
self._draw();
if (!self._scrollAnimationEnd) {
state.currentIndex = self._findItemIndexByY(
-1 * (state.scroll.current - SCREEN_HEIGHT / 2 + 1));
util.requestAnimationFrame(self._renderCallback);
} else {
self._rendering = false;
}
};
prototype._requestRender = function () {
var self = this;
if (!self._rendering) {
self._rendering = true;
util.requestAnimationFrame(self._renderCallback);
}
self._lastRenderRequest = Date.now();
};
/**
* Find closer item for given "y" position
* @method _findItemIndexByY
* @param {number} y
* @return {number}
* @protected
* @memberof ns.widget.wearable.ArcListview
*/
prototype._findItemIndexByY = function (y) {
var items = this._state.items,
len = items.length,
minY = items[0].y,
maxY = items[len - 1].y,
prev,
current,
next,
loop = true,
diffY = maxY - minY,
tempIndex = diffY !== 0 ? round((y - minY) / (diffY) * len) : 0;
tempIndex = min(len - 1, max(0, tempIndex));
while (loop) {
prev = abs((items[tempIndex - 1]) ? y - items[tempIndex - 1].y : Infinity);
current = abs(y - items[tempIndex].y);
next = abs((items[tempIndex + 1]) ? y - items[tempIndex + 1].y : -Infinity);
if (prev < current) {
tempIndex--;
} else if (next < current) {
tempIndex++;
} else {
loop = false;
}
}
return tempIndex;
};
/**
* Refresh method
* @method _refresh
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._refresh = function () {
var self = this,
state = self._state,
currentTime = Date.now(),
deltaTime = currentTime - lastTouchTime,
items = state.items,
currentItem,
toY,
scroll = state.scroll;
sumTime += -1 * deltaTime;
sumDistance += deltaTouchY;
averageVelocity = sumDistance / sumTime;
self._halfItemsCount = Math.ceil((parseInt(self.options.visibleItems, 10) + 2) / 2);
if (momentum !== 0) {
momentum *= averageVelocity;
// momentum value has to be limited to defined max value
momentum = max(min(momentum, MOMENTUM_MAX_VALUE), -MOMENTUM_MAX_VALUE);
toY = -1 * (scroll.current - momentum - SCREEN_HEIGHT / 2 + 1);
// snap to closer item
currentItem = self._findItemIndexByY(toY);
toY = items[currentItem].y;
state.currentIndex = currentItem;
scroll.from = scroll.current;
scroll.to = -1 * (toY - SCREEN_HEIGHT / 2 + 1);
// if average velocity is rising then duration should be longer,
// but no longer then MAX_SCROLL_DURATION
// the averageVelocity is strongly dependent to device,
// eg. for emulator is between 8-30 so this value should be
// divided by 4 for more convenient use
state.duration = min(SCROLL_DURATION * max(Math.abs(averageVelocity) / 4, 1), MAX_SCROLL_DURATION);
}
if (self._scrollAnimationEnd) {
state.startTime = Date.now();
self._scrollAnimationEnd = false;
self._requestRender();
}
};
/**
* Simulate scroll
* @protected
*/
prototype._scroll = function () {
var self = this;
momentum = (momentum === undefined) ? 0 : momentum;
self._refresh();
self._requestRender();
};
/**
* Calculate scale for given Y position
* @param {number} y
* @return {number}
* @protected
*/
prototype._getScaleByY = function (y) {
var self = this,
roundY = round(y);
if (roundY > self.options.ellipsisB || roundY < -self.options.ellipsisB) {
return 0;
} else {
return factorsX[abs(roundY)];
}
};
/**
* Redraw list after roll down/up
* @method _roll
* @param {number} duration Time of rolling
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._roll = function (duration) {
var self = this,
state = self._state,
scroll = state.scroll;
// increase scroll duration according to length of items
// one item more increase duration +25%
// scroll duration is set to 0 when animations are disabled
state.duration = duration !== undefined ? duration :
SCROLL_DURATION * (1 + (abs(state.currentIndex - state.toIndex) - 1) / 4);
// start scroll animation from current scroll position
scroll.from = scroll.current;
scroll.to = -1 * (state.items[state.toIndex].y - SCREEN_HEIGHT / 2 + 1);
// if scroll animation is ended then animation start
if (self._scrollAnimationEnd) {
state.startTime = Date.now();
self._scrollAnimationEnd = false;
self._requestRender();
}
};
/**
* Change to next item
* @method _rollDown
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._rollDown = function () {
var self = this,
state = self._state,
bouncingEffect = self._bouncingEffect;
self.trigger(events.CHANGE, {
"unselected": state.currentIndex
});
if (state.toIndex < state.items.length - 1) {
state.toIndex++;
// hide end effect
bouncingEffect.dragEnd();
} else {
// show bottom end effect
bouncingEffect.drag(0, -self._maxScrollY);
// hide after timeout
self._setBouncingTimeout();
}
self._roll();
};
/**
* Change to prev item
* @method _rollUp
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._rollUp = function () {
var self = this,
state = self._state,
bouncingEffect = self._bouncingEffect;
self.trigger(events.CHANGE, {
"unselected": state.currentIndex
});
if (state.toIndex > 0) {
state.toIndex--;
// hide end effect
bouncingEffect.dragEnd();
} else {
// show top end effect
bouncingEffect.drag(0, 0);
// hide after timeout
self._setBouncingTimeout();
}
self._roll();
};
/**
* Callback for rotary event
* @param {Event} event
* @protected
*/
prototype._onRotary = function (event) {
var self = this;
self._scrollAnimationEnd = true;
if (event.detail.direction === "CW") {
self._rollDown();
} else {
self._rollUp();
}
};
/**
* Scroll list to index
* @method scrollToPosition
* @param {number} index
* @param {boolean} skipAnimation
* @public
* @return {boolean} True if the list was scrolled, false - otherwise.
* @member ns.widget.wearable.SnapListview
*/
prototype.scrollToPosition = function (index, skipAnimation) {
var self = this,
state = self._state;
self.trigger(events.CHANGE, {
"unselected": state.currentIndex
});
state.toIndex = index;
if (state.toIndex > state.items.length - 1) {
state.toIndex = state.items.length - 1;
}
if (state.toIndex < 0) {
state.toIndex = 0;
}
if (skipAnimation) {
self._roll(ONE_FRAME_TIME);
} else {
self._roll();
}
};
/**
* Get selected index
* @method getSelectedIndex
* @return {number} index
* @public
* @member ns.widget.wearable.SnapListview
*/
prototype.getSelectedIndex = function () {
return this._state.currentIndex;
};
/**
* Handler for event touch start
* @method _onTouchStart
* @param {Event} event
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._onTouchStart = function (event) {
var self = this,
touch = event.changedTouches[0],
state = self._state;
deltaTouchY = 0;
lastTouchY = touch.clientY;
startTouchTime = Date.now();
deltaSumTouchY = 0;
lastTouchTime = startTouchTime;
averageVelocity = 0;
sumTime = 0;
sumDistance = 0;
momentum = 0;
self._scrollAnimationEnd = true;
didScroll = false;
self._carouselUpdate(state.currentIndex);
};
/**
* Handler for event touch move
* @method _onTouchMove
* @param {Event} event
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._onTouchMove = function (event) {
var self = this,
state = self._state,
touch = event.changedTouches[0],
deltaTouchTime,
scroll = state.scroll,
current = scroll.current,
bouncingEffect = self._bouncingEffect;
// time
lastTouchTime = Date.now();
deltaTouchTime = lastTouchTime - startTouchTime;
// move
deltaTouchY = touch.clientY - lastTouchY;
current += deltaTouchY;
deltaSumTouchY += deltaTouchY;
if (didScroll === false &&
(deltaTouchTime > TOUCH_MOVE_TIME_THRESHOLD || abs(deltaSumTouchY) > TOUCH_MOVE_Y_THRESHOLD)) {
didScroll = true;
self.trigger(events.CHANGE, {
"unselected": state.currentIndex
});
}
if (didScroll) {
lastTouchY = touch.clientY;
// set current to correct range
if (current > 0) {
current = 0;
// enable top end effect
bouncingEffect.drag(0, 0);
self._setBouncingTimeout();
} else if (current < -self._maxScrollY) {
current = -self._maxScrollY;
// enable bottom end effect
bouncingEffect.drag(0, current);
self._setBouncingTimeout();
} else {
// hide end effect
bouncingEffect.dragEnd();
}
scroll.current = current;
state.currentIndex = self._findItemIndexByY(-1 * (current - SCREEN_HEIGHT / 2 + 1));
self._carouselUpdate(state.currentIndex);
momentum = 0;
self._scroll();
lastTouchTime = Date.now();
}
};
/**
* Handler for event touch end
* @method _onTouchEnd
* @param {Event} event
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._onTouchEnd = function (event) {
var touch = event.changedTouches[0],
self = this,
state = self._state,
scroll = state.scroll,
bouncingEffect = self._bouncingEffect;
if (didScroll) {
deltaTouchY = touch.clientY - lastTouchY;
lastTouchY = touch.clientY;
scroll.current += deltaTouchY;
if (scroll.current > 0) {
scroll.current = 0;
}
state.currentIndex = self._findItemIndexByY(-1 * (scroll.current - SCREEN_HEIGHT / 2 + 1));
self._carouselUpdate(state.currentIndex);
momentum = MOMENTUM_VALUE;
self._scrollAnimationEnd = true;
self._scroll();
lastTouchTime = 0;
// bouncing effect
if (bouncingEffect) {
bouncingEffect.dragEnd();
}
}
};
function showHighlight(arcListviewSelection, selectedElement) {
arcListviewSelection.style.height = selectedElement.getBoundingClientRect().height + "px";
arcListviewSelection.classList.add(classes.SELECTION_SHOW);
}
/**
* Handler for event select
* @method _selectItem
* @param {number} selectedIndex
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._selectItem = function (selectedIndex) {
var ui = this._ui,
state = this._state,
selectedElement = state.items[selectedIndex].element;
if (selectedElement.classList.contains(classes.SELECTED)) {
showHighlight(ui.arcListviewSelection, selectedElement);
} else {
eventUtils.one(selectedElement, "transitionend", function () {
showHighlight(ui.arcListviewSelection, selectedElement);
});
selectedElement.classList.add(classes.SELECTED);
}
};
/**
* Handler for change event
* @method _onChange
* @param {Event} event
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._onChange = function (event) {
var selectedIndex = event.detail.selected,
unselectedIndex = event.detail.unselected,
classList = this._ui.arcListviewSelection.classList;
if (!event.defaultPrevented) {
if (selectedIndex !== undefined) {
this._selectItem(selectedIndex);
} else {
classList.remove(classes.SELECTION_SHOW);
this._state.items[unselectedIndex].element.classList.remove(classes.SELECTED);
}
}
};
/**
* Handler for click event
* @method _onClick
* @param {Event} event
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._onClick = function (event) {
var self = this,
target = event.target,
state = self._state,
li = selectorsUtil.getClosestByTag(target, "li"),
toIndex = state.items.map(function (item) {
return item.element;
}).indexOf(li);
if (toIndex && toIndex !== state.currentIndex) {
self.trigger(events.CHANGE, {
"unselected": state.currentIndex
});
if (toIndex >= 0 && toIndex < state.items.length) {
state.toIndex = toIndex;
}
self._roll();
}
};
prototype._onPageInit = function () {
this._init();
};
prototype._buildArcListviewSelection = function (page) {
// find or add selection for current list element
var arcListviewSelection = page.querySelector(selectors.SELECTION);
if (!arcListviewSelection) {
arcListviewSelection = document.createElement("div");
arcListviewSelection.classList.add(classes.SELECTION);
page.appendChild(arcListviewSelection);
}
return arcListviewSelection;
};
function buildArcListviewCarousel(carousel, count) {
// create carousel
var arcListviewCarousel = document.createElement("div"),
carouselElement,
carouselSeparator,
fragment = document.createDocumentFragment(),
i = 0;
arcListviewCarousel.classList.add(classes.CAROUSEL, classes.PREFIX + count);
for (; i < count + 4; i++) {
carouselElement = document.createElement("ul");
carouselElement.classList.add(classes.CAROUSEL_ITEM);
carouselElement.classList.add(classes.LISTVIEW);
carouselSeparator = document.createElement("ul");
carouselSeparator.classList.add(classes.CAROUSEL_ITEM);
carouselSeparator.classList.add(classes.CAROUSEL_ITEM_SEPARATOR);
carouselSeparator.classList.add(classes.LISTVIEW);
carousel.items[i] = {
carouselSeparator: carouselSeparator,
carouselElement: carouselElement
};
fragment.appendChild(carouselSeparator);
fragment.appendChild(carouselElement);
}
arcListviewCarousel.appendChild(fragment);
return arcListviewCarousel;
}
/**
* Widget build method
* @method _build
* @param {HTMLElement} element
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._build = function (element) {
if (engine.getBinding(element, "Listview")) {
return null;
}
if (engine.getBinding(element, "SnapListview")) {
ns.warn("Can't create Listview on SnapListview element");
return null;
}
return element;
};
/**
* Widget init method
* @method _init
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._init = function () {
var self = this,
element = self.element,
options = self.options,
arcListviewCarousel,
page,
scroller,
ui = self._ui,
carousel = self._carousel,
visibleItemsCount = parseInt(self.options.visibleItems, 10);
// find outer parent elements
page = selectorsUtil.getClosestBySelector(element, selectors.PAGE);
ui.page = page;
scroller = selectorsUtil.getClosestBySelector(element, selectors.SCROLLER);
if (scroller) {
element.classList.add(WIDGET_CLASS, classes.PREFIX + visibleItemsCount);
// find list elements with including group indexes
self._items = slice.call(page.querySelectorAll(selectors.ITEMS)) || [];
arrayUtil.forEach(self._items, function (item) {
var textInputEl = selectorsUtil.getChildrenBySelector(item, selectors.TEXT_INPUT)[0];
if (textInputEl) {
ns.widget.TextInput(textInputEl);
}
});
ui.arcListviewSelection = self._buildArcListviewSelection(page);
arcListviewCarousel = buildArcListviewCarousel(carousel, visibleItemsCount);
ui.arcListviewCarousel = arcListviewCarousel;
// append carousel outside scroller element
scroller.parentElement.appendChild(arcListviewCarousel);
self._ui.arcListviewCarousel.addEventListener("vclick", self, true);
// cache HTML elements
ui.scroller = scroller;
ArcListview.calcFactors(options.ellipsisA, options.ellipsisB);
// init items;
self._setAnimatedItems();
self._scrollAnimationEnd = true;
momentum = 1;
self._refresh();
self._scroll();
self._initBouncingEffect();
}
};
/**
* Event handler for widget
* @param {Event} event
* @method handleEvent
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype.handleEvent = function (event) {
var self = this,
page = self._ui.page;
if (event.type === "pageinit") {
self._onPageInit(event);
} else if (page && page.classList.contains("ui-page-active")) {
// disable events on non active page
switch (event.type) {
case "touchmove" :
self._onTouchMove(event);
break;
case "rotarydetent" :
self._onRotary(event);
break;
case "touchstart" :
self._onTouchStart(event);
break;
case "touchend" :
self._onTouchEnd(event);
break;
case "change" :
self._onChange(event);
break;
case "vclick" :
self._onClick(event);
}
}
};
/**
* Bind event listeners to widget instance
* @method _bindEvents
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._bindEvents = function () {
var self = this,
element = self.element,
page = self._ui.page;
page.addEventListener("touchstart", self, true);
page.addEventListener("touchmove", self, true);
page.addEventListener("touchend", self, true);
page.addEventListener("pageinit", self, true);
if (self._ui.arcListviewCarousel) {
self._ui.arcListviewCarousel.addEventListener("vclick", self, true);
}
document.addEventListener("rotarydetent", self, true);
element.addEventListener("change", self, true);
};
/**
* Binds methods unbound by disableList method
* @method enableList
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype.enableList = function () {
var self = this,
page = self._ui.page;
page.addEventListener("touchstart", self, true);
page.addEventListener("touchmove", self, true);
page.addEventListener("touchend", self, true);
if (self._ui.arcListviewCarousel) {
self._ui.arcListviewCarousel.addEventListener("vclick", self, true);
}
document.addEventListener("rotarydetent", self, true);
}
/**
* Unbind events that can be possibly triggered by the user
* Can be handy while we want to bind these event to the other list
* opened in the popup.
* @method disableList
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype.disableList = function () {
var self = this,
page = self._ui.page;
page.removeEventListener("touchstart", self, true);
page.removeEventListener("touchmove", self, true);
page.removeEventListener("touchend", self, true);
self._ui.arcListviewCarousel.removeEventListener("vclick", self, true);
document.removeEventListener("rotarydetent", self, true);
}
/**
* Remove event listeners from widget instance
* @method _unbindEvents
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._unbindEvents = function () {
var self = this,
element = self.element,
page = self._ui.page;
page.removeEventListener("touchstart", self, true);
page.removeEventListener("touchmove", self, true);
page.removeEventListener("touchend", self, true);
page.removeEventListener("pageinit", self, true);
if (self._ui.arcListviewCarousel) {
self._ui.arcListviewCarousel.removeEventListener("vclick", self, true);
}
document.removeEventListener("rotarydetent", self, true);
element.removeEventListener("change", self, true);
};
/**
* Destroy widget instance
* @method _destroy
* @memberof ns.widget.wearable.ArcListview
* @protected
*/
prototype._destroy = function () {
var self = this,
ui = self._ui,
arcListviewSelection = ui.arcListviewSelection,
arcListviewCarousel = ui.arcListviewCarousel;
self._unbindEvents();
self._items.forEach(function (li) {
self.element.appendChild(li);
li.setAttribute("style", "");
});
self._items = [];
// remove added elements
if (arcListviewSelection && arcListviewSelection.parentElement) {
arcListviewSelection.parentElement.removeChild(arcListviewSelection);
}
if (arcListviewCarousel && arcListviewCarousel.parentElement) {
arcListviewCarousel.parentElement.removeChild(arcListviewCarousel);
}
};
prototype._initBouncingEffect = function () {
var self = this;
self._maxScrollY = self.element.getBoundingClientRect().height - BOTTOM_MARGIN;
self._bouncingEffect = new ns.widget.core.scroller.effect.Bouncing(self._ui.page, {
maxScrollX: 0,
maxScrollY: self._maxScrollY,
orientation: "vertical"
});
};
ArcListview.prototype = prototype;
ns.widget.wearable.ArcListview = ArcListview;
ArcListview.classes = classes;
engine.defineWidget(
"ArcListview",
"." + WIDGET_CLASS,
[],
ArcListview,
"wearable"
);
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define, ns */
/**
* # Listview
* Shows a list view.
*
* The list widget is used to display, for example, navigation data, results, and data entries. The following table describes the supported list classes.
*
* ## Default selectors
*
* Default selector for listview widget is class *ui-listview*.
*
* To add a list widget to the application, use the following code:
*
* ### List with basic items
*
* You can add a basic list widget as follows:
*
* @example
* <ul class="ui-listview">
* <li>1line</li>
* <li>2line</li>
* <li>3line</li>
* <li>4line</li>
* <li>5line</li>
* </ul>
*
* ### List with link items
*
* You can add a list widget with a link and press effect that allows the user to click each list item as follows:
*
* @example
* <ul class="ui-listview">
* <li>
* <a href="#">1line</a>
* </li>
* <li>
* <a href="#">2line</a>
* </li>
* <li>
* <a href="#">3line</a>
* </li>
* <li>
* <a href="#">4line</a>
* </li>
* <li>
* <a href="#">5line</a>
* </li>
* </ul>
*
* ## JavaScript API
*
* Listview widget hasn't JavaScript API.
*
* @class ns.widget.wearable.Listview
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var CoreListview = ns.widget.core.Listview,
ArcListview = ns.widget.wearable.ArcListview,
engine = ns.engine,
_isCircle = ns.support.shape.circle,
ParentClass = _isCircle ? ArcListview : CoreListview,
Listview = function () {
ParentClass.call(this);
},
prototype = new ParentClass();
/**
* Dictionary for listview related events.
* For listview, it is an empty object.
* @property {Object} events
* @member ns.widget.wearable.Listview
* @static
*/
Listview.events = ParentClass.events;
Listview.prototype = prototype;
ns.widget.wearable.Listview = Listview;
engine.defineWidget(
"Listview",
".ui-listview",
[],
Listview,
"wearable",
true
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (ns) {
"use strict";
/** @namespace ns.widget.wearable */
ns.widget.core.indexscrollbar = ns.widget.core.indexscrollbar || {};
}(ns));
/*global define, ns, document, window */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #IndexBar widget
* Widget creates bar with index.
*
* @internal
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @class ns.widget.wearable.indexscrollbar.IndexBar
*/
(function (document, ns) {
"use strict";
var utilsObject = ns.util.object,
utilsDOM = ns.util.DOM;
function IndexBar(element, options) {
this.element = element;
this.options = utilsObject.merge(options, this._options, false);
this.container = this.options.container;
this.indices = {
original: this.options.index,
merged: []
};
this._init();
return this;
}
IndexBar.prototype = {
_options: {
container: null,
offsetLeft: 0,
index: [],
verticalCenter: false,
moreChar: "*",
moreCharLineHeight: 9,
indexHeight: 41,
selectedClass: "ui-state-selected",
ulClass: null,
maxIndexLen: 0
},
_init: function () {
this.indices.original = this.options.index;
this.indexLookupTable = [];
this.indexElements = null;
this.selectedIndex = -1;
this.visiblity = "hidden";
this._setMaxIndexLen();
this._makeMergedIndices();
this._drawDOM();
this._appendToContainer();
if (this.options.verticalCenter) {
this._adjustVerticalCenter();
}
this._setIndexCellInfo();
},
_clear: function () {
while (this.element.firstChild) {
this.element.removeChild(this.element.firstChild);
}
this.indices.merged.length = 0;
this.indexLookupTable.length = 0;
this.indexElements = null;
this.selectedIndex = -1;
this.visiblity = null;
},
/**
* Refreshes widget.
* @method refresh
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
refresh: function () {
this._clear();
this._init();
},
/**
* Destroys widget.
* @method destroy
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
destroy: function () {
this._clear();
},
/**
* Shows widget.
* @method show
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
show: function () {
this.visibility = "visible";
this.element.style.visibility = this.visibility;
},
/**
* Hides widget.
* @method hide
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
hide: function () {
this.visibility = "hidden";
this.element.style.visibility = this.visibility;
},
/**
* Get if the visibility status is shown or not
* @method isShown
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
isShown: function () {
return "visible" === this.visibility;
},
_setMaxIndexLen: function () {
var maxIndexLen,
self = this,
options = self.options,
container = self.container,
indexHeight = options.indexHeight,
containerHeight = container.offsetHeight;
maxIndexLen = Math.floor(containerHeight / indexHeight);
if (maxIndexLen > 0 && maxIndexLen % 2 === 0) {
maxIndexLen -= 1; // Ensure odd number
}
options.maxIndexLen = options.maxIndexLen > 0 ? Math.min(maxIndexLen, options.maxIndexLen) : maxIndexLen;
},
_makeMergedIndices: function () {
var origIndices = this.indices.original,
origIndexLen = origIndices.length,
visibleIndexLen = Math.min(this.options.maxIndexLen, origIndexLen),
totalLeft = origIndexLen - visibleIndexLen,
nIndexPerItem = parseInt(totalLeft / parseInt(visibleIndexLen / 2, 10), 10),
leftItems = totalLeft % parseInt(visibleIndexLen / 2, 10),
indexItemSize = [],
mergedIndices = [],
i,
len,
position = 0;
for (i = 0, len = visibleIndexLen; i < len; i++) {
indexItemSize[i] = 1;
if (i % 2) { // omit even numbers
indexItemSize[i] += nIndexPerItem + (leftItems-- > 0 ? 1 : 0);
}
position += indexItemSize[i];
mergedIndices.push({
start: position - 1,
length: indexItemSize[i]
});
}
this.indices.merged = mergedIndices;
},
_drawDOM: function () {
var origIndices = this.indices.original,
indices = this.indices.merged,
indexLen = indices.length,
indexHeight = this.options.indexHeight,
moreChar = this.options.moreChar,
// Height of the last index is total height - all other indexes
lastElementHeight = this.container.clientHeight - ((indexLen - 1) * indexHeight),
addMoreCharLineHeight = this.options.moreCharLineHeight,
text,
frag,
li,
i,
m;
frag = document.createDocumentFragment();
for (i = 0; i < indexLen; i++) {
m = indices[i];
text = m.length === 1 ? origIndices[m.start] : moreChar;
li = document.createElement("li");
li.innerText = text.toUpperCase();
li.style.height = ((i === indexLen - 1) ? lastElementHeight : indexHeight) + "px";
li.style.lineHeight = text === moreChar ? indexHeight + addMoreCharLineHeight + "px" : indexHeight + "px";
frag.appendChild(li);
}
this.element.appendChild(frag);
if (this.options.ulClass) {
this.element.classList.add(this.options.ulClass);
}
},
_adjustVerticalCenter: function () {
var nItem = this.indices.merged.length,
totalIndexLen = nItem * this.options.indexHeight,
vPadding = parseInt((this.container.offsetHeight - totalIndexLen) / 2, 10);
this.element.style.paddingTop = vPadding + "px";
},
_appendToContainer: function () {
var self = this,
options = self.options,
element = self.element,
container = self.container,
elementStyle = element.style,
divWithMargin = document.createElement("div"),
distanceFromBottom = options.paddingBottom + "px";
container.appendChild(element);
elementStyle.left = options.offsetLeft + "px";
if (options.paddingBottom) {
elementStyle.paddingBottom = distanceFromBottom;
divWithMargin.classList.add("ui-indexscrollbar-margin");
divWithMargin.style.height = distanceFromBottom;
container.appendChild(divWithMargin);
}
},
/**
* Sets padding top for element.
* @method setPaddingTop
* @param {number} paddingTop
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
setPaddingTop: function (paddingTop) {
var height = this.element.clientHeight,
oldPaddingTop = this.element.style.paddingTop,
containerHeight = this.container.clientHeight;
if (oldPaddingTop === "") {
oldPaddingTop = 0;
} else {
oldPaddingTop = parseInt(oldPaddingTop, 10);
}
height = height - oldPaddingTop;
if (height > containerHeight) {
paddingTop -= (paddingTop + height - containerHeight);
}
this.element.style.paddingTop = paddingTop + "px";
this._setIndexCellInfo(); // update index cell info
},
/**
* Returns element's offsetTop of given index.
* @method getOffsetTopByIndex
* @param {number} index
* @return {number}
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
getOffsetTopByIndex: function (index) {
var cellIndex = this.indexLookupTable[index].cellIndex,
el = this.indexElements[cellIndex],
offsetTop = el.offsetTop;
return offsetTop;
},
_setIndexCellInfo: function () {
var element = this.element,
mergedIndices = this.indices.merged,
containerOffsetTop = utilsDOM.getElementOffset(this.container).top,
listItems = this.element.querySelectorAll("LI"),
lookupTable = [];
[].forEach.call(listItems, function (node, idx) {
var m = mergedIndices[idx],
i = m.start,
len = i + m.length,
top = containerOffsetTop + node.offsetTop,
height = node.offsetHeight / m.length;
for (; i < len; i++) {
lookupTable.push({
cellIndex: idx,
top: top,
range: height
});
top += height;
}
});
this.indexLookupTable = lookupTable;
this.indexElements = element.children;
},
/**
* Returns index for given position.
* @method getIndexByPosition
* @param {number} posY
* @return {number}
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
getIndexByPosition: function (posY) {
var table = this.indexLookupTable,
info,
i,
len,
range;
// boundary check
if (table[0]) {
info = table[0];
if (posY < info.top) {
return 0;
}
}
if (table[table.length - 1]) {
info = table[table.length - 1];
if (posY >= info.top + info.range) {
return table.length - 1;
}
}
for (i = 0, len = table.length; i < len; i++) {
info = table[i];
range = posY - info.top;
if (range >= 0 && range < info.range) {
return i;
}
}
return 0;
},
/**
* Returns value for given index.
* @method getValueByIndex
* @param {number} idx
* @return {number}
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
getValueByIndex: function (idx) {
if (idx < 0) {
idx = 0;
}
return this.indices.original[idx];
},
/**
* Select given index
* @method select
* @param {number} idx
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
select: function (idx) {
var cellIndex,
eCell;
this.clearSelected();
if (this.selectedIndex === idx) {
return;
}
this.selectedIndex = idx;
cellIndex = this.indexLookupTable[idx].cellIndex;
eCell = this.indexElements[cellIndex];
eCell.classList.add(this.options.selectedClass);
},
/**
* Clears selected class.
* @method clearSelected
* @member ns.widget.wearable.indexscrollbar.IndexBar
*/
clearSelected: function () {
var el = this.element,
selectedClass = this.options.selectedClass,
selectedElement = el.querySelectorAll("." + selectedClass);
[].forEach.call(selectedElement, function (node) {
node.classList.remove(selectedClass);
});
this.selectedIndex = -1;
}
};
ns.widget.core.indexscrollbar.IndexBar = IndexBar;
}(window.document, ns));
/*global define, ns, document, window */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #IndexIndicator widget
* Class creates index indicator.
*
* @internal
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @class ns.widget.wearable.indexscrollbar.IndexIndicator
*/
(function (document, ns) {
"use strict";
var utilsObject = ns.util.object,
events = ns.event;
/**
* block 'unexpected bouncing effect' on indexscroller indicator.
* @param {Event} event
*/
function blockEvent(event) {
event.preventDefault();
event.stopPropagation();
}
function IndexIndicator(element, options) {
this.element = element;
this.options = utilsObject.merge(options, this._options, false);
this.value = null;
this._init();
return this;
}
IndexIndicator.prototype = {
_options: {
className: "ui-indexscrollbar-indicator",
selectedClass: "ui-selected",
alignTo: "container",
container: null
},
_init: function () {
var self = this,
options = self.options,
element = self.element;
element.className = options.className;
element.innerHTML = "<span></span>";
events.on(element, ["touchstart", "touchmove"], blockEvent, false);
// Add to DOM tree
options.referenceElement.parentNode.insertBefore(element, options.referenceElement);
self.fitToContainer();
},
/**
* Fits size to container.
* @method fitToContainer
* @param {HTMLElement} alignTo align indicator position relative to particular element
* @member ns.widget.wearable.indexscrollbar.IndexIndicator
*/
fitToContainer: function (alignTo) {
var self = this,
element = self.element,
style = element.style,
options = self.options,
container = options.container,
containerRect = container.getBoundingClientRect();
alignTo = alignTo || options.alignTo;
style.width = containerRect.width + "px";
if (alignTo === "container") {
style.height = containerRect.height + "px";
} else {
style.height = (containerRect.height + containerRect.top) + "px";
}
style.top = ((alignTo === "container") ? containerRect.top : 0) + "px";
style.left = containerRect.left + "px";
},
/**
* Sets value of widget.
* @method setValue
* @param {string} value
* @member ns.widget.wearable.indexscrollbar.IndexIndicator
*/
setValue: function (value) {
var selected = "",
remained = "";
this.value = value; // remember value
value = value.toUpperCase();
selected = value.substr(value.length - 1);
remained = value.substr(0, value.length - 1);
this.element.firstChild.innerHTML = "<span>" + remained + "</span><span class=\"ui-selected\">" +
selected + "</span>"; // Set indicator text
},
/**
* Shows widget.
* @method show
* @member ns.widget.wearable.indexscrollbar.IndexIndicator
*/
show: function () {
//this.element.style.visibility="visible";
this.element.style.display = "block";
},
/**
* Hides widget.
* @method hide
* @member ns.widget.wearable.indexscrollbar.IndexIndicator
*/
hide: function () {
this.element.style.display = "none";
},
/**
* Destroys widget.
* @method destroy
* @member ns.widget.wearable.indexscrollbar.IndexIndicator
*/
destroy: function () {
var element = this.element;
while (element.firstChild) {
element.removeChild(element.firstChild);
}
events.off(element, ["touchstart", "touchmove"], blockEvent, false);
this.element = null; // unreference element
}
};
ns.widget.core.indexscrollbar.IndexIndicator = IndexIndicator;
}(window.document, ns));
/*global define, ns, document, window */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* #Index Scrollbar
* Shows an index scroll bar with indices, usually for the list.
*
* The index scroll bar widget shows on the screen a scrollbar with indices,
* and fires a select event when the index characters are clicked.
* The following table describes the supported index scroll bar APIs.
*
* ## Manual constructor
* For manual creation of widget you can use constructor of widget from **tau** namespace:
*
* @example
* var indexscrollbarElement = document.getElementById('indexscrollbar'),
* indexscrollbar = tau.widget.IndexScrollbar(IndexScrollbar, {index: "A,B,C"});
*
* Constructor has one require parameter **element** which are base **HTMLElement** to create widget.
* We recommend get this element by method *document.getElementById*. Second parameter is **options**
* and it is a object with options for widget.
*
* To add an IndexScrollbar widget to the application, use the following code:
*
* @example
* <div id="foo" class="ui-indexscrollbar" data-index="A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z"></div>
* <script>
* (function() {
* var elem = document.getElementById("foo");
* tau.widget.IndexScrollbar(elem);
* elem.addEventListener("select", function( event ) {
* var index = event.detail.index;
* console.log(index);
* });
* }());
* </script>
*
* The index value can be retrieved by accessing event.detail.index property.
*
* In the following example, the list scrolls to the position of the list item defined using
* the li-divider class, selected by the index scroll bar:
*
* @example
* <div id="pageIndexScrollbar" class="ui-page">
* <header class="ui-header">
* <h2 class="ui-title">IndexScrollbar</h2>
* </header>
* <section class="ui-content">
* <div style="overflow-y:scroll;">
* <div id="indexscrollbar1"
* class="ui-indexscrollbar"
* data-index="A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z">
* </div>
* <ul class="ui-listview" id="list1">
* <li class="li-divider">A</li>
* <li>Anton</li>
* <li>Arabella</li>
* <li>Art</li>
* <li class="li-divider">B</li>
* <li>Barry</li>
* <li>Bibi</li>
* <li>Billy</li>
* <li>Bob</li>
* <li class="li-divider">D</li>
* <li>Daisy</li>
* <li>Derek</li>
* <li>Desmond</li>
* </ul>
* </div>
* </section>
* <script>
* (function () {
* var page = document.getElementById("pageIndexScrollbar");
* page.addEventListener("pagecreate", function () {
* var elem = document.getElementById("indexscrollbar1"), // Index scroll bar element
* elList = document.getElementById("list1"), // List element
* elDividers = elList.getElementsByClassName("li-divider"), // List items (dividers)
* elScroller = elList.parentElement, // List's parent item (overflow-y:scroll)
* dividers = {}, // Collection of list dividers
* indices = [], // List of index
* elDivider,
* i, idx;
*
* // For all list dividers
* for (i = 0; i < elDividers.length; i++) {
* // Add the list divider elements to the collection
* elDivider = elDividers[i];
* // li element having the li-divider class
* idx = elDivider.innerText;
* // Get a text (index value)
* dividers[idx] = elDivider;
* // Remember the element
*
* // Add the index to the index list
* indices.push(idx);
* }
*
* // Change the data-index attribute to the indexscrollbar element
* // before initializing IndexScrollbar widget
* elem.setAttribute("data-index", indices.join(","));
*
* // Create index scroll bar
* tau.IndexScrollbar(elem);
*
* // Bind the select callback
* elem.addEventListener("select", function (ev) {
* var elDivider,
* idx = ev.detail.index;
* elDivider = dividers[idx];
* if (elDivider) {
* // Scroll to the li-divider element
* elScroller.scrollTop = elDivider.offsetTop - elScroller.offsetTop;
* }
* });
* });
* }());
* </script>
* </div>
*
* The following example uses the supplementScroll argument, which shows a level 2 index scroll bar.
* The application code must contain a level 2 index array for each level 1 index character.
* The example shows a way to analyze list items and create a dictionary (secondIndex) for level 1
* indices for the index scroll bar, and a dictionary (keyItem) for moving list items at runtime:
*
* @example
* <div id="indexscrollbar2" class="ui-indexscrollbar"
* data-index="A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z">
* </div>
* <ul class="ui-listview" id="iBar2_list2">
* <li>Anton</li>
* <li>Arabella</li>
* <li>Art</li>
* <li>Barry</li>
* <li>Bibi</li>
* <li>Billy</li>
* <li>Bob</li>
* <li>Carry</li>
* <li>Cibi</li>
* <li>Daisy</li>
* <li>Derek</li>
* <li>Desmond</li>
* </ul>
*
* <script>
* (function () {
* var page = document.getElementById("pageIndexScrollbar2"),
* isb,
* index = [],
* supIndex = {},
* elIndex = {};
* page.addEventListener("pageshow", function () {
* var elisb = document.getElementById("indexscrollbar2"),
* elList = document.getElementById("iBar2_list2"), // List element
* elItems = elList.children,
* elScroller = elList.parentElement, // Scroller (overflow-y:hidden)
* indexData = getIndexData(
* {
* array: elItems,
* getTextValue: function (array, i) {
* return array[i].innerText;
* }
* });
*
* function getIndexData(options) {
* var array = options.array,
* getTextValue = options.getTextValue,
* item,
* text,
* firstIndex = [],
* secondIndex = {},
* keyItem = {},
* c1 = null,
* c2 = null,
* i;
*
* for (i = 0; i < array.length; i++) {
* item = array[i];
* text = getTextValue(array, i);
* if (text.length > 0) {
* if (!c1 || c1 !== text[0]) {
* // New c1
* c1 = text[0];
* firstIndex.push(c1);
* keyItem[c1] = item;
* secondIndex[c1] = [];
* c2 = text[1];
* if (c2) {
* secondIndex[c1].push(c2);
* }
* else {
* c2 = '';
* }
* keyItem[c1 + c2] = item;
* }
* else {
* // Existing c1
* if (c2 !== text[1]) {
* c2 = text[1];
* secondIndex[c1].push(c2);
* keyItem[c1 + c2] = item;
* }
* }
* }
* }
* return {
* firstIndex: firstIndex,
* secondIndex: secondIndex,
* keyItem: keyItem
* };
* }
*
* // Update the data-index attribute to the indexscrollbar element, with the index list above
* elisb.setAttribute("data-index", indexData.firstIndex);
* // Create IndexScrollbar
* isb = new tau.IndexScrollbar(elisb, {
* index: indexData.firstIndex,
* supplementaryIndex: function (firstIndex) {
* return indexData.secondIndex[firstIndex];
* }
* });
* // Bind the select callback
* elisb.addEventListener("select", function (ev) {
* var el,
* index = ev.detail.index;
* el = indexData.keyItem[index];
* if (el) {
* // Scroll to the li-divider element
* elScroller.scrollTop = el.offsetTop - elScroller.offsetTop;
* }
* });
* });
* page.addEventListener("pagehide", function () {
* console.log('isb2:destroy');
* isb.destroy();
* index.length = 0;
* supIndex = {};
* elIndex = {};
* });
* }());
* </script>
*
* ##Options for widget
*
* Options for widget can be defined as _data-..._ attributes or give as parameter in constructor.
*
* You can change option for widget using method **option**.
*
* ##Methods
*
* To call method on widget you can use tau API:
*
* First API is from tau namespace:
*
* @example
* var indexscrollbarElement = document.getElementById('indexscrollbar'),
* indexscrollbar = tau.widget.IndexScrollbar(indexscrollbarElement);
*
* indexscrollbar.methodName(methodArgument1, methodArgument2, ...);
*
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Jadwiga Sosnowska <j.sosnowska@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
* @class ns.widget.core.IndexScrollbar
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var IndexScrollbar = function () {
var self = this;// Support calling without 'new' keyword
self.indicator = null;
self.indexBar1 = null; // First IndexBar. Always shown.
self.indexBar2 = null; // 2-depth IndexBar. shown if needed.
self._ui = {};
self.index = null;
self.touchAreaOffsetLeft = 0;
self.indexElements = null;
self.selectEventTriggerTimeoutId = null;
self.ulMarginTop = 0;
self.eventHandlers = {};
},
BaseWidget = ns.widget.BaseWidget,
/**
* Alias for class {@link ns.event}
* @property {Object} events
* @member ns.widget.core.IndexScrollbar
* @private
* @static
*/
events = ns.event,
selectors = ns.util.selectors,
/**
* Alias for class {@link ns.util.object}
* @property {Object} utilsObject
* @member ns.widget.core.IndexScrollbar
* @private
* @static
*/
utilsObject = ns.util.object,
/**
* Alias for class ns.util.DOM
* @property {ns.util.DOM} doms
* @member ns.widget.wearable.IndexScrollbar
* @private
* @static
*/
doms = ns.util.DOM,
IndexBar = ns.widget.core.indexscrollbar.IndexBar,
IndexIndicator = ns.widget.core.indexscrollbar.IndexIndicator,
Page = ns.widget.core.Page,
pageSelector = ns.engine.getWidgetDefinition("Page").selector,
EventType = {
/**
* Event triggered after select index by user
* @event select
* @member ns.widget.core.IndexScrollbar
*/
SELECT: "select"
},
POINTER_START = "vmousedown",
POINTER_MOVE = "vmousemove",
POINTER_END = "vmouseup",
pointerIsPressed = false,
prototype = new BaseWidget();
IndexScrollbar.prototype = prototype;
utilsObject.merge(prototype, {
widgetName: "IndexScrollbar",
widgetClass: "ui-indexscrollbar",
_configure: function () {
/**
* All possible widget options
* @property {Object} options
* @property {string} [options.moreChar="*"] more character
* @property {string} [options.selectedClass="ui-state-selected"] disabled class name
* @property {string} [options.delimiter=","] delimiter in index
* @property {string|Array} [options.index=["A","B","C","D","E","F","G","H","I",
* "J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z","1"]]
* String with list of letters separate be delimiter or array of letters
* @property {boolean} [options.maxIndexLen=0]
* @property {boolean} [options.indexHeight=41]
* @property {boolean} [options.keepSelectEventDelay=50]
* @property {?boolean} [options.container=null]
* @property {?boolean} [options.supplementaryIndex=null]
* @property {number} [options.supplementaryIndexMargin=1]
* @member ns.widget.core.IndexScrollbar
*/
this.options = {
moreChar: "*",
indexScrollbarClass: "ui-indexscrollbar",
selectedClass: "ui-state-selected",
indicatorClass: "ui-indexscrollbar-indicator",
delimiter: ",",
index: [
"A", "B", "C", "D", "E", "F", "G", "H",
"I", "J", "K", "L", "M", "N", "O", "P", "Q",
"R", "S", "T", "U", "V", "W", "X", "Y", "Z", "1"
],
maxIndexLen: 0,
indexHeight: 41,
keepSelectEventDelay: 50,
container: null,
supplementaryIndex: null,
supplementaryIndexMargin: 1,
moreCharLineHeight: 9,
verticalCenter: true,
indicatorAlignTo: "container"
};
},
/**
* This method builds widget.
* @method _build
* @protected
* @param {HTMLElement} element
* @return {HTMLElement}
* @member ns.widget.core.IndexScrollbar
*/
_build: function (element) {
return element;
},
/**
* This method inits widget.
* @method _init
* @protected
* @param {HTMLElement} element
* @return {HTMLElement}
* @member ns.widget.core.IndexScrollbar
*/
_init: function (element) {
var self = this,
options = self.options;
element.classList.add(options.indexScrollbarClass);
self._ui.page = selectors.getClosestBySelector(element, pageSelector);
self._setIndex(element, options.index);
self._setMaxIndexLen(element, options.maxIndexLen);
self._setInitialLayout(); // This is needed for creating sub objects
self._createSubObjects();
self._updateLayout();
// Mark as extended
self._extended(true);
return element;
},
/**
* This method refreshes widget.
* @method _refresh
* @protected
* @return {HTMLElement}
* @member ns.widget.core.IndexScrollbar
*/
_refresh: function () {
var self = this;
if (self._isExtended()) {
self._unbindEvent();
self.indicator.hide();
self._extended(false);
}
self._updateLayout();
self.indexBar1.options.index = self.options.index;
self.indexBar1.refresh();
self.indicator.fitToContainer();
self._bindEvents();
self._extended(true);
},
/**
* This method destroys widget.
* @method _destroy
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_destroy: function () {
var self = this;
if (self.isBound()) {
self._unbindEvent();
self._extended(false);
self._destroySubObjects();
self.indicator = null;
self.index = null;
self.eventHandlers = {};
}
},
/**
* This method creates indexBar1 and indicator in the indexScrollbar
* @method _createSubObjects
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_createSubObjects: function () {
var self = this,
options = self.options,
element = self.element;
// indexBar1
self.indexBar1 = new IndexBar(document.createElement("UL"), {
container: element,
offsetLeft: 0,
index: options.index,
verticalCenter: options.verticalCenter,
indexHeight: options.indexHeight,
maxIndexLen: options.maxIndexLen,
paddingBottom: options.paddingBottom,
moreCharLineHeight: options.moreCharLineHeight
});
// indexBar2
if (typeof options.supplementaryIndex === "function") {
self.indexBar2 = new IndexBar(document.createElement("UL"), {
container: element,
offsetLeft: -element.clientWidth - options.supplementaryIndexMargin,
index: [], // empty index
indexHeight: options.indexHeight,
ulClass: "ui-indexscrollbar-supplementary"
});
self.indexBar2.hide();
}
// indicator
self.indicator = new IndexIndicator(document.createElement("DIV"), {
container: self._getContainer(),
referenceElement: self.element,
className: options.indicatorClass,
alignTo: options.indicatorAlignTo
});
},
/**
* This method destroys sub-elements: index bars and indicator.
* @method _destroySubObjects
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_destroySubObjects: function () {
var subObjs = {
iBar1: this.indexBar1,
iBar2: this.indexBar2,
indicator: this.indicator
},
subObj,
el,
i;
for (i in subObjs) {
if (subObjs.hasOwnProperty(i)) {
subObj = subObjs[i];
if (subObj) {
el = subObj.element;
subObj.destroy();
el.parentNode.removeChild(el);
}
}
}
},
/**
* This method sets initial layout.
* @method _setInitialLayout
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_setInitialLayout: function () {
var indexScrollbar = this.element,
container = this._getContainer(),
containerPosition = window.getComputedStyle(container).position,
indexScrollbarStyle = indexScrollbar.style;
// Set the indexScrollbar's position, if needed
if (containerPosition !== "absolute" && containerPosition !== "relative") {
indexScrollbarStyle.top = container.offsetTop + "px";
indexScrollbarStyle.height = container.offsetHeight + "px";
}
},
/**
* This method calculates maximum index length.
* @method _setMaxIndexLen
* @protected
* @param {HTMLElement} element
* @param {number} value
* @member ns.widget.core.IndexScrollbar
*/
_setMaxIndexLen: function (element, value) {
var self = this,
options = self.options,
container = self._getContainer(),
containerHeight = container.offsetHeight;
if (value <= 0) {
value = Math.floor(containerHeight / options.indexHeight);
}
if (value > 0 && value % 2 === 0) {
value -= 1; // Ensure odd number
}
options.maxIndexLen = value;
},
/**
* This method updates layout.
* @method _updateLayout
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_updateLayout: function () {
var self = this;
self._setInitialLayout();
self._draw();
self.touchAreaOffsetLeft = self.element.offsetLeft - 10;
},
/**
* This method draws additional sub-elements
* @method _draw
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_draw: function () {
this.indexBar1.show();
return this;
},
/**
* This method removes indicator.
* @method _removeIndicator
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_removeIndicator: function () {
var indicator = this.indicator,
parentElem = indicator.element.parentNode;
parentElem.removeChild(indicator.element);
indicator.destroy();
this.indicator = null;
},
/**
* This method returns the receiver of event by position.
* @method _getEventReceiverByPosition
* @param {number} posX The position relative to the left edge of the document.
* @return {?ns.widget.core.indexscrollbar.IndexBar} Receiver of event
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_getEventReceiverByPosition: function (posX) {
var windowWidth = window.innerWidth,
elementWidth = this.element.clientWidth,
receiver;
if (this.options.supplementaryIndex) {
if (windowWidth - elementWidth <= posX && posX <= windowWidth) {
receiver = this.indexBar1;
} else {
receiver = this.indexBar2;
}
} else {
receiver = this.indexBar1;
}
return receiver;
},
/**
* This method updates indicator.
* It sets new value of indicator and triggers event "select".
* @method _updateIndicatorAndTriggerEvent
* @param {number} val The value of indicator
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_updateIndicatorAndTriggerEvent: function (val) {
this.indicator.setValue(val);
this.indicator.show();
if (this.selectEventTriggerTimeoutId) {
window.clearTimeout(this.selectEventTriggerTimeoutId);
}
this.selectEventTriggerTimeoutId = window.setTimeout(function () {
this.trigger(EventType.SELECT, {index: val});
this.selectEventTriggerTimeoutId = null;
}.bind(this), this.options.keepSelectEventDelay);
},
/**
* This method is executed on event "touchstart"
* @method _onTouchStartHandler
* @param {Event} event Event
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_onTouchStartHandler: function (event) {
var touches = event.touches || event._originalEvent && event._originalEvent.touches,
pos = null,
// At touchstart, only indexBar1 is shown.
iBar1 = null,
idx = 0,
val = 0;
pointerIsPressed = true;
if (touches && (touches.length > 1)) {
event.preventDefault();
event.stopPropagation();
return;
}
pos = this._getPositionFromEvent(event);
// At touchstart, only indexBar1 is shown.
iBar1 = this.indexBar1;
idx = iBar1.getIndexByPosition(pos.y);
val = iBar1.getValueByIndex(idx);
iBar1.select(idx); // highlight selected value
document.addEventListener(POINTER_MOVE, this.eventHandlers.touchMove);
document.addEventListener(POINTER_END, this.eventHandlers.touchEnd);
document.addEventListener("touchcancel", this.eventHandlers.touchEnd);
this._updateIndicatorAndTriggerEvent(val);
},
/**
* This method is executed on event "touchmove"
* @method _onTouchMoveHandler
* @param {Event} event Event
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_onTouchMoveHandler: function (event) {
var touches = event._originalEvent && event._originalEvent.touches,
pos = null,
iBar1 = null,
iBar2 = null,
idx,
iBar,
val;
if (touches && (touches.length > 1) || !pointerIsPressed) {
events.preventDefault(event);
events.stopPropagation(event);
return;
}
pos = this._getPositionFromEvent(event);
iBar1 = this.indexBar1;
iBar2 = this.indexBar2;
// Check event receiver: iBar1 or iBar2
iBar = this._getEventReceiverByPosition(pos.x);
if (iBar === iBar2) {
iBar2.options.index = this.options.supplementaryIndex(iBar1.getValueByIndex(iBar1.selectedIndex));
iBar2.refresh();
}
// get index and value from iBar1 or iBar2
idx = iBar.getIndexByPosition(pos.y);
val = iBar.getValueByIndex(idx);
if (iBar === iBar2) {
// Update val to make a concatenated string for indexIndicator
val = iBar1.getValueByIndex(iBar1.selectedIndex) + val;
} else if (iBar2 && !iBar2.isShown()) {
// iBar1 is selected.
// Set iBar2's paddingTop, only when the iBar2 isn't shown
iBar2.setPaddingTop(iBar1.getOffsetTopByIndex(iBar1.selectedIndex));
}
// update iBars
iBar.select(idx); // highlight selected value
iBar.show();
if (iBar1 === iBar && iBar2) {
iBar2.hide();
}
// update indicator
this._updateIndicatorAndTriggerEvent(val);
events.preventDefault(event);
events.stopPropagation(event);
},
/**
* This method is executed on event "touchend"
* @method _onTouchEndHandler
* @param {Event} event Event
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_onTouchEndHandler: function (event) {
var self = this,
touches = event._originalEvent && event._originalEvent.touches;
if (touches && (touches.length === 0) || !touches) {
pointerIsPressed = false;
}
self.indicator.hide();
self.indexBar1.clearSelected();
if (self.indexBar2) {
self.indexBar2.clearSelected();
self.indexBar2.hide();
}
document.removeEventListener(POINTER_MOVE, self.eventHandlers.touchMove);
document.removeEventListener(POINTER_END, self.eventHandlers.touchEnd);
document.removeEventListener("touchcancel", self.eventHandlers.touchEnd);
},
_bindOnPageShow: function () {
var self = this;
self.eventHandlers.onPageShow = self.refresh.bind(self);
if (self._ui.page) {
self._ui.page.addEventListener(Page.events.BEFORE_SHOW, self.eventHandlers.onPageShow, false);
}
},
_unbindOnPageShow: function () {
var self = this;
if (self.eventHandlers.onPageShow && self._ui.page) {
self._ui.page.removeEventListener(Page.events.BEFORE_SHOW, self.eventHandlers.onPageShow, false);
}
},
/**
* This method binds events to widget.
* @method _bindEvents
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_bindEvents: function () {
var self = this;
self._bindResizeEvent();
self._bindEventToTriggerSelectEvent();
self._bindOnPageShow();
},
/**
* This method unbinds events to widget.
* @method _unbindEvent
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_unbindEvent: function () {
var self = this;
self._unbindResizeEvent();
self._unbindEventToTriggerSelectEvent();
self._unbindOnPageShow();
},
/**
* This method binds event "resize".
* @method _bindResizeEvent
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_bindResizeEvent: function () {
this.eventHandlers.onresize = function (/* ev */) {
this.refresh();
}.bind(this);
window.addEventListener("resize", this.eventHandlers.onresize);
},
/**
* This method unbinds event "resize".
* @method _bindResizeEvent
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_unbindResizeEvent: function () {
if (this.eventHandlers.onresize) {
window.removeEventListener("resize", this.eventHandlers.onresize);
}
},
/**
* This method binds touch events.
* @method _bindEventToTriggerSelectEvent
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_bindEventToTriggerSelectEvent: function () {
var self = this;
self.eventHandlers.touchStart = self._onTouchStartHandler.bind(self);
self.eventHandlers.touchEnd = self._onTouchEndHandler.bind(self);
self.eventHandlers.touchMove = self._onTouchMoveHandler.bind(self);
self.element.addEventListener(POINTER_START, self.eventHandlers.touchStart);
},
/**
* This method unbinds touch events.
* @method _unbindEventToTriggerSelectEvent
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_unbindEventToTriggerSelectEvent: function () {
var self = this;
self.element.removeEventListener(POINTER_START, self.eventHandlers.touchStart);
},
/**
* This method sets or gets data from widget.
* @method _data
* @param {string|Object} key
* @param {*} val
* @return {*} Return value of data or widget's object
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_data: function (key, val) {
var el = this.element,
d = el.__data,
idx;
if (!d) {
d = el.__data = {};
}
if (typeof key === "object") {
// Support data collection
for (idx in key) {
if (key.hasOwnProperty(idx)) {
this._data(idx, key[idx]);
}
}
return this;
} else {
if ("undefined" === typeof val) { // Getter
return d[key];
} else { // Setter
d[key] = val;
return this;
}
}
},
/**
* This method checks if element is valid element of widget IndexScrollbar.
* @method _isValidElement
* @param {HTMLElement} el
* @return {boolean} True, if element is valid.
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_isValidElement: function (el) {
return el.classList.contains(this.widgetClass);
},
/**
* This method checks if widget is extended.
* @method _isExtended
* @return {boolean} True, if element is extended.
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_isExtended: function () {
return !!this._data("extended");
},
/**
* This method sets value of "extended" to widget.
* @method _extended
* @param {boolean} flag Value for extended
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_extended: function (flag) {
this._data("extended", flag);
return this;
},
/**
* This method gets indices prepared from parameter
* or index of widget.
* @method _setIndex
* @param {HTMLElement} element element
* @param {string} value Indices to prepared
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_setIndex: function (element, value) {
var options = this.options;
if (typeof value === "string") {
value = value.split(options.delimiter); // delimiter
}
options.index = value;
},
/**
* This method gets offset of element.
* @method _getOffset
* @param {HTMLElement} el Element
* @return {Object} Offset with "top" and "left" properties
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_getOffset: function (el) {
var left = 0,
top = 0;
do {
top += el.offsetTop;
left += el.offsetLeft;
el = el.offsetParent;
} while (el);
return {
top: top,
left: left
};
},
/**
* This method returns container of widget.
* @method _getContainer
* @return {HTMLElement} Container
* @protected
* @member ns.widget.core.IndexScrollbar
*/
_getContainer: function () {
var container = this.options.container,
element = this.element,
parentElement = element.parentNode,
overflow;
if (!container) {
while (parentElement && parentElement !== document.body) {
overflow = doms.getCSSProperty(parentElement, "overflow-y");
if (overflow === "scroll" || (overflow === "auto" && parentElement.scrollHeight > parentElement.clientHeight)) {
return parentElement;
}
parentElement = parentElement.parentNode;
}
container = element.parentNode;
}
return container || element.parentNode;
},
/**
* Returns position of event.
* @method _getPositionFromEvent
* @return {Object} Position of event with properties "x" and "y"
* @protected
* @param {Event} ev
* @member ns.widget.core.IndexScrollbar
*/
_getPositionFromEvent: function (ev) {
return ev.type.search(/^touch/) !== -1 ?
{x: ev.touches[0].clientX, y: ev.touches[0].clientY} :
{x: ev.clientX, y: ev.clientY};
},
/**
* Adds event listener to element of widget.
* @method addEventListener
* @param {string} type Name of event
* @param {Function} listener Function to be executed
* @member ns.widget.core.IndexScrollbar
*/
addEventListener: function (type, listener) {
this.element.addEventListener(type, listener);
},
/**
* Removes event listener from element of widget.
* @method removeEventListener
* @param {string} type Name of event
* @param {Function} listener Function to be removed
* @member ns.widget.core.IndexScrollbar
*/
removeEventListener: function (type, listener) {
this.element.removeEventListener(type, listener);
}
});
// definition
ns.widget.core.IndexScrollbar = IndexScrollbar;
}(window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/*
* #Index scroll bar
* Shows an index scroll bar with indices, usually for the list.
*
* @class ns.widget.wearable.IndexScrollbar
* @extends ns.widget.core.IndexScrollbar
* @since 2.0
*/
(function (document, ns) {
"use strict";
var engine = ns.engine,
CoreIndexScrollbar = ns.widget.core.IndexScrollbar,
prototype = new CoreIndexScrollbar(),
IndexScrollbar = function () {
CoreIndexScrollbar.call(this);
};
// definition
IndexScrollbar.prototype = prototype;
ns.widget.wearable.IndexScrollbar = IndexScrollbar;
engine.defineWidget(
"IndexScrollbar",
".ui-indexscrollbar",
[],
IndexScrollbar,
"wearable"
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # Circular index scroll bar
* Shows a circular index scroll bar which uses rotary.
*
* The circularindexscrollbar component shows on the screen a circularscrollbar with indices.
* The indices can be selected by moving the rotary.
* And it fires a select event when the index characters are selected.
*
* ## Manual constructor
* For manual creation of UI Component you can use constructor of component from **tau** namespace:
*
* @example
* var circularIndexElement = document.getElementById('circularIndex'),
* circularIndexscrollbar = tau.widget.CircularIndexScrollbar(circularIndexElement, {index: "A,B,C"});
*
* Constructor has one require parameter **element** which are base **HTMLElement** to create component.
* We recommend get this element by method *document.getElementById*. Second parameter is **options**
* and it is a object with options for component.
*
* To add an CircularIndexScrollbar component to the application, use the following code:
*
* @example
* <div id="foo" class="ui-circularindexscrollbar" data-index="A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z"></div>
* <script>
* (function() {
* var elem = document.getElementById("foo");
* tau.widget.CircularIndexScrollbar(elem);
* elem.addEventListener("select", function( event ) {
* var index = event.detail.index;
* console.log(index);
* });
* }());
* </script>
*
* The index value can be retrieved by accessing event.detail.index property.
*
* In the following example, the list scrolls to the position of the list item defined using
* the li-divider class, selected by the circularindexscrollbar:
*
* @example
* <div id="pageCircularIndexScrollbar" class="ui-page">
* <header class="ui-header">
* <h2 class="ui-title">CircularIndexScrollbar</h2>
* </header>
* <div id="circularindexscrollbar"class="ui-circularindexscrollbar" data-index="A,B,C,D,E"></div>
* <section class="ui-content">
* <ul class="ui-listview" id="list1">
* <li class="li-divider">A</li>
* <li>Anton</li>
* <li>Arabella</li>
* <li>Art</li>
* <li class="li-divider">B</li>
* <li>Barry</li>
* <li>Bibi</li>
* <li>Billy</li>
* <li>Bob</li>
* <li class="li-divider">D</li>
* <li>Daisy</li>
* <li>Derek</li>
* <li>Desmond</li>
* </ul>
* </section>
* <script>
* (function () {
* var page = document.getElementById("pageIndexScrollbar"),
circularIndexScrollbar;
* page.addEventListener("pagecreate", function () {
* var elisb = document.getElementById("circularindexscrollbar"), // circularIndexScrollbar element
* elList = document.getElementById("list1"), // List element
* elDividers = elList.getElementsByClassName("li-divider"), // List items (dividers)
* elScroller = elList.parentElement, // List's parent item
* dividers = {}, // Collection of list dividers
* indices = [], // List of index
* elDivider,
* i, idx;
*
* // For all list dividers
* for (i = 0; i < elDividers.length; i++) {
* // Add the list divider elements to the collection
* elDivider = elDividers[i];
* // li element having the li-divider class
* idx = elDivider.innerText;
* // Get a text (index value)
* dividers[idx] = elDivider;
* // Remember the element
*
* // Add the index to the index list
* indices.push(idx);
* }
*
* // Create CircularIndexScrollbar
* circularIndexScrollbar = new tau.widget.CircularIndexScrollbar(elisb, {index: indices});
*
* // Bind the select callback
* elisb.addEventListener("select", function (ev) {
* var elDivider,
* idx = ev.detail.index;
* elDivider = dividers[idx];
* if (elDivider) {
* // Scroll to the li-divider element
* elScroller.scrollTop = elDivider.offsetTop - elScroller.offsetTop;
* }
* });
* });
* }());
* </script>
* </div>
*
* @author Junyoung Park <jy-.park@samsung.com>
* @author Hagun Kim <hagun.kim@samsung.com>
* @class ns.widget.wearable.CircularIndexScrollbar
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
utilsEvents = ns.event,
eventTrigger = utilsEvents.trigger,
prototype = new BaseWidget(),
CircularIndexScrollbar = function () {
this._phase = null;
this._tid = {
phaseOne: 0,
phaseThree: 0
};
this._detent = {
phaseOne: 0
};
this.options = {};
this._activeIndex = 0;
},
rotaryDirection = {
// right rotary direction
CW: "CW",
// left rotary direction
CCW: "CCW"
},
EventType = {
/**
* Event triggered after select index by user
* @event select
* @member ns.widget.wearable.CircularIndexScrollbar
*/
SELECT: "select"
},
classes = {
INDEXSCROLLBAR: "ui-circularindexscrollbar",
INDICATOR: "ui-circularindexscrollbar-indicator",
INDICATOR_TEXT: "ui-circularindexscrollbar-indicator-text",
SHOW: "ui-circularindexscrollbar-show"
};
CircularIndexScrollbar.prototype = prototype;
/**
* This method configure component.
* @method _configure
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._configure = function () {
/**
* All possible component options
* @property {Object} options
* @property {string} [options.delimiter=","] delimiter in index
* @property {string|Array} [options.index=["A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z","1"]] indices list
* String with list of letters separate be delimiter or array of letters
* @property {number} [options.maxVisibleIndex=30] maximum length of visible indices
* @property {number} [options.duration=500] duration of show/hide animation time
* @member ns.widget.wearable.CircularIndexScrollbar
*/
this.options = {
delimiter: ",",
index: [
"A", "B", "C", "D", "E", "F", "G", "H",
"I", "J", "K", "L", "M", "N", "O", "P", "Q",
"R", "S", "T", "U", "V", "W", "X", "Y", "Z", "1"
]
};
};
/**
* This method build component.
* @method _build
* @protected
* @param {HTMLElement} element
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._build = function (element) {
var indicator,
indicatorText;
indicator = document.createElement("div");
indicator.classList.add(classes.INDICATOR);
indicatorText = document.createElement("span");
indicatorText.classList.add(classes.INDICATOR_TEXT);
indicator.appendChild(indicatorText);
element.appendChild(indicator);
element.classList.add(classes.INDEXSCROLLBAR);
return element;
};
/**
* This method inits component.
* @method _init
* @protected
* @param {HTMLElement} element
* @return {HTMLElement}
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._init = function (element) {
var self = this,
options = self.options;
self._phase = 1;
self._setIndices(options.index);
self._setValueByPosition(self._activeIndex, true);
return element;
};
/**
* This method set indices prepared from parameter
* or index of component.
* @method _setIndices
* @param {string} [value] Indices to prepared
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._setIndices = function (value) {
var self = this,
options = self.options;
if (value === null) {
ns.warn("CircularIndexScrollbar must have indices.");
options.index = null;
return;
}
if (typeof value === "string") {
value = value.split(options.delimiter); // delimiter
}
options.index = value;
};
/**
* This method select the index
* @method _setValueByPosition
* @protected
* @param {string} index index number
* @param {boolean} isFireEvent whether "select" event is fired or not
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._setValueByPosition = function (index, isFireEvent) {
var self = this,
indicatorText;
if (!self.options.index) {
return;
}
indicatorText = self.element.querySelector("." + classes.INDICATOR_TEXT);
self._activeIndex = index;
indicatorText.innerHTML = self.options.index[index];
if (isFireEvent) {
eventTrigger(self.element, EventType.SELECT, {index: self.options.index[index]});
}
};
/**
* This method select next index
* @method _nextIndex
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._nextIndex = function () {
var self = this,
activeIndex = self._activeIndex,
indexLen = self.options.index.length,
nextIndex;
if (activeIndex < indexLen - 1) {
nextIndex = activeIndex + 1;
} else {
return;
}
self._setValueByPosition(nextIndex, true);
};
/**
* This method select previous index
* @method _prevIndex
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._prevIndex = function () {
var self = this,
activeIndex = self._activeIndex,
prevIndex;
if (activeIndex > 0) {
prevIndex = activeIndex - 1;
} else {
return;
}
self._setValueByPosition(prevIndex, true);
};
/**
* Get or Set index of the CircularIndexScrollbar
*
* Return current index or set the index
*
* @example
* <progress class="ui-circularindexscrollbar" id="circularindexscrollbar"></progress>
* <script>
* var circularIndexElement = document.getElementById("circularIndex"),
* circularIndexScrollbar = tau.widget.CircleProgressBar(circularIndexElement),
* // return current index value
* value = circularIndexScrollbar.value();
* // sets the index value
* circularIndexScrollbar.value("C");
* </script>
* @method value
* return {string} In get mode return current index value
* @member ns.widget.wearable.CircularIndexScrollbar
*/
/**
* This method select the index
* @method _setValue
* @protected
* @param {string} value of index
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._setValue = function (value) {
var self = this,
index = self.options.index,
indexNumber;
if (index && (indexNumber = index.indexOf(value)) >= 0) {
self._setValueByPosition(indexNumber, false);
}
};
/**
* This method gets current index
* @method _getValue
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._getValue = function () {
var self = this,
index = self.options.index;
if (index) {
return index[self._activeIndex];
} else {
return null;
}
};
/**
* This method is a "rotarydetent" event handler
* @method _rotary
* @protected
* @param {Event} event Event
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._rotary = function (event) {
var self = this,
direction = event.detail.direction;
if (!self.options.index) {
return;
}
if (self._phase === 1) {
self._rotaryPhaseOne();
} else if (self._phase === 3) {
event.stopPropagation();
self._rotaryPhaseThree(direction);
}
};
/**
* This method is for phase 1 operation.
* @method _rotaryPhaseOne
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._rotaryPhaseOne = function () {
var self = this;
clearTimeout(self._tid.phaseOne);
self._tid.phaseOne = setTimeout(function () {
if (self._phase === 1) {
self._detent.phaseOne = 0;
}
}, 100);
if (self._detent.phaseOne > 3) {
self._phase = 3;
clearTimeout(self._tid.phaseOne);
self._detent.phaseOne = 0;
} else {
self._detent.phaseOne++;
}
};
/**
* This method is for phase 3 operation.
* @method _rotaryPhaseThree
* @protected
* @param {string} direction direction of rotarydetent event
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._rotaryPhaseThree = function (direction) {
var self = this;
clearTimeout(self._tid.phaseThree);
self._tid.phaseThree = setTimeout(function () {
self.element.classList.remove(classes.SHOW);
self._phase = 1;
}, 1000);
if (self._phase === 3) {
self.element.classList.add(classes.SHOW);
if (direction === rotaryDirection.CW) {
self._nextIndex();
} else {
self._prevIndex();
}
}
};
/**
* This method handles events
* @method handleEvent
* @public
* @param {Event} event Event
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "rotarydetent":
self._rotary(event);
break;
}
};
/**
* This method binds events to component.
* method _bindEvents
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._bindEvents = function () {
var self = this;
utilsEvents.on(document, "rotarydetent", self);
};
/**
* This method unbinds events to component.
* method _unbindEvents
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._unbindEvents = function () {
var self = this;
utilsEvents.off(document, "rotarydetent", self);
};
/**
* This method refreshes component.
* @method _refresh
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._refresh = function () {
var self = this,
options = self.options;
self._unbindEvents();
self._setIndices(options.index);
self._setValueByPosition(self._activeIndex, true);
self._bindEvents();
};
/**
* This method destroys component.
* @method _destroy
* @protected
* @member ns.widget.wearable.CircularIndexScrollbar
*/
prototype._destroy = function () {
var self = this;
self._unbindEvents();
};
// definition
ns.widget.wearable.CircularIndexScrollbar = CircularIndexScrollbar;
engine.defineWidget(
"CircularIndexScrollbar",
".ui-circularindexscrollbar",
[],
CircularIndexScrollbar,
"wearable"
);
}(window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true */
/**
* # Progress
* Shows a control that indicates the linear shape progressbar percentage of an on-going operation.
*
* The progress widget shows a control that indicates the progress percentage of an on-going operation. This widget can be scaled to fit inside a parent container.
*
* ## Default selectors
*
* This widget provide three style progress.
*
* ### Simple progress bar
* If you don't implement any class, you can show default progress style
* To add a progress widget to the application, use the following code:
*
* @example
* <progress max="100" value="90"></progress>
*
* ### Infinite progress bar
* If you implement class (*ui-progress-indeterminate*), you can show image looks like infinite move.
*
* To add a progress widget to the application, use the following code:
* @example
* <progress class="ui-progress-indeterminate" max="100" value="100"></progress>
*
* ### Progress bar with additional information
* If you implement div tag that can choose two classes (*ui-progress-proportion* or *ui-progress-ratio*) at progress tag same level, you can show two information (proportion information is located left below and ratio information is located right below)
*
* To add a progress widget to the application, use the following code:
*
* @example
* <progress max="100" value="50"></progress>
* <div class="ui-progress-proportion">00/20</div>
* <div class="ui-progress-ratio">50%</div>
*
* ## JavaScript API
*
* Progress widget hasn't JavaScript API.
*
* @class ns.widget.wearable.Progress
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
Progress = function () {
return this;
},
prototype = new BaseWidget();
Progress.events = {};
/**
* Build Progress
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.Progress
*/
prototype._build = function (element) {
return element;
};
prototype._init = function (element) {
return element;
};
prototype._bindEvents = function (element) {
return element;
};
/**
* Refresh structure
* @method _refresh
* @protected
* @member ns.widget.wearable.Progress
*/
prototype._refresh = function () {
return null;
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.wearable.Progress
*/
prototype._destroy = function () {
return null;
};
Progress.prototype = prototype;
ns.widget.wearable.Progress = Progress;
engine.defineWidget(
"Progress",
"progress",
[],
Progress,
"wearable"
);
}(window.document, ns));
/*global window, ns, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true */
/**
* # Processing
* Shows a control that operates as progress infinitely.
*
* The processing widget shows that an operation is in progress.
*
* ## Default selectors
*
* To add a processing widget to the application, use the following code:
*
* @example template tau-precessing
* <div class="ui-processing"></div>
* <div class="ui-processing-text">
* Description about progress
* </div>
*
* ## JavaScript API
*
* Processing widget hasn't JavaScript API.
* @component-selector .ui-processing
* @component-type standalone-component
* @class ns.widget.wearable.Progressing
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
Progressing = function () {
return this;
},
prototype = new BaseWidget();
Progressing.events = {};
/**
* Set full screen size
* @style ui-processing-full-size
* @member ns.widget.wearable.Progressing
*/
/**
* Build Progressing
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.Progressing
*/
prototype._build = function (element) {
return element;
};
prototype._init = function (element) {
return element;
};
prototype._bindEvents = function (element) {
return element;
};
/**
* Refresh structure
* @method _refresh
* @protected
* @member ns.widget.wearable.Progressing
*/
prototype._refresh = function () {
return null;
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.wearable.Progressing
*/
prototype._destroy = function () {
return null;
};
Progressing.prototype = prototype;
ns.widget.wearable.Progressing = Progressing;
engine.defineWidget(
"Progressing",
".ui-progress",
[],
Progressing,
"wearable"
);
}(window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true */
/**
* # Toggle Switch Widget
* Shows a 2-state switch.
*
* The toggle switch widget shows a 2-state switch on the screen.
*
* ## Default selectors
*
* To add a toggle switch widget to the application, use the following code:
*
* @example template
* <div class="ui-toggleswitch ui-toggleswitch-large">
* <input type="checkbox" class="ui-switch-input" />
* <div class="ui-switch-button"></div>
* </div>
*
* @example tau-toggle-switch
* <div class="ui-switch">
* <div class="ui-switch-text">
* Toggle Switch
* </div>
* <label class="ui-toggleswitch">
* <input type="checkbox" class="ui-switch-input">
* <div class="ui-switch-activation">
* <div class="ui-switch-inneroffset">
* <div class="ui-switch-handler"></div>
* </div>
* </div>
* </label>
* </div>
*
* ## JavaScript API
*
* ToggleSwitch widget hasn't JavaScript API.
*
* @class ns.widget.wearable.ToggleSwitch
* @component-selector .ui-toggleswitch
* @component-type standalone-component
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
ToggleSwitch = function () {
/**
* Options for widget
* @property {Object} options
* @property {?string} [options.text=null] Shown text
* @member ns.widget.wearable.ToggleSwitch
*/
this.options = {
text: null
};
},
events = {},
classesPrefix = "ui-switch",
classes = {
handler: classesPrefix + "-handler",
inneroffset: classesPrefix + "-inneroffset",
activation: classesPrefix + "-activation",
input: classesPrefix + "-input",
text: classesPrefix + "-text"
/**
* Set big size
* @style ui-toggleswitch-large
* @member ns.widget.wearable.ToggleSwitch
*/
},
prototype = new BaseWidget();
function getClass(name) {
return classes[name];
}
function addClass(element, classId) {
element.classList.add(getClass(classId));
}
function createElement(name) {
return document.createElement(name);
}
/**
* Dictionary for ToggleSwitch related events.
* For ToggleSwitch, it is an empty object.
* @property {Object} events
* @member ns.widget.wearable.ToggleSwitch
* @static
*/
ToggleSwitch.events = events;
/**
* Dictionary for ToggleSwitch related css class names
* @property {Object} classes
* @member ns.widget.wearable.ToggleSwitch
* @static
* @readonly
*/
ToggleSwitch.classes = classes;
/**
* Build ToggleSwitch
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.ToggleSwitch
*/
prototype._build = function (element) {
var options = this.options,
text = options.text,
divText,
label = createElement("label"),
input = createElement("input"),
divActivation = createElement("div"),
divInnerOffset = createElement("div"),
divHandler = createElement("div");
if (text) {
divText = createElement("div");
addClass(divText, "text");
divText.innerHTML = text;
element.appendChild(divText);
}
addClass(divHandler, "handler");
divInnerOffset.appendChild(divHandler);
addClass(divInnerOffset, "inneroffset");
divActivation.appendChild(divInnerOffset);
addClass(divActivation, "activation");
label.classList.add("ui-toggleswitch");
input.type = "checkbox";
addClass(input, "input");
label.appendChild(input);
label.appendChild(divActivation);
element.appendChild(label);
return element;
};
ToggleSwitch.prototype = prototype;
ns.widget.wearable.ToggleSwitch = ToggleSwitch;
engine.defineWidget(
"ToggleSwitch",
".ui-switch",
[],
ToggleSwitch,
"wearable"
);
}(window.document, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, white: true, plusplus: true*/
/**
* #Virtual list
* Shows a list view for large amounts of data.
*
* @class ns.widget.core.VirtualListview
* @extends ns.core.BaseWidget
* @since 2.0
*/
(function (document, ns) {
"use strict";
/**
* @property {Object} Widget Alias for {@link ns.widget.BaseWidget}
* @member ns.widget.core.VirtualListview
* @private
* @static
*/
var BaseWidget = ns.widget.BaseWidget,
// Constants definition
/**
* Defines index of scroll `{@link ns.widget.core.VirtualListview#_scroll}.direction`
* @property {number} SCROLL_NONE
* to retrieve if user is not scrolling
* @private
* @static
* @member ns.widget.core.VirtualListview
*/
SCROLL_NONE = -1,
/**
* Defines index of scroll `{@link ns.widget.core.VirtualListview#_scroll}.direction`
* @property {number} SCROLL_UP
* to retrieve if user is scrolling up
* @private
* @static
* @member ns.widget.core.VirtualListview
*/
SCROLL_UP = 0,
/**
* Defines index of scroll {@link ns.widget.core.VirtualListview#_scroll}
* @property {number} SCROLL_DOWN
* to retrieve if user is scrolling down
* @private
* @static
* @member ns.widget.core.VirtualListview
*/
SCROLL_DOWN = 1,
/**
* Defines index of scroll {@link ns.widget.core.VirtualListview#_scroll}
* @property {number} SCROLL_LEFT
* to retrieve if user is scrolling left
* @private
* @static
* @member ns.widget.core.VirtualListview
*/
SCROLL_LEFT = 2,
/**
* Defines index of scroll `{@link ns.widget.core.VirtualListview#_scroll}.direction`
* @property {number} SCROLL_RIGHT
* to retrieve if user is scrolling right
* @private
* @static
* @member ns.widget.core.VirtualListview
*/
SCROLL_RIGHT = 3,
/**
* Defines vertical scrolling orientation. It's default orientation.
* @property {string} VERTICAL
* @private
* @static
*/
VERTICAL = "y",
/**
* Defines horizontal scrolling orientation.
* @property {string} HORIZONTAL
* @private
* @static
*/
HORIZONTAL = "x",
/**
* Determines that scroll event should not be taken into account if scroll event occurs.
* @property {boolean} blockEvent
* @private
* @static
*/
blockEvent = false,
/**
* Handle window timeout ID.
* @property {number} timeoutHandler
* @private
* @static
*/
/**
* Alias for ns.util
* @property {Object} util
* @private
* @static
*/
util = ns.util,
/**
* Alias for ns.util.requestAnimationFrame
* @property {Function} requestFrame
* @private
* @static
*/
requestFrame = util.requestAnimationFrame,
selectors = util.selectors,
utilEvent = ns.event,
utilScrolling = ns.util.scrolling,
/**
* Local constructor function
* @method VirtualListview
* @private
* @member ns.widget.core.VirtualListview
*/
VirtualListview = function () {
var self = this;
/**
* VirtualListview widget's properties associated with
* @property {Object} ui
* User Interface
* @property {?HTMLElement} [ui.scrollview=null] Scroll element
* @property {?HTMLElement} [ui.spacer=null] HTML element which makes scrollbar proper
* size
* @property {number} [ui.itemSize=0] Size of list element in pixels. If scrolling is
* vertically it's item width in other case it"s height of item element
* @member ns.widget.core.VirtualListview
*/
self._ui = {
scrollview: null,
spacer: null,
itemSize: 0
};
/**
* Holds information about scrolling state
* @property {Object} _scroll
* @property {Array} [_scroll.direction=[0,0,0,0]] Holds current direction of scrolling.
* Indexes suit to following order: [up, left, down, right]
* @property {number} [_scroll.lastPositionX=0] Last scroll position from top in pixels.
* @property {number} [_scroll.lastPositionY=0] Last scroll position from left in pixels.
* @property {number} [_scroll.lastJumpX=0] Difference between last and current
* position of horizontal scroll.
* @property {number} [_scroll.lastJumpY=0] Difference between last and current
* position of vertical scroll.
* @property {number} [_scroll.clipWidth=0] Width of clip - visible area for user.
* @property {number} [_scroll.clipHeight=0] Height of clip - visible area for user.
* @member ns.widget.core.VirtualListview
*/
self._scroll = {
direction: [0, 0, 0, 0],
dir: SCROLL_NONE,
lastPositionX: 0,
lastPositionY: 0,
lastJumpX: 0,
lastJumpY: 0,
clipWidth: 0,
clipHeight: 0
};
/**
* Name of widget
* @property {string} name
* @member ns.widget.core.VirtualListview
* @static
*/
self.name = "VirtualListview";
/**
* Current zero-based index of data set.
* @property {number} _currentIndex
* @member ns.widget.core.VirtualListview
* @protected
*/
self._currentIndex = 0;
/**
* VirtualListview widget options.
* @property {Object} options
* @property {number} [options.bufferSize=100] Number of items of result set. The default
* value is 100.
* As the value gets higher, the loading time increases while the system performance
* improves. So you need to pick a value that provides the best performance
* without excessive loading time. It's recommended to set bufferSize at least 3 times
* bigger than number
* of visible elements.
* @property {number} [options.dataLength=0] Total number of items.
* @property {string} [options.orientation=VERTICAL] Scrolling orientation. Default
* VERTICAL scrolling enabled.
* @property {Object} options.listItemUpdater Holds reference to method which modifies
* list item, depended
* at specified index from database. **Method should be overridden by developer using
* {@link ns.widget.core.VirtualListview#setListItemUpdater} method.** or defined as a
* config
* object. Method takes two parameters:
* - element {HTMLElement} List item to be modified
* - index {number} Index of data set
* @member ns.widget.core.VirtualListview
*/
self.options = {
bufferSize: 100,
dataLength: 0,
orientation: VERTICAL,
listItemUpdater: null,
scrollElement: null,
optimizedScrolling: false
};
/**
* Binding for scroll event listener.
* @method _scrollEventBound
* @member ns.widget.core.VirtualListview
* @protected
*/
self._scrollEventBound = null;
/**
* Render function
* @method _render
* @protected
* @member ns.widget.core.VirtualListview
*/
self._render = render.bind(null, this);
/**
* Render command list
* @property {Array.<*>} _renderList
* @member ns.widget.core.VirtualListview
* @protected
*/
self._renderList = [];
/**
* Element size cache
* @property {Array.<number>} _sizeMap
* @member ns.widget.core.VirtualListview
* @protected
*/
self._sizeMap = [];
/**
* DocumentFragment buffer for DOM offscreen manipulations
* @property {DocumentFragment} _domBuffer
* @member ns.widget.core.VirtualListview
* @protected
*/
self._domBuffer = document.createDocumentFragment();
/**
* Time for last cleared cache data
* @property {number} _lastRenderClearTimestamp
* @member ns.widget.core.VirtualListview
* @protected
*/
self._lastRenderClearTimestamp = 0;
/**
* Time to lease for clearing render caches
* @property {number} _lastRenderClearTTL
* @member ns.widget.core.VirtualListview
* @protected
*/
self._lastRenderClearTTL = 10000;
/**
* Average list item size cache
* @property {number} _avgListItemSize
* @member ns.widget.core.VirtualListview
* @protected
*/
self._avgListItemSize = -1;
return self;
},
// Cached prototype for better minification
prototype = new BaseWidget();
/**
* Dictionary object containing commonly used widget classes
* @property {Object} classes
* @static
* @readonly
* @member ns.widget.core.VirtualListview
*/
VirtualListview.classes = {
uiVirtualListContainer: "ui-virtual-list-container",
spacer: "ui-virtual-list-spacer"
};
/**
* Main render function
* @method render
* @member ns.widget.core.VirtualListview
* @param {ns.widget.core.VirtualListview} vList Reference to VirtualListview object
* @param {DOMHighResTimeStamp} timestamp The current time of the animation
* @private
* @static
*/
function render(vList, timestamp) {
var ops = vList._renderList,
i = 0,
l = ops.length;
for (; i < l; i += 4) {
if (ops[i] === "propset") {
ops[i + 1][ops[i + 2]] = ops[i + 3];
}
}
if (l === 0 && timestamp - vList._lastRenderClearTimestamp > vList._lastRenderClearTTL) {
vList._lastRenderClearTimestamp = timestamp;
// clear
vList._sizeMap.length = 0;
vList._avgListItemSize = -1;
}
ops.length = 0;
}
/**
* Updates scroll information about position, direction and jump size.
* @method _updateScrollInfo
* @param {ns.widget.core.VirtualListview} self VirtualListview widget reference
* @param {Event} [event] scroll event object.
* @member ns.widget.core.VirtualListview
* @private
* @static
*/
function _updateScrollInfo(self, event) {
var scrollInfo = self._scroll,
scrollDir = SCROLL_NONE,
scrollViewElement = self._ui.scrollview,
scrollLastPositionX = scrollInfo.lastPositionX,
scrollLastPositionY = scrollInfo.lastPositionY,
scrollviewPosX = scrollViewElement.scrollLeft,
scrollviewPosY = (event && event.detail && event.detail.scrollTop) ||
scrollViewElement.scrollTop;
self._refreshScrollbar();
//Scrolling UP
if (scrollviewPosY < scrollLastPositionY) {
scrollDir = SCROLL_UP;
}
//Scrolling RIGHT
if (scrollviewPosX < scrollLastPositionX) {
scrollDir = SCROLL_RIGHT;
}
//Scrolling DOWN
if (scrollviewPosY > scrollLastPositionY) {
scrollDir = SCROLL_DOWN;
}
//Scrolling LEFT
if (scrollviewPosX > scrollLastPositionX) {
scrollDir = SCROLL_LEFT;
}
scrollInfo.lastJumpY = Math.abs(scrollviewPosY - scrollLastPositionY);
scrollInfo.lastJumpX = Math.abs(scrollviewPosX - scrollLastPositionX);
scrollInfo.lastPositionX = scrollviewPosX;
scrollInfo.lastPositionY = scrollviewPosY;
scrollInfo.dir = scrollDir;
scrollInfo.clipHeight = scrollViewElement.clientHeight;
scrollInfo.clipWidth = scrollViewElement.clientWidth;
}
/**
* Computes list element size according to scrolling orientation
* @method _computeElementSize
* @param {HTMLElement} element Element whose size should be computed
* @param {string} orientation Scrolling orientation
* @return {number} Size of element in pixels
* @member ns.widget.core.VirtualListview
* @private
* @static
*/
function _computeElementSize(element, orientation) {
return parseInt((orientation === VERTICAL) ? element.clientHeight : element.clientWidth, 10);
}
/**
* Scrolls and manipulates DOM element to destination index. Element at destination
* index is the first visible element on the screen. Destination index can
* be different from Virtual List's current index, because current index points
* to first element in the buffer.
* @member ns.widget.core.VirtualListview
* @param {ns.widget.core.VirtualListview} self VirtualListview widget reference
* @param {number} toIndex Destination index.
* @method _orderElementsByIndex
* @private
* @static
*/
function _orderElementsByIndex(self, toIndex) {
var element = self.element,
options = self.options,
scrollInfo = self._scroll,
scrollClipSize,
dataLength = options.dataLength,
indexCorrection,
bufferedElements,
avgListItemSize = self._avgListItemSize,
bufferSize = options.bufferSize,
i,
offset,
index,
isLastBuffer = false;
//Get size of scroll clip depended on scroll direction
scrollClipSize = options.orientation === VERTICAL ? scrollInfo.clipHeight :
scrollInfo.clipWidth;
//Compute average list item size
if (avgListItemSize === -1) {
self._avgListItemSize = avgListItemSize =
_computeElementSize(element, options.orientation) / bufferSize;
}
//Compute average number of elements in each buffer (before and after clip)
bufferedElements = Math.floor((bufferSize -
Math.floor(scrollClipSize / avgListItemSize)) / 2);
if (toIndex - bufferedElements <= 0) {
index = 0;
} else {
index = toIndex - bufferedElements;
}
if (index + bufferSize >= dataLength) {
index = dataLength - bufferSize;
if (index < 0) {
index = 0;
}
isLastBuffer = true;
}
indexCorrection = toIndex - index;
self._loadData(index);
blockEvent = true;
offset = index * avgListItemSize;
if (options.orientation === VERTICAL) {
if (isLastBuffer) {
offset = self._ui.spacer.clientHeight;
}
self._addToRenderList("propset", element.style, "margin-top", offset + "px");
} else {
if (isLastBuffer) {
offset = self._ui.spacer.clientWidth;
}
self._addToRenderList("propset", element.style, "margin-left", offset + "px");
}
for (i = 0; i < indexCorrection; i += 1) {
offset += _computeElementSize(element.children[i], options.orientation);
}
if (options.orientation === VERTICAL) {
//MOBILE: self._ui.scrollview.element.scrollTop = offset;
if (utilScrolling.isElement(self._ui.scrollview)) {
utilScrolling.scrollTo(offset);
} else {
self._ui.scrollview.scrollTop = offset;
}
} else {
//MOBILE: self._ui.scrollview.element.scrollLeft = offset;
self._ui.scrollview.scrollLeft = offset;
}
blockEvent = false;
self._currentIndex = index;
}
/**
* Loads element range into internal list item buffer. Elements are taken off one end of the
* children list,
* placed on the other end (i.e.: first is taken and appended ath the end when scrolling
* down)
* and their contents get reloaded. Content reload is delegated to an external function
* (_updateListItem).
* Depending on the direction, elements are
* @param {VirtualList} self
* @param {HTMLElement} element parent widget (the list view) of the (re)loaded element range
* @param {HTMLElement} domBuffer an off-document element for temporary storage of processed
* elements
* @param {Function} sizeGetter a function calculating element size
* @param {number} loadIndex element index to start loading at
* @param {number} indexDirection -1 when indices decrease with each loaded element, +1
* otherwise
* @param {number} elementsToLoad loaded element count
* @return {number} number of pixels the positions of the widgets in the list moved.
* Repositioning the widget by this amount (along the scroll axis) is needed for the
* remaining children
* elements not to move, relative to the viewport.
* @private
*/
function _loadListElementRange(self, element, domBuffer, sizeGetter, loadIndex,
indexDirection, elementsToLoad) {
var temporaryElement,
jump = 0,
i;
if (indexDirection > 0) {
for (i = elementsToLoad; i > 0; i--) {
temporaryElement = element.firstElementChild;
// move to offscreen buffer
domBuffer.appendChild(temporaryElement);
//Updates list item using template
self._updateListItem(temporaryElement, loadIndex);
// move back to document
element.appendChild(temporaryElement);
jump += sizeGetter(temporaryElement, loadIndex++);
}
self._currentIndex += elementsToLoad;
} else {
for (i = elementsToLoad; i > 0; i--) {
temporaryElement = element.lastElementChild;
// move to offscreen buffer
domBuffer.appendChild(temporaryElement);
//Updates list item using template
self._updateListItem(temporaryElement, loadIndex);
element.insertBefore(temporaryElement, element.firstElementChild);
jump -= sizeGetter(temporaryElement, loadIndex--);
}
self._currentIndex -= elementsToLoad;
}
return jump;
}
/**
* For a given element style, positioning direction, set the top/left position to
* elementPosition* adjusted by |jump|. In case the resulting position is outside the bounds
* defined by valid index ranges (0..dataLength-1), clamp the position to tha boundary.
* @param {VirtualList} self
* @param {number} dataLength max valid index
* @param {Object} elementStyle style of the element repositioned
* @param {number} scrollDir one of the BaseWidget.SCROLL_*
* @param {number} jump amount of pixels the repositioned element should be moved
* @param {number} elementPositionTop current elementTop
* @param {number} elementPositionLeft current elementLeft
* @private
*/
function _setElementStylePosition(self, dataLength, elementStyle, scrollDir, jump,
elementPositionTop, elementPositionLeft) {
var scrolledVertically = (scrollDir & 2) === 0,
scrolledHorizontally = (scrollDir & 2) === 1,
newPosition,
currentIndex = self._currentIndex;
if (scrolledVertically) {
newPosition = elementPositionTop + jump;
if (currentIndex <= 0) {
self._currentIndex = currentIndex = 0;
newPosition = 0;
}
if (currentIndex >= (dataLength - 1)) {
newPosition = self._ui.spacer.clientHeight;
}
if (newPosition < 0) {
newPosition = 0;
}
self._addToRenderList("propset", elementStyle, "margin-top", newPosition + "px");
}
if (scrolledHorizontally) {
newPosition = elementPositionLeft + jump;
if (currentIndex <= 0) {
self._currentIndex = currentIndex = 0;
newPosition = 0;
}
if (currentIndex >= (dataLength - 1)) {
newPosition = self._ui.spacer.clientWidth;
}
if (newPosition < 0) {
newPosition = 0;
}
self._addToRenderList("propset", elementStyle, "margin-left", newPosition + "px");
}
}
/**
* Sums numeric properties of an array of objects
* @method sumProperty
* @member ns.widget.core.VirtualListview
* @param {Array.<Object>} elements An array of objects
* @param {string} property The property name
* @return {number}
* @private
* @static
*/
function sumProperty(elements, property) {
var result = 0,
i = elements.length;
while (--i >= 0) {
result += elements[i][property];
}
return result;
}
/**
*
* @param {Array} sizeMap
* @param {boolean} horizontal
* @param {HTMLElement} element
* @param {number} index
* @return {*}
* @private
*/
function _getElementSize(sizeMap, horizontal, element, index) {
if (sizeMap[index] === undefined) {
sizeMap[index] = horizontal ? element.clientWidth : element.clientHeight;
}
return sizeMap[index];
}
/**
* Orders elements. Controls resultset visibility and does DOM manipulation. This
* method is used during normal scrolling.
* @method _orderElements
* @param {ns.widget.core.VirtualListview} self VirtualListview widget reference
* @member ns.widget.core.VirtualListview
* @private
* @static
*/
function _orderElements(self) {
var element = self.element,
scrollInfo = self._scroll,
options = self.options,
elementStyle = element.style,
//Current index of data, first element of resultset
currentIndex = self._currentIndex,
//Number of items in resultset
bufferSize = parseInt(options.bufferSize, 10),
//Total number of items
dataLength = options.dataLength,
//Array of scroll direction
scrollDir = scrollInfo.dir,
scrollLastPositionY = scrollInfo.lastPositionY,
scrollLastPositionX = scrollInfo.lastPositionX,
elementPositionTop = parseInt(elementStyle.marginTop, 10) || 0,
elementPositionLeft = parseInt(elementStyle.marginLeft, 10) || 0,
elementsToLoad,
bufferToLoad,
elementsLeftToLoad = 0,
domBuffer = self._domBuffer,
avgListItemSize = self._avgListItemSize,
resultsetSize = sumProperty(
element.children,
options.orientation === VERTICAL ? "clientHeight" : "clientWidth"
),
sizeMap = self._sizeMap,
jump = 0,
hiddenPart = 0,
indexDirection,
loadIndex;
if (avgListItemSize === -1) {
//Compute average list item size
self._avgListItemSize = avgListItemSize =
_computeElementSize(element, options.orientation) / bufferSize;
}
switch (scrollDir) {
case SCROLL_NONE:
break;
case SCROLL_DOWN:
hiddenPart = scrollLastPositionY - elementPositionTop;
elementsLeftToLoad = dataLength - currentIndex - bufferSize;
break;
case SCROLL_UP:
hiddenPart = (elementPositionTop + resultsetSize) -
(scrollLastPositionY + scrollInfo.clipHeight);
elementsLeftToLoad = currentIndex;
break;
case SCROLL_RIGHT:
hiddenPart = scrollLastPositionX - elementPositionLeft;
elementsLeftToLoad = dataLength - currentIndex - bufferSize;
break;
case SCROLL_LEFT:
hiddenPart = (elementPositionLeft + resultsetSize) -
(scrollLastPositionX - scrollInfo.clipWidth);
elementsLeftToLoad = currentIndex;
break;
}
//manipulate DOM only, when at least 1/2 of result set is hidden
//NOTE: Result Set should be at least 2x bigger then clip size
if (hiddenPart > 0 && (resultsetSize / hiddenPart) <= 2) {
//Left half of hidden elements still hidden/cached
elementsToLoad = ((hiddenPart / avgListItemSize) -
// |0 = floor the value
((bufferSize - scrollInfo.clipHeight / avgListItemSize) / 5) | 0) | 0;
elementsToLoad = Math.min(elementsLeftToLoad, elementsToLoad);
bufferToLoad = (elementsToLoad / bufferSize) | 0;
elementsToLoad = elementsToLoad % bufferSize;
if (scrollDir === SCROLL_DOWN || scrollDir === SCROLL_RIGHT) {
indexDirection = 1;
} else {
indexDirection = -1;
}
// Scrolling more then buffer
if (bufferToLoad > 0) {
// Load data to buffer according to jumped index
self._loadData(currentIndex + indexDirection * bufferToLoad * bufferSize);
// Refresh current index after buffer jump
currentIndex = self._currentIndex;
jump += indexDirection * bufferToLoad * bufferSize * avgListItemSize;
}
loadIndex = currentIndex + (indexDirection > 0 ? bufferSize : -1);
// Note: currentIndex is not valid after this call.
jump += _loadListElementRange(self, element, domBuffer,
_getElementSize.bind(null, sizeMap, scrollDir & 2),
loadIndex, indexDirection, elementsToLoad);
_setElementStylePosition(self, dataLength, elementStyle, scrollDir, jump,
elementPositionTop, elementPositionLeft);
}
}
/**
* Check if scrolling position is changed and updates list if it needed.
* @method _updateList
* @param {ns.widget.core.VirtualListview} self VirtualListview widget reference
* @param {Event} event scroll event triggering this update
* @member ns.widget.core.VirtualListview
* @private
* @static
*/
function _updateList(self, event) {
var _scroll = self._scroll;
_updateScrollInfo(self, event);
if (_scroll.lastJumpY > 0 || _scroll.lastJumpX > 0 && !blockEvent) {
_orderElements(self);
utilEvent.trigger(self.element, "vlistupdate");
}
}
/**
* Updates list item using user defined listItemUpdater function.
* @method _updateListItem
* @param {HTMLElement} element List element to update
* @param {number} index Data row index
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._updateListItem = function (element, index) {
this.options.listItemUpdater(element, index);
};
prototype._setupScrollview = function (element, orientation) {
var scrollview = selectors.getClosestByClass(element, "ui-scroller") || element.parentElement,
scrollviewStyle;
//Get scrollview instance
scrollviewStyle = scrollview.style;
if (orientation === HORIZONTAL) {
scrollviewStyle.overflowX = "scroll";
scrollviewStyle.overflowY = "hidden";
} else {
scrollviewStyle.overflowX = "hidden";
scrollviewStyle.overflowY = "scroll";
}
return scrollview;
};
prototype._getScrollView = function (options, element) {
var scrollview = null;
if (options.scrollElement) {
if (typeof options.scrollElement === "string") {
scrollview = selectors.getClosestBySelector(element, "." + options.scrollElement);
} else {
scrollview = options.scrollElement;
}
}
if (!scrollview) {
scrollview = this._setupScrollview(element, options.orientation);
}
return scrollview;
};
/**
* Build widget structure
* @method _build
* @param {HTMLElement} element Widget's element
* @return {HTMLElement} Element on which built is widget
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
classes = VirtualListview.classes,
options = self.options,
scrollview,
spacer = document.createElement("div"),
spacerStyle,
orientation;
//Prepare element
element.style.position = "relative";
element.classList.add(classes.uiVirtualListContainer);
//Set orientation, default vertical scrolling is allowed
orientation = options.orientation.toLowerCase() === HORIZONTAL ? HORIZONTAL : VERTICAL;
scrollview = self._getScrollView(options, element);
// Prepare spacer (element which makes scrollBar proper size)
spacer.classList.add(classes.spacer);
spacerStyle = spacer.style;
spacerStyle.display = "block";
spacerStyle.position = "static";
if (orientation === HORIZONTAL) {
spacerStyle.float = "left";
}
scrollview.appendChild(spacer);
// Assign variables to members
ui.spacer = spacer;
ui.scrollview = scrollview;
options.orientation = orientation;
return element;
};
/**
* Initialize widget on an element.
* @method _init
* @param {HTMLElement} element Widget's element
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._init = function (element) {
var self = this,
ui = self._ui,
options = self.options,
scrollview = self.scrollview || self._getScrollView(options, element),
elementRect,
scrollviewRect;
if (options.dataLength < options.bufferSize) {
options.bufferSize = options.dataLength;
}
if (options.bufferSize < 1) {
options.bufferSize = 1;
}
elementRect = element.getBoundingClientRect();
scrollviewRect = scrollview.getBoundingClientRect();
// Assign variables to members
self._initTopPosition = elementRect.top - scrollviewRect.top;
self._initLeftPosition = elementRect.left - scrollviewRect.left;
scrollview.classList.add("ui-has-virtual-list");
ui.spacer = ui.spacer || scrollview.querySelector("." + VirtualListview.classes.spacer);
ui.scrollview = scrollview;
options.orientation = options.orientation.toLowerCase() === HORIZONTAL ? HORIZONTAL : VERTICAL;
if (options.optimizedScrolling) {
utilScrolling.enable(scrollview, options.orientation);
utilScrolling.enableScrollBar();
}
};
/**
* Builds Virtual List structure
* @method _buildList
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._buildList = function () {
var self = this,
listItem,
list = self.element,
options = self.options,
childElementType = (list.tagName === "UL" ||
list.tagName === "OL" ||
list.tagName === "TAU-VIRTUALLISTVIEW") ? "li" : "div",
numberOfItems = options.bufferSize,
documentFragment = self._domBuffer,
orientation = options.orientation,
i;
for (i = 0; i < numberOfItems; ++i) {
listItem = document.createElement(childElementType);
if (orientation === HORIZONTAL) {
// NOTE: after rebuild this condition check possible duplication from _init method
listItem.style.float = "left";
}
self._updateListItem(listItem, i);
documentFragment.appendChild(listItem);
}
list.appendChild(documentFragment);
this._refresh();
};
/**
* Refresh list
* @method _refresh
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._refresh = function () {
//Set default value of variable create
this._refreshScrollbar();
};
/**
* Loads data from specified index to result set.
* @method _loadData
* @param {number} index Index of first row
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._loadData = function (index) {
var self = this,
children = self.element.firstElementChild;
if (self._currentIndex !== index) {
self._currentIndex = index;
do {
self._updateListItem(children, index);
++index;
children = children.nextElementSibling;
} while (children);
}
};
/**
* Sets proper scrollbar size: height (vertical), width (horizontal)
* @method _refreshScrollbar
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._refreshScrollbar = function () {
var self = this,
element = self.element,
options = self.options,
ui = self._ui,
spacerStyle = ui.spacer.style,
bufferSizePx,
listSize;
if (options.orientation === VERTICAL) {
//Note: element.clientHeight is variable
bufferSizePx = parseFloat(element.clientHeight) || 0;
listSize = bufferSizePx / options.bufferSize * options.dataLength;
if (options.optimizedScrolling) {
utilScrolling.setMaxScroll(listSize);
} else {
self._addToRenderList("propset", spacerStyle, "height", (listSize - bufferSizePx) +
"px");
}
} else {
//Note: element.clientWidth is variable
bufferSizePx = parseFloat(element.clientWidth) || 0;
listSize = bufferSizePx / options.bufferSize * options.dataLength;
if (options.optimizedScrolling) {
utilScrolling.setMaxScroll(listSize);
} else {
self._addToRenderList("propset", spacerStyle, "width", (bufferSizePx /
options.bufferSize * (options.dataLength - 1) - 4 / 3 * bufferSizePx) + "px");
}
}
};
/**
* Binds VirtualListview events
* @method _bindEvents
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._addToRenderList = function () {
var self = this,
renderList = self._renderList;
renderList.push.apply(renderList, arguments);
requestFrame(self._render);
//MOBILE: parent_bindEvents.call(self, self.element);
};
/**
* Binds VirtualListview events
* @method _bindEvents
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._bindEvents = function () {
var scrollEventBound = _updateList.bind(null, this),
//MOBILE: scrollviewClip = self._ui.scrollview && self._ui.scrollview.element;
scrollviewClip = this._ui.scrollview;
if (scrollviewClip) {
scrollviewClip.addEventListener("scroll", scrollEventBound, false);
this._scrollEventBound = scrollEventBound;
}
//MOBILE: parent_bindEvents.call(self, self.element);
};
/**
* Cleans widget's resources
* @method _destroy
* @member ns.widget.core.VirtualListview
* @protected
*/
prototype._destroy = function () {
var self = this,
scrollView = self._ui.scrollview,
uiSpacer = self._ui.spacer,
element = self.element,
elementStyle = element.style;
// Restore start position
elementStyle.position = "static";
if (self.options.orientation === VERTICAL) {
elementStyle.top = "auto";
} else {
elementStyle.left = "auto";
}
if (scrollView) {
utilScrolling.disable(scrollView);
scrollView.removeEventListener("scroll", self._scrollEventBound, false);
}
//Remove spacer element
if (uiSpacer.parentNode) {
uiSpacer.parentNode.removeChild(uiSpacer);
}
//Remove li elements.
while (element.firstElementChild) {
element.removeChild(element.firstElementChild);
}
};
/**
* This method scrolls list to defined position in pixels.
* @method scrollTo
* @param {number} position Scroll position expressed in pixels.
* @member ns.widget.core.VirtualListview
*/
prototype.scrollTo = function (position) {
var self = this;
if (utilScrolling.isElement(self._ui.scrollview)) {
utilScrolling.scrollTo(position);
} else {
self._ui.scrollview.scrollTop = position;
}
};
/**
* This method scrolls list to defined index.
* @method scrollToIndex
* @param {number} index Scroll Destination index.
* @member ns.widget.core.VirtualListview
*/
prototype.scrollToIndex = function (index) {
if (index < 0) {
index = 0;
}
if (index >= this.options.dataLength) {
index = this.options.dataLength - 1;
}
_updateScrollInfo(this);
_orderElementsByIndex(this, index);
};
/**
* This method builds widget and trigger event "draw".
* @method draw
* @member ns.widget.core.VirtualListview
*/
prototype.draw = function () {
this._buildList();
this.trigger("draw");
};
/**
* This method sets list item updater function.
* To learn how to create list item updater function please
* visit Virtual List User Guide.
* @method setListItemUpdater
* @param {Object} updateFunction Function reference.
* @member ns.widget.core.VirtualListview
*/
prototype.setListItemUpdater = function (updateFunction) {
this.options.listItemUpdater = updateFunction;
};
// Assign prototype
VirtualListview.prototype = prototype;
ns.widget.core.VirtualListview = VirtualListview;
}(window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, white: true, plusplus: true*/
/**
*#Virtual ListView Widget
* Shows a list view for large amounts of data.
*
* In the Web environment, it is challenging to display a large amount of data in a list, such as
* displaying a contact list of over 1000 list items. It takes time to display the entire list in
* HTML and the DOM manipulation is complex.
*
* The virtual list widget is used to display a list of unlimited data elements on the screen
* for better performance. This widget provides easy access to databases to retrieve and display data.
* It based on **result set** which is fixed size defined by developer by data-row attribute. Result
* set should be **at least 3 times bigger** then size of clip (number of visible elements).
*
* To add a virtual list widget to the application follow these steps:
*
* ##Create widget container - list element
*
* &lt;ul id=&quot;vList&quot; class=&quot;ui-listview ui-virtuallistview&quot;&gt;&lt;/ul&gt;
*
*
* ##Initialize widget
*
* // Get HTML Element reference
* var elList = document.getElementById("vList"),
* // Set up config. All config options can be found in virtual list reference
* vListConfig = {
* dataLength: 2000,
* bufferSize: 40,
* listItemUpdater: function(elListItem, newIndex){
* // NOTE: JSON_DATA is global object with all data rows.
* var data = JSON_DATA["newIndex"];
* elListItem.innerHTML = '<span class="ui-li-text-main">' +
* data.NAME + '</span>';
* }
* };
* vList = tau.widget.VirtualListview(elList, vListConfig);
*
* More config options can be found in {@link ns.widget.wearable.VirtualListview#options}
*
* ##Set list item update function
*
* List item update function is responsible to update list element depending on data row index. If you didnt
* pass list item update function by config option, you have to do it using following method.
* Otherwise you will see an empty list.
*
* vList.setListItemUpdater(function(elListItem, newIndex){
* // NOTE: JSON_DATA is global object with all data rows.
* var data = JSON_DATA["newIndex"];
* elListItem.innerHTML = '<span class="ui-li-text-main">' +
* data.NAME + '</span>';
* });
*
* **Attention:** Virtual List manipulates DOM elements to be more efficient. It doesnt remove or create list
* elements before calling list item update function. It means that, you have to take care about list element
* and keep it clean from custom classes an attributes, because order of li elements is volatile.
*
* ##Draw child elements
* If all configuration options are set, call draw method to draw child elements and make virtual list work.
*
* vList.draw();
*
* ##Destroy Virtual List
* Its highly recommended to destroy widgets, when they arent necessary. To destroy Virtual List call destroy
* method.
*
* vList.destroy();
*
* ##Full working code
*
* var page = document.getElementById("pageTestVirtualList"),
* vList,
* // Assign data.
* JSON_DATA = [
* {NAME:"Abdelnaby, Alaa", ACTIVE:"1990 - 1994", FROM:"College - Duke", TEAM_LOGO:"../test/1_raw.jpg"},
* {NAME:"Abdul-Aziz, Zaid", ACTIVE:"1968 - 1977", FROM:"College - Iowa State", TEAM_LOGO:"../test/2_raw.jpg"}
* // A lot of records.
* // These database can be found in Gear Sample Application Winset included to Tizen SDK
* ];
*
* page.addEventListener("pageshow", function() {
* var elList = document.getElementById("vList");
*
* vList = tau.widget.VirtualListview(elList, {
* dataLength: JSON_DATA.length,
* bufferSize: 40
* });
*
* // Set list item updater
* vList.setListItemUpdater(function(elListItem, newIndex) {
* //TODO: Update listItem here
* var data = JSON_DATA[newIndex];
* elListItem.innerHTML = '<span class="ui-li-text-main">' +
* data.NAME + '</span>';
* });
* // Draw child elements
* vList.draw();
* });
* page.addEventListener("pagehide", function() {
* // Remove all children in the vList
* vList.destroy();
* });
*
* @class ns.widget.wearable.VirtualListview
* @since 2.2
* @extends ns.widget.BaseWidget
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
* @author Michał Szepielak <m.szepielak@samsung.com>
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function (document, ns) {
"use strict";
var VirtualListview = ns.widget.core.VirtualListview;
VirtualListview.prototype = new VirtualListview();
ns.widget.wearable.VirtualListview = VirtualListview;
ns.engine.defineWidget(
"VirtualListview",
"",
["draw", "setListItemUpdater", "scrollTo", "scrollToIndex"],
VirtualListview,
"wearable"
);
}(window.document, ns));
/*global window, ns, define */
/*jslint nomen: true, plusplus: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #VirtualGrid Widget
* Widget creates special grid which can contain big number of items.
*
* @class ns.widget.wearable.VirtualGrid
* @since 2.3
* @extends ns.widget.wearable.VirtualListview
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
* @author Piotr Karny <p.karny@samsung.com>
*/
(function (window, document, ns) {
"use strict";
/**
* Alias for {@link ns.widget.wearable.VirtualListview}
* @property {Object} VirtualList
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
var VirtualList = ns.widget.wearable.VirtualListview,
/**
* Alias for class {@link ns.engine}
* @property {Object} engine
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
engine = ns.engine,
/**
* Alias for class {@link ns.util.DOM}
* @property {Object} DOM
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
DOM = ns.util.DOM,
/**
* Constant for horizontal virtual grid
* @property {string} HORIZONTAL="x"
* @private
* @member ns.widget.wearable.VirtualGrid
* @static
*/
HORIZONTAL = "x",
/**
* Constant for vertical virtual grid
* @property {string} VERTICAL="y"
* @private
* @member ns.widget.wearable.VirtualGrid
* @static
*/
VERTICAL = "y",
FOCUS_SELECTOR = "::virtualgrid",
FOCUS_SELECTOR_PATTERN = /(::virtualgrid\((\d+)\))/gi,
/**
* Alias for class VirtualGrid
* @method VirtualGrid
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
VirtualGrid = function () {
/**
* Object with default options
* @property {Object} options
* @property {number} [options.bufferSize=100] Element count in buffer
* @property {number} [options.dataLength=0] Element count in list
* @property {"x"|"y"} [options.orientation="y"] Orientation : horizontal ("x"), vertical ("y")
* @member ns.widget.wearable.VirtualGrid
*/
this.options = {
bufferSize: 100,
dataLength: 0,
orientation: VERTICAL,
/**
* Method which modifies list item, depended at specified index from database.
* @method options.listItemUpdater
* @member ns.widget.wearable.VirtualGrid
*/
listItemUpdater: function () {
return null;
}
};
this._onFocusQuery = null;
return this;
},
prototype = new VirtualList(),
/**
* Alias for VirtualList prototype
* @property {Object} VirtualListPrototype
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
VirtualListPrototype = VirtualList.prototype,
/**
* Alias for {@link ns.widget.wearable.VirtualListview#draw VirtualList.draw}
* @method parentDraw
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
parentDraw = VirtualListPrototype.draw,
/**
* Alias for {@link ns.widget.wearable.VirtualListview#_refreshScrollbar VirtualList.\_refreshScrollbar}
* @method parentRefreshScrollbar
* @member ns.widget.wearable.VirtualGrid
* @private
* @static
*/
parentRefreshScrollbar = VirtualListPrototype._refreshScrollbar,
parentBindEvents = VirtualListPrototype._bindEvents,
parentDestroy = VirtualListPrototype._destroy;
/**
* This method draws item.
* @method draw
* @member ns.widget.wearable.VirtualGrid
*/
prototype.draw = function () {
var self = this,
element = self.element,
ui = self._ui,
newDiv = null,
newDivStyle = null;
if (self.options.orientation === HORIZONTAL) {
newDiv = document.createElement("div");
newDivStyle = newDiv.style;
element.parentNode.appendChild(newDiv);
newDiv.appendChild(element);
newDiv.appendChild(ui.spacer);
newDivStyle.width = "10000px";
newDivStyle.height = "100%";
ui.container = newDiv;
}
self._initListItem();
parentDraw.call(self);
};
function onFocusQuery(self, event) {
var data = event.detail,
selector = data.selector,
index = -1;
if (selector.indexOf(FOCUS_SELECTOR) > -1) {
data.selector = selector = selector.replace(FOCUS_SELECTOR_PATTERN,
function (match, widgetMatch, indexMatch) {
if (widgetMatch && indexMatch) {
index = indexMatch | 0;
return "#" + self.id + " [data-index='" + index + "']";
}
return match;
});
if (index > -1) {
self.scrollToIndex(index);
data.nextElement = document.querySelector(selector);
event.preventDefault(); // consume
}
}
}
prototype._bindEvents = function (element) {
var self = this;
parentBindEvents.call(self, element);
self._onFocusQuery = onFocusQuery.bind(null, self);
self.element.addEventListener("focusquery", self._onFocusQuery);
};
prototype._destroy = function (element) {
var self = this;
parentDestroy.call(self, element);
self.element.removeEventListener("focusquery", self._onFocusQuery);
};
/**
* Sets proper scrollbar size: width (horizontal)
* @method _refreshScrollbar
* @protected
* @member ns.widget.wearable.VirtualGrid
*/
prototype._refreshScrollbar = function () {
var width = 0,
ui = this._ui;
parentRefreshScrollbar.call(this);
if (ui.container) {
width = this.element.clientWidth + ui.spacer.clientWidth;
ui.container.style.width = width + "px";
}
};
/**
* Initializes list item
* @method _initListItem
* @protected
* @member ns.widget.wearable.VirtualGrid
*/
prototype._initListItem = function () {
var self = this,
thisElement = self.element,
element = document.createElement("div"),
rowElement = document.createElement("div"),
elementStyle = element.style,
orientation = self.options.orientation,
thisElementStyle = thisElement.style,
rowElementStyle = rowElement.style;
elementStyle.overflow = "hidden";
rowElement.style.overflow = "hidden";
thisElement.appendChild(rowElement);
rowElement.appendChild(element);
self.options.listItemUpdater(element, 0);
if (orientation === VERTICAL) {
thisElementStyle.overflowY = "auto";
thisElementStyle.overflowX = "hidden";
rowElementStyle.overflow = "hidden";
element.style.float = "left";
self._cellSize = DOM.getElementWidth(element);
self._columnsCount = Math.floor(DOM.getElementWidth(thisElement) / self._cellSize);
} else {
thisElementStyle.overflowX = "auto";
thisElementStyle.overflowY = "hidden";
rowElementStyle.overflow = "hidden";
rowElementStyle.float = "left";
thisElementStyle.height = "100%";
rowElementStyle.height = "100%";
self._cellSize = DOM.getElementHeight(element);
self._columnsCount = Math.floor(DOM.getElementHeight(thisElement) / self._cellSize);
}
thisElement.removeChild(rowElement);
self.options.originalDataLength = self.options.dataLength;
self.options.dataLength /= self._columnsCount;
};
/**
* Updates list item with data using defined template
* @method _updateListItem
* @param {HTMLElement} element List element to update
* @param {number} index Data row index
* @protected
* @member ns.widget.wearable.VirtualGrid
*/
prototype._updateListItem = function (element, index) {
var elementI,
i,
count,
elementStyle = element.style,
options = this.options,
elementIStyle,
size;
element.innerHTML = "";
elementStyle.overflow = "hidden";
elementStyle.position = "relative";
if (options.orientation === HORIZONTAL) {
elementStyle.height = "100%";
}
count = this._columnsCount;
size = (100 / count);
for (i = 0; i < count; i++) {
elementI = document.createElement("div");
elementIStyle = elementI.style;
elementIStyle.overflow = "hidden";
elementI.setAttribute("data-index", count * index + i);
if (options.orientation === VERTICAL) {
elementI.style.float = "left";
elementI.style.width = size + "%";
} else {
elementI.style.height = size + "%";
}
if (count * index + i < options.originalDataLength) {
this.options.listItemUpdater(elementI, count * index + i, count);
}
element.appendChild(elementI);
}
};
VirtualGrid.prototype = prototype;
ns.widget.wearable.VirtualGrid = VirtualGrid;
engine.defineWidget(
"VirtualGrid",
".ui-virtualgrid",
[],
VirtualGrid
);
}(window, window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns */
/**
* # SnapListview Widget
* Shows a snap list view.
* It detects center-positioned list item when scroll end. When scroll event started, SnapListview trigger *scrollstart* event, and scroll event ended, it trigger *scrollend* event.
* When scroll ended and it attach class to detected item.
*
* ## Default selectors
*
* Default selector for snap listview widget is class *ui-snap-listview*.
*
* To add a list widget to the application, use the following code:
*
* ### List with basic items
*
* You can add a basic list widget as follows:
*
* @example
* <ul class="ui-listview ui-snap-listview">
* <li>1line</li>
* <li>2line</li>
* <li>3line</li>
* <li>4line</li>
* <li>5line</li>
* </ul>
*
* ## JavaScript API
*
* There is no JavaScript API.
*
* @author Heeju Joo <heeju.joo@samsung.com>
* @class ns.widget.wearable.SnapListview
* @extends ns.widget.BaseWidget
*/
(function (window, document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
/**
* Alias for class ns.engine
* @property {ns.engine} engine
* @member ns.widget.wearable.SnapListview
* @private
*/
engine = ns.engine,
/**
* Alias for class ns.event
* @property {ns.event} utilEvent
* @member ns.widget.wearable.SnapListview
* @private
*/
utilEvent = ns.event,
/**
* Alias for class ns.util.DOM
* @property {ns.util.DOM} doms
* @member ns.widget.wearable.SnapListview
* @private
*/
util = ns.util,
doms = util.DOM,
/**
* Alias for class ns.util.selectors
* @property {ns.util.selectors} utilSelector
* @member ns.widget.wearable.SnapListview
* @private
*/
utilSelector = util.selectors,
scrolling = util.scrolling,
/**
* Triggered when scroll will be started
* @event scrollstart
* @member ns.widget.wearable.SnapListview
*/
/**
* Triggered when scroll will be ended
* @event scrollend
* @member ns.widget.wearable.SnapListview
*/
/**
* Triggered when selected element
* @event selected
* @member ns.widget.wearable.SnapListview
*/
eventType = {
SCROLL_START: "scrollstart",
SCROLL_END: "scrollend",
SELECTED: "selected"
},
utilArray = ns.util.array,
SnapListview = function () {
var self = this;
self._ui = {
page: null,
scrollableParent: {
element: null,
height: 0
},
childItems: {}
};
/**
* Object with default options
* @property {Object} options
* @property {string} [options.selector=li:not(.ui-listview-divider)]
* @property {string} [options.animate=none]
* @property {Object} [options.scale]
* @property {Object} [options.scale.from=0.67]
* @property {Object} [options.scale.to=1]
* @property {Object} [options.opacity]
* @property {Object} [options.opacity.from=0.7]
* @property {Object} [options.opacity.to=1]
* @memberof ns.widget.wearable.ArcListview
*/
self.options = {
selector: "li:not(.ui-listview-divider)",
animate: "none",
scale: {
from: 0.67,
to: 1
},
opacity: {
from: 0.7,
to: 1
}
};
self._listItems = [];
self._callbacks = {};
self._scrollEndTimeoutId = null;
self._isScrollStarted = false;
self._selectedIndex = null;
self._currentIndex = null;
self._enabled = true;
self._isTouched = false;
self._scrollEventCount = 0;
},
prototype = new BaseWidget(),
CLASSES_PREFIX = "ui-snap-listview",
classes = {
SNAP_CONTAINER: "ui-snap-container",
SNAP_DISABLED: "ui-snap-disabled",
SNAP_LISTVIEW: CLASSES_PREFIX,
SNAP_LISTVIEW_SELECTED: CLASSES_PREFIX + "-selected",
SNAP_LISTVIEW_ITEM: CLASSES_PREFIX + "-item"
},
// time threshold for detect scroll end
SCROLL_END_TIME_THRESHOLD = 0;
SnapListview.classes = classes;
SnapListview.animationTimer = null;
/**
* Class representing one item in list
* @param {HTMLElement} element list element
* @param {number} visibleOffset top offset of list
* @class ns.widget.wearable.SnapListview.ListItem
*/
SnapListview.ListItem = function (element, visibleOffset) {
var offsetTop,
height;
element.classList.add(classes.SNAP_LISTVIEW_ITEM);
offsetTop = element.offsetTop;
height = element.offsetHeight;
this.element = element;
this.rate = -1;
this.coord = {
top: offsetTop,
height: height
};
this.position = {
begin: offsetTop - visibleOffset,
start: offsetTop - visibleOffset + height,
stop: offsetTop,
end: offsetTop + height
};
};
SnapListview.ListItem.prototype = {
/**
* Class represent one item in list
* @method animate
* @param {number} offset
* @param {Function} callback
* @memberof ns.widget.wearable.SnapListview.ListItem
*/
animate: function (offset, callback) {
var element = this.element,
p = this.position,
begin = p.begin,
end = p.end,
start = p.start,
stop = p.stop,
rate;
if (offset >= start && offset <= stop) {
rate = Math.min(1, Math.abs((offset - start) / (stop - start)));
} else if ((offset > begin && offset < start) || (offset < end && offset > stop)) {
rate = 0;
} else {
rate = -1;
}
if (this.rate !== rate) {
callback(element, rate);
this.rate = rate;
}
}
};
function removeSelectedClass(self) {
var selectedIndex = self._selectedIndex;
if (selectedIndex !== null) {
self._listItems[selectedIndex].element.classList.remove(classes.SNAP_LISTVIEW_SELECTED);
self._selectedIndex = null;
}
}
/**
* Check if element of list item is displayed
* @param {Object} listItem
* @return {boolean}
* @private
*/
function isListItemDisplayed(listItem) {
return listItem.element.style.display !== "none";
}
function getScrollPosition(scrollableParentElement) {
var contentElement = scrollableParentElement.querySelector(".ui-content"),
marginTop = 0;
if (contentElement) {
marginTop = parseInt(window.getComputedStyle(contentElement).marginTop, 10);
}
return -scrollableParentElement.firstElementChild.getBoundingClientRect().top + marginTop;
}
function setSelection(self) {
var ui = self._ui,
listItems = self._listItems,
scrollableParent = ui.scrollableParent,
scrollableParentHeight = scrollableParent.height || ui.page.offsetHeight,
scrollableParentElement = scrollableParent.element || ui.page,
scrollCenter = getScrollPosition(scrollableParentElement) + scrollableParentHeight / 2,
listItemLength = listItems.length,
tempListItem,
tempListItemCoord,
i,
previousSelectedIndex = self._selectedIndex,
selectedIndex;
for (i = 0; i < listItemLength; i++) {
tempListItem = listItems[i];
tempListItemCoord = tempListItem.coord;
// element has to be displayed to be able to be selected
if (isListItemDisplayed(tempListItem) &&
(tempListItemCoord.top < scrollCenter) &&
(tempListItemCoord.top + tempListItemCoord.height >= scrollCenter)) {
selectedIndex = i;
break;
}
}
if (selectedIndex !== previousSelectedIndex && selectedIndex !== undefined) {
removeSelectedClass(self);
if (self._selectTimeout) {
clearTimeout(self._selectTimeout);
}
self._selectTimeout = setTimeout(function () {
var element = self._listItems && self._listItems[selectedIndex].element;
if (element) {
self._selectedIndex = selectedIndex;
element.classList.add(classes.SNAP_LISTVIEW_SELECTED);
utilEvent.trigger(element, eventType.SELECTED);
}
}, 300);
}
}
/**
* Animate list items
* @method _listItemAnimate
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._listItemAnimate = function () {
var self = this,
anim = self.options.animate,
animateCallback = self._callbacks[anim],
scrollPosition,
scrollableParentElement = self._ui.scrollableParent.element || self._ui.page;
if (animateCallback) {
scrollPosition = getScrollPosition(scrollableParentElement);
utilArray.forEach(self._listItems, function (item) {
item.animate(scrollPosition, animateCallback);
});
}
};
function scrollEndCallback(self) {
if (self._isTouched === false) {
self._isScrollStarted = false;
// trigger "scrollend" event
utilEvent.trigger(self.element, eventType.SCROLL_END);
setSelection(self);
}
}
function scrollHandler(self) {
var callbacks = self._callbacks,
scrollEndCallback = callbacks.scrollEnd;
if (!self._isScrollStarted) {
self._isScrollStarted = true;
utilEvent.trigger(self.element, eventType.SCROLL_START);
self._scrollEventCount = 0;
}
self._scrollEventCount++;
if (self._scrollEventCount > 2 || self._isTouched === true) {
removeSelectedClass(self);
}
self._listItemAnimate();
// scrollend handler can be run only when all touches are released.
if (self._isTouched === false) {
window.clearTimeout(self._scrollEndTimeoutId);
self._scrollEndTimeoutId = window.setTimeout(scrollEndCallback, SCROLL_END_TIME_THRESHOLD);
}
}
function onTouchStart(self) {
self._isTouched = true;
}
function onTouchEnd(self) {
self._isTouched = false;
setSelection(self);
}
function getScrollableParent(element) {
var overflow;
while (element && element !== document.body) {
if (scrolling.isElement(element)) {
return element;
}
overflow = doms.getCSSProperty(element, "overflow-y");
if (overflow === "scroll" || (overflow === "auto" && element.scrollHeight > element.clientHeight)) {
return element;
}
element = element.parentNode;
}
return null;
}
/**
* Init snaplistview
* @method _initSnapListview
* @param {HTMLElement} listview
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._initSnapListview = function (listview) {
var self = this,
ui = self._ui,
scroller,
visibleOffset,
elementHeight = listview.firstElementChild.getBoundingClientRect().height,
scrollMargin;
// finding page and scroller
ui.page = utilSelector.getClosestByClass(listview, "ui-page") || document.body;
scroller = getScrollableParent(listview);
if (scroller) {
if (!scrolling.isElement(scroller)) {
scrolling.enable(scroller, "y");
}
scrollMargin = listview.getBoundingClientRect().top -
scroller.getBoundingClientRect().top - elementHeight / 2;
scrolling.setMaxScroll(scroller.firstElementChild.getBoundingClientRect()
.height + scrollMargin);
scrolling.setSnapSize(elementHeight);
scroller.classList.add(classes.SNAP_CONTAINER);
ui.scrollableParent.element = scroller;
visibleOffset = scroller.clientHeight;
ui.scrollableParent.height = visibleOffset;
}
};
prototype._refreshSnapListview = function (listview) {
var self = this,
ui = self._ui,
options = self.options,
listItems = [],
scroller = ui.scrollableParent.element,
visibleOffset;
if (!scroller) {
self._initSnapListview(listview);
}
visibleOffset = ui.scrollableParent.height || ui.page.offsetHeight;
// init information about widget
self._selectedIndex = null;
// init items on each element
utilArray.forEach(listview.querySelectorAll(options.selector), function (element, index) {
listItems.push(new SnapListview.ListItem(element, visibleOffset));
// searching existing selected element
if (element.classList.contains(classes.SNAP_LISTVIEW_SELECTED)) {
self._selectedIndex = index;
self._currentIndex = index;
}
});
self._listItems = listItems;
self._listItemAnimate();
};
/**
* Build widget
* @method _build
* @param {HTMLElement} element
* @protected
* @member ns.widget.wearable.SnapListview
* return {HTMLElement}
*/
prototype._build = function (element) {
var classList = element.classList;
// build only if not exist listview on this element
if (!engine.getBinding(element, "Listview")) {
if (!classList.contains(classes.SNAP_LISTVIEW)) {
classList.add(classes.SNAP_LISTVIEW);
}
// return element to continue flow
return element;
} else {
// in another case display warning
ns.warn("Can't create SnapListview on Listview element");
// return element to stop flow
return null;
}
};
/**
* Init SnapListview
* @method _init
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._init = function (element) {
var self = this,
options = this.options,
scaleForm = options.scale.from,
scaleTo = options.scale.to,
opacityForm = options.opacity.from,
opacityTo = options.opacity.to;
self._callbacks = {
scroll: scrollHandler.bind(null, self),
scrollEnd: scrollEndCallback.bind(null, self),
scale: function (listItemElement, rate) {
var scale,
opacity;
if (rate < 0) {
listItemElement.style.webkitTransform = "";
listItemElement.style.opacity = "";
return;
}
rate = rate > 0.5 ? 1 - rate : rate;
scale = scaleForm + ((scaleTo - scaleForm) * rate * 2);
opacity = opacityForm + ((opacityTo - opacityForm) * rate * 2);
listItemElement.style.webkitTransform = "scale3d(" + scale + "," + scale + "," + scale + ")";
listItemElement.style.opacity = opacity;
}
};
self._refreshSnapListview(element);
setSelection(self);
return element;
};
/**
* Refresh structure.
* This function has to be called every time when the structure of list changed,
* eg. the visibility of item on list was changed by setting value of 'display' property
*
* @method _refresh
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._refresh = function () {
var self = this,
element = self.element;
self._refreshSnapListview(element);
setSelection(self);
return null;
};
/**
* Bind events
* @method _bindEvents
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._bindEvents = function () {
var self = this,
element = self.element,
scrollableElement = self._ui.scrollableParent.element;
self._callbacks.touchstart = onTouchStart.bind(null, self);
self._callbacks.touchend = onTouchEnd.bind(null, self);
self._callbacks.vclick = vClickHandler.bind(null, self);
if (scrollableElement) {
utilEvent.on(scrollableElement, "scroll", this._callbacks.scroll, false);
}
element.addEventListener("touchstart", self._callbacks.touchstart, false);
element.addEventListener("touchend", self._callbacks.touchend, false);
element.addEventListener("vclick", self._callbacks.vclick, false);
};
/**
* Unbind events
* @method _unbindEvents
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._unbindEvents = function () {
var self = this,
element = self.element,
scrollableElement = self._ui.scrollableParent.element;
if (scrollableElement) {
utilEvent.off(scrollableElement, "scroll", this._callbacks.scroll, false);
}
element.removeEventListener("touchstart", self._callbacks.touchstart, false);
element.removeEventListener("touchend", self._callbacks.touchend, false);
element.removeEventListener("vclick", self._callbacks.vclick, false);
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._destroy = function () {
var self = this;
self._unbindEvents();
self._ui = null;
self._callbacks = null;
self._listItems = null;
self._isScrollStarted = null;
if (self._scrollEndTimeoutId) {
window.clearTimeout(self._scrollEndTimeoutId);
}
self._scrollEndTimeoutId = null;
self._selectedIndex = null;
self._currentIndex = null;
scrolling.disable();
return null;
};
/**
* Enable widget
* @method _enable
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._enable = function () {
var self = this,
scrollableParent = self._ui.scrollableParent.element || self._ui.page;
scrollableParent.classList.remove(classes.SNAP_DISABLED);
if (!self._enabled) {
self._enabled = true;
self._refresh();
}
};
/**
* Disable widget
* @method _disable
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._disable = function () {
var self = this,
scrollableParent = self._ui.scrollableParent.element;
scrollableParent.classList.add(classes.SNAP_DISABLED);
self._enabled = false;
};
/**
* Get selectedIndex
* @method getSelectedIndex
* @return {number} index
* @public
* @member ns.widget.wearable.SnapListview
*/
prototype.getSelectedIndex = function () {
return this._currentIndex || this._selectedIndex;
};
function vClickHandler(self, e) {
var listItems = self._listItems,
selectedIndex = self._selectedIndex,
targetListItem,
targetIndex;
targetListItem = getSnapListItem(e.target, self.element);
if (targetListItem && targetListItem.classList.contains(classes.SNAP_LISTVIEW_SELECTED)) {
return;
}
targetIndex = getIndexOfSnapListItem(targetListItem, listItems);
utilEvent.preventDefault(e);
utilEvent.stopPropagation(e);
if (targetIndex > -1 && selectedIndex !== null) {
if (targetIndex < selectedIndex) {
utilEvent.trigger(window, "rotarydetent", {direction: "CCW"}, true);
} else if (targetIndex > selectedIndex) {
utilEvent.trigger(window, "rotarydetent", {direction: "CW"}, true);
}
}
}
function getIndexOfSnapListItem(targetListItem, targetList) {
var length = targetList.length,
i;
for (i = 0; i < length; i++) {
if (targetList[i].element === targetListItem) {
return i;
}
}
return -1;
}
function getSnapListItem(target, listElement) {
var current = target;
while (current.parentNode && current !== listElement) {
if (current.classList.contains(classes.SNAP_LISTVIEW_ITEM)) {
return current;
}
current = current.parentNode;
}
return undefined;
}
/**
* Scroll SnapList by index
* @method scrollToPosition
* @param {number} index
* @public
* @return {boolean} True if the list was scrolled, false - otherwise.
* @member ns.widget.wearable.SnapListview
*/
prototype.scrollToPosition = function (index) {
return this._scrollToPosition(index);
};
/**
* Scroll SnapList by index
* @method _scrollToPosition
* @param {number} index
* @param {Function} callback
* @protected
* @member ns.widget.wearable.SnapListview
*/
prototype._scrollToPosition = function (index, callback) {
var self = this,
ui = self._ui,
enabled = self._enabled,
listItems = self._listItems,
scrollableParent = ui.scrollableParent,
listItemLength = listItems.length,
listItem = listItems[index],
listItemIndex,
dest;
// if list is disabled or selected index is out of range, or item on selected index
// is not displayed, this function returns false
if (!enabled || index < 0 || index >= listItemLength || self._currentIndex === index ||
!isListItemDisplayed(listItem)) {
return false;
}
self._currentIndex = index;
removeSelectedClass(self);
listItemIndex = listItems[index].coord;
dest = listItemIndex.top - scrollableParent.height / 2 + listItemIndex.height / 2;
scrollAnimation(scrollableParent.element, -scrollableParent.element.firstElementChild.getBoundingClientRect().top, dest, 450, callback);
return true;
};
function cubicBezier(x1, y1, x2, y2) {
return function (t) {
var rp = 1 - t,
rp3 = 3 * rp,
p2 = t * t,
p3 = p2 * t,
a1 = rp3 * t * rp,
a2 = rp3 * p2;
return a1 * y1 + a2 * y2 + p3;
};
}
function scrollAnimation(element, from, to, duration, callback) {
var easeOut = cubicBezier(0.25, 0.46, 0.45, 1),
startTime = 0,
currentTime = 0,
progress = 0,
easeProgress = 0,
distance = to - from,
scrollTop = element.scrollTop,
animationTimer = SnapListview.animationTimer;
startTime = window.performance.now();
if (animationTimer !== null) {
window.cancelAnimationFrame(animationTimer);
}
animationTimer = window.requestAnimationFrame(function animation() {
var gap;
currentTime = window.performance.now();
progress = (currentTime - startTime) / duration;
easeProgress = easeOut(progress);
gap = distance * easeProgress;
element.scrollTop = scrollTop + gap;
if (progress <= 1 && progress >= 0) {
animationTimer = window.requestAnimationFrame(animation);
} else {
animationTimer = null;
if (callback && typeof callback === "function") {
callback();
}
}
});
}
SnapListview.prototype = prototype;
ns.widget.wearable.SnapListview = SnapListview;
engine.defineWidget(
"SnapListview",
".ui-snap-listview",
[],
SnapListview,
"wearable"
);
}(window, window.document, ns));
/*global ns, window, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Gesture Plugin: swipe
* Plugin enables swipe event.
*
* @class ns.event.gesture.Swipe
*/
(function (ns) {
"use strict";
var gesture = ns.event.gesture,
Result = gesture.Result,
Detector = gesture.Detector,
Swipe = Detector.plugin.create({
/**
* Gesture name
* @property {string} [name="swipe"]
* @member ns.event.gesture.Swipe
*/
name: "swipe",
/**
* Gesture Index
* @property {number} [index=400]
* @member ns.event.gesture.Swipe
*/
index: 400,
/**
* Default values for swipe gesture
* @property {Object} defaults
* @property {number} [defaults.timeThreshold=400]
* @property {number} [defaults.velocity=0.6]
* @property {ns.event.gesture.HORIZONTAL|ns.event.gesture.VERTICAL} [defaults.orientation=ns.event.gesture.HORIZONTAL]
* @member ns.event.gesture.Swipe
*/
defaults: {
timeThreshold: 400,
velocity: 0.6,
orientation: gesture.Orientation.HORIZONTAL
},
/**
* Handler for swipe gesture
* @method handler
* @param {Event} gestureEvent gesture event
* @param {Object} sender event's sender
* @param {Object} options options
* @return {number}
* @member ns.event.gesture.Swipe
*/
handler: function (gestureEvent, sender, options) {
var result = Result.PENDING,
velocity = options.velocity;
if (gestureEvent.eventType === gesture.Event.END) {
if ((gestureEvent.deltaTime > options.timeThreshold) ||
(options.orientation !== gesture.utils.getOrientation(gestureEvent.direction))) {
result = Result.FINISHED;
} else if (gestureEvent.velocityX > velocity || gestureEvent.velocityY > velocity) {
sender.sendEvent(this.name, gestureEvent);
result = Result.FINISHED | Result.BLOCK;
}
}
return result;
}
});
gesture.Swipe = Swipe;
}(ns));
/*global window, ns, define, Event, console */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true, plusplus: true */
/**
* # Swipe List
* Shows a list where you can swipe horizontally through a list item to perform a specific task.
*
* The swipe list widget shows on the screen a list where you can swipe horizontally through a list item to activate a specific feature or perform a specific task. For example, you can swipe a contact in a contact list to call them or to open a message editor in order to write them a message.
*
* The following table describes the supported swipe list options.
*
* @example
* <div class="ui-content">
* <!--List items that can be swiped-->
* <ul class="ui-listview ui-swipelist-list">
* <li>Andrew</li>
* <li>Bill</li>
* <li>Christina</li>
* <li>Daniel</li>
* <li>Edward</li>
* <li>Peter</li>
* <li>Sam</li>
* <li>Tom</li>
* </ul>
* <!--Swipe actions-->
* <div class="ui-swipelist">
* <div class="ui-swipelist-left">
* <div class="ui-swipelist-icon"></div>
* <div class="ui-swipelist-text">Calling</div>
* </div>
* <div class="ui-swipelist-right">
* <div class="ui-swipelist-icon"></div>
* <div class="ui-swipelist-text">Message</div>
* </div>
* </div>
* </div>
* <script>
* (function () {
* var page = document.getElementById("swipelist"),
* listElement = page.getElementsByClassName("ui-swipelist-list", "ul")[0],
* swipeList;
* page.addEventListener("pageshow", function () {
* // Make swipe list object
* var options = {
* left: true,
* right: true
* };
* swipeList = new tau.widget.SwipeList(listElement, options);
* });
* page.addEventListener("pagehide", function () {
* // Release object
* swipeList.destroy();
* });
* })();
* </script>
* @class ns.widget.wearable.SwipeList
* @since 2.2
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var gesture = ns.event.gesture,
utilsEvents = ns.event,
engine = ns.engine,
dom = ns.util.DOM,
selectors = ns.util.selectors,
eventType = {
/**
* Triggered when a left-to-right swipe is completed.
* @event swipelist.left
* @member ns.widget.wearable.SwipeList
*/
LEFT: "swipelist.left",
/**
* Triggered when a right-to-left swipe is completed.
* @event swipelist.right
* @member ns.widget.wearable.SwipeList
*/
RIGHT: "swipelist.right"
},
SwipeList = function () {
/**
* SwipeList's container.
* @property {?HTMLElement} [container=null]
* @member ns.widget.wearable.SwipeList
*/
this.container = null;
/**
* SwipeList's element.
* @property {?HTMLElement} [swipeElement=null]
* @member ns.widget.wearable.SwipeList
*/
this.swipeElement = null;
/**
* Left element of widget.
* @property {?HTMLElement} [swipeLeftElement=null]
* @member ns.widget.wearable.SwipeList
*/
this.swipeLeftElement = null;
/**
* Right element of widget.
* @property {?HTMLElement} [swipeRightElement=null]
* @member ns.widget.wearable.SwipeList
*/
this.swipeRightElement = null;
/**
* Style of SwipeList's element.
* @property {?Object} [swipeElementStyle=null]
* @member ns.widget.wearable.SwipeList
*/
this.swipeElementStyle = null;
/**
* Style of left element of widget.
* @property {?Object} [swipeLeftElementStyle=null]
* @member ns.widget.wearable.SwipeList
*/
this.swipeLeftElementStyle = null;
/**
* Style of right element of widget.
* @property {?Object} [swipeRightElementStyle=null]
* @member ns.widget.wearable.SwipeList
*/
this.swipeRightElementStyle = null;
/**
* Active element of widget.
* @property {?HTMLElement} [activeElement=null]
* @member ns.widget.wearable.SwipeList
*/
this.activeElement = null;
/**
* Target of swipe event.
* @property {?HTMLElement} [activeTarget=null]
* @member ns.widget.wearable.SwipeList
*/
this.activeTarget = null;
/**
* Function calls on destroying.
* @property {?Function} [resetLayoutCallback=null]
* @member ns.widget.wearable.SwipeList
*/
this.resetLayoutCallback = null;
this.options = {};
this._interval = 0;
this._cancelled = false;
this._dragging = false;
this._animating = false;
},
prototype = new ns.widget.BaseWidget(),
blockEvent = function (event) {
event.preventDefault();
};
prototype._configure = function () {
/**
* Options for widget
* @property {Object} options
* @property {boolean} [options.left=false] Set to true to allow swiping from left to right.
* @property {boolean} [options.right=false] Set to true to allow swiping from right to left.
* @property {number} [options.threshold=10] Define the threshold (in pixels) for the minimum swipe movement which allows the swipe action to appear.
* @property {number} [options.animationThreshold=150] Define the threshold (in pixels) for the minimum swipe movement that allows a swipe animation (with a color change) to be shown. The animation threshold is usually the threshold for the next operation after the swipe.
* @property {number} [options.animationDuration=200] Define the swipe list animation duration. Do not change the default value, since it has been defined to show a complete color change.
* @property {number} [options.animationInterval=8] Define the swipe list animation interval. The animation is called with the requestAnimationFrame() method once every 1/60 seconds. The interval determines how many coordinates the animation proceeds between each call. The animation ends when the coordinates reach the value defined as animationDuration. This option basically allows you to control the speed of the animation.
* @property {string} [options.ltrStartColor=""] Define the start color for the left-to-right swipe.
* @property {string} [options.ltrEndColor=""] Define the end color for the left-to-right swipe.
* @property {string} [options.rtlStartColor=""] Define the start color for the right-to-left swipe.
* @property {string} [options.rtlEndColor=""] Define the end color for the right-to-left swipe.
* @property {?HTMLElement} [options.container=null] Define container of widget.
* @property {string} [options.swipeTarget="li"] Selector for swipe list
* @property {string} [options.swipeElement=".ui-swipelist"] Selector for swipe list container
* @property {string} [options.swipeLeftElement=".ui-swipelist-left"] Selector for swipe left container
* @property {string} [options.swipeRightElement=".ui-swipelist-right"] Selector for swipe right container
* @member ns.widget.wearable.SwipeList
*/
this.options = {
threshold: 10,
animationThreshold: 150,
animationDuration: 200,
animationInterval: 8,
container: null,
swipeTarget: "li",
swipeElement: ".ui-swipelist",
swipeLeftElement: ".ui-swipelist-left",
swipeRightElement: ".ui-swipelist-right",
ltrStartColor: "",
ltrEndColor: "",
rtlStartColor: "",
rtlEndColor: ""
};
};
prototype._init = function (element) {
var page = selectors.getClosestBySelector(element, "." + ns.widget.core.Page.classes.uiPage),
options = this.options,
swipeLeftElementBg,
swipeRightElementBg,
rgbStringRgExp = /rgb\(([0-9]+), ([0-9]+), ([0-9]+)\)/g;
if (options.container) {
this.container = page.querySelector(options.container);
} else {
this.container = element.parentNode;
}
this.scrollableElement = selectors.getScrollableParent(element);
if (!this.scrollableElement) {
this.scrollableElement = this.container;
}
this.swipeElement = page.querySelector(options.swipeElement);
this.swipeLeftElement = options.swipeLeftElement ? page.querySelector(options.swipeLeftElement) : undefined;
this.swipeRightElement = options.swipeRightElement ? page.querySelector(options.swipeRightElement) : undefined;
if (this.swipeElement) {
this.swipeElementStyle = this.swipeElement.style;
this.swipeElementStyle.display = "none";
this.swipeElementStyle.background = "transparent";
this.swipeElementStyle.width = this.scrollableElement.offsetWidth + "px";
this.swipeElementStyle.height = this.scrollableElement.offsetHeight + "px";
}
if (this.swipeLeftElement) {
this.swipeLeftElementStyle = this.swipeLeftElement.style;
this.swipeLeftElementStyle.display = "none";
// Get background-color value for swipe left element
swipeLeftElementBg = this.swipeLeftElement ? dom.getCSSProperty(this.swipeLeftElement, "background-image").match(rgbStringRgExp) : undefined;
}
if (this.swipeRightElement) {
this.swipeRightElementStyle = this.swipeRightElement.style;
this.swipeRightElementStyle.display = "none";
// Get background-color value for swipe right element
swipeRightElementBg = this.swipeRightElement ? dom.getCSSProperty(this.swipeRightElement, "background-image").match(rgbStringRgExp) : undefined;
}
// Set start/end color: If user set color as option, that color will be used. If not, css based color of swipe will be used.
if (swipeLeftElementBg) {
options.ltrStartColor = options.ltrStartColor || swipeLeftElementBg[0];
options.ltrEndColor = options.ltrEndColor || swipeLeftElementBg[1];
}
if (swipeRightElementBg) {
options.rtlStartColor = options.rtlStartColor || swipeRightElementBg[0];
options.rtlEndColor = options.rtlEndColor || swipeRightElementBg[1];
}
this.resetLayoutCallback = null;
if (this.swipeElement.parentNode !== this.container) {
this.resetLayoutCallback = (function (parent, nextSibling, element) {
return function () {
try {
if (nextSibling) {
parent.insertBefore(element, nextSibling);
} else {
parent.appendChild(element);
}
} catch (e) {
element.parentNode.removeChild(element);
}
};
}(this.swipeElement.parentNode, this.swipeElement.nextElementSibling, this.swipeElement));
this.container.appendChild(this.swipeElement);
}
};
prototype._reset = function () {
this.container.style.position = "";
this.swipeElementStyle.display = "";
this.swipeElementStyle.background = "";
this.swipeElementStyle.width = "";
this.swipeElementStyle.height = "";
this.swipeLeftElementStyle.display = "";
this.swipeLeftElementStyle.background = "";
this.swipeRightElementStyle.display = "";
this.swipeRightElementStyle.background = "";
if (this.resetLayoutCallback) {
this.resetLayoutCallback();
}
this._unbindEvents();
};
prototype._bindEvents = function () {
ns.event.enableGesture(
this.element,
new gesture.Drag({
threshold: this.options.threshold,
blockVertical: true
}),
new gesture.Swipe({
orientation: gesture.Orientation.HORIZONTAL
})
);
utilsEvents.on(this.element, "drag dragstart dragend dragcancel swipe", this);
utilsEvents.on(document, "scroll touchcancel", this);
utilsEvents.on(this.swipeElement, "touchstart touchmove touchend", blockEvent, false);
};
prototype._unbindEvents = function () {
ns.event.disableGesture(this.element);
utilsEvents.off(this.element, "drag dragstart dragend dragcancel swipe", this);
utilsEvents.off(document, "scroll touchcancel", this);
utilsEvents.off(this.swipeElement, "touchstart touchmove touchend", blockEvent, false);
};
prototype.handleEvent = function (event) {
switch (event.type) {
case "dragstart":
this._start(event);
break;
case "drag":
this._move(event);
break;
case "dragend":
this._end(event);
break;
case "swipe":
this._swipe(event);
break;
case "dragcancel":
case "scroll":
this._cancel();
break;
}
};
prototype._translate = function (activeElementStyle, translateX, anim) {
var deltaX = translateX / window.innerWidth * 100,
self = this,
fromColor,
toColor,
prefix;
if (this.swipeLeftElement && translateX >= 0) {
// left
fromColor = self.options.ltrStartColor;
toColor = self.options.ltrEndColor;
prefix = "left";
} else if (this.swipeRightElement && translateX < 0) {
fromColor = self.options.rtlStartColor;
toColor = self.options.rtlEndColor;
prefix = "right";
deltaX = Math.abs(deltaX);
}
(function animate() {
activeElementStyle.background = "-webkit-linear-gradient(" + prefix + ", " + fromColor + " 0%, " + toColor + " " + deltaX + "%)";
if (anim && deltaX < self.options.animationDuration) {
self._animating = true;
deltaX += self.options.animationInterval;
window.webkitRequestAnimationFrame(animate);
} else if (anim && deltaX >= self.options.animationDuration) {
self._animating = false;
self._transitionEnd();
}
}());
};
prototype._findSwipeTarget = function (element) {
var selector = this.options.swipeTarget;
while (element && element.webkitMatchesSelector && !element.webkitMatchesSelector(selector)) {
element = element.parentNode;
}
return element;
};
prototype._fireEvent = function (eventName, detail) {
var target = this.activeTarget || this.listElement;
utilsEvents.trigger(target, eventName, detail);
};
prototype._start = function (e) {
var gesture = e.detail,
width,
height,
top;
this._dragging = false;
this._cancelled = false;
this.activeTarget = this._findSwipeTarget(gesture.srcEvent.target);
if (this.activeTarget) {
width = this.activeTarget.offsetWidth;
height = this.activeTarget.offsetHeight;
top = this.activeTarget.offsetTop - this.scrollableElement.scrollTop;
if (this.swipeLeftElementStyle) {
this.swipeLeftElementStyle.width = width + "px";
this.swipeLeftElementStyle.height = height + "px";
this.swipeLeftElementStyle.top = top + "px";
}
if (this.swipeRightElementStyle) {
this.swipeRightElementStyle.width = width + "px";
this.swipeRightElementStyle.height = height + "px";
this.swipeRightElementStyle.top = top + "px";
}
this._dragging = true;
}
};
prototype._move = function (e) {
var gestureInfo = e.detail,
translateX = gestureInfo.estimatedDeltaX,
activeElementStyle;
if (!this._dragging || this._cancelled) {
return;
}
if (this.swipeLeftElement && (gestureInfo.direction === gesture.Direction.RIGHT) && translateX >= 0) {
if (this.swipeRightElementStyle) {
this.swipeRightElementStyle.display = "none";
}
this.activeElement = this.swipeLeftElement;
activeElementStyle = this.swipeLeftElementStyle;
} else if (this.swipeRightElement && (gestureInfo.direction === gesture.Direction.LEFT) && translateX < 0) {
if (this.swipeLeftElementStyle) {
this.swipeLeftElementStyle.display = "none";
}
this.activeElement = this.swipeRightElement;
activeElementStyle = this.swipeRightElementStyle;
}
if (!activeElementStyle) {
return;
}
activeElementStyle.display = "block";
this.swipeElementStyle.display = "block"; // wrapper element
this._translate(activeElementStyle, translateX, false);
};
prototype._end = function (e) {
var gesture = e.detail;
if (!this._dragging || this._cancelled) {
return;
}
if (this.swipeLeftElement && (gesture.estimatedDeltaX > this.options.animationThreshold)) {
this._fire(eventType.LEFT, e);
} else if (this.swipeRightElement && (gesture.estimatedDeltaX < -this.options.animationThreshold)) {
this._fire(eventType.RIGHT, e);
} else {
this._hide();
}
this._dragging = false;
};
prototype._swipe = function (e) {
var gestureInfo = e.detail;
if (!this._dragging || this._cancelled) {
return;
}
if (this.swipeLeftElement && (gestureInfo.direction === gesture.Direction.RIGHT)) {
this._fire(eventType.LEFT, e);
} else if (this.swipeRightElement && (gestureInfo.direction === gesture.Direction.LEFT)) {
this._fire(eventType.RIGHT, e);
} else {
this._hide();
}
this._dragging = false;
};
prototype._fire = function (type, e) {
var gesture = e.detail;
if (type === eventType.LEFT) {
this._translate(this.swipeLeftElementStyle, gesture.estimatedDeltaX, true);
} else if (type === eventType.RIGHT) {
this._translate(this.swipeRightElementStyle, gesture.estimatedDeltaX, true);
}
};
prototype._transitionEnd = function () {
this._hide();
if (this.activeElement === this.swipeLeftElement) {
this._fireEvent(eventType.LEFT);
} else if (this.activeElement === this.swipeRightElement) {
this._fireEvent(eventType.RIGHT);
}
};
prototype._cancel = function () {
this._dragging = false;
this._cancelled = true;
this._hide();
};
prototype._hide = function () {
if (this.swipeElementStyle) {
this.swipeElementStyle.display = "none";
}
if (this.activeElement) {
this.activeElement.style.display = "none";
}
};
prototype._destroy = function () {
this._reset();
this.element = null;
this.container = null;
this.swipeElement = null;
this.swipeLeftElement = null;
this.swipeRightElement = null;
this.swipeElementStyle = null;
this.swipeLeftElementStyle = null;
this.swipeRightElementStyle = null;
this.activeElement = null;
this.activeTarget = null;
this.startX = null;
this.options = null;
this.gesture = null;
this._cancelled = null;
this._dragging = null;
this._animating = null;
};
SwipeList.prototype = prototype;
ns.widget.wearable.SwipeList = SwipeList;
engine.defineWidget(
"SwipeList",
".ui-swipe",
[],
SwipeList
);
}(window.document, ns));
/*global ns, window, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Gesture Plugin: longPress
* Plugin enables long press event.
*
* @class ns.event.gesture.LongPress
*/
(function (ns) {
"use strict";
/**
* Local alias for {@link ns.event.gesture}
* @property {Object}
* @member ns.event.gesture.LongPress
* @private
* @static
*/
var gesture = ns.event.gesture,
/**
* Local alias for {@link ns.event.gesture.Detector}
* @property {Object}
* @member ns.event.gesture.LongPress
* @private
* @static
*/
Detector = gesture.Detector,
LongPress = Detector.plugin.create({
/**
* Gesture name
* @property {string} [name="longpress"]
* @member ns.event.gesture.LongPress
*/
name: "longpress",
/**
* Gesture Index
* @property {number} [index=200]
* @member ns.event.gesture.LongPress
*/
index: 600,
/**
* Default values for longPress gesture
* @property {Object} defaults
* @property {number} [defaults.timeThreshold=400]
* @property {number} [defaults.longPressDistanceThreshold=15]
* @property {boolean} [defaults.preventClick]
* @member ns.event.gesture.LongPress
*/
defaults: {
longPressTimeThreshold: 750,
longPressDistanceThreshold: 20,
preventClick: true
},
/**
* IsTriggered
* @property {boolean} [isTriggered=false]
* @member ns.event.gesture.LongPress
*/
isTriggered: false,
/**
* longPressTimeOutId
* @property {number} [longPressTimeOutId=0]
* @member ns.event.gesture.LongPress
*/
longPressTimeOutId: 0,
/**
* Handler for longPress gesture
* @method handler
* @param {Event} gestureEvent gesture event
* @param {Object} sender event's sender
* @param {Object} options options
* @return {number}
* @member ns.event.gesture.LongPress
*/
handler: function (gestureEvent, sender, options) {
var result = gesture.Result.PENDING;
switch (gestureEvent.eventType) {
case gesture.Event.START:
this.isTriggered = false;
this.longPressTimeOutId = setTimeout(function () {
this.isTriggered = true;
sender.sendEvent(this.name, gestureEvent);
}.bind(this), options.longPressTimeThreshold);
break;
case gesture.Event.MOVE:
if (gestureEvent.distance > options.longPressDistanceThreshold && !this.isTriggered) {
clearTimeout(this.longPressTimeOutId);
result = gesture.Result.FINISHED;
}
break;
case gesture.Event.END:
if (!this.isTriggered) {
clearTimeout(this.longPressTimeOutId);
} else if (options.preventClick) {
gestureEvent.preventDefault();
}
result = gesture.Result.FINISHED;
break;
}
return result;
}
});
gesture.LongPress = LongPress;
}(ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # Selector Component
*
* Selector component is special component that has unique UX of Tizen wearable profile.
* Selector component has been used in more options commonly but If you want to use other situation
* then you can use this component as standalone component in everywhere.
* Selector component was consisted as selector element and item elements. You can set the item
* selector, each items locate degree and radius.
* Selector component has made layers automatically. Layer has items and you can set items number
* on one layer.
* Indicator is indicator that located center of Selector. We provide default indicator style and
* function.
* But, If you want to change indicator style and function, you can make the custom indicator and
* set your indicator for operate with Selector.
* Indicator arrow is special indicator style that has the arrow. That was used for provide more
* correct indicate information for user.
* Also, you can make the custom indicator arrow and set your custom indicator arrow for operate
* with Selector.
* Selector provide to control for arrow indicate active item position.
*
* ## HTML example
*
* @example
* <div class="ui-page ui-page-active" id="main">
* <div id="selector" class="ui-selector">
* <div class="ui-item ui-show-icon" data-title="Show"></div>
* <div class="ui-item ui-human-icon" data-title="Human"></div>
* <div class="ui-item ui-delete-icon" data-title="Delete"></div>
* <div class="ui-item ui-show-icon" data-title="Show"></div>
* <div class="ui-item ui-human-icon" data-title="Human"></div>
* <div class="ui-item ui-delete-icon" data-title="Delete"></div>
* <div class="ui-item ui-x-icon" data-title="X Icon"></div>
* <div class="ui-item ui-fail-icon" data-title="Fail"></div>
* <div class="ui-item ui-show-icon" data-title="Show"></div>
* <div class="ui-item ui-human-icon" data-title="Human"></div>
* <div class="ui-item ui-delete-icon" data-title="Delete"></div>
* </div>
* </div>
*
* ## Manual constructor
*
* @example
* (function() {
* var page = document.getElementById("selectorPage"),
* selector = document.getElementById("selector"),
* clickBound;
*
* function onClick(event) {
* var activeItem = selector.querySelector(".ui-item-active");
* }
* page.addEventListener("pagebeforeshow", function() {
* clickBound = onClick.bind(null);
* tau.widget.Selector(selector);
* selector.addEventListener("click", clickBound, false);
* });
* page.addEventListener("pagebeforehide", function() {
* selector.removeEventListener("click", clickBound, false);
* });
* })();
*
* ## Options
* Selector component options
*
* {string} itemSelector [options.itemSelector=".ui-item"] or You can set attribute on tag
* [data-item-selector=".ui-item] Selector item selector that style is css selector.
* {string} indicatorSelector [options.indicatorSelector=".ui-selector-indicator"] or You can set
* attribute on tag [data-indicator-selector=".ui-selector-indicator"] Selector indicator selector
* that style is css selector.
* {string} indicatorArrowSelector [options.indicatorArrowSelector=".ui-selector-indicator-arrow"]
* or You can set attribute on tag [data-indicator-arrow-selector=".ui-selector-indicator-arrow"]
* Selector indicator arrow selector that style is css style.
* {number} itemDegree [options.itemDegree=30] or You can set attribute on tag
* [data-item-degree=30] Items degree each other.
* {number} itemRadius [options.itemRadius=140] or You can set attribute on tag
* [data-item-radius=140] Items radius between center and it.
* {number} maxItemNumber [options.maxItemNumber=11] or You can set attribute on tag
* [data-max-item-number=11] Max item number on one layer. If you change the itemDegree, we
* recommend to consider to modify this value for fit your Selector layout.
* {boolean} indicatorAutoControl [options.indicatorAutoControl=true] or You can set attribute on
* tag [data-indicator-auto-control=true] Indicator auto control switch. If you want to control
* your indicator manually, change this options to false.
*
* @class ns.widget.wearable.Selector
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (document, ns) {
"use strict";
var engine = ns.engine,
utilDom = ns.util.DOM,
Gesture = ns.event.gesture,
events = ns.event,
utilsObject = ns.util.object,
requestAnimationFrame = window.requestAnimationFrame || window.webkitRequestAnimationFrame,
Selector = function () {
var self = this;
self._ui = {};
self.options = {
editable: false,
plusButton: true
};
self._editModeEnabled = false;
self._movedElementIndex = null;
self._destinationIndex = null;
self._pointedLayer = null;
self._changeLayerInterval = null;
self._itemsToReorder = [];
self._removedItemIndex = null;
self._reorderEnd = null;
self._reorderAnimationEnd = null;
},
classes = {
SELECTOR: "ui-selector",
LAYER: "ui-layer",
LAYER_ACTIVE: "ui-layer-active",
LAYER_PREV: "ui-layer-prev",
LAYER_NEXT: "ui-layer-next",
LAYER_HIDE: "ui-layer-hide",
ITEM: "ui-item",
ITEM_ACTIVE: "ui-item-active",
ITEM_REMOVABLE: "ui-item-removable",
ITEM_ICON_REMOVE: "ui-item-icon-remove",
ITEM_ICON_REMOVE_BG: "ui-item-icon-remove-bg",
INDICATOR: "ui-selector-indicator",
INDICATOR_ACTIVE: "ui-selector-indicator-active",
INDICATOR_TEXT: "ui-selector-indicator-text",
INDICATOR_ICON: "ui-selector-indicator-icon",
INDICATOR_ICON_ACTIVE: "ui-selector-indicator-icon-active",
INDICATOR_ICON_ACTIVE_WITH_TEXT: "ui-selector-indicator-icon-active-with-text",
INDICATOR_SUBTEXT: "ui-selector-indicator-subtext",
INDICATOR_WITH_SUBTITLE: "ui-selector-indicator-with-subtext",
INDICATOR_NEXT_END: "ui-selector-indicator-next-end",
INDICATOR_PREV_END: "ui-selector-indicator-prev-end",
INDICATOR_ARROW: "ui-selector-indicator-arrow",
EDIT_MODE: "ui-selector-edit-mode",
REORDER: "ui-selector-reorder",
PLUS_BUTTON: "ui-item-plus",
ITEM_PLACEHOLDER: "ui-item-placeholder",
ITEM_MOVED: "ui-item-moved",
ITEM_REMOVED: "ui-item-removed",
ITEM_END: "ui-item-moved-end"
},
STATIC = {
RADIUS_RATIO: 0.8,
SCALE_FACTOR: 0.8235
},
DEFAULT = {
ITEM_SELECTOR: "." + classes.ITEM,
INDICATOR_SELECTOR: "." + classes.INDICATOR,
INDICATOR_TEXT_SELECTOR: "." + classes.INDICATOR_TEXT,
INDICATOR_ARROW_SELECTOR: "." + classes.INDICATOR_ARROW,
ITEM_DEGREE: 30,
MAX_ITEM_NUMBER: 11,
ITEM_RADIUS: -1,
ITEM_START_DEGREE: 30,
ITEM_END_DEGREE: 330,
ITEM_NORMAL_SCALE: "scale(" + STATIC.SCALE_FACTOR + ")",
ITEM_ACTIVE_SCALE: "scale(1)",
ITEM_MOVED_SCALE: "scale(0.92)",
EMPTY_STATE_TEXT: "Selector is empty"
},
EVENT_TYPE = {
/**
* Triggered when the active item is changed. Target is active item element.
* This event has detail information.
* - layer: Layer element on active item
* - layerIndex: Layer's index on active item
* - index: Item index on layer.
* - title: If Item has 'data-title' attribute, this value is that.
* @event selectoritemchange
* @member ns.widget.wearable.Selector
*/
ITEM_CHANGE: "selectoritemchange",
/**
* Triggered when the active layer is changed. Target is active layer element.
* This event has detail information.
* - index: Layer index.
* @event selectorlayerchange
* @member ns.widget.wearable.Selector
*/
LAYER_CHANGE: "selectorlayerchange"
},
BaseWidget = ns.widget.BaseWidget,
prototype = new BaseWidget();
Selector.prototype = prototype;
function buildLayers(element, items, options) {
var layers = [],
layer,
i,
len;
removeLayers(element, options);
len = items.length;
for (i = 0; i < len; i++) {
if (!(i % options.maxItemNumber)) {
layer = document.createElement("div");
layer.classList.add(classes.LAYER);
element.appendChild(layer);
layers.push(layer);
}
if (layer) {
layer.appendChild(items[i]);
if (utilDom.getNSData(items[i], "active")) {
items[i].classList.add(classes.ITEM_ACTIVE);
layer.classList.add(classes.LAYER_ACTIVE);
}
}
}
return layers;
}
function removeLayers(element, options) {
var layers = element.getElementsByClassName(classes.LAYER),
items,
i,
len,
j,
itemLength;
if (layers.length) {
// Delete legacy layers
len = layers.length;
for (i = 0; i < len; i++) {
items = layers[0].querySelectorAll(options.itemSelector);
itemLength = items.length;
for (j = 0; j < itemLength; j++) {
element.appendChild(items[j]);
}
element.removeChild(layers[0]);
}
}
}
/**
* Bind events
* @method bindEvents
* @param {Object} self
* @private
* @member ns.widget.wearable.Selector
*/
function bindEvents(self) {
var element = self.element;
events.enableGesture(
element,
new Gesture.Drag(),
new Gesture.LongPress(),
new Gesture.Swipe({
orientation: Gesture.Orientation.HORIZONTAL
})
);
events.on(document, "rotarydetent", self, false);
events.on(document, "swipe", self, true);
self.on("dragstart drag dragend click longpress mouseup touchend transitionend" +
" animationend webkitAnimationEnd", self, false);
}
/**
* Unbind events
* @method unbindEvents
* @param {Object} self
* @private
* @member ns.widget.wearable.Selector
*/
function unbindEvents(self) {
var element = self.element;
events.disableGesture(
element
);
events.off(document, "rotarydetent", self, false);
events.off(document, "swipe", self, true);
self.off("dragstart drag dragend click longpress mouseup touchend transitionend" +
" animationend webkitAnimationEnd", self, false);
}
/**
* Remove ordering classes of layers base on parameter.
* @method removeLayerClasses
* @param {HTMLElement} activeLayer
* @private
* @member ns.widget.wearable.Selector
*/
function removeLayerClasses(activeLayer) {
var activePrevLayer = activeLayer.previousElementSibling,
activeNextLayer = activeLayer.nextElementSibling;
if (activePrevLayer) {
activePrevLayer.classList.remove(classes.LAYER_PREV);
}
if (activeNextLayer) {
activeNextLayer.classList.remove(classes.LAYER_NEXT);
}
activeLayer.classList.remove(classes.LAYER_ACTIVE);
}
/**
* Add ordering classes of layers base on parameter.
* @method addLayerClasses
* @param {HTMLElement} validLayer
* @private
* @member ns.widget.wearable.Selector
*/
function addLayerClasses(validLayer) {
var validPrevLayer = validLayer.previousElementSibling,
validNextLayer = validLayer.nextElementSibling;
if (validPrevLayer && validPrevLayer.classList.contains(classes.LAYER)) {
validPrevLayer.classList.add(classes.LAYER_PREV);
}
if (validNextLayer && validNextLayer.classList.contains(classes.LAYER)) {
validNextLayer.classList.add(classes.LAYER_NEXT);
}
validLayer.classList.add(classes.LAYER_ACTIVE);
validLayer.style.transform = "none";
}
function setItemTransform(element, degree, radius, selfDegree, scale) {
element.style.transform = "rotate(" + degree + "deg) " +
"translate3d(0, " + -radius + "px, 0) " +
"rotate(" + selfDegree + "deg) " +
scale;
}
function setIndicatorTransform(element, selfDegree) {
element.style.transform = "rotate(" + selfDegree + "deg) translate3d(0, 0, 0)";
element.style.transition = "transform 300ms";
}
prototype._configure = function () {
var self = this;
/**
* Selector component options
* @property {string} itemSelector [options.itemSelector=".ui-item"] Selector item selector
* that style is css selector.
* @property {string} indicatorSelector
* [options.indicatorSelector=".ui-selector-indicator"] Selector indicator selector that
* style is css selector.
* @property {string} indicatorArrowSelector
* [options.indicatorArrowSelector=".ui-selector-indicator-arrow"] Selector indicator
* arrow selector that style is css style.
* @property {number} itemDegree [options.itemDegree=30] Each items locate degree.
* @property {number} itemRadius [options.itemRadius=-1] Items locate radius between center
* to it. Default value is determined by Selector element layout.
* @property {number} maxItemNumber [options.maxItemNumber=11] Max item number on one
* layer. If you change the itemDegree, we recommend to consider to modify this value for
* fit your Selector layout.
* @property {boolean} indicatorAutoControl [options.indicatorAutoControl=true] Indicator
* auto control switch. If you want to control your indicator manually, change this options
* to false.
*/
self.options = utilsObject.merge(self.options, {
itemSelector: DEFAULT.ITEM_SELECTOR,
indicatorSelector: DEFAULT.INDICATOR_SELECTOR,
indicatorTextSelector: DEFAULT.INDICATOR_TEXT_SELECTOR,
indicatorArrowSelector: DEFAULT.INDICATOR_ARROW_SELECTOR,
itemDegree: DEFAULT.ITEM_DEGREE,
itemRadius: DEFAULT.ITEM_RADIUS,
maxItemNumber: DEFAULT.MAX_ITEM_NUMBER,
indicatorAutoControl: true,
emptyStateText: DEFAULT.EMPTY_STATE_TEXT
});
};
/**
* Create indicator structure
* @param {Object} ui
* @param {HTMLElement} element
*/
function createIndicator(ui, element) {
var indicator,
indicatorText,
indicatorSubText,
indicatorIcon;
indicator = document.createElement("div");
indicator.classList.add(classes.INDICATOR);
ui.indicator = indicator;
indicatorIcon = document.createElement("div");
indicatorIcon.classList.add(classes.INDICATOR_ICON);
ui.indicatorIcon = indicatorIcon;
ui.indicator.appendChild(ui.indicatorIcon);
indicatorText = document.createElement("div");
indicatorText.classList.add(classes.INDICATOR_TEXT);
ui.indicatorText = indicatorText;
indicator.appendChild(indicatorText);
indicatorSubText = document.createElement("div");
indicatorSubText.classList.add(classes.INDICATOR_SUBTEXT);
ui.indicatorSubText = indicatorSubText;
ui.indicator.appendChild(ui.indicatorSubText);
element.appendChild(ui.indicator);
}
prototype._buildIndicator = function (element) {
var self = this,
options = self.options,
ui = self._ui,
queryIndicator = element.querySelector(options.indicatorSelector),
queryIndicatorArrow = element.querySelector(options.indicatorArrowSelector),
queryIndicatorText = element.querySelector(options.indicatorTextSelector),
indicatorArrow;
if (queryIndicator) {
ui.indicator = queryIndicator;
if (queryIndicatorText) {
ui.indicatorText = queryIndicatorText;
}
} else {
createIndicator(ui, element);
}
if (queryIndicatorArrow) {
ui.indicatorArrow = queryIndicatorArrow;
} else {
indicatorArrow = document.createElement("div");
indicatorArrow.classList.add(classes.INDICATOR_ARROW);
ui.indicatorArrow = indicatorArrow;
element.appendChild(ui.indicatorArrow);
}
};
/**
* Build Selector component
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement} element
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
options = self.options,
items = element.querySelectorAll(self.options.itemSelector),
layers;
if (items && items.length) {
layers = buildLayers(element, items, options);
element.classList.add(classes.SELECTOR);
if (options.indicatorAutoControl) {
self._buildIndicator(element);
}
ui.items = items;
ui.layers = layers;
} else {
ns.warn("Please check your item selector option. Default value is '.ui-item'");
return null;
}
return element;
};
/**
* Init Selector component
* @method _init
* @param {HTMLElement} element
* @return {HTMLElement} element
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._init = function (element) {
var self = this,
options = self.options,
items = self._ui.items,
activeLayerIndex = self._getActiveLayer(),
activeItemIndex = self._getActiveItem(),
validLayout = element.offsetWidth > element.offsetHeight ?
element.offsetHeight : element.offsetWidth,
i,
len;
self._started = false;
self._enabled = true;
self._activeItemIndex = activeItemIndex === null ? 0 : activeItemIndex;
options.itemRadius = options.itemRadius < 0 ? validLayout / 2 * STATIC.RADIUS_RATIO :
options.itemRadius;
len = items.length;
for (i = 0; i < len; i++) {
utilDom.setNSData(items[i], "index", i);
setItemTransform(items[i], DEFAULT.ITEM_END_DEGREE, options.itemRadius,
-DEFAULT.ITEM_END_DEGREE, DEFAULT.ITEM_NORMAL_SCALE);
}
if (activeLayerIndex === null) {
self._activeLayerIndex = 0;
self._setActiveLayer(0);
} else {
self._activeLayerIndex = activeLayerIndex;
self._setActiveLayer(activeLayerIndex);
}
return element;
};
/**
* Init items on layer
* @method _initItems
* @param {HTMLElement} layer
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._initItems = function (layer) {
var self = this,
options = self.options,
items = layer.querySelectorAll(options.itemSelector),
degree,
i,
len;
len = items.length > options.maxItemNumber ? options.maxItemNumber : items.length;
for (i = 0; i < len; i++) {
if (self._itemsToReorder.indexOf(i) === -1) {
degree = DEFAULT.ITEM_START_DEGREE + (options.itemDegree * i);
setItemTransform(items[i], degree, options.itemRadius, -degree,
DEFAULT.ITEM_NORMAL_SCALE);
}
}
if (self._editModeEnabled) {
self._animateReorderedItems();
}
if (self.options.plusButton) {
len--;
}
if (!self._editModeEnabled && len > 0) {
self._setActiveItem(self._activeItemIndex);
}
};
prototype._animateReorderedItems = function () {
var self = this,
options = self.options,
layer = self._ui.layers[self._activeLayerIndex],
items = layer.querySelectorAll(options.itemSelector),
reorderedItems = self._itemsToReorder,
length = reorderedItems.length,
degree,
i;
if (length) {
self._disable();
setTimeout(function () {
for (i = 0; i < length; i++) {
degree = DEFAULT.ITEM_START_DEGREE + (options.itemDegree *
reorderedItems[i]);
setItemTransform(items[reorderedItems[i]], degree, options.itemRadius,
-degree, DEFAULT.ITEM_NORMAL_SCALE);
}
self._itemsToReorder = [];
}, 30);
}
};
prototype._addIconRemove = function (item, index) {
var maxItemNumber = this.options.maxItemNumber,
iconScaleFactor = 1 / STATIC.SCALE_FACTOR,
iconElement = document.createElement("div"),
iconBgElement = document.createElement("div"),
leftItemsCount,
removeIconPosition;
leftItemsCount = parseInt(maxItemNumber / 2, 10) - 1;
removeIconPosition = (index % maxItemNumber) > leftItemsCount ? "right" : "left";
iconBgElement.classList.add(classes.ITEM_ICON_REMOVE_BG);
iconElement.classList.add(classes.ITEM_ICON_REMOVE + "-" + removeIconPosition);
iconElement.style.transform = "scale(" + iconScaleFactor + ")";
iconElement.appendChild(iconBgElement);
item.classList.add(classes.ITEM_REMOVABLE);
item.appendChild(iconElement);
};
prototype._addRemoveIcons = function () {
var self = this,
isRemovable,
item,
items = self._ui.items,
i;
for (i = 0; i < items.length; i++) {
item = items[i];
isRemovable = utilDom.getNSData(item, "removable");
item.setAttribute("draggable", "true");
if (isRemovable !== false) {
self._addIconRemove(item, i);
}
}
};
prototype._removeRemoveIcons = function () {
var self = this,
i,
items = self._ui.items,
item;
for (i = 0; i < items.length; i++) {
item = items[i];
if (item.classList.contains(classes.ITEM_REMOVABLE)) {
item.innerHTML = "";
item.classList.remove(classes.ITEM_REMOVABLE);
}
}
};
/**
* Bind events on Selector component
* @method _bindEvents
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._bindEvents = function () {
bindEvents(this);
};
/**
* Handle events on Selector component
* @method handleEvent
* @param {Event} event
* @public
* @member ns.widget.wearable.Selector
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "dragstart":
self._onDragstart(event);
break;
case "drag":
self._onDrag(event);
break;
case "dragend":
self._onDragend(event);
break;
case "click":
self._onClick(event);
break;
case "rotarydetent":
self._onRotary(event);
break;
case "transitionend":
self._onTransitionEnd(event);
break;
case "animationend":
case "webkitAnimationEnd":
self._onAnimationEnd(event);
break;
case "longpress":
self._onLongPress(event);
break;
case "mouseup":
case "touchend":
self._onTouchEnd(event);
break;
case "tizenhwkey":
event.stopPropagation();
self._onHWKey(event);
break;
case "swipe":
self._onSwipe(event);
break;
}
};
/**
* Get the active layer
* @method _getActiveLayer
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._getActiveLayer = function () {
var self = this,
ui = self._ui,
i,
len;
len = ui.layers.length;
for (i = 0; i < len; i++) {
if (ui.layers[i].classList.contains(classes.LAYER_ACTIVE)) {
return i;
}
}
return null;
};
/**
* Set the active layer
* @method _setActiveLayer
* @param {number} index
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._setActiveLayer = function (index) {
var self = this,
ui = self._ui,
active = self._activeLayerIndex,
activeLayer = ui.layers[active],
validLayer = ui.layers[index];
if (activeLayer) {
removeLayerClasses(activeLayer);
}
if (validLayer) {
addLayerClasses(validLayer);
}
self._activeLayerIndex = index;
if (ui.items.length > 0 && ui.layers[index]) {
self._initItems(validLayer);
events.trigger(validLayer, EVENT_TYPE, {
index: index
});
}
};
/**
* Get the active item
* @method _getActiveItem
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._getActiveItem = function () {
var self = this,
ui = self._ui,
i,
len;
len = ui.items.length;
for (i = 0; i < len; i++) {
if (ui.items[i].classList.contains(classes.ITEM_ACTIVE)) {
return i;
}
}
return null;
};
/**
* Set the active item
* @method _setActiveItem
* @param {number} index
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._setActiveItem = function (index) {
var self = this,
element = self.element,
ui = self._ui,
items = ui.items,
transform,
newTransformStyle,
active = element.querySelector("." + classes.ITEM_ACTIVE);
index = index !== undefined ? index : 0;
transform = items[index].style.transform || items[index].style.webkitTransform;
if (active) {
active.style.transform =
active.style.transform.replace(DEFAULT.ITEM_ACTIVE_SCALE,
DEFAULT.ITEM_NORMAL_SCALE);
active.classList.remove(classes.ITEM_ACTIVE);
}
if (items.length) {
items[index].classList.add(classes.ITEM_ACTIVE);
newTransformStyle = transform.replace(DEFAULT.ITEM_NORMAL_SCALE,
DEFAULT.ITEM_ACTIVE_SCALE);
items[index].style.transform = newTransformStyle;
items[index].style.webkitTransform = newTransformStyle;
if (self.options.indicatorAutoControl) {
self._setIndicatorIndex(index);
}
self._activeItemIndex = index;
events.trigger(items[index], EVENT_TYPE.ITEM_CHANGE, {
layer: ui.layers[self._activeLayerIndex],
layerIndex: self._activeLayerIndex,
index: index,
title: utilDom.getNSData(items[index], "title")
});
}
};
/**
* Set indicator index. Handler direction was set by index value.
* @method _setIndicatorIndex
* @param {number} index
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._setIndicatorIndex = function (index) {
var self = this,
ui = self._ui,
item = ui.items[index],
title = utilDom.getNSData(item, "title"),
icon = utilDom.getNSData(item, "icon"),
subtext = utilDom.getNSData(item, "subtitle"),
iconActiveClass = classes.INDICATOR_ICON_ACTIVE,
iconActiveWithTextClass = classes.INDICATOR_ICON_ACTIVE_WITH_TEXT,
indicatorWithSubtitleClass = classes.INDICATOR_WITH_SUBTITLE,
indicator = ui.indicator,
indicatorText = ui.indicatorText,
indicatorIcon = ui.indicatorIcon,
indicatorSubText = ui.indicatorSubText,
indicatorArrow = ui.indicatorArrow,
indicatorClassList = indicator.classList,
indicatorIconClassList = indicatorIcon.classList,
idcIndex = index % self.options.maxItemNumber;
if (title) {
indicatorText.textContent = title;
if (subtext) {
indicatorClassList.add(indicatorWithSubtitleClass);
indicatorSubText.textContent = subtext;
} else {
indicatorClassList.remove(indicatorWithSubtitleClass);
indicatorSubText.textContent = "";
}
if (icon) {
indicatorIconClassList.add(iconActiveWithTextClass);
}
} else {
indicatorText.textContent = "";
indicatorIconClassList.remove(iconActiveWithTextClass);
}
if (icon) {
indicatorIconClassList.add(iconActiveClass);
indicatorIcon.style.backgroundImage = "url(" + icon + ")";
indicatorSubText.textContent = "";
} else {
indicatorIconClassList.remove(iconActiveClass);
indicatorIconClassList.remove(iconActiveWithTextClass);
}
utilDom.setNSData(indicator, "index", index);
setIndicatorTransform(indicatorArrow, DEFAULT.ITEM_START_DEGREE + self.options.itemDegree *
idcIndex);
};
/**
* Dragstart event handler
* @method _onDragstart
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._onDragstart = function () {
this._started = true;
};
/**
* Clear active class on animation end
* @method _onAnimationEnd
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._onAnimationEnd = function (event) {
var self = this,
ui = self._ui,
targetClassList = event.target.classList;
if (targetClassList.contains(classes.INDICATOR)) {
ui.indicator.classList.remove(classes.INDICATOR_ACTIVE);
} else if (targetClassList.contains(classes.ITEM_MOVED)) {
self._reorderAnimationEnd = true;
if (self._reorderEnd && !self._started) {
setTimeout(function () {
ui.movedItem.classList.add(classes.ITEM_END);
}, 30);
}
}
};
prototype._onTransitionEnd = function (event) {
var self = this,
targetElement = event.target,
classList = targetElement.classList;
if (!self._enabled && classList.contains(classes.ITEM)) {
if (classList.contains(classes.ITEM_REMOVED)) {
self.removeItem(parseInt(utilDom.getNSData(targetElement, "index"), 10));
} else if (classList.contains(classes.ITEM_END)) {
self._clearReorder();
} else if (classList.contains(classes.ITEM_MOVED)) {
requestAnimationFrame(function () {
classList.add(classes.ITEM_END);
});
} else if (!self._reorderEnd) {
self._enable();
}
}
};
prototype._clearReorder = function () {
var self = this,
ui = self._ui;
ui.items[self._destinationIndex].classList.remove(classes.ITEM_PLACEHOLDER);
self.element.removeChild(self._ui.movedItem);
ui.movedItem = null;
self.element.classList.remove(classes.REORDER);
self._movedElementIndex = null;
self._destinationIndex = null;
self._pointedLayer = null;
clearInterval(self._changeLayerInterval);
self._changeLayerInterval = null;
self._enable();
self._reorderEnd = false;
self._reorderAnimationEnd = false;
};
prototype._onDragMovedElement = function (pointedElement, x, y, index) {
var self = this,
movedItemStyle = self._ui.movedItem.style,
pointedClassList = pointedElement && pointedElement.classList;
movedItemStyle.top = y + "px";
movedItemStyle.left = x + "px";
if (pointedElement) {
if (pointedClassList.contains(classes.LAYER_PREV)) {
self._pointedLayer = "prev";
} else if (pointedClassList.contains(classes.LAYER_NEXT)) {
self._pointedLayer = "next";
} else {
self._pointedLayer = null;
clearInterval(self._changeLayerInterval);
self._changeLayerInterval = null;
}
}
if (self._enabled) {
if (pointedElement && self._pointedLayer !== null) {
self._moveItemToLayer();
}
if (index !== null && index !== self._destinationIndex) {
self._setNewItemDestination(index);
}
}
};
/**
* Drag event handler
* @method _onDrag
* @param {Event} event
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._onDrag = function (event) {
var self = this,
x,
y,
pointedElement,
index = null;
if (this._started) {
x = event.detail.estimatedX;
y = event.detail.estimatedY;
pointedElement = document.elementFromPoint(x, y);
if (pointedElement && pointedElement.classList.contains(classes.ITEM) &&
!pointedElement.classList.contains(classes.ITEM_PLACEHOLDER)) {
index = parseInt(utilDom.getNSData(pointedElement, "index"), 10);
}
if (!self._editModeEnabled && index !== null) {
self._setActiveItem(index);
}
if (self._movedElementIndex !== null) {
self._onDragMovedElement(pointedElement, x, y, index);
}
}
};
prototype._moveItemToLayer = function () {
var self = this,
layer = self._pointedLayer;
if (self._changeLayerInterval === null) {
self._changeLayerInterval = setInterval(function () {
if (self._pointedLayer !== null && layer === self._pointedLayer) {
if (layer === "prev") {
self._setPreviousLayer();
} else {
self._setNextLayer();
}
}
}, 1000);
}
};
prototype._setNextLayer = function () {
var self = this,
options = self.options,
items = self._ui.items,
len = items.length,
i;
if (self._enabled) {
for (i = 0; i < len; i++) {
utilDom.setNSData(items[i], "index", i);
setItemTransform(items[i], DEFAULT.ITEM_START_DEGREE, options.itemRadius,
-DEFAULT.ITEM_START_DEGREE, DEFAULT.ITEM_NORMAL_SCALE);
}
self._setItemAndLayer(self._activeLayerIndex + 1,
(self._activeLayerIndex + 1) * self.options.maxItemNumber);
}
};
prototype._setPreviousLayer = function () {
var self = this,
options = self.options,
items = self._ui.items,
len = items.length,
i;
if (self._enabled) {
for (i = 0; i < len; i++) {
utilDom.setNSData(items[i], "index", i);
setItemTransform(items[i], DEFAULT.ITEM_END_DEGREE, options.itemRadius,
-DEFAULT.ITEM_END_DEGREE, DEFAULT.ITEM_NORMAL_SCALE);
}
self._setItemAndLayer(self._activeLayerIndex - 1,
self._activeLayerIndex * self.options.maxItemNumber - 1);
}
};
prototype._setNewItemDestination = function (index) {
var self = this,
element = self.element,
destinationIndex = self._destinationIndex,
items = self._ui.items,
destinationParent;
removeLayers(element, self.options);
destinationParent = items[destinationIndex].parentNode;
if (index + 1 > self._destinationIndex) {
destinationParent.insertBefore(items[destinationIndex], items[index + 1]);
} else {
destinationParent.insertBefore(items[destinationIndex], items[index]);
}
self._ui.items = element.querySelectorAll("." + classes.ITEM + ":not(." +
classes.ITEM_MOVED + ")");
self._refresh();
self._destinationIndex = index;
};
prototype._onTouchEnd = function () {
var self = this,
ui = self._ui,
movedElement,
movedStyle,
destinationRect;
if (self._movedElementIndex !== null && !self._reorderEnd) {
self.disable();
self._reorderEnd = true;
movedElement = ui.movedItem;
movedStyle = movedElement.style;
movedStyle.transition = "top 200ms, left 200ms, opacity 200ms, transform 200ms";
destinationRect = ui.items[self._destinationIndex].getBoundingClientRect();
if (self._reorderAnimationEnd && !self._started) {
setTimeout(function () {
movedElement.classList.add(classes.ITEM_END);
}, 30);
} else if (self._reorderAnimationEnd) {
movedStyle.top = (destinationRect.top + destinationRect.width / 2) + "px";
movedStyle.left = (destinationRect.left + destinationRect.height / 2) +
"px";
}
}
};
/**
* Dragend event handler
* @method _onDragend
* @param {Event} event
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._onDragend = function (event) {
var self = this,
pointedElement = self._getPointedElement(event.detail),
index;
if (!self._editModeEnabled && pointedElement &&
pointedElement.classList.contains(classes.ITEM)) {
index = parseInt(utilDom.getNSData(pointedElement, "index"), 10);
self._setActiveItem(index);
}
self._started = false;
};
prototype._onClickChangeActive = function (targetElement) {
var self = this,
ui = self._ui,
pointedElement = document.elementFromPoint(event.pageX, event.pageY),
indicatorClassList = self._ui.indicator.classList,
activeLayer,
prevLayer,
nextLayer,
index;
if (ui.items.length > 0) {
activeLayer = ui.layers[self._activeLayerIndex];
prevLayer = activeLayer.previousElementSibling;
nextLayer = activeLayer.nextElementSibling;
}
if (targetElement.classList.contains(classes.LAYER_PREV) && prevLayer) {
self._setPreviousLayer();
} else if (targetElement.classList.contains(classes.LAYER_NEXT) && nextLayer) {
self._setNextLayer();
} else if (self._enabled && !self._editModeEnabled) {
if (pointedElement && (pointedElement.classList.contains(classes.INDICATOR) ||
pointedElement.parentElement.classList.contains(classes.INDICATOR))) {
indicatorClassList.remove(classes.INDICATOR_ACTIVE);
requestAnimationFrame(function () {
indicatorClassList.add(classes.INDICATOR_ACTIVE);
});
}
if (pointedElement && pointedElement.classList.contains(classes.ITEM)) {
index = parseInt(utilDom.getNSData(pointedElement, "index"), 10);
self._setActiveItem(index);
}
}
};
/**
* Click event handler
* @method _onClick
* @param {Event} event
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._onClick = function (event) {
var self = this,
targetElement = event.target,
targetClassList = targetElement.classList,
activeItem = self._getActiveItem(),
indicatorClassList = null;
if (activeItem !== null &&
self._ui.items[activeItem] === targetElement) {
// Show press effect on selector indicator after click on selected item
indicatorClassList = self._ui.indicator.classList;
requestAnimationFrame(function () {
indicatorClassList.add(classes.INDICATOR_ACTIVE);
});
}
self._onClickChangeActive(targetElement);
if (targetElement.classList.contains(classes.PLUS_BUTTON)) {
self.trigger("add");
}
if (self._editModeEnabled) {
event.stopImmediatePropagation();
if (self._enabled &&
(targetClassList.contains(classes.ITEM_ICON_REMOVE + "-left") ||
targetClassList.contains(classes.ITEM_ICON_REMOVE + "-right"))) {
self._disable();
targetElement.parentElement.classList.add(classes.ITEM_REMOVED);
}
}
};
/**
* Sets active layer and item
* @param {number} layerIndex
* @param {number} itemIndex
* @private
*/
prototype._setItemAndLayer = function (layerIndex, itemIndex) {
this._activeItemIndex = itemIndex;
this._changeLayer(layerIndex);
};
prototype._onRotaryCW = function () {
var self = this,
ui = self._ui,
options = self.options,
activeLayer = ui.layers[self._activeLayerIndex],
activeLayerItemsLength = activeLayer &&
activeLayer.querySelectorAll(options.itemSelector).length,
bounceDegree;
// check length
if ((self._activeItemIndex === (activeLayerItemsLength +
self._activeLayerIndex * options.maxItemNumber) - 1) ||
self._editModeEnabled) {
if (self._siblingLayerExists("next")) {
self._setNextLayer();
} else {
bounceDegree = DEFAULT.ITEM_START_DEGREE + options.itemDegree *
(self._activeItemIndex % options.maxItemNumber);
setIndicatorTransform(ui.indicatorArrow, bounceDegree +
options.itemDegree / 3);
setTimeout(function () {
setIndicatorTransform(ui.indicatorArrow, bounceDegree);
}, 100);
}
} else {
self._changeItem(self._activeItemIndex + 1);
}
};
prototype._onRotaryCCW = function () {
var self = this,
ui = self._ui,
options = self.options;
// check 0
if ((self._activeItemIndex % options.maxItemNumber === 0) ||
self._editModeEnabled) {
if (self._siblingLayerExists("prev")) {
self._setPreviousLayer();
} else {
setIndicatorTransform(ui.indicatorArrow, DEFAULT.ITEM_START_DEGREE -
DEFAULT.ITEM_START_DEGREE / 3);
setTimeout(function () {
setIndicatorTransform(ui.indicatorArrow, DEFAULT.ITEM_START_DEGREE);
}, 100);
}
} else {
self._changeItem(self._activeItemIndex - 1);
}
};
/**
* Rotary event handler
* @method _onRotary
* @param {Event} event
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._onRotary = function (event) {
var self = this,
ui = self._ui,
options = self.options,
direction = event.detail.direction;
if (!options.indicatorAutoControl || !self._enabled || ui.items.length === 0) {
return;
}
event.stopPropagation();
if (direction === "CW") {
self._onRotaryCW();
} else {
self._onRotaryCCW();
}
};
/**
* Hide items on layer
* @method _hideItems
* @param {HTMLElement} layer
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._hideItems = function (layer) {
var self = this,
items = layer.getElementsByClassName(classes.ITEM),
i,
len;
layer.classList.add(classes.LAYER_HIDE);
len = items.length;
for (i = 0; i < len; i++) {
setItemTransform(items[i], DEFAULT.ITEM_START_DEGREE, self.options.itemRadius,
-DEFAULT.ITEM_START_DEGREE, DEFAULT.ITEM_NORMAL_SCALE);
}
setTimeout(function () {
len = items.length;
for (i = 0; i < len; i++) {
setItemTransform(items[i], DEFAULT.ITEM_END_DEGREE, self.options.itemRadius,
-DEFAULT.ITEM_END_DEGREE, DEFAULT.ITEM_NORMAL_SCALE);
}
layer.classList.remove(classes.LAYER_HIDE);
}, 150);
};
prototype._setIndexes = function () {
var self = this,
ui = self._ui,
items = ui.items,
i;
for (i = 0; i < ui.items.length; i++) {
utilDom.setNSData(items[i], "index", i);
}
};
prototype._refreshEditMode = function () {
var self = this,
ui = self._ui,
items = ui.items,
options = self.options,
reorderedItems = self._itemsToReorder,
maxItemNumber = options.maxItemNumber,
activeLayerIndex = self._activeLayerIndex,
lastOnLayerIndex = (activeLayerIndex + 1) * maxItemNumber,
firstOnLayerIndex = activeLayerIndex * maxItemNumber,
index,
additionalDegree,
i,
isCorrectIndex;
for (i = 0; i < ui.items.length; i++) {
index = parseInt(utilDom.getNSData(items[i], "index"), 10);
isCorrectIndex = i !== index && !Number.isNaN(index);
if (isCorrectIndex &&
(i < lastOnLayerIndex) &&
(i >= firstOnLayerIndex) &&
!items[i].classList.contains(classes.ITEM_PLACEHOLDER)) {
if (index >= lastOnLayerIndex) {
additionalDegree = DEFAULT.ITEM_START_DEGREE +
(options.itemDegree * maxItemNumber);
setItemTransform(items[i], additionalDegree, options.itemRadius,
-additionalDegree, DEFAULT.ITEM_NORMAL_SCALE);
}
reorderedItems.push(i % maxItemNumber);
}
}
};
/**
* Refresh Selector component
* @method _refresh
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._refresh = function () {
var self = this,
ui = self._ui,
items = ui.items,
options = self.options,
element = self.element;
if (self._editModeEnabled) {
self._removeRemoveIcons();
self._refreshEditMode();
self._setIndexes();
self._addRemoveIcons();
} else {
self._setIndexes();
}
ui.layers = buildLayers(element, items, options);
self._setActiveLayer(self._activeLayerIndex);
};
/**
* Change active layer
* @method _changeLayer
* @param {number} index
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._changeLayer = function (index) {
var self = this,
layers = self._ui.layers,
activeLayer = layers[self._activeLayerIndex];
if (index < 0 || index > layers.length - 1) {
ns.warn("Please insert index between 0 to layers number");
return;
}
self._enabled = false;
self._hideItems(activeLayer);
requestAnimationFrame(function () {
self._setActiveLayer(index);
});
};
prototype._onLongPress = function (event) {
var self = this,
pointedElement = self._getPointedElement(event.detail),
pointedClassList = pointedElement.classList,
index = parseInt(utilDom.getNSData(pointedElement, "index"), 10),
movedElement;
if (self.options.editable && self._editModeEnabled === false) {
self._enableEditMode();
}
if (self._editModeEnabled && pointedClassList.contains(classes.ITEM) &&
!pointedClassList.contains(classes.PLUS_BUTTON)) {
movedElement = self._ui.items[index];
self._cloneMovedItem(index);
movedElement.classList.add(classes.ITEM_PLACEHOLDER);
self._movedElementIndex = index;
self._destinationIndex = index;
self.element.classList.add(classes.REORDER);
}
};
prototype._getPointedElement = function (detail) {
var x = detail.estimatedX,
y = detail.estimatedY;
return document.elementFromPoint(x, y);
};
prototype._cloneMovedItem = function (index) {
var self = this,
element = self.element,
clonedElement,
clonedElementRect,
movedElement,
initialPosX,
initialPosY;
clonedElement = self._ui.items[index];
movedElement = clonedElement.cloneNode(true);
clonedElementRect = clonedElement.getBoundingClientRect();
// This sets moved item in the middle of cloned item
// Additional operations are needed due to margins set on items
initialPosX = clonedElementRect.left + clonedElementRect.height / 2;
initialPosY = clonedElementRect.top + clonedElementRect.width / 2;
movedElement.classList.add(classes.ITEM_MOVED);
movedElement.setAttribute("style", "left:" + initialPosX + "px; top:" +
initialPosY + "px");
element.appendChild(movedElement);
self._ui.movedItem = element.querySelector("." + classes.ITEM_MOVED);
};
prototype._onHWKey = function (event) {
var self = this;
if (event.keyName === "back" && self.options.editable && self._editModeEnabled) {
self._disableEditMode();
}
};
/**
* Check if sibling (next or previous) layer exists
* @method _siblingLayerExists
* @param {string} sibling ["next", "prev"]
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._siblingLayerExists = function (sibling) {
var self = this,
next = sibling === "next",
ui = self._ui,
activeLayer = ui.layers[self._activeLayerIndex],
siblingLayer = activeLayer && (next ?
activeLayer.nextElementSibling :
activeLayer.previousElementSibling);
return siblingLayer && siblingLayer.classList.contains(next ?
classes.LAYER_NEXT :
classes.LAYER_PREV);
}
prototype._onSwipe = function (event) {
var self = this;
if ((event.detail.direction === "right") &&
(self._siblingLayerExists("next"))) {
self._setNextLayer();
} else if ((event.detail.direction === "left") &&
(self._siblingLayerExists("prev"))) {
self._setPreviousLayer();
}
};
prototype._addPlusButton = function () {
var plusButtonElement;
plusButtonElement = document.createElement("div");
plusButtonElement.classList.add(classes.PLUS_BUTTON);
utilDom.setNSData(plusButtonElement, "removable", "false");
this.addItem(plusButtonElement);
};
prototype._removePlusButton = function () {
var self = this,
items = self._ui.items,
lastItemIndex = items.length - 1,
itemsOnLayer = self.options.maxItemNumber,
activeLayerIndex = self._activeLayerIndex,
firstItemOnLayerIndex;
firstItemOnLayerIndex = activeLayerIndex * itemsOnLayer;
if (lastItemIndex === firstItemOnLayerIndex) {
self._changeLayer(activeLayerIndex - 1);
}
if (items[lastItemIndex].classList.contains(classes.PLUS_BUTTON)) {
self.removeItem(lastItemIndex);
}
};
prototype._enableEditMode = function () {
var self = this,
ui = self._ui,
length = ui.items.length,
activeItem = ui.items[self._activeItemIndex];
if (self.options.plusButton) {
self._addPlusButton();
}
self._addRemoveIcons();
self.element.classList.add(classes.EDIT_MODE);
ui.indicatorText.textContent = "Edit mode";
if (length > 0) {
activeItem.classList.remove(classes.ITEM_ACTIVE);
requestAnimationFrame(function () {
activeItem.style.transform =
activeItem.style.transform.replace(DEFAULT.ITEM_ACTIVE_SCALE,
DEFAULT.ITEM_NORMAL_SCALE);
});
}
events.on(window, "tizenhwkey", self, true);
self._editModeEnabled = true;
};
prototype._disableEditMode = function () {
var self = this,
items,
ui = self._ui,
elementClassList = self.element.classList;
if (self.options.plusButton) {
self._removePlusButton();
}
elementClassList.remove(classes.EDIT_MODE);
items = ui.items;
if (items.length > 0) {
items[self._activeItemIndex].classList.add(classes.ITEM_ACTIVE);
self._removeRemoveIcons();
requestAnimationFrame(function () {
self._setActiveItem(self._activeItemIndex);
});
} else {
ui.indicatorText.textContent = self.options.emptyStateText;
ui.indicatorSubText.textContent = "";
ui.indicatorIcon.classList.remove(classes.INDICATOR_ICON_ACTIVE,
classes.INDICATOR_ICON_ACTIVE_WITH_TEXT);
}
events.off(window, "tizenhwkey", self, true);
self._editModeEnabled = false;
};
/**
* Change active item on active layer
* @method _changeItem
* @param {number} index
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._changeItem = function (index) {
this._setActiveItem(index);
};
/**
* Change active item on active layer
* @method changeItem
* @param {number} index
* @public
* @member ns.widget.wearable.Selector
*/
prototype.changeItem = function (index) {
this._changeItem(index);
};
/**
* Add new item
* @method addItem
* @param {HTMLElement} item
* @param {number} index
* @public
* @member ns.widget.wearable.Selector
*/
prototype.addItem = function (item, index) {
var self = this,
element = self.element,
items = element.querySelectorAll(self.options.itemSelector),
plusBtnIndex = items.length - 1,
plusBtnEnabled = items[plusBtnIndex].classList.contains(classes.PLUS_BUTTON),
ui = self._ui,
length = plusBtnEnabled ? ui.items.length : ui.items.length - 1;
removeLayers(self.element, self.options);
setItemTransform(item, DEFAULT.ITEM_END_DEGREE,
self.options.itemRadius, -DEFAULT.ITEM_END_DEGREE, DEFAULT.ITEM_NORMAL_SCALE);
item.classList.add(classes.ITEM);
if (index >= 0 && index < length) {
element.insertBefore(item, items[index]);
} else if (plusBtnEnabled) {
element.insertBefore(item, items[plusBtnIndex]);
} else {
element.appendChild(item);
}
ui.items = element.querySelectorAll(self.options.itemSelector);
self._refresh();
};
/**
* Remove item on specific layer
* @method removeItem
* @param {number} index
* @public
* @member ns.widget.wearable.Selector
*/
prototype.removeItem = function (index) {
var self = this,
ui = self._ui,
element = self.element,
length,
itemsOnLayer = self.options.maxItemNumber;
removeLayers(self.element, self.options);
element.removeChild(ui.items[index]);
ui.items = element.querySelectorAll(self.options.itemSelector);
length = ui.items.length;
/** This block checks if the removed item is last on active layer, and if this
* condition is true, it changes active layer to previous one.
*/
if ((index % itemsOnLayer === 0) && (index === ui.items.length - 1)) {
self._changeLayer(self._activeLayerIndex - 1);
}
if (self._activeItemIndex >= length) {
self._activeItemIndex = length - 1;
}
self._refresh();
};
prototype._destroy = function () {
var self = this,
activeItem;
unbindEvents(self);
activeItem = self._getActiveItem();
if (activeItem !== null) {
self._ui.items[activeItem].classList.remove(classes.ITEM_ACTIVE);
}
self._ui = null;
};
/**
* Disable Selector
* @method _disable
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._disable = function () {
this._enabled = false;
};
/**
* Enable Selector
* @method _enable
* @protected
* @member ns.widget.wearable.Selector
*/
prototype._enable = function () {
this._enabled = true;
};
ns.widget.wearable.Selector = Selector;
engine.defineWidget(
"Selector",
".ui-selector",
[
"changeItem",
"addItem",
"removeItem",
"enable",
"disable"
],
Selector,
"wearable"
);
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
/*global window, ns, define */
/**
* #Grid
*
* @class ns.widget.wearable.Grid
* @since 3.0
* @extends ns.widget.wearable.Listview
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function (window, document) {
"use strict";
var Listview = ns.widget.wearable.Listview,
/**
* Alias for class {@link ns.engine}
* @property {Object} engine
* @member ns.widget.wearable.Grid
* @private
* @static
*/
engine = ns.engine,
/* Alias for helper methods from Array */
slice = [].slice,
min = Math.min,
max = Math.max,
round = Math.round,
ceil = Math.ceil,
easeOutQuad = ns.util.easing.easeOutQuad,
/**
* Cache for anim states
* @property {Array} anims
*/
anims = [],
render = function (state) {
var dTime = Date.now() - state.startTime,
progress = dTime / state.duration;
if (!state.end) {
state.current = easeOutQuad(Math.min(progress, 1), state.from, state.to, 1);
// apply scroll value to element
state.element[state.propertyName] = state.current;
// register callback for next request animation frame;
state.requestHandler = window.requestAnimationFrame(state.render);
}
if (progress > 1) {
state.end = true;
window.cancelAnimationFrame(state.requestHandler);
state.requestHandler = null;
}
},
createState = function (from, to, element, duration, options) {
var state = {
from: from,
to: to,
current: from,
startTime: Date.now(),
duration: duration,
end: true,
render: null,
requestHandler: null,
element: element,
propertyName: options && options.propertyName || "scrollTop"
};
state.render = render.bind(null, state);
anims.push(state);
return state;
},
find = function (element) {
return anims.filter(function (state) {
return state.element === element;
})[0];
},
request = function (state, items) {
var len = items.length,
i = 0,
duration = state.duration,
progress = (Date.now() - state.startTime) / duration,
draw = state.drawFn,
timing = state.timingFn;
// calculation
for (; i < len; ++i) {
timing(items[i], min(progress, 1));
}
// draw
for (i = 0; i < len; ++i) {
draw(items[i], i);
}
// add request animation frame
if (!state.end) {
state.handler = window.requestAnimationFrame(state.request);
} else {
if (typeof state.onEnd === "function") {
state.onEnd();
}
}
if (progress > 1) {
state.end = true;
}
},
/**
* Method to create animation on object properties
* @param {Array|Object} items
* @param {number} duration
* @param {Function} timingFn
* @param {Function} drawFn
* @param {Function} onEnd
* @return {Object}
*/
anim = function anim(items, duration, timingFn, drawFn, onEnd) {
// item (or items) should has properties: from, to
var state = {
end: false,
startTime: Date.now(),
duration: duration,
timingFn: timingFn,
drawFn: drawFn,
onEnd: onEnd
};
items = (Array.isArray(items)) ? items : [items];
state.request = request.bind(null, state, items);
// animation run
state.handler = window.requestAnimationFrame(state.request);
return state;
},
// setting for Grid which depend from options
GRID_SETTINGS = {
// setting for lines = 2
2: {
circle: {
marginTop: -75,
marginLeft: 38,
marginRight: 140,
scale: 0.3833,
scaleThumbnail: 0.6,
scaleThumbnailX: 0.6,
marginThumbnail: 26,
size: 146
},
rectangle: {
marginTop: -66,
marginLeft: 57,
marginRight: 230,
scale: 0.325,
scaleThumbnail: 0.715,
scaleThumbnailX: 0.4722,
marginThumbnail: -8,
size: 130
}
},
// setting for lines = 3
3: {
circle: {
marginTop: 0,
marginLeft: 11,
marginRight: 179,
scale: 0.3027,
scaleThumbnail: 0.6,
scaleThumbnailX: 0.6,
marginThumbnail: 26,
size: 115
},
rectangle: {
}
}
},
/**
* Alias for class Grid
* @method Grid
* @member ns.widget.wearable.Grid
* @private
* @static
*/
Grid = function () {
var self = this;
/**
* Object with default options
* @property {Object} options
* @property {string} [options.mode="3x3"] grid mode
* @property {boolean} [options.scrollbar=true] enable/disable scrollbar
* @property {number} [options.lines=3] number of lines in grid view: 2 or 3
* @property {string} [options.mode="circle"] shape of block: circle or rectangle
* @member ns.widget.wearable.Grid
*/
self.options = {
// default Grid mode is Thumbnail 3x3
mode: "3x3",
scrollbar: true,
lines: 3,
shape: "circle",
orientation: "horizontal"
};
self._ui = {
container: null
};
self._currentIndex = -1;
self._settings = GRID_SETTINGS[3].circle;
},
CLASS_PREFIX = "ui-grid",
CLASSES = {
SHAPE_PREFIX: CLASS_PREFIX + "-",
MODE3X3: CLASS_PREFIX + "-3x3",
THUMBNAIL: CLASS_PREFIX + "-thumbnail",
IMAGE: CLASS_PREFIX + "-image",
THUMB: "thumb",
POSITIONED: "ui-positioned"
},
GALLERY_SIZE = 360,
HEIGHT_IN_GRID_MODE = 101,
GRID_MARGIN = 5,
SCROLL_DURATION = 250,
TRANSFORM_DURATION = 450, // [ms]
SCALE = {
IMAGE: 1
},
THUMBNAIL_OPACITY = 0.75,
IMAGE_OPACITY = 1,
prototype = new Listview();
/**
* Method scroll element content with animation
* Extension for TAU (animated-scroll.js)
* @method scrollTo
* @param {HTMLElement} element
* @param {number} changeValue
* @param {number} duration
* @param {Object} [options=null]
* @param {string} [options.propertyName=scrollTop] element property name to animate
* @member ns.widget.wearable.Grid
* @protected
*/
prototype._scrollTo = function (element, changeValue, duration, options) {
var propertyName = options.propertyName || "scrollTop",
state = find(element) ||
createState(element[propertyName], changeValue, element, duration, options);
state.startTime = Date.now();
if (!state.end) {
state.from = state.current;
// snap to multiplication of change value
state.to += 2 * changeValue - (state.current + state.to) % changeValue;
} else {
state.end = false;
state.from = element[propertyName];
state.to = changeValue;
state.duration = duration;
state.render();
}
};
/**
* Toggle selected item by changing class
* @protected
* @param {boolean} visible
* @method _toggleSelectedItem
* @member ns.widget.wearable.Grid
* @protected
*/
prototype._toggleSelectedItem = function (visible) {
var self = this,
item = this._items[self._currentIndex];
if (visible) {
item.element.classList.add("ui-selected");
} else {
item.element.classList.remove("ui-selected");
}
};
function createThumbnail(url, href) {
var li = document.createElement("li"),
a = document.createElement("a"),
img = document.createElement("img");
href = href || "#";
img.setAttribute("src", url);
img.setAttribute("class", CLASSES.THUMB);
a.setAttribute("href", href);
a.appendChild(img);
li.appendChild(a);
li.setAttribute("class", CLASSES.POSITIONED);
return li;
}
/**
* Return size of item for given mode
* @param {string} mode
* @return {number}
* @member ns.widget.wearable.Grid
* @protected
*/
prototype._getItemSize = function (mode) {
var self = this,
settings = self._settings;
switch (mode || self.options.mode) {
case "3x3":
return GALLERY_SIZE * settings.scale + GRID_MARGIN;
case "image":
// full screen
return GALLERY_SIZE;
case "thumbnail":
return GALLERY_SIZE * settings.scaleThumbnailX + settings.marginThumbnail;
default:
return 0;
}
};
prototype._prepareInsertItem = function (items, index, size, scale) {
var self = this,
newItem = items[index],
beforeItems = items.filter(function (item, key) {
return key < index;
}),
afterItems = items.filter(function (item, key) {
return key > index;
});
// apply "to" properties on items
self._applyItemsTo(beforeItems);
// set how to items after insert position will be moved on right
setItemsPositionTo(afterItems, size, self._scrollDimension, self._nonScrollDimension);
// prepare starting position for new item
setItemsPositionTo([newItem], size * index, self._scrollDimension,
self._nonScrollDimension);
// apply "to" properties at new item
self._applyItemsTo([newItem]);
// set new item scale before show
newItem.scale = 0;
// set item scale on end
setItemsScaleTo([newItem], scale);
// prepare items.from
updateItemsFrom(items);
};
prototype._prepareRemoveItem = function (items, index, size) {
var self = this,
afterItems = items.filter(function (item, key) {
return key > index;
});
// set how to items after removed item will be moved on left
setItemsPositionTo(afterItems, -1 * size, self._scrollDimension, self._nonScrollDimension);
};
/**
* Add image to grid
* @param {string} url image url
* @param {number} [index] list index where image will be added
* @return {ns.widget.wearable.Grid}
* @method add
* @member ns.widget.wearable.Grid
*/
prototype.add = function (url, index) {
var self = this,
element = self.element,
thumb = createThumbnail(url),
snapPoint = self._createSnapPoint(),
items = self._items;
// Add new item to "items" array in grid widget
if (index !== undefined && index < element.children.length) {
items.splice(index, 0, createItem(thumb));
self._snapPoints.splice(index, 0, snapPoint);
element.insertBefore(thumb, element.children[index]);
} else {
items.push(createItem(thumb));
self._snapPoints.push(snapPoint);
element.appendChild(thumb);
}
self._updateSnapPointPositions();
// Add thumbnail HTMLElement to grid with animation
switch (self.options.mode) {
case "3x3" :
updateItemsFrom(items);
self._assembleItemsTo3x3(items);
break;
case "image" :
self._prepareInsertItem(items, index, self._getItemSize(), SCALE.IMAGE);
break;
case "thumbnail" :
self._prepareInsertItem(items, index, self._getItemSize(), self.settings.scaleThumbnailX);
break;
}
anim(items, TRANSFORM_DURATION, changeItems, transformItem, function () {
element.style[self._scrollSize] = getGridSize(self, self.options.mode) + "px";
});
// chain
return self;
};
/**
* Remove image from grid
* @param {number} index image index
* @return {ns.widget.wearable.Grid}
* @method remove
* @member ns.widget.wearable.Grid
*/
prototype.remove = function (index) {
var self = this,
element = self.element,
style = element.style,
items = self._items,
item = items[index],
itemTo = item.to,
thumb = item.element,
snapPoints = self._snapPoints;
if (index !== undefined && index < element.children.length) {
updateItemsFrom([item]);
switch (self.options.mode) {
case "3x3" :
// hide item with animation
itemTo.scale = 0;
// move to center of item during disappearing
itemTo.position = {};
itemTo.position[self._scrollDimension] = item.position[self._scrollDimension] +
self._getItemSize() / 2;
itemTo.position[self._nonScrollDimension] = item.position[self._nonScrollDimension];
anim(item, TRANSFORM_DURATION, changeItems, transformItem);
items.splice(index, 1);
snapPoints.splice(index, 1);
// refresh grid 3x3
updateItemsFrom(items);
self._assembleItemsTo3x3(items);
anim(items, TRANSFORM_DURATION, changeItems, transformItem, function () {
self._updateSnapPointPositions();
element.removeChild(thumb);
style[self._scrollSize] = getGridSize(self, "3x3") + "px";
});
break;
case "image" :
case "thumbnail" :
// hide item with animation
itemTo.scale = 0;
// move items after removed item to left
updateItemsFrom(items);
self._prepareRemoveItem(items, index, self._getItemSize());
// transformation
anim(items, TRANSFORM_DURATION, changeItems, transformItem, function () {
self._updateSnapPointPositions();
element.removeChild(thumb);
style[self._scrollSize] = getGridSize(self, self.options.mode) + "px";
items.splice(index, 1);
snapPoints.splice(index, 1);
});
break;
}
}
// chain
return self;
};
prototype._changeModeTo3x3 = function () {
var self = this,
element = self.element,
classList = element.classList;
// remove previous classes;
classList.remove(CLASSES.IMAGE);
// add new classes
classList.add(CLASSES.MODE3X3);
// set proper mode in options
self.options.mode = "3x3";
element.style[self._scrollSize] = self._getGridSize("3x3") + "px";
};
function changeModeToImage(self) {
var element = self.element,
elementClassList = element.classList;
if (self._currentIndex > -1) {
elementClassList.remove(CLASSES.MODE3X3);
elementClassList.remove(CLASSES.THUMBNAIL);
// set grid mode to image
elementClassList.add(CLASSES.IMAGE);
// set proper mode in options
self.options.mode = "image";
}
}
prototype._changeModeToThumbnail = function () {
// thumbnail mode is accessible only from image mode
if (this._currentIndex !== -1) {
this.element.classList.add(CLASSES.THUMBNAIL);
}
};
/**
* Change grid mode
* @param {"3x3"|"thumbnail"|"image"} toMode Grid works in three mode
* @return {ns.widget.wearable.Grid}
* @method mode
* @member ns.widget.wearable.Grid
*/
prototype.mode = function (toMode) {
var self = this,
currentMode = self.options.mode;
switch (toMode) {
case "3x3" :
if (currentMode === "image") {
self.trigger("modechange", {
mode: toMode
});
self._imageToGrid();
} else {
self.trigger("modechange", {
mode: toMode
});
self._changeModeTo3x3();
}
break;
case "image" :
if (currentMode === "3x3") {
self.trigger("modechange", {
mode: toMode
});
self._gridToImage();
} else if (currentMode === "thumbnail") {
self.trigger("modechange", {
mode: toMode
});
self._thumbnailToImage();
}
break;
case "thumbnail" :
if (currentMode === "image") {
self.trigger("modechange", {
mode: toMode
});
self._imageToThumbnail();
} else if (currentMode === "3x3") {
ns.warn("thumbnail mode is not allowed directly from 3x3 mode," +
"change to image mode before");
}
break;
default:
ns.warn("unsupported grid mode, available: 3x3 | image | thumbnail");
break;
}
// chain
return self;
};
/**
* Change current exposed image to image indicated by index
* @param {number} index Image index
* @return {ns.widget.wearable.Grid}
* @method changeIndex
* @member ns.widget.wearable.Grid
*/
prototype.changeIndex = function (index) {
var self = this,
container = self._ui.container,
scrollProperty = self._scrollProperty;
self._currentIndex = index;
self._scrollTo(
container,
self._getGridScrollPosition(self.options.mode) - container[scrollProperty],
SCROLL_DURATION,
{
propertyName: scrollProperty
}
);
// chain
return self;
};
/**
* Get current exposed image
* @method getIndex
* @member ns.widget.wearable.Grid
* @return {number}
*/
prototype.getIndex = function () {
var self = this;
self._currentIndex = self._findItemIndexByScroll(self._ui.container);
return self._currentIndex;
};
prototype._createSnapPoint = function () {
var point = document.createElement("div");
point.className = "snap-point";
return point;
};
prototype._createSnapPoints = function () {
var self = this,
fragment = document.createDocumentFragment(),
items = self._items,
length = items.length,
i = 0,
point,
snapPoints = [];
for (; i < length; i++) {
point = self._createSnapPoint();
snapPoints.push(point);
fragment.appendChild(point);
}
self._ui.container.appendChild(fragment);
self._snapPoints = snapPoints;
};
prototype._updateSnapPointPositions = function () {
var self = this,
snapPoints = self._snapPoints,
len = snapPoints.length,
start = 0,
delta = 0,
interval = 3,
point,
i = 0,
settings = self._settings,
scale = settings.scale;
switch (self.options.mode) {
case "3x3" :
start = GALLERY_SIZE * scale / 2 + settings.marginLeft;
delta = GALLERY_SIZE * scale / 3;
interval = 3;
break;
case "image" :
start = GALLERY_SIZE / 2;
delta = GALLERY_SIZE;
interval = 1;
break;
case "thumbnail" :
start = GALLERY_SIZE / 2;
delta = GALLERY_SIZE * settings.scaleThumbnailX + settings.marginThumbnail;
interval = 1;
break;
}
for (; i < len; i++) {
point = snapPoints[i];
point.style[self._scrollDimension] = start + delta * (i - i % interval) + "px";
}
};
/**
* Widget build method
* @protected
* @method _build
* @param {HTMLElement} element
* @member ns.widget.wearable.Grid
* @return {HTMLElement}
*/
prototype._build = function (element) {
var self = this,
container = document.createElement("div");
self._ui.container = container;
container.setAttribute("class", "ui-grid-container");
self._setScrollbar(element, self.options.scrollbar);
element.parentElement.replaceChild(container, element);
container.appendChild(element);
return element;
};
prototype._setScrollbar = function (element, value) {
var container = this._ui.container;
if (value) {
container.setAttribute("tizen-circular-scrollbar", "");
} else {
container.removeAttribute("tizen-circular-scrollbar");
}
};
/**
* Parse, validate and set lines option and set correct settings for option
* @param {HTMLElement} element
* @param {number|string} value
* @protected
* @method _setLines
* @memberof ns.widget.wearable.Grid
*/
prototype._setLines = function (element, value) {
var linesCount = parseInt(value, 10),
options = this.options;
// validation: possible values 2 or 3, all values different from 2 will be change to 3
// (default)
if (linesCount !== 2) {
linesCount = 3;
}
this._settings = GRID_SETTINGS[linesCount][options.shape];
options.lines = linesCount;
};
/**
*
* @param {HTMLElement} element
* @param {number|string} value
* @protected
* @method _setOrientation
* @memberof ns.widget.wearable.Grid
*/
prototype._setOrientation = function (element, value) {
var self = this,
options = self.options;
// validation: possible values vertical or horizontal, all values different from vertical
// will be change to horizontal (default)
if (value !== "vertical") {
value = "horizontal";
}
if (value === "horizontal") {
self._scrollProperty = "scrollLeft";
self._scrollDimension = "left";
self._nonScrollDimension = "top";
self._scrollSize = "width";
} else {
self._scrollProperty = "scrollTop";
self._scrollDimension = "top";
self._nonScrollDimension = "left";
self._scrollSize = "height";
}
options.orientation = value;
element.classList.add(CLASS_PREFIX + "-" + value);
self._ui.container.classList.add(CLASS_PREFIX + "-" + value);
};
/**
* Validate and set shape style option
* @param {HTMLElement} element
* @param {string} value
* @protected
* @method _setShape
* @memberof ns.widget.wearable.Grid
*/
prototype._setShape = function (element, value) {
var shape = value,
options = this.options,
classList = element.classList;
// validation
if (shape !== "rectangle") {
shape = "circle";
}
classList.remove(CLASSES.SHAPE_PREFIX + options.shape);
classList.add(CLASSES.SHAPE_PREFIX + shape);
this._settings = GRID_SETTINGS[options.lines][shape];
options.shape = shape;
};
/**
* Widget init method
* @protected
* @method _init
* @memberof ns.widget.wearable.Grid
*/
prototype._init = function () {
var self = this,
items = [],
element = self.element,
options = self.options;
self._items = items;
element.classList.add("ui-children-positioned");
self._setLines(element, options.lines);
self._setShape(element, options.shape);
self._setOrientation(element, options.orientation);
// collect grid items from DOM
self._getItems();
self._assembleItemsTo3x3(items);
// apply transformations to items immediately
self._transformItems();
// snap points are used as places where scroll will be stopped
self._createSnapPoints();
self._updateSnapPointPositions();
// set proper grid look
self.mode(options.mode);
};
function findChildIndex(self, target) {
var children = slice.call(self.element.children, 0),
index = -1;
while (target !== null && index < 0) {
index = children.indexOf(target);
if (index > -1) {
return index;
} else {
target = target.parentNode;
}
}
return index;
}
prototype._findChildIndex = function (target) {
return findChildIndex(this, target);
};
/**
* Method used by animation to apply transformation on grid element
* @param {Object} item
* @private
* @method transformItem
* @member ns.widget.wearable.Grid
*/
function transformItem(item) {
var element = item.element,
style = element.style,
transform = "translate3d(" + item.position.left + "px, " + item.position.top + "px, 0)",
scale = "scale(" + item.scale + ")";
style.transform = transform + " " + scale;
style.webkitTransform = transform + " " + scale;
style.opacity = item.opacity;
}
prototype._transformItems = function () {
var self = this,
items = self._items;
self._applyItemsTo(items);
items.forEach(transformItem);
};
/**
* Calculation of item position
* @param {Object} item
* @param {number} progress
* @private
* @method changeItems
* @member ns.widget.wearable.Grid
*/
function changeItems(item, progress) {
var to = item.to,
from = item.from,
position = item.position,
fromPosition,
toPosition;
if (to && from) {
fromPosition = from.position;
toPosition = to.position;
if (toPosition && fromPosition) {
position.top = easeOutQuad(
progress, fromPosition.top, toPosition.top - fromPosition.top, 1
);
position.left = easeOutQuad(
progress, fromPosition.left, toPosition.left - fromPosition.left, 1
);
}
item.scale = easeOutQuad(
progress, from.scale, to.scale - from.scale, 1
);
item.opacity = easeOutQuad(
progress, from.opacity, to.opacity - from.opacity, 1
);
}
}
/*
*
* Items transformations
*
*/
function createItem(element, item) {
if (typeof item !== "object") {
item = {};
}
item.element = element;
item.position = {
left: 0,
top: 0
};
item.scale = 0;
item.opacity = 1;
item.to = {
position: {},
scale: 1,
opacity: 1
};
item.from = {
position: {},
scale: 0,
opacity: 1
};
return item;
}
prototype._applyItemsTo = function (items) {
var len = items.length,
item,
to,
i = 0;
for (; i < len; ++i) {
item = items[i];
to = item.to;
if (to.position) {
item.position.left = to.position.left;
item.position.top = to.position.top;
}
if (to.scale) {
item.scale = to.scale;
}
if (to.opacity) {
item.opacity = to.opacity;
}
}
};
function updateItemsFrom(items) {
var len = items.length,
item,
i = 0,
from;
for (; i < len; ++i) {
item = items[i];
from = item.from;
from.position = {
left: item.position.left,
top: item.position.top
};
from.scale = item.scale;
from.opacity = item.opacity;
}
}
prototype._assembleItemsTo3x3 = function (items) {
var self = this,
length = items.length,
i = 0,
index,
scrollDimension,
nonScrollDimension,
to,
settings = self._settings,
size = settings.size,
// pattern of positioning elements in 3x3 mode, relative position [x, y] in column
pattern = [[size / 2, -HEIGHT_IN_GRID_MODE], [0, 0], [size / 2, HEIGHT_IN_GRID_MODE]];
for (; i < length; ++i) {
to = items[i].to;
if (self.options.lines === 3) {
index = i % 3;
scrollDimension = pattern[index][0] + ((i / 3) | 0) * size;
nonScrollDimension = pattern[index][1];
} else {
scrollDimension = ((i / 2) | 0) * size;
nonScrollDimension = (i % 2) * size;
}
to.scale = settings.scale;
to.position = {};
to.position[self._scrollDimension] = scrollDimension + settings.marginLeft;
to.position[self._nonScrollDimension] = nonScrollDimension + settings.marginTop
}
};
prototype._assembleItemsToImages = function () {
var self = this,
items = self._items,
len = items.length,
to,
i = 0,
size = self._getItemSize("image");
for (; i < len; ++i) {
to = items[i].to;
to.position = {};
to.position[self._scrollDimension] = i * size;
to.position[self._nonScrollDimension] = 0;
to.scale = SCALE.IMAGE;
}
};
prototype._scaleItemsToThumbnails = function () {
var self = this,
items = self._items,
currentIndex = self._currentIndex,
itemsLength = items.length,
targetState,
size = self._getItemSize("thumbnail"),
settings = self._settings,
scaleThumbnailX = settings.scaleThumbnailX,
// is used to calculate scrolled position between items, this value is used to calculate
// scale of items
scrolledModPosition = 2 * ((self._ui.container[self._scrollProperty] -
settings.marginThumbnail) % size) / size - 1,
scrolledAbsModPosition = Math.abs(scrolledModPosition) / 2,
itemScale,
i = 0;
for (; i < itemsLength; ++i) {
targetState = items[i].to;
targetState.position = {};
targetState.position[self._scrollDimension] = i * size;
targetState.position[self._nonScrollDimension] = 0;
targetState.scale = scaleThumbnailX;
itemScale = settings.scaleThumbnail - scaleThumbnailX;
targetState.opacity = THUMBNAIL_OPACITY;
if (i === currentIndex) {
targetState.scale += itemScale * (0.5 + scrolledAbsModPosition);
targetState.opacity += (1 - THUMBNAIL_OPACITY) * (0.5 + scrolledAbsModPosition);
} else if (((i - currentIndex) === 1 && scrolledModPosition < 0) ||
((i - currentIndex) === -1 && scrolledModPosition >= 0)) {
targetState.scale += itemScale * (0.5 - scrolledAbsModPosition);
targetState.opacity += (1 - THUMBNAIL_OPACITY) * (0.5 - scrolledAbsModPosition);
}
}
};
function setItemsPositionTo(items, deltaX, scrollDimension, nonScrollDimension) {
var len = items.length,
item,
i = 0,
to;
for (; i < len; ++i) {
item = items[i];
to = item.to;
to.position = {};
to.position[scrollDimension] = item.position[scrollDimension] + deltaX;
to.position[nonScrollDimension] = item.position[nonScrollDimension];
}
}
function setItemsScaleTo(items, scale) {
var len = items.length,
i = 0;
for (; i < len; ++i) {
items[i].to.scale = scale;
}
}
prototype._moveItemsToImages = function () {
var self = this,
items = self._items,
len = items.length,
to,
i = 0;
for (; i < len; ++i) {
to = items[i].to;
to.position = {};
to.position[self._scrollDimension] = i * self._getItemSize("image");
to.position[self._nonScrollDimension] = 0;
to.scale = self._settings.scaleThumbnail;
to.opacity = IMAGE_OPACITY;
}
};
function moveItemsToThumbnails(self) {
var items = self._items,
len = items.length,
to,
i = 0;
for (; i < len; ++i) {
to = items[i].to;
to.position = {};
to.position[self._scrollDimension] = i * self._getItemSize("thumbnail") +
(i - self._currentIndex) * 200;
to.position[self._nonScrollDimension] = 0;
to.scale = SCALE.IMAGE;
if (self.options.shape === "rectangle") {
to.opacity = (i === self._currentIndex) ? IMAGE_OPACITY : THUMBNAIL_OPACITY;
}
}
}
prototype._getItems = function () {
var self = this,
children = slice.call(self.element.children),
len = children.length,
child,
items = self._items,
i = 0;
for (; i < len; ++i) {
child = children[i];
items[i] = createItem(child, items[i]);
child.classList.add("ui-positioned");
}
};
function getGridSize(self, mode) {
var size,
length = self._items.length,
options = self.options,
settings = self._settings;
switch (mode) {
case "3x3" :
size = max(ceil(length / options.lines) * ceil(GALLERY_SIZE * settings.scale) +
settings.marginLeft + settings.marginRight, GALLERY_SIZE);
break;
case "image" :
size = length * GALLERY_SIZE;
break;
case "thumbnail" :
size = length * GALLERY_SIZE * settings.scaleThumbnailX +
(length - 1.5) * settings.marginThumbnail +
GALLERY_SIZE * (1 - settings.scaleThumbnailX);
break;
default:
size = GALLERY_SIZE;
}
return size;
}
prototype._getGridSize = function (mode) {
return getGridSize(this, mode);
};
prototype._getGridScrollPosition = function (mode) {
var self = this,
scroll,
itemSize = self._getItemSize(mode),
currentIndex = self._currentIndex;
switch (mode) {
case "3x3" :
scroll = (((currentIndex - 1) / 3) | 0) * ceil(itemSize);
break;
case "image" :
case "thumbnail" :
scroll = currentIndex * itemSize;
break;
default:
scroll = 0;
}
return scroll;
};
prototype._setGridSize = function (mode) {
var self = this,
element = self.element;
// set proper mode in options
self.options.mode = "image";
element.style[self._scrollSize] = getGridSize(self, mode) + "px";
element.parentElement[self._scrollProperty] = self._getGridScrollPosition(mode);
};
prototype._findItemIndexByScroll = function (element) {
var self = this,
scroll = element[self._scrollProperty],
itemSize = self._getItemSize(),
items = self._items;
switch (self.options.mode) {
case "image" :
return min(
round(scroll / itemSize),
items.length - 1
);
case "thumbnail" :
return min(
round((scroll - self._settings.marginThumbnail) / itemSize),
items.length - 1
);
default :
return -1;
}
};
prototype._gridToImage = function () {
var self = this,
element = self.element;
if (self._currentIndex === -1) {
self._currentIndex = 0;
}
self._dispersionItems(self._currentIndex);
updateItemsFrom(self._items);
anim(self._items, TRANSFORM_DURATION, changeItems, transformItem, function () {
changeModeToImage(self);
self._assembleItemsToImages();
self._transformItems();
self._setGridSize("image");
self._updateSnapPointPositions();
});
// change history
ns.router.Router.getInstance().open(element, {
url: "#image", rel: "grid"
});
};
prototype._imageToThumbnail = function () {
var self = this,
element = self.element,
items = self._items;
moveItemsToThumbnails(self);
self._transformItems();
// set proper mode in options
self.options.mode = "thumbnail";
self._changeModeToThumbnail();
element.parentElement[self._scrollProperty] = self._getGridScrollPosition("thumbnail");
updateItemsFrom(items);
self._scaleItemsToThumbnails();
anim(items, TRANSFORM_DURATION, changeItems, transformItem, function () {
element.style[self._scrollSize] = getGridSize(self, "thumbnail") + "px";
self._updateSnapPointPositions();
});
// change history
ns.router.Router.getInstance().open(element, {
url: "#thumbnail", rel: "grid"
});
};
prototype._imageToGrid = function () {
var self = this,
element = self.element,
items = self._items,
scrollValue = self._getGridScrollPosition("3x3");
self._assembleItemsTo3x3(items);
self._transformItems();
self._dispersionItems(self._currentIndex);
self._transformItems();
self._changeModeTo3x3();
element.parentElement[self._scrollProperty] = min(scrollValue, getGridSize(self, "3x3") -
GALLERY_SIZE);
items[self._currentIndex].position[self._scrollDimension] = min(scrollValue,
getGridSize(self, "3x3") - GALLERY_SIZE);
updateItemsFrom(items);
self._assembleItemsTo3x3(items);
anim(items, TRANSFORM_DURATION, changeItems, transformItem, function onTransitionEnd() {
element.style[self._scrollSize] = getGridSize(self, "3x3") + "px";
self._updateSnapPointPositions();
});
};
prototype._thumbnailToImage = function () {
var self = this,
items = self._items;
self._moveItemsToImages();
self._transformItems();
self._setGridSize("image");
self._assembleItemsToImages();
updateItemsFrom(items);
changeModeToImage(self);
anim(items, TRANSFORM_DURATION, changeItems, transformItem, function () {
self._updateSnapPointPositions();
});
};
prototype._dispersionItems = function (fromItemIndex) {
var self = this,
element = self.element,
items = self._items,
center = items[fromItemIndex],
item,
length = items.length,
i = 0,
state;
for (; i < length; ++i) {
item = items[i];
state = item.position;
if (i !== fromItemIndex) {
item.to = {
position: {
left: state.left + 2.2 * (state.left - center.position.left),
top: state.top + 2.2 * (state.top - center.position.top)
},
scale: self._settings.scale
};
} else {
item.to = {
position: {},
scale: SCALE.IMAGE
};
item.to.position[self._scrollDimension] = element.parentElement[self._scrollProperty];
item.to.position[self._nonScrollDimension] = 0;
}
}
};
/**
* Event handlers
* @param {Event} event
*/
prototype._onClick = function (event) {
var self = this;
self._currentIndex = self._findChildIndex(event.target);
switch (self.options.mode) {
case "3x3" :
self.mode("image");
break;
case "image" :
self.mode("thumbnail");
break;
}
};
prototype._onPopState = function (event) {
var self = this;
self._currentIndex = self._findItemIndexByScroll(self._ui.container);
switch (self.options.mode) {
case "image":
event.preventDefault();
event.stopImmediatePropagation();
self.mode("3x3");
break;
case "thumbnail":
event.preventDefault();
event.stopImmediatePropagation();
self.mode("image");
break;
}
};
prototype._onHWKey = function (event) {
switch (event.keyName) {
case "back" :
this._onPopState(event);
break;
}
};
prototype._onRotary = function (ev) {
var self = this,
itemSize = self._getItemSize(),
direction = (ev.detail.direction === "CW") ? 1 : -1,
container = self._ui.container;
if (itemSize !== 0) {
self._scrollTo(container, direction * itemSize, SCROLL_DURATION, {
propertyName: self._scrollProperty
});
}
};
prototype._onScroll = function () {
var self = this,
newIndex = self._findItemIndexByScroll(self._ui.container),
options = self.options;
if (options.shape === "rectangle" && options.mode === "thumbnail") {
self._currentIndex = newIndex;
self._scaleItemsToThumbnails();
anim(self._items, 0, changeItems, transformItem, function () {
self._updateSnapPointPositions();
});
}
self.trigger("change", {
active: newIndex
});
};
/**
* Event handler for widget
* @param {Event} event
* @method handleEvent
* @member ns.widget.wearable.Grid
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "rotarydetent" :
self._onRotary(event);
break;
case "click" :
self._onClick(event);
break;
case "tizenhwkey" :
self._onHWKey(event);
break;
case "popstate" :
self._onPopState(event);
break;
case "scroll":
self._onScroll();
}
};
/**
* Bind event listeners to widget instance
* @protected
* @method _bindEvents
* @param {HTMLElement} element
* @member ns.widget.wearable.Grid
* @protected
*/
prototype._bindEvents = function (element) {
var self = this;
document.addEventListener("rotarydetent", self, true);
window.addEventListener("popstate", self, true);
element.addEventListener("click", self, true);
window.addEventListener("tizenhwkey", self, true);
self._ui.container.addEventListener("scroll", self, true);
};
/**
* Remove event listeners from widget instance
* @protected
* @method _unbindEvents
* @member ns.widget.wearable.Grid
* @protected
*/
prototype._unbindEvents = function () {
var self = this;
document.removeEventListener("rotarydetent", self, true);
window.removeEventListener("popstate", self, true);
self.element.removeEventListener("click", self, true);
window.removeEventListener("tizenhwkey", self, true);
self._ui.container.removeEventListener("scroll", self, true);
};
/**
* Destroy widget instance
* @protected
* @method _destroy
* @member ns.widget.wearable.Grid
* @protected
*/
prototype._destroy = function () {
var self = this,
items = self._items,
len = items.length,
i = 0;
self._unbindEvents();
// remove items
for (; i < len; ++i) {
items[i] = null;
}
self._items = [];
};
Grid.prototype = prototype;
ns.widget.wearable.Grid = Grid;
engine.defineWidget(
"Grid",
"." + CLASS_PREFIX,
[],
Grid,
"wearable"
);
}(window, window.document));
/*global window, define, ns */
/*jslint nomen: true, plusplus: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
/**
* #Spin
*
* @class ns.widget.wearable.Spin
* @since 5.0
* @extends ns.widget.core.BaseWidget
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
/**
* Main file of applications, which connect other parts
*/
// then we can load plugins for libraries and application
(function (window, ns) {
"use strict";
var document = window.document,
BaseWidget = ns.widget.BaseWidget,
/**
* Alias for class {@link ns.engine}
* @property {Object} engine
* @member ns.widget.wearable.Spin
* @private
* @static
*/
engine = ns.engine,
utilsEvents = ns.event,
gesture = utilsEvents.gesture,
Animation = ns.util.Animate,
ENABLING_DURATION = 300, // [ms]
ROLL_DURATION = 600,
DELTA_Y = 100,
DRAG_STEP_TO_VALUE = 30,
VIBRATION_DURATION = 10,
lastDragValueChange = 0,
dragGestureInstance = null,
/**
* Alias for class Spin
* @method Spin
* @member ns.widget.wearable.Spin
* @private
* @static
*/
Spin = function () {
/**
* Object with default options
* @property {Object} options
* @property {Object} [options.type] Spin type
* @property {number} [options.orientation] orientation
* @member ns.widget.wearable.Spin
*/
this.options = {
min: 0,
max: 9,
step: 1,
moduloValue: "enabled",
shortPath: "enabled",
duration: ROLL_DURATION,
direction: "up",
rollHeight: "custom", // "container" | "item" | "custom"
itemHeight: 38,
momentumLevel: 0, // 0 - one item on swipe
scaleFactor: 0.4,
moveFactor: 0.4,
loop: "enabled",
labels: [],
digits: 0 // 0 - doesn't complete by zeros
};
this._ui = {};
this.length = this.options.max - this.options.min + 1;
this._prevValue = null; // this property has to be "null" on start
// enabled drag gesture for document
if (dragGestureInstance === null) {
dragGestureInstance = new gesture.Drag({
blockHorizontal: true
});
utilsEvents.enableGesture(document, dragGestureInstance);
}
},
WIDGET_CLASS = "ui-spin",
classes = {
SPIN: WIDGET_CLASS,
ITEM: WIDGET_CLASS + "-item",
SELECTED: WIDGET_CLASS + "-item-selected",
NEXT: WIDGET_CLASS + "-item-next",
PREV: WIDGET_CLASS + "-item-prev",
ENABLED: "enabled",
ENABLING: WIDGET_CLASS + "-enabling"
},
prototype = new BaseWidget();
Spin.classes = classes;
Spin.timing = Animation.timing;
function transform(value, index, centerY, options) {
var diff,
direction,
diffAbs,
scale,
moveY,
opacity,
delta = options.max - options.min + options.step,
numberOfItems = delta / options.step,
currentIndex = Math.round((value - options.min) / options.step);
if (options.loop === "enabled") {
if (value >= options.max - 2 * options.step) {
if (numberOfItems - currentIndex < 3) {
if (index < 3) {
index = index + numberOfItems;
}
}
} else if (value <= options.min + 2 * options.step) {
if (currentIndex < 3) {
if (index > numberOfItems - 3) {
index = index - numberOfItems;
}
}
}
}
diff = value - options.min - index * options.step;
direction = diff < 0 ? 1 : -1;
diffAbs = Math.abs(diff);
scale = 1 - options.scaleFactor * diffAbs;
moveY = 1 - options.moveFactor * diffAbs;
opacity = 1 - ((options.enabled) ? options.scaleFactor : 1) * diffAbs;
scale = (scale < 0) ? 0 : scale;
opacity = (opacity < 0) ? 0 : opacity;
moveY = direction * (DELTA_Y * (1 - moveY)) + centerY;
return {
moveY: moveY,
scale: scale,
opacity: opacity
}
}
function showAnimationTick(self) {
var items = self._ui.items,
options = self.options,
itemHeight = self._itemHeight,
state = self._objectValue,
centerY = (self._containerRect.height - itemHeight) / 2;
items.forEach(function (item, index) {
var change = transform(state.value, index, centerY, options);
// set item position
if (change.opacity > 0) {
item.style.transform = "translateY(" + change.moveY + "px) scale(" + change.scale + ")";
} else {
item.style.transform = "translateY(-1000px)"; // move item from active area
}
item.style.opacity = change.opacity;
});
ns.event.trigger(self.element, "spinstep", parseInt(state.value, 10));
}
function getStartValue(self) {
var prevValue = (self._prevValue === null) ? self.options.value : self._prevValue,
startValue = prevValue,
diff = self.options.value - prevValue,
rest = 0,
int = 0;
if (self.options.moduloValue === "enabled") {
int = diff / self.length | 0;
if (Math.abs(diff) >= self.length) {
startValue = prevValue + self.length * int;
}
rest = diff % self.length;
if (self.options.shortPath === "enabled" &&
Math.abs(rest) > self.length / 2) {
int += (rest < 0) ? -1 : 1;
startValue = prevValue + self.length * int;
}
}
return startValue;
}
prototype._valueToIndex = function (value) {
var options = this.options,
delta = options.max - options.min + 1;
value = value - options.min;
while (value < options.min) {
value += delta;
}
while (value > options.max) {
value -= delta;
}
return parseInt(value, 10) % this.length;
}
prototype._removeSelectedLayout = function () {
var self = this;
if (self._prevValue !== null) {
self._ui.items[self._valueToIndex(self._prevValue)]
.classList.remove(classes.SELECTED);
}
}
prototype._addSelectedLayout = function () {
var self = this,
index = self._valueToIndex(self.options.value);
self._ui.items[index].classList.add(classes.SELECTED);
}
prototype._show = function (triggerChangeEvent) {
var self = this,
animation = new Animation({}),
state = null,
objectValue = {
value: getStartValue(self)
};
self._removeSelectedLayout();
state = {
animation: [{
object: objectValue,
property: "value",
to: self.options.value
}],
animationConfig: {
// when widget is disabled then duration of animation should be minimal
duration: (self.options.enabled) ? self.options.duration : 1,
timing: Spin.timing.ease
}
};
self.state = state;
self._objectValue = objectValue;
self._animation = animation;
animation.set(state.animation, state.animationConfig);
animation.tick(showAnimationTick.bind(null, self));
animation.start(function () {
self._addSelectedLayout();
if (triggerChangeEvent) {
ns.event.trigger(self.element, "spinchange", {
value: parseInt(self.options.value, 10),
dValue: parseInt(self.options.value, 10) - parseInt(self._prevValue, 10)
});
}
});
};
prototype._modifyItems = function () {
var self = this,
options = self.options,
element = self.element,
itemHeight = 0,
items = [].slice.call(element.querySelectorAll("." + classes.ITEM)),
len = options.max - options.min + 1,
diff = len - items.length,
centerY,
item = null,
i = 0;
// add or remove item from spin widget
if (diff > 0) {
for (; i < diff; i++) {
item = document.createElement("div");
item.classList.add(classes.ITEM);
element.appendChild(item);
items.push(item);
}
} else if (diff < 0) {
diff = -diff;
for (; i < diff; i++) {
element.removeChild(items.pop());
}
}
// set content;
items.forEach(function (item, index) {
var textValue = "";
if (self.options.labels.length) {
textValue = self.options.labels[index];
} else {
textValue += (options.min + index);
if (options.digits > 0) {
while (textValue.length < options.digits) {
textValue = "0" + textValue;
}
}
}
item.innerHTML = textValue
});
// determine item height for scroll
if (options.rollHeight === "container") {
itemHeight = self._containerRect.height;
} else if (options.rollHeight === "custom") {
itemHeight = options.itemHeight;
} else { // item height
item = items[0];
itemHeight = (item) ?
item.getBoundingClientRect().height :
self._containerRect.height;
}
self._itemHeight = itemHeight;
centerY = (self._containerRect.height - itemHeight) / 2,
// set position;
items.forEach(function (item, index) {
var change = transform(self.value, index, centerY, options);
// set item position
item.style.transform = "translateY(" + change.moveY + "px) scale(" + change.scale + ")";
item.style.opacity = change.opacity;
});
self._ui.items = items;
};
prototype._setItemHeight = function (element, value) {
value = (typeof value === "string") ? parseInt(value.replace("px").trim(), 10) : value;
this.options.itemHeight = value;
};
prototype._refresh = function () {
var self = this;
self._containerRect = self.element.getBoundingClientRect();
self._modifyItems();
self._show();
};
/**
* Widget init method
* @protected
* @method _init
* @member ns.widget.wearable.Spin
*/
prototype._init = function () {
var self = this,
options = self.options;
// convert options
options.min = (options.min !== undefined) ? parseInt(options.min, 10) : 0;
options.max = (options.max !== undefined) ? parseInt(options.max, 10) : 0;
options.value = (options.value !== undefined) ? parseInt(options.value, 10) : 0;
options.duration = (options.duration !== undefined) ? parseInt(options.duration, 10) : 0;
options.labels = (Array.isArray(options.labels)) ? options.labels : options.labels.split(",");
self.length = options.max - options.min + 1;
self._refresh();
};
prototype._build = function (element) {
element.classList.add(classes.SPIN);
return element;
};
prototype._setValue = function (value, enableChangeEvent) {
var self = this,
animation;
value = window.parseInt(value, 10);
if (isNaN(value)) {
ns.warn("Spin: value is not a number");
} else if (value !== self.options.value) {
if (value >= self.options.min && value <= self.options.max || self.options.loop === "enabled") {
self._prevValue = self.options.value;
if (self.options.loop === "enabled") {
if (value > self.options.max) {
value = self.options.min;
} else if (value < self.options.min) {
value = self.options.max;
}
}
self.options.value = value;
// stop previous animation
animation = self.state.animation[0];
if (animation !== null && animation.to !== animation.current) {
self._animation.stop();
}
// update status of widget
self._show(enableChangeEvent);
}
}
};
prototype._getValue = function () {
return this.options.value;
};
prototype._setMax = function (element, max) {
var options = this.options;
options.max = (max !== undefined) ? parseInt(max, 10) : 0;
this.length = options.max - options.min + 1;
};
prototype._setMin = function (element, min) {
var options = this.options;
options.min = (min !== undefined) ? parseInt(min, 10) : 0;
this.length = options.max - options.min + 1;
};
prototype._setLabels = function (element, value) {
var self = this;
self.options.labels = value.split(",");
self._refresh();
};
prototype._setModuloValue = function (element, value) {
this.options.moduloValue = (value === "enabled") ? "enabled" : "disabled";
};
prototype._setShortPath = function (element, value) {
this.options.shortPath = (value === "enabled") ? "enabled" : "disabled";
};
prototype._setLoop = function (element, value) {
this.options.loop = (value === "enabled") ? "enabled" : "disabled";
};
prototype._setDuration = function (element, value) {
this.options.duration = window.parseInt(value, 10);
};
prototype._setEnabled = function (element, value) {
var self = this;
self.options.enabled = (value === "false") ? false : value;
if (self.options.enabled) {
element.classList.add(classes.ENABLING);
window.setTimeout(function () {
element.classList.remove(classes.ENABLING);
}, ENABLING_DURATION);
element.classList.add(classes.ENABLED);
utilsEvents.on(document, "drag dragend", self);
} else {
element.classList.add(classes.ENABLING);
window.setTimeout(function () {
element.classList.remove(classes.ENABLING);
self.refresh();
}, ENABLING_DURATION);
element.classList.remove(classes.ENABLED);
utilsEvents.off(document, "drag dragend", self);
}
// reset previous value;
this._prevValue = null;
return true;
};
prototype._setDirection = function (element, direction) {
this.options.direction = (["up", "down"].indexOf(direction) > -1) ?
direction : "up";
};
prototype._drag = function (e) {
var self = this,
dragValue,
value;
// if element is detached from DOM then event listener should be removed
if (document.getElementById(self.element.id) === null) {
utilsEvents.off(document, "drag dragend", self);
} else {
if (self.options.enabled) {
value = self.value();
dragValue = e.detail.deltaY - lastDragValueChange;
if (Math.abs(dragValue) > DRAG_STEP_TO_VALUE) {
self._setValue(value - Math.round(dragValue / DRAG_STEP_TO_VALUE), true);
lastDragValueChange = e.detail.deltaY;
window.navigator.vibrate(VIBRATION_DURATION);
}
}
}
};
prototype._dragEnd = function () {
lastDragValueChange = 0;
};
prototype._click = function (e) {
var target = e.target,
self = this,
items = self._ui.items,
value = self.value(),
targetIndex = items.indexOf(target),
currentIndex = self._valueToIndex(value);
if (targetIndex > -1 && targetIndex !== currentIndex) {
if (currentIndex === items.length - 1 && targetIndex == 0) {
// loop - current index is 12/12 and event target has index 0/12
self._setValue(value + 1, true);
} else if (currentIndex === 0 && targetIndex == items.length - 1) {
// loop - current index is 0/12 and event target has index 12/12
self._setValue(value - 1, true);
} else if (targetIndex < currentIndex) {
self._setValue(value - 1, true);
} else if (targetIndex > currentIndex) {
self._setValue(value + 1, true);
}
}
}
prototype.handleEvent = function (event) {
switch (event.type) {
case "drag":
this._drag(event);
break;
case "dragend":
this._dragEnd(event);
break;
case "click":
this._click(event);
break;
}
};
prototype._bindEvents = function () {
var self = this;
utilsEvents.on(self.element, "click", self);
};
prototype._unbindEvents = function () {
var self = this;
utilsEvents.off(self.element, "drag dragend", self);
utilsEvents.off(self.element, "click", self);
};
/**
* Destroy widget instance
* @protected
* @method _destroy
* @member ns.widget.wearable.Spin
* @protected
*/
prototype._destroy = function () {
var self = this,
element = self.element;
self._unbindEvents();
self._ui.items.forEach(function (item) {
item.parentNode.removeChild(item);
});
element.classList.remove(classes.SPIN);
};
Spin.prototype = prototype;
ns.widget.wearable.Spin = Spin;
engine.defineWidget(
"Spin",
"." + WIDGET_CLASS,
[],
Spin,
"wearable"
);
})(window, ns);
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global window, define, ns */
/**
* # CircleIndicator Widget
*
* Shows a control that indicates the circular shape progress of an on-going operation.
*
*
* ## Sample implementation of circular indicator
* To add a circular indicator widget to the application, use the following code:
*
* @example
* <div class="ui-circleindicator app-circleindicator internal"
* data-circle-r="0"
* data-from="0"
* data-to="210"
* data-start="240"
* data-cut="140"
*
* data-text="standard"
* data-text-r="140"
* data-text-color="rgba(154,178,179,1)"
*
* data-big-tick="25"
* data-big-tick-r="176"
* data-big-tick-height="6"
*
* data-small-tick="1"
* data-small-tick-r="174"
* data-small-tick-height="2"
*
* data-indicator-type="line"
* data-indicator-height="130"
* data-indicator-Color="rgba(255,0,0,0.8)"
* data-indicator-r="170"
* ></div>
* <script>
*
* var // get element to build indicator
* element = document.querySelector(".ui-circleindicator"),
* // create speedometer widget
* speedometer = tau.widget.CircleIndicator(element);
*
* // set widget value
* speedometer.value(0);
* </script>
*
* @class ns.widget.wearable.CircleIndicator
* @since 3.0
* @extends ns.widget.core.BaseWidget
* @author Maciej Moczulski <m.moczulski@samsung.com>
*/
(function () {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
/**
* Alias for class {@link ns.engine}
* @property {Object} engine
* @member ns.widget.core.CircleIndicator
* @private
* @static
*/
engine = ns.engine,
/**
* svg drawing helper
* @property {ns.util.polar} polar
* @member ns.util.polar
* @private
*/
polar = ns.util.polar,
/**
* array utils
* @property {ns.util.array} arrayUtil
* @member ns.util.array
* @private
*/
arrayUtil = ns.util.array,
/**
* Alias for class CircleIndicator
* @method CircleIndicator
* @member ns.widget.core.CircleIndicator
* @private
* @static
*/
CircleIndicator = function () {
/**
* Object with default options
* @property {Object} options
* @property {number} [options.circleR = 0] radius for circle, if
* circle === 0 then don't draw it
* @property {number} [options.from = 0] first step for drawing scale
* @property {number} [options.to = 0] last step for drawing scale.
* ratio 360 / (to - from) describe how many steps will be set on 360deg circle
* @property {number} [options.start = 0] starting point for drawing scale.
* @property {number} [options.cut = 0] from where to stop drawing.
* @property {string} [options.text = none] ("none", "standard", "rotated") define text and its type
* @property {number} [options.textR = 180] radius for text
* @property {string} [options.textColor = "white"] color for text if defined
* @property {number} [options.textDigits = "0"] represent number with defined number of digits
* @property {number} [options.bigTick = 180] start point for drawing bigTick
* @property {number} [options.bigTickHeight = 10] height for bigTick
* @property {number} [options.bigTickWidth = 3] width for bigTick
* @property {number} [options.bigTickR = 0] radius for bigThick
* @property {number} [options.smallTick = 180] start point for drawing smallTick
* @property {number} [options.smallTickHeight = 10] height for smallTick
* * @property {number} [options.bigTickWidth = 1] width for smallTick
* @property {number} [options.smallTickR = 0] radius for smallThick
* @property {string} [options.indicatorType = "arc"] radius for text
* @property {string} [options.indicatorColor = "red"] radius for text
* @property {number} [options.indicatorHeight = 40] radius for text
* @property {number} [options.indicatorWidth = 2] radius for text
* @property {number} [options.indicatorR = 180] radius for text
* @member ns.widget.core.CircleIndicator
*/
this.options = {
circleR: 0,
circleStartArc: 0,
circleEndArc: 0,
circleWidth: 2,
circleColor: "white",
from: 0,
to: 60,
start: 0,
cut: 0,
text: "none",
textR: 180,
textColor: "white",
textDigits: 0,
bigTick: 0,
bigTickColor: "white",
bigTickHeight: 10,
bigTickWidth: 3,
bigTickR: 0,
smallTick: 0,
smallTickHeight: 5,
smallTickWidth: 1,
smallTickR: 0,
smallTickColor: "white",
indicatorType: "arc",
indicatorColor: "red",
indicatorHeight: 40,
indicatorWidth: 2,
indicatorR: 180
};
this._ui = {
element: null
};
this.indicatorValue = 0;
this.minimumCirclePoints = 0;
},
WIDGET_CLASS = "ui-circleindicator",
classes = {
WIDGET: WIDGET_CLASS
},
prototype = new BaseWidget();
CircleIndicator.classes = classes;
/**
* Helper method for parse indicated object properties to int value
* @param {Object} object
* @param {string[]} props
* @method parseIntObject
* @private
* @member ns.widget.wearable.CircleIndicator
*/
function parseIntObject(object, props) {
var property = null;
arrayUtil.forEach(props, function (propertyName) {
property = object[propertyName];
if (typeof property !== "number" && !Number.isInteger(property)) {
object[propertyName] = parseInt(property, 10);
}
});
}
function prepareTick(svg, properties) {
var svgElement = null,
width = properties.width,
height = properties.height,
degrees = properties.degrees,
tickHeight = properties.tickHeight;
svgElement = polar.addRadius(svg, {
classes: properties.classes,
x: width / 2,
y: height / 2,
r: properties.r,
degrees: degrees,
length: tickHeight,
direction: "out",
width: properties.strokeWidth,
color: properties.color,
animation: properties.animation || false
});
return svgElement;
}
function prepareCircle(svg, properties) {
polar.addCircle(svg, {
arcStart: 0,
arcEnd: 360,
r: properties.r,
width: properties.width,
color: properties.color,
fill: "none"
});
}
function prepareArc(svg, properties) {
polar.addArc(svg, {
arcStart: properties.arcStart,
arcEnd: properties.arcEnd,
r: properties.r - 50,
width: properties.width,
color: properties.color,
fill: "none"
});
}
function prepareArcIndicator(self, properties) {
var svgIndicator = polar.createSVG(self._ui.element),
circleIndicator = null,
options = self.options,
startPointForAnimation = 0,
start = parseInt(options.start, 10),
r = parseInt(properties.r, 10),
minimumCirclePoints = 0;
self._ui.svgIndicator = svgIndicator;
polar.addCircle(svgIndicator, {
arcStart: 0,
arcEnd: 360,
r: r,
width: 8,
color: properties.color,
fill: "transparent"
});
circleIndicator = svgIndicator.querySelector("circle");
//Im using dasharray which starts from right center
//in order to to set proper start point 90deg needs to be added to start
//point
startPointForAnimation = start - 90;
//minimum circle points depends on r
minimumCirclePoints = 2 * Math.PI * r;
circleIndicator.setAttribute("stroke-dasharray", "" + minimumCirclePoints);
//set the beginning for animation
svgIndicator.style.transform = "rotate(" + startPointForAnimation + "deg)";
//hiding indicator at the beginning
circleIndicator.setAttribute("stroke-dashoffset", "" + minimumCirclePoints);
self.minimumCirclePoints = minimumCirclePoints;
return circleIndicator;
}
function createTextIndex(index, textDigits) {
var i = 0,
textLength = 0,
textIndex = index + "";
if (textDigits > 0 && textIndex.toString().length < textDigits) {
for (i = 0, textLength = textDigits - index.toString.length; i < textLength; i++) {
textIndex = "0" + textIndex;
}
}
return textIndex;
}
function prepareTickText(self, index, width, height, degrees) {
var options = self.options,
svg = self._ui.svg,
text = options.text,
textDigits = options.textDigits,
textColor = options.textColor,
textIndex = "",
textPolarToCartesian = null,
textTransform = "";
textPolarToCartesian = polar.polarToCartesian(width / 2, height / 2 + 8, options.textR, degrees);
textIndex = createTextIndex(index, textDigits);
//only if bigTick is set and text defined
if (text === "rotated") {
textTransform = "rotate(" + degrees + "," + textPolarToCartesian.x + "," + (textPolarToCartesian.y - 8) + ")";
}
polar.addText(svg, {
x: textPolarToCartesian.x,
y: textPolarToCartesian.y,
text: textIndex,
transform: textTransform,
color: textColor
});
}
function prepareTickCircle(self, element, index) {
var options = self.options,
svg = self._ui.svg,
degreeRatio = 360 / (options.to - options.from),
degrees = index * degreeRatio + options.start,
elementRect = element.getClientRects()[0],
width = elementRect.width,
height = elementRect.height;
// bigTick parameter lets you draw with the given degree step
if (options.bigTick && index % options.bigTick === 0) {
prepareTick(svg, {
"degrees": degrees,
"width": width,
"height": height,
"tickHeight": options.bigTickHeight,
"classes": "ui-big",
"color": options.bigTickColor,
"strokeWidth": options.bigTickWidth,
"r": options.bigTickR
});
if (self.options.text !== "none") {
prepareTickText(self, index, width, height, degrees);
}
} else if (options.smallTick && index % options.smallTick === 0) {
//s, if circle === 0 then don't draw smallTick parameter lets you draw with the given degree step
prepareTick(svg, {
"degrees": degrees,
"width": width,
"height": height,
"tickHeight": options.smallTickHeight,
"classes": "ui-small",
"color": options.smallTickColor,
"strokeWidth": options.smallTickWidth,
"r": options.smallTickR
});
}
}
function prepareCircleR(svg, options) {
var circleData = {
"r": options.circleR,
"width": options.circleWidth,
"color": options.circleColor
};
//if circle start or end is defined then we use arc to draw part of
//the circle
if (options.circleStartArc !== 0 || options.circleEndArc !== 0) {
circleData.arcStart = options.circleStartArc;
circleData.arcEnd = options.circleEndArc;
prepareArc(svg, circleData);
} else {
prepareCircle(svg, circleData);
}
}
/**
* Draws indicator
* @param {HTMLElement} element
* @method _drawIndicator
* @protected
* @member ns.widget.wearable.CircleIndicator
*/
prototype._drawIndicator = function (element) {
var self = this,
options = self.options,
ui = self._ui,
svg = ui.svg,
elementRect = element.getClientRects()[0],
width = elementRect.width,
height = elementRect.height;
switch (options.indicatorType) {
case "line":
ui.pointer = prepareTick(svg, {
"degrees": self.indicatorValue + options.start,
"width": width,
"strokeWidth": options.indicatorWidth,
"height": height,
"tickHeight": options.indicatorHeight,
"r": options.indicatorR,
"classes": "ui-pointer",
"color": options.indicatorColor,
"animation": true
});
break;
case "arc":
ui.pointer = prepareArcIndicator(self, {
r: options.indicatorR,
color: options.indicatorColor
});
break;
default :
break;
}
};
/**
* Method prepares ticks circle
* @param {HTMLElement} element
* @method _prepareTicksCircle
* @protected
* @member ns.widget.wearable.CircleIndicator
*/
prototype._prepareTicksCircle = function (element) {
var self = this,
svg = self._ui.svg,
options = self.options,
index = 0,
to = (options.cut > 0 && options.cut < options.to) ? options.cut : options.to;
while (index < to) {
prepareTickCircle(self, element, index);
++index;
}
//if custom r for circle is given then draw it with this R
if (options.circleR) {
prepareCircleR(svg, options);
}
};
/**
* Build method
* @param {HTMLElement} element
* @method _build
* @protected
* @member ns.widget.wearable.CircleIndicator
*/
prototype._build = function (element) {
var id = element.id,
self = this,
svg = polar.createSVG(element);
// Parse to int indicated values from data-* attributes
parseIntObject(self.options, ["to", "from", "textR", "cut", "bigTick", "start",
"textDigits", "bigTickR", "smallTick", "circleWidth", "indicatorR",
"circleEndArc", "circleStartArc", "indicatorHeight", "indicatorWidth",
"bigTickHeight", "smallTickHeight"
]);
// set id
if (!id) {
element.id = "tau-custom-widget-" + Date.now();
}
// add widget class if not exists
element.classList.add(WIDGET_CLASS);
// set ui components
self._ui = {
element: element,
svgIndicator: null,
pointer: null,
svg: svg
};
self._prepareTicksCircle(element);
self._drawIndicator(element);
return element;
};
/**
* Get value of Circle Progressbar
* @method _getValue
* @protected
* @member ns.widget.wearable.CircleIndicator
*/
prototype._getValue = function () {
return this.indicatorValue;
};
/**
* Set value of Circle Progressbar
* @method _setValue
* @param {string} inputValue
* @protected
* @member ns.widget.wearable.CircleIndicator
*/
prototype._setValue = function (inputValue) {
var self = this,
options = self.options,
ui = self._ui,
svg = ui.svg,
pointer = ui.pointer,
indicatorType = options.indicatorType,
elementRect = ui.element.getClientRects()[0],
//this value will not change and can be taken from options
bigTickR = options.bigTickR,
width = elementRect.width,
height = elementRect.height,
circleValue = 0,
to = options.to;
self.indicatorValue = inputValue;
if (indicatorType === "line") {
//polar api force me to add all the options again
polar.updatePosition(svg, ".ui-pointer", {
degrees: inputValue * (width / to),
classes: pointer.getAttribute("class"),
color: pointer.getAttribute("stroke"),
direction: "out",
length: 40,
r: bigTickR,
width: pointer.getAttribute("stroke-width"),
x: width / 2,
y: height / 2,
animation: true
});
} else if (indicatorType === "arc") {
circleValue = self.minimumCirclePoints - ((inputValue * self.minimumCirclePoints) / to);
pointer.setAttribute("stroke-dashoffset", "" + circleValue);
}
};
/**
* Remove HTML elements created in widget build process
* @method _removeItems
* @protected
* @member ns.widget.wearable.CircleIndicator
*/
prototype._removeItems = function () {
var itemContainer = this._ui.element;
while (itemContainer.firstChild) {
itemContainer.removeChild(itemContainer.firstChild);
}
};
prototype._removeTicksCircle = function () {
var ticks = this._ui.svg.querySelectorAll(".ui-big, .ui-small"),
length = ticks.length,
i;
for (i = 0; i < length; i++) {
ticks[i].parentElement.removeChild(ticks[i]);
}
};
prototype._refresh = function () {
var pointer = this._ui.pointer;
this._removeTicksCircle();
this._prepareTicksCircle(this.element);
pointer.parentElement.appendChild(pointer);
};
/**
* Destroy widget instance
* @protected
* @method _destroy
* @member ns.widget.core.CircleIndicator
* @protected
*/
prototype._destroy = function () {
this._removeItems();
};
CircleIndicator.prototype = prototype;
ns.widget.wearable.CircleIndicator = CircleIndicator;
engine.defineWidget(
"CircleIndicator",
"." + classes.WIDGET,
[],
CircleIndicator,
"wearable"
);
}());
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global window, define, ns */
/**
* #NumberPicker Widget
*
* @class ns.widget.wearable.NumberPicker
* @since 3.0
* @extends ns.widget.core.BaseWidget
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function (window, document) {
"use strict";
var /**
* Alias for class {@link ns.util.selectors}
* @property {Object} engine
* @member ns.widget.core.NumberPicker
* @private
* @static
*/
selectors = ns.util.selectors,
prototype = new ns.widget.BaseWidget(),
Spin = ns.widget.wearable.Spin,
SPIN_CLASS = Spin.classes.SPIN,
WIDGET_CLASS = "ui-number-picker",
WIDGET_SELECTOR = "input[type='number']",
classes = {
CONTAINER: WIDGET_CLASS + "-container",
NUMBER: WIDGET_CLASS + "-number",
NUMBER_BLINK: WIDGET_CLASS + "-number-blink",
LABEL: WIDGET_CLASS + "-label",
LABEL_PRESSED: WIDGET_CLASS + "-label-pressed",
BUTTON_SET: WIDGET_CLASS + "-set",
DISABLED: WIDGET_CLASS + "-disabled",
HIDDEN: "hidden"
};
function NumberPicker() {
var self = this;
self.options = {
min: 0,
max: 12,
step: 1,
disabled: false,
accelerated: 0
};
// other widgets instances using by number picker
self._circleIndicator = null;
self._spin = null;
// widget UI cache
self._ui = {
number: null,
page: null,
container: null,
indicator: null,
buttonSet: null,
label: null,
footer: null
};
}
NumberPicker.classes = classes;
/**
* Method trying find label for number element or create label element if not found it
* @param {HTMLElement} element
* @method _extractLabel
* @member ns.widget.core.NumberPicker
* @protected
*/
prototype._extractLabel = function (element) {
var elementId = "",
label = null;
// find label by "for" attribute
elementId = element.getAttribute("id");
if (elementId) {
label = document.querySelector("*[for=\"" + elementId + "\"]");
}
// check closing label
if (!label) {
label = selectors.getClosestByTag(element, "label");
}
// replace label by element
if (label && element.parentElement === label) {
label.parentElement.replaceChild(element, label);
}
// if label not existed before then create it
if (!label) {
label = document.createElement("label");
element.parentNode.appendChild(label);
}
return label;
};
/**
* Method searching footer of closing page or popup-element
* @param {HTMLElement} element
* @method _findFooter
* @member ns.widget.core.NumberPicker
* @protected
*/
prototype._findFooter = function (element) {
var parent = selectors.getClosestBySelector(element, ".ui-page, .ui-popup"),
footerClassList = null,
footer = null;
// find close page or popup element
if (parent) {
footer = parent.querySelector("footer, .ui-footer, .ui-popup-footer");
if (!footer) {
footer = document.createElement("footer");
parent.appendChild(footer);
}
// add standard footer class for footer with button
footerClassList = footer.classList;
footerClassList.add("ui-footer");
footerClassList.add("ui-bottom-button");
footerClassList.add("ui-fixed");
}
return footer;
};
/**
* Create dependent widgets
* @method _createWidgets
* @member ns.widget.core.NumberPicker
* @protected
*/
prototype._createWidgets = function (element) {
var self = this,
ui = self._ui,
options = self.options;
// Create circle indicator widget
self._circleIndicator = ns.widget.CircleIndicator(ui.indicator, {
text: options.circleType || "none",
circleR: options.circleR || 0,
from: options.from || 0,
to: options.to || 360,
indicatorType: "line",
indicatorHeight: 21,
indicatorColor: "rgba(249,123,47,1)",
indicatorWidth: 6,
indicatorR: 180,
bigTick: options.bigTick || 0,
bigTickR: options.bigTickR || 0,
bigTickHeight: options.bigTickHeight || 0,
bigTickWidth: options.bigTickWidth,
smallTick: options.smallTick || 0,
smallTickR: options.smallTickR || 0,
smallTickHeight: options.smallTickHeight || 0
});
if (element) {
self._spin = ns.widget.Spin(ui.number, {
min: self.options.min,
max: self.options.max,
loop: "enabled",
rollHeight: "custom",
itemHeight: 38,
duration: 300,
value: element.value
});
}
};
/**
* Collect attributes of input element and convert to widget options
* @param {HTMLElement} element
* @protected
* @method _getOptions
* @member ns.widget.core.NumberPicker
*/
prototype._getOptions = function (element) {
var options = this.options;
element = this.element || element;
options.min = parseInt(element.getAttribute("min"), 10);
options.max = parseInt(element.getAttribute("max"), 10);
options.step = parseInt(element.getAttribute("step"), 10);
options.disabled = element.getAttribute("disabled", 10);
};
/**
* Collect attributes of input element when widget is creating
* @param {HTMLElement} element
* @protected
* @method _configure
* @member ns.widget.core.NumberPicker
*/
prototype._configure = function (element) {
this._getOptions(element);
};
/**
* Toggle widget state of disabled/enabled
* @param {boolean} disabled
* @protected
* @method _toggle
* @member ns.widget.core.NumberPicker
*/
prototype._toggle = function (disabled) {
var self = this;
self.options.disabled = disabled;
// update disabled state
if (disabled) {
self._ui.container.classList.add(classes.DISABLED);
} else {
self._ui.container.classList.remove(classes.DISABLED);
}
};
/**
* Toggle circle indicator
* @protected
* @method _toggleCircleIndicator
* @member ns.widget.core.NumberPicker
*/
prototype._toggleCircleIndicator = function (enable) {
var self = this;
if (!enable) {
self._circleIndicator.element.classList.add(classes.HIDDEN);
} else {
self._circleIndicator.element.classList.remove(classes.HIDDEN);
}
}
/**
* Refresh number picker
* eg. after change of element attributes like "max" or "min"
* @protected
* @method _refresh
* @member ns.widget.core.NumberPicker
*/
prototype._refresh = function () {
var self = this,
element = self.element;
self._getOptions();
self._setValue(element.getAttribute("value"));
self._toggleCircleIndicator(false);
self._toggle(!!self.options.disabled);
};
/**
* Update visual representation of value of number picker
* @param {number} value
* @protected
* @method _updateValue
* @member ns.widget.core.NumberPicker
*/
prototype._updateValue = function (value) {
/**
* If representing of value is realized by Spin widget
*/
this._spin.value(value);
};
/**
* Get value of number picker
* @protected
* @method _getValue
* @member ns.widget.core.NumberPicker
* @return {number}
*/
prototype._getValue = function () {
return parseInt(this.element.value, 10);
};
/**
* Set value of number picker
* @param {number} value
* @protected
* @method _setValue
* @member ns.widget.core.NumberPicker
*/
prototype._setValue = function (value) {
var self = this,
element = self.element,
options = self.options;
value = parseInt(value, 10);
// loop widget value;
if (value > options.max) {
value = options.min;
} else if (value < options.min) {
value = options.max;
}
element.setAttribute("value", value);
element.value = value;
self._updateValue(value);
};
/**
* Init method
* @protected
* @method _init
* @member ns.widget.core.NumberPicker
* @protected
*/
prototype._init = function () {
var self = this;
self.value(self.element.value);
// update disabled state
self._toggle(!!self.options.disabled);
self._toggleCircleIndicator(false);
};
/**
* Build widget instance
* @param {HTMLElement} element
* @protected
* @method _build
* @member ns.widget.core.NumberPicker
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
indicator = document.createElement("div"),
parent = selectors.getClosestBySelector(element, ".ui-page, .ui-popup"),
container = document.createElement("div"),
number = document.createElement("div"),
buttonSet = document.createElement("button"),
label = null,
footer = null;
// find or create label and footer
label = self._extractLabel(element);
footer = self._findFooter(element);
// add classes
container.classList.add(classes.CONTAINER);
number.classList.add(classes.NUMBER);
label.classList.add(classes.LABEL);
// create button set
buttonSet.innerHTML = "Set";
buttonSet.classList.add("ui-btn");
buttonSet.classList.add(classes.BUTTON_SET);
// add "set" button to the footer
footer.appendChild(buttonSet);
// build DOM structure
container.appendChild(number);
container.appendChild(indicator);
container.appendChild(label);
// add widget container
element.parentElement.appendChild(container);
container.appendChild(element);
// cache ui elements
ui.indicator = indicator;
ui.parent = parent;
ui.container = container;
ui.number = number;
ui.buttonSet = buttonSet;
ui.label = label;
ui.footer = footer;
// Create widgets
self._createWidgets(element);
return element;
};
/**
* Destroy widget instance
* @protected
* @method _destroy
* @member ns.widget.core.NumberPicker
*/
prototype._destroy = function () {
var self = this,
ui = self._ui,
container = ui.container,
footer = ui.footer;
self._unbindEvents();
// destroy widgets
self._circleIndicator.destroy();
// remove classes
container.classList.remove(classes.CONTAINER);
ui.number.classList.remove(classes.NUMBER);
ui.label.classList.remove(classes.LABEL);
ui.buttonSet.classList.remove(classes.BUTTON_SET);
footer.classList.remove("ui-bottom-button");
// recovery DOM structure
if (container.parentElement) {
container.parentElement.replaceChild(self.element, container);
}
};
function onSet(self) {
ns.event.trigger(self.element, "change", {
value: self.value()
});
history.back();
}
function onRotary(self, ev) {
var step = parseInt(self.options.step, 10),
now = Date.now(),
accelerated = parseInt(self.options.accelerated, 10);
if (self._spin.option("enabled")) {
if (accelerated) {
if (now - self._previousRotaryTime < 30) {
step *= accelerated;
}
self._previousRotaryTime = now;
}
if (ev.detail.direction === "CW") {
self.value(self.value() + step);
} else {
self.value(self.value() - step);
}
}
}
function toggleNumberEdit(self, enabled) {
if (enabled) {
if (!self._ui.number.classList.contains("enabled")) {
self._ui.label.classList.add(classes.HIDDEN);
self._spin.option("enabled", true);
}
} else {
if (self._ui.number.classList.contains("enabled")) {
self._ui.label.classList.remove(classes.HIDDEN);
self._spin.option("enabled", false);
}
}
}
function onNumberClick(self, ev) {
var target = ev.target;
if (target) {
toggleNumberEdit(self, (selectors.getClosestByClass(target, SPIN_CLASS) === self._ui.number));
}
}
function onNumberChange(self, ev) {
var target = ev.target;
if (target) {
self.element.value = ev.detail.value;
self.element.setAttribute("value", ev.detail.value);
}
}
/**
* Bind widget event handlers
* @protected
* @method _bindEvents
* @member ns.widget.core.NumberPicker
*/
prototype._bindEvents = function () {
var self = this;
self._onSet = onSet.bind(null, self);
self._onRotary = onRotary.bind(null, self);
self._onNumberClick = onNumberClick.bind(null, self);
self._onNumberChange = onNumberChange.bind(null, self);
self._ui.buttonSet.addEventListener("click", self._onSet);
self._ui.parent.addEventListener("click", self._onNumberClick);
self._ui.number.addEventListener("spinchange", self._onNumberChange);
document.addEventListener("rotarydetent", self._onRotary);
};
/**
* Unbind widget event handlers
* @protected
* @method _unbindEvents
* @member ns.widget.core.NumberPicker
*/
prototype._unbindEvents = function () {
var self = this;
self._ui.buttonSet.removeEventListener("click", self._onSet);
self._ui.parent.removeEventListener("click", self._onNumberClick);
self._ui.number.removeEventListener("spinchange", self._onNumberChange);
document.removeEventListener("rotarydetent", self._onRotary);
};
NumberPicker.prototype = prototype;
// definition
ns.widget.wearable.NumberPicker = NumberPicker;
ns.engine.defineWidget(
"NumberPicker",
WIDGET_SELECTOR,
[],
NumberPicker,
""
);
}(window, window.document));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* global window, define */
/**
* # TimePicker Widget
* Shows a control that can be used to set hours and minutes.
* It support 12/24 hours format. It contains two inputs which control the values
*
* ## Default selectors
*
* Default selector for timepicker is class *ui-time-picker*
*
* ### HTML Examples
*
* #### 12 hours format
* To add a timepicker widget to the application, use the following code:
*
* @example
* <div class="ui-time-picker" data-format="h">
*
* #### 24 hours format
* To add a timepicker widget to the application, use the following code:
*
* @example
* <div class="ui-time-picker" data-format="H">
*
* @class ns.widget.wearable.TimePicker
* @since 4.0
* @extends ns.widget.wearable.NumberPicker
* @author Maciej Moczulski <m.moczulski@samsung.com>
*/
(function (window, document, ns) {
"use strict";
var /**
* @property {Object} engine
* @member ns.widget.core.NumberPicker
* @private
* @static
*/
utilsEvents = ns.event,
getClosestByClass = ns.util.selectors.getClosestByClass,
NumberPicker = ns.widget.wearable.NumberPicker,
prototype = Object.create(NumberPicker.prototype),
WIDGET_CLASS = "ui-time-picker",
classes = {
CONTAINER: WIDGET_CLASS + "-container",
HOURS_CONTAINER: WIDGET_CLASS + "-container-hours",
MINUTES_CONTAINER: WIDGET_CLASS + "-container-minutes",
AMPM_CONTAINER: WIDGET_CLASS + "-container-ampm",
AMPM_PRESSED: WIDGET_CLASS + "-container-ampm-pressed",
COLON: WIDGET_CLASS + "-colon-container",
AMPM: WIDGET_CLASS + "-am-pm",
AMPM_INNER_CONTAINER: WIDGET_CLASS + "-am-pm-inner-container",
NO_AMPM: WIDGET_CLASS + "-no-am-pm",
ACTIVE_LABEL: WIDGET_CLASS + "-active-label",
ACTIVE_LABEL_ANIMATION: WIDGET_CLASS + "-active-label-animation",
SHOW_PM_ANIMATION: WIDGET_CLASS + "-show-pm",
HIDE_PM_ANIMATION: WIDGET_CLASS + "-hide-pm",
DISABLE_ANIMATION: WIDGET_CLASS + "-disable-animation",
CIRCLE_INDICATOR_BACKGROUND: WIDGET_CLASS + "-background",
HIDDEN: WIDGET_CLASS + "-hidden",
HIDDEN_LABEL: "ui-number-picker-label-hidden"
},
WIDGET_SELECTOR = "." + WIDGET_CLASS,
AMPM_PRESS_EFFECT_DURATION = 300;
function TimePicker() {
var self = this;
// other widgets instances using by number picker
self._circleIndicator = null;
// circle indicator widget will just draw minutes on the board
self._circleIndicatorSupporter = null;
// hours and minutes input have different max values, holds active input max value
self._actualMax = 0;
// store timer id
self.rotaryControler = 0;
self._rotation = 0;
self._spins = null;
NumberPicker.call(self);
}
/**
* Collect options from DOM
* currently only display 24 or 12 format can be picked up
* @protected
* @method _configure
* @member ns.widget.core.TimePicker
*/
prototype._configure = function () {
/**
* All possible component options
* @property {Object} options
* @property {string|Array} [options.format=["h","H"] indices format for
* presentation. h is for 12H format and H is for 24H format
* @member ns.widget.wearable.TimePicker
*/
var options = this.options;
options.circleType = "none";
options.circleR = 0;
options.from = 0;
options.to = 12;
options.format = options.format || "H";
};
/**
* Init method
* @method _init
* @member ns.widget.core.TimePicker
* @protected
*/
prototype._init = function () {
var self = this,
initDate = new Date(),
ui = self._ui,
uiNumberHours = ui.numberHours,
uiInputHours = ui.numberPickerHoursInput;
//set the initial hours value, based on time stamp
self._setValue(initDate);
if (self.options.format === "H") {
self._maxHour = 24;
} else {
self._maxHour = 12;
}
uiNumberHours.classList.add(classes.ACTIVE_LABEL);
uiNumberHours.classList.add(classes.ACTIVE_LABEL_ANIMATION);
self._actualMax = parseInt(uiInputHours.max, 10);
self._toggleCircleIndicator();
// move indicator to the selected hours value
self._circleIndicator.option("to", 12);
self._showIndicator();
};
prototype._buildAMPM = function (numberPickerHoursContainer, element) {
var self = this,
ui = self._ui,
amPmBlock,
amSpan,
pmSpan,
amPmInnerContainer;
if (self.options.format === "h") {
amPmBlock = document.createElement("div");
amPmBlock.classList.add(classes.AMPM_CONTAINER);
element.appendChild(amPmBlock);
amPmInnerContainer = document.createElement("div");
amPmInnerContainer.classList.add(classes.AMPM_INNER_CONTAINER);
amPmBlock.appendChild(amPmInnerContainer);
amSpan = document.createElement("span");
pmSpan = document.createElement("span");
amSpan.innerHTML = "AM";
pmSpan.innerHTML = "PM";
amPmInnerContainer.appendChild(amSpan);
amPmInnerContainer.appendChild(pmSpan);
//instance variable storing information whether it is am or pm, default value is pm
self.options.amOrPm = "AM";
ui.amOrPmContainer = amPmBlock;
numberPickerHoursContainer.classList.add(classes.AMPM);
} else {
numberPickerHoursContainer.classList.add(classes.NO_AMPM);
}
};
/**
* Build widget instance
* @param {HTMLElement} element
* @protected
* @method _build
* @member ns.widget.core.TimePicker
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
footer,
indicator = document.createElement("div"),
indicatorMinutes = document.createElement("div"),
buttonSet = document.createElement("button"),
numberPickerColon = document.createElement("span"),
numberPickerHoursContainer = self._addIndicator("Hours"),
numberPickerColonContainer = document.createElement("div"),
numberPickerMinutesContainer = self._addIndicator("Minutes");
footer = self._findFooter(element);
// create button set
buttonSet.innerHTML = "SET";
// add classes
element.classList.add(NumberPicker.classes.CONTAINER);
buttonSet.classList.add("ui-btn");
buttonSet.classList.add(NumberPicker.classes.BUTTON_SET);
numberPickerHoursContainer.classList.add(classes.HOURS_CONTAINER);
numberPickerHoursContainer.classList.add(classes.CONTAINER);
numberPickerColonContainer.classList.add(classes.COLON) ;
numberPickerMinutesContainer.classList.add(classes.MINUTES_CONTAINER);
numberPickerMinutesContainer.classList.add(classes.CONTAINER);
numberPickerColon.innerHTML = ":";
// build DOM structure
element.appendChild(numberPickerHoursContainer);
element.appendChild(numberPickerColonContainer);
element.appendChild(numberPickerMinutesContainer);
numberPickerColonContainer.appendChild(numberPickerColon);
self._buildAMPM(numberPickerHoursContainer, element);
element.appendChild(indicatorMinutes);
element.appendChild(indicator);
footer.appendChild(buttonSet);
// main indicator used for both hours, minutes inputs
ui.indicator = indicator;
ui.indicatorMinutes = indicatorMinutes;
// footer elements
ui.buttonSet = buttonSet;
ui.footer = footer;
// Create circle widget, defined by Number Picker,
// main indicator will work on this widget
self._createWidgets(element);
self._buildNumberPicker();
self._circleIndicator.element.classList.add(classes.CIRCLE_INDICATOR_BACKGROUND);
return element;
};
/**
* Method for rotary detent event
*
* Method sets the new value after rotary event
* @method _onRotary
* @param {Event} event
* @protected
* @member ns.widget.mobile.TimePicker
*/
prototype._onRotary = function (event) {
var self = this,
currentValue,
activeInput,
activeNumber = document.querySelector("." + classes.ACTIVE_LABEL);
if (activeNumber) {
activeInput = activeNumber.parentElement.children[2];
currentValue = parseInt(activeInput.value, 10);
if (event.detail.direction === "CW") {
currentValue++;
if (currentValue % self._circleIndicator.options.to === 0) {
self._rotation++;
}
} else {
currentValue--;
if ((currentValue - self._circleIndicator.options.to) % self._circleIndicator.options.to === -1) {
self._rotation--;
}
}
self.value(currentValue);
}
};
/**
* Method for click event
*
* @method _onClick
* @param {Event} event
* @protected
* @member ns.widget.mobile.TimePicker
*/
prototype._onClick = function (event) {
var self = this,
ui = self._ui,
eventTargetElement = event.target,
uiNumberHours = ui.numberHours,
uiNumberMinutes = ui.numberMinutes,
uiInputHours = ui.numberPickerHoursInput,
uiAmPmContainer = ui.amOrPmContainer,
parentContainer = getClosestByClass(eventTargetElement, classes.CONTAINER);
//hours
if (parentContainer && parentContainer.classList.contains(classes.HOURS_CONTAINER)) {
uiNumberHours.classList.add(classes.ACTIVE_LABEL);
uiNumberMinutes.classList.remove(classes.ACTIVE_LABEL);
ui.labelHours.classList.add(classes.HIDDEN_LABEL);
ui.labelMinutes.classList.remove(classes.HIDDEN_LABEL);
uiNumberHours.classList.add(classes.ACTIVE_LABEL_ANIMATION);
uiNumberMinutes.classList.remove(classes.ACTIVE_LABEL_ANIMATION);
self._actualMax = parseInt(uiInputHours.max, 10);
// move indicator to the selected hours value
self._circleIndicator.option("to", 12);
if (self._spins) {
if (self._spins["Minutes"].option("enabled")) {
self._spins["Minutes"].option("enabled", false);
}
if (!self._spins["Hours"].option("enabled")) {
self._spins["Hours"].option("enabled", true);
}
}
//minutes
} else if (parentContainer && parentContainer.classList.contains(classes.MINUTES_CONTAINER)) {
uiNumberHours.classList.remove(classes.ACTIVE_LABEL);
uiNumberMinutes.classList.add(classes.ACTIVE_LABEL);
ui.labelHours.classList.remove(classes.HIDDEN_LABEL);
ui.labelMinutes.classList.add(classes.HIDDEN_LABEL);
uiNumberHours.classList.remove(classes.ACTIVE_LABEL_ANIMATION);
uiNumberMinutes.classList.add(classes.ACTIVE_LABEL_ANIMATION);
self._actualMax = 60;
// move indicator to the selected minutes value
self._circleIndicator.option("to", 60);
if (self._spins) {
if (self._spins["Hours"].option("enabled")) {
self._spins["Hours"].option("enabled", false);
}
if (!self._spins["Minutes"].option("enabled")) {
self._spins["Minutes"].option("enabled", true);
}
}
//AM PM
} else if (eventTargetElement.parentElement.classList.contains(classes.AMPM_INNER_CONTAINER)) {
uiAmPmContainer.classList.add(classes.AMPM_PRESSED);
window.setTimeout(function () {
uiAmPmContainer.classList.remove(classes.AMPM_PRESSED);
}, AMPM_PRESS_EFFECT_DURATION);
if (self.options.amOrPm === "AM") {
uiAmPmContainer.firstElementChild.classList.remove(classes.HIDE_PM_ANIMATION);
uiAmPmContainer.firstElementChild.classList.add(classes.SHOW_PM_ANIMATION);
self.options.amOrPm = "PM";
} else {
uiAmPmContainer.firstElementChild.classList.remove(classes.SHOW_PM_ANIMATION);
uiAmPmContainer.firstElementChild.classList.add(classes.HIDE_PM_ANIMATION);
self.options.amOrPm = "AM";
}
} else if (eventTargetElement.classList.contains("ui-number-picker-set")) {
self.trigger("change", {
value: self.value()
});
history.back();
} else {
ui.labelHours.classList.remove(classes.HIDDEN_LABEL);
ui.labelMinutes.classList.remove(classes.HIDDEN_LABEL);
if (self._spins) {
self._spins["Hours"].option("enabled", false);
self._spins["Minutes"].option("enabled", false);
}
}
};
/**
* Change value of spin included in timePicker
* @method _onSpinChange
* @param {Event} event
* @memberof ns.widget.wearable.TimePicker
* @protected
*/
prototype._onSpinChange = function (event) {
var self = this,
parentElement = getClosestByClass(event.target, classes.CONTAINER);
if (parentElement) {
self.value(event.detail.value);
}
};
/**
* Handle events
* @method handleEvent
* @public
* @param {Event} event Event
* @member ns.widget.wearable.TimePicker
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "click":
event.preventDefault();
self._onClick(event);
break;
case "rotarydetent":
event.preventDefault();
self._onRotary(event);
break;
case "spinchange":
self._onSpinChange(event);
break;
}
};
/**
*
* @protected
* @method _hideIndicator
* @member ns.widget.core.TimePicker
*/
prototype._hideIndicator = function () {
this._circleIndicator.element.querySelector(".ui-polar").style.visibility = "hidden";
};
/**
*
* @protected
* @method _showIndicator
* @member ns.widget.core.TimePicker
*/
prototype._showIndicator = function () {
this._circleIndicator.element.querySelector(".ui-polar").style.visibility = "visible";
};
/**
* Build DOM for Hours and Minutes number picker
* @param {string} name
* @protected
* @method _addIndicator
* @member ns.widget.core.TimePicker
*/
prototype._addIndicator = function (name) {
var self = this,
ui = self._ui,
number = document.createElement("div"),
numberPickerInput = document.createElement("input"),
numberPickerLabel = document.createElement("label"),
numberPickerContainer = document.createElement("div");
number.classList.add(NumberPicker.classes.NUMBER);
numberPickerLabel.classList.add(NumberPicker.classes.LABEL);
//prepare dom for inputs
if (name === "Hours") {
numberPickerLabel.innerText = "Hrs";
if (self.options.format === "H") {
numberPickerInput.min = "0";
numberPickerInput.max = "24";
} else {
numberPickerInput.min = "1";
numberPickerInput.max = "12";
}
} else if (name === "Minutes") {
numberPickerLabel.innerText = "Mins";
numberPickerInput.min = "0";
numberPickerInput.max = "60";
}
numberPickerInput.type = "number";
numberPickerInput.step = "1";
numberPickerInput.value = "0";
numberPickerContainer.appendChild(numberPickerLabel);
numberPickerContainer.appendChild(number);
numberPickerContainer.appendChild(numberPickerInput);
ui["number" + name] = number;
ui["label" + name] = numberPickerLabel;
ui["numberPicker" + name + "Input"] = numberPickerInput;
ui["numberPicker" + name + "Container"] = numberPickerContainer;
return numberPickerContainer;
};
/**
* Build number picker
* @method _buildNumberPicker
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._buildNumberPicker = function () {
var self = this,
ui = self._ui,
names = ["Hours", "Minutes"],
options;
self._spins = {};
names.forEach(function (name) {
var numberElement = ui["number" + name],
input = ui["numberPicker" + name + "Input"];
switch (name) {
case "Hours" :
options = {
min: parseInt(input.min, 10),
max: self.options.format === "H" ? parseInt(input.max, 10) - 1 : parseInt(input.max, 10),
loop: "enabled",
rollHeight: "custom",
itemHeight: 50,
duration: 300,
digits: 2,
scaleFactor: 0.6,
moveFactor: 0.445,
value: parseInt(input.value, 10)
};
break;
case "Minutes" :
options = {
min: 0,
max: 59,
loop: "enabled",
rollHeight: "custom",
itemHeight: 50,
duration: 300,
digits: 2,
scaleFactor: 0.6,
moveFactor: 0.445,
value: parseInt(input.value, 10)
};
break;
}
self._spins[name] = ns.widget.Spin(numberElement, options);
});
};
prototype._setDateValue = function (value) {
var self = this,
ui = self._ui,
hours,
minutes;
hours = value.getHours();
minutes = value.getMinutes();
if (self.options.format === "h") {
if (hours > 12) {
hours -= 12;
self.options.amOrPm = "PM";
} else {
self.options.amOrPm = "AM";
}
}
ui.numberPickerHoursInput.setAttribute("value", hours);
ui.numberPickerHoursInput.value = hours;
ui.numberPickerMinutesInput.setAttribute("value", minutes);
ui.numberPickerMinutesInput.value = minutes;
if (self._spins) {
self._spins["Hours"].value(hours);
self._spins["Minutes"].value((minutes < 10 ? "0" : "") + minutes);
}
//by default set the indicator on hours value
self._actualMax = parseInt(ui.numberPickerHoursInput.max, 10);
};
/**
* Set value of number picker
* @param {number} value
* @protected
* @method _setValue
* @member ns.widget.core.TimePicker
*/
prototype._setValue = function (value) {
var self = this,
activeInput,
activeNumber,
visibleValue;
if (value instanceof Date) {
self._setDateValue(value);
} else {
value = parseInt(value, 10);
activeNumber = document.querySelector("." + classes.ACTIVE_LABEL);
if (activeNumber) {
activeInput = activeNumber.parentElement.children[2];
activeInput.setAttribute("value", value);
if (self._circleIndicator.options.to === 12) {
visibleValue = (self._maxHour + value) % self._maxHour;
} else {
visibleValue = (self._circleIndicator.options.to + value) % self._circleIndicator.options.to;
}
if (self.options.format === "h" && self._circleIndicator.options.to === 12 && visibleValue === 0) {
visibleValue = 12;
}
activeInput.value = visibleValue;
if (self._spins) {
if (self._circleIndicator.options.to === 60) {
self._spins["Minutes"].value((visibleValue < 10 ? "0" : "") + visibleValue); // minutes
} else {
self._spins["Hours"].value(visibleValue); // hours
}
}
}
}
};
/**
* Toggle circle indicator
* @protected
* @method _toggleCircleIndicator
* @member ns.widget.wearable.DatePicker
*/
prototype._toggleCircleIndicator = function () {
var self = this;
if (!self.options.indicator) {
self._circleIndicator.element.classList.add(classes.HIDDEN);
} else {
self._circleIndicator.element.classList.remove(classes.HIDDEN);
}
}
/**
* Destroy widget instance
* @protected
* @method _destroy
* @member ns.widget.core.TimePicker
*/
prototype._destroy = function () {
var self = this,
ui = self._ui,
element = self.element;
// destroy widgets
self._circleIndicator.destroy();
// recovery DOM structure
while (element.firstChild) {
element.removeChild(element.firstChild);
}
ui.footer.classList.remove("ui-bottom-button");
if (ui.footer.children.length) {
ui.footer.removeChild(ui.buttonSet);
}
self._unbindEvents();
};
/**
* Bind widget event handlers override NumberPicker to not call
* @protected
* @method _bindEvents
* @member ns.widget.core.TimePicker
*/
prototype._bindEvents = function () {
var self = this,
ui = self._ui;
utilsEvents.on(document, "rotarydetent", self, true);
utilsEvents.on(document, "click", self, true);
utilsEvents.on(ui.numberMinutes, "spinchange", self, true);
utilsEvents.on(ui.numberHours, "spinchange", self, true);
};
/**
* Unbind widget event handlers override NumberPicker to not call
* @protected
* @method _unbindEvents
* @member ns.widget.core.TimePicker
*/
prototype._unbindEvents = function () {
var self = this,
ui = self._ui;
utilsEvents.off(document, "rotarydetent", self, true);
utilsEvents.off(document, "click", self, true);
utilsEvents.on(ui.numberMinutes, "spinchange", self, true);
utilsEvents.on(ui.numberHours, "spinchange", self, true);
};
TimePicker.prototype = prototype;
TimePicker.prototype.constructor = TimePicker;
// definition
ns.widget.wearable.TimePicker = TimePicker;
ns.engine.defineWidget(
"TimePicker",
WIDGET_SELECTOR,
[],
TimePicker,
""
);
}(window, window.document, window.tau));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # ColorPicker Component
*
* Color picker is a Tizen component based on Selector, dedicated for easy color selection.
* It works in a similar way to Selector and all Selector methods are compatible with Color
* Picker as well. Compared to Selector it has additional methods for getting the value of selected
* color. The component has built-in set of 11 default colors.
*
* ## HTML example
*
* @example
* <div class="ui-page ui-page-active" id="main">
* <div id="colorpicker" class="ui-colorpicker">
* </div>
* </div>
*
* ## Manual constructor
*
* @example
* (function() {
* var page = document.getElementById("main"),
* colorpicker = document.getElementById("colorpicker"),
* clickBound;
*
* function onClick(event) {
* var activeItem = selector.querySelector(".ui-item-active");
* }
* page.addEventListener("pagebeforeshow", function() {
* clickBound = onClick.bind(null);
* tau.widget.Selector(selector);
* colorpicker.addEventListener("click", clickBound, false);
* });
* page.addEventListener("pagebeforehide", function() {
* colorpicker.removeEventListener("click", clickBound, false);
* });
* })();
*
* ## Options
* This component has no additional options.
*
* @class ns.widget.wearable.ColorPicker
* @author Dariusz Dyrda <d.dyrda@samsung.com>
*/
(function (document, ns) {
"use strict";
var Selector = ns.widget.wearable.Selector,
engine = ns.engine,
ColorPicker = function () {
var self = this;
self.options = {};
Selector.call(self);
},
colorDefinitions = {
red: "#FE0030",
darkorange: "#FE5E34",
orange: "#FE8E38",
yellow: "#FEEE43",
yellowgreen: "#82C350",
green: "#00B455",
darkturquoise: "#00A99C",
deepskyblue: "#00B0EA",
darkblue: "#0058A1",
purple: "#6A338D",
grey: "#727272"
},
WIDGET_CLASS = "ui-colorpicker",
classes = {
WIDGET: WIDGET_CLASS,
SELECTOR: "ui-selector",
ITEM: "ui-item",
INDICATOR: "ui-selector-indicator-text",
ITEM_ACTIVE: "ui-item-active"
},
activeColor,
prototype = new Selector();
/**
* Dictionary for ColorPicker related events.
* For color picker, it is an empty object.
* @property {Object} events
* @member ns.widget.wearable.ColorPicker
* @static
*/
ColorPicker.events = {};
/**
* Build ColorPicker component
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.ColorPicker
*/
prototype._build = function (element) {
var self = this;
self._createItems(element);
Selector.prototype._build.call(self, element);
element.classList.add(WIDGET_CLASS, classes.SELECTOR);
return element;
};
/**
* Create selector items based on colorDefinitions array
* @method _createItems
* @param {HTMLElement} element
* @protected
*/
prototype._createItems = function (element) {
var itemClass = classes.ITEM,
item;
Object.keys(colorDefinitions).forEach(function (color) {
item = document.createElement("div");
item.classList.add(itemClass);
item.style.backgroundColor = colorDefinitions[color];
item.setAttribute("data-title", color);
element.appendChild(item);
});
};
/**
* Set the active color and set indicator background
* @method _setActiveItem
* @param {number} index
* @protected
*/
prototype._setActiveItem = function (index) {
var self = this,
activeItem,
indicator;
Selector.prototype._setActiveItem.call(self, index);
indicator = self.element.querySelector("." + classes.INDICATOR);
activeItem = self.element.querySelector("." + classes.ITEM_ACTIVE).getAttribute("data-title");
activeColor = colorDefinitions[activeItem];
indicator.style.backgroundColor = activeColor;
};
/**
* This method returns hex value of the selected color
* @method getSelectedColor
* @return {string} color
* @public
* @member ns.widget.wearable.ColorPicker
*/
prototype.getSelectedColor = function () {
return activeColor;
};
/**
* Destroy widget
* @method _destroy
* @protected
* @member ns.widget.wearable.ColorPicker
*/
prototype._destroy = function () {
var self = this,
element = self.element;
Selector.prototype._destroy.call(self);
element.innerHTML = "";
};
ColorPicker.prototype = prototype;
ns.widget.wearable.ColorPicker = ColorPicker;
engine.defineWidget(
"ColorPicker",
".ui-colorpicker",
[
"getSelectedColor"
],
ColorPicker
);
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns*/
/**
* #DatePicker Widget
*
* @class ns.widget.wearable.DatePicker
* @since 4.0
* @extends ns.widget.BaseWidget
*/
(function (window, document) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
utilsEvents = ns.event,
NumberPicker = ns.widget.wearable.NumberPicker,
prototype = new BaseWidget(),
getClosestByClass = ns.util.selectors.getClosestByClass,
WIDGET_CLASS = "ui-date-picker",
classes = {
CONTAINER: WIDGET_CLASS + "-container",
CONTAINER_PREFIX: WIDGET_CLASS + "-container-",
DAYNAME_CONTAINER: WIDGET_CLASS + "-containter-dayname",
ACTIVE_LABEL_ANIMATION: WIDGET_CLASS + "-active-label-animation",
HIDDEN: WIDGET_CLASS + "-hidden",
LABEL_HIDDEN: "ui-number-picker-label-hidden"
},
DAY_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"],
MONTH_NAMES = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"],
WIDGET_SELECTOR = "." + WIDGET_CLASS,
INDICATOR_OPTIONS = {
month: {
to: 12,
bigTick: 1,
bigTickHeight: 20,
smallTick: 0
},
year: {
to: 50,
bigTickHeight: 13,
bigTick: 5,
smallTick: 1
},
day: {
to: 30,
bigTickHeight: 13,
bigTick: 2,
smallTick: 1
}
},
MIN_YEAR = 1900,
MAX_YEAR = 2050,
CONTAINERS = ["month", "day", "year"];
function DatePicker() {
var self = this;
self._ui = {
display: {},
dayNameContainer: null,
footer: null
};
self.options = {
min: 0,
max: 12,
step: 1,
disabled: false
};
self._circleIndicatorSupporter = null;
self._activeSelector = null;
self._spins = {};
}
/**
* Initialize widget state, set current date and init month indicator
* @method _init
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._init = function () {
this._setValue(new Date());
this._setActiveSelector("month");
};
/**
* Bind events click and rotarydetent
* @method _bindEvents
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._bindEvents = function () {
var self = this;
self.on("click", self, true);
utilsEvents.on(self._ui.display.day, "spinchange", self, false);
utilsEvents.on(self._ui.display.month, "spinchange", self, false);
utilsEvents.on(self._ui.display.year, "spinchange", self, false);
utilsEvents.on(document, "rotarydetent", self, true);
};
/**
* Unbind events click and rotarydetent
* @method _unbindEvents
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._unbindEvents = function () {
var self = this;
utilsEvents.off(document, "rotarydetent", self, true);
self.off("click", self, true);
};
/**
* Build full widget structure
* @method _build
* @param {HTMLElement} element
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
footer = document.createElement("footer"),
buttonSet = document.createElement("button"),
dayNameContainer = document.createElement("div");
// create button set
buttonSet.innerHTML = "SET";
// add classes
element.classList.add(NumberPicker.classes.CONTAINER);
buttonSet.classList.add("ui-btn", NumberPicker.classes.BUTTON_SET);
footer.classList.add("ui-footer", "ui-bottom-button", "ui-fixed");
dayNameContainer.classList.add(classes.DAYNAME_CONTAINER);
// build DOM structure
CONTAINERS.forEach(function (name) {
element.appendChild(self._createContainer(name));
});
element.appendChild(dayNameContainer);
element.appendChild(footer);
footer.appendChild(buttonSet);
ui.buttonSet = buttonSet;
ui.dayNameContainer = dayNameContainer;
ui.footer = footer;
self._buildNumberPicker();
return element;
};
/**
* Build number picker
* @method _buildNumberPicker
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._buildNumberPicker = function () {
var self = this,
display = self._ui.display;
Object.keys(display).forEach(function (key) {
var options;
switch (key) {
case "month" :
options = {
min: 1,
max: MONTH_NAMES.length,
loop: "enabled",
labels: MONTH_NAMES.join(","),
rollHeight: "custom",
itemHeight: 50,
duration: 300,
value: 2
};
break;
case "day" :
options = {
min: 1,
max: 31,
loop: "enabled",
rollHeight: "custom",
itemHeight: 50,
duration: 300,
value: 1
};
break;
case "year" :
// @ todo: change spin to carousel for big data
options = {
min: MIN_YEAR,
max: MAX_YEAR,
loop: "enabled",
rollHeight: "custom",
itemHeight: 50,
duration: 300,
value: 1
};
break;
}
self._spins[key] = ns.widget.Spin(display[key], options);
});
};
/**
* Set options "to" for indicator
* @method _setOptionsTo
* @param {string} type
* @param {number} number
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._setOptionsTo = function (type, number) {
var options = INDICATOR_OPTIONS[type];
if (number) {
options.to = number;
}
};
/**
* Create one container with children
* @method _createContainer
* @param {string} name
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._createContainer = function (name) {
var self = this,
ui = self._ui,
number = document.createElement("div"),
numberPickerLabel = document.createElement("label"),
numberPickerContainer = document.createElement("div");
number.classList.add(NumberPicker.classes.NUMBER);
numberPickerContainer.classList.add(classes.CONTAINER);
numberPickerLabel.classList.add(NumberPicker.classes.LABEL);
numberPickerLabel.innerText = name[0].toUpperCase() + name.substr(1);
numberPickerContainer.appendChild(numberPickerLabel);
numberPickerContainer.appendChild(number);
numberPickerContainer.classList.add(classes.CONTAINER_PREFIX + name);
ui.display[name] = number;
return numberPickerContainer;
};
/**
* Set value of widget
* @method _setValue
* @param {Date} value
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._setValue = function (value) {
var self = this,
ui = self._ui,
dayName = DAY_NAMES[value.getDay()];
self._value = value;
Object.keys(ui.display).forEach(function (name) {
self._spins[name].value(self._getValue(name));
});
ui.dayNameContainer.innerHTML = dayName;
};
/**
* Return Date value or value of one field
* @method _getValue
* @param {string} type
* @memberof ns.widget.wearable.DatePicker
* @return {Date|number}
* @protected
*/
prototype._getValue = function (type) {
var value = this._value;
switch (type) {
case "month":
return value.getMonth() + 1;
case "day":
return value.getDate();
case "year":
return value.getFullYear();
default:
return value;
}
};
prototype._getTextValue = function (type) {
var value = this._value;
switch (type) {
case "month":
return MONTH_NAMES[value.getMonth()];
case "day":
return value.getDate();
case "year":
return value.getFullYear();
default:
return value;
}
};
prototype._getIndicatorValue = function (type) {
var value = this._value;
switch (type) {
case "month":
return value.getMonth() + 1;
case "day":
return value.getDate();
case "year":
return value.getFullYear() % 50;
default:
return value;
}
};
/**
* Return days in month
* @method _daysInMonth
* @param {number} year
* @param {number} month
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._daysInMonth = function (year, month) {
if (year === undefined) {
year = this._getValue("year");
}
if (month === undefined) {
month = this._getValue("month") - 1;
}
return new Date(year, month + 1, 0).getDate();
};
/**
* Handle events
* @method handleEvent
* @param {Event} event
* @memberof ns.widget.wearable.DatePicker
*/
prototype.handleEvent = function (event) {
var self = this;
if (event.type === "click") {
event.preventDefault();
self._onClick(event);
} else if (event.type === "rotarydetent") {
event.preventDefault();
self._onRotary(event);
} else if (event.type === "spinchange") {
self._onSpinChange(event.detail.value);
}
};
/**
* Get value of number of ticks on full rotation
* @method _getMaxValue
* @param {string} activeName
* @memberof ns.widget.wearable.DatePicker
* @return {number}
* @protected
*/
prototype._getMaxValue = function (activeName) {
switch (activeName) {
case "day":
return this._daysInMonth();
case "year":
return 50;
default:
return 12;
}
};
/**
* Set label visible
* @method _setLabelVisible
* @param {string} activeName
* @param {boolean} state
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._setLabelVisible = function (activeName, state) {
var parent = getClosestByClass(this._ui.display[activeName], classes.CONTAINER),
label = parent.querySelector("." + NumberPicker.classes.LABEL);
if (!state) {
label.classList.add(classes.LABEL_HIDDEN);
} else {
label.classList.remove(classes.LABEL_HIDDEN);
}
}
/**
* Change indicator after click in value
* @method _setActiveSelector
* @param {string} activeName
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._setActiveSelector = function (activeName) {
var self = this,
ui = self._ui,
maxValue = self._getMaxValue(activeName),
spins = self._spins;
if (self._activeSelector !== activeName) {
if (activeName) {
self._setOptionsTo(activeName, maxValue);
}
// disable all;
Object.keys(ui.display).forEach(function (name) {
if (spins[name].option("enabled")) {
spins[name].option("enabled", false);
self._setLabelVisible(name, true);
}
});
// enable selected;
if (activeName && spins[activeName]) {
spins[activeName].option("enabled", true);
self._setLabelVisible(activeName, false);
}
}
self._activeSelector = activeName;
};
/**
* On click change current indicator or exit page on set click
* @method _onClick
* @param {Event} event
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._onClick = function (event) {
var self = this,
target = event.target,
parent = getClosestByClass(target, classes.CONTAINER),
parentClassName = (parent) ? parent.className : "",
activeName = "";
if (parentClassName) {
activeName = parentClassName.replace(classes.CONTAINER_PREFIX, "")
.replace(classes.CONTAINER, "")
.trim();
}
if (parent && activeName && CONTAINERS.indexOf(activeName) > -1) {
self._setActiveSelector(activeName);
} else if (target.classList.contains("ui-number-picker-set")) {
self.trigger("change", {
value: self.value()
});
history.back();
} else {
self._setActiveSelector(""); // disable all
}
};
/**
* Destroy widget
* @method _destroy
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._destroy = function () {
this._unbindEvents();
this.element.innerHTML = "";
};
/**
* Change month value on rotary event
* @method _changeMonth
* @param {number} changeValue
* @param {boolean} value
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._changeMonth = function (changeValue) {
var self = this,
value = self.value(),
month = value.getMonth(),
newValue,
day = value.getDate(),
year = value.getFullYear(),
daysInMonth;
newValue = month + changeValue;
value.setMonth(newValue);
value.setFullYear(year);
daysInMonth = self._daysInMonth(year, newValue);
if (day > daysInMonth && (self._daysInMonth(year, month) > daysInMonth)) {
value = new Date(year, newValue, daysInMonth);
}
self._changeValue(value);
};
/**
* Change day value on rotary event
* @method _changeDay
* @param {number} changeValue
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._changeDay = function (changeValue) {
var self = this,
value = self.value(),
month = value.getMonth(),
newValue,
day = value.getDate(),
year = value.getFullYear(),
daysInMonth = self._daysInMonth(year, month);
newValue = day + changeValue;
if (changeValue < 0 && day === 1) {
value.setDate(daysInMonth);
} else {
value.setDate(newValue);
}
value.setMonth(month);
value.setFullYear(year);
self._changeValue(value);
};
/**
* Change year value on rotary event
* @method _changeYear
* @param {number} changeValue
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._changeYear = function (changeValue) {
var self = this,
value = self.value(),
month = value.getMonth(),
year = value.getFullYear(),
newYear = year + changeValue,
daysInMonth;
if (newYear > MAX_YEAR) {
newYear = MIN_YEAR;
} else if (newYear < MIN_YEAR) {
newYear = MAX_YEAR;
}
value.setFullYear(newYear);
// last day in Feb case, month = 1 => Feb
daysInMonth = self._daysInMonth(value.getFullYear(), 1);
if ((month === 1) && (self._daysInMonth(year, 1) > daysInMonth)) {
value.setMonth(1);
value.setDate(daysInMonth);
}
self._changeValue(value);
};
/**
* Update indicator value
* @method _changeValue
* @param {number} value
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._changeValue = function (value) {
var self = this;
self._setValue(value);
};
/**
* Change indicator on rotary
* @method _onRotary
* @param {Event} event
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._onRotary = function (event) {
var self = this,
direction = event.detail.direction,
changeValue;
if (direction === "CW") {
changeValue = 1;
} else {
changeValue = -1;
}
switch (self._activeSelector) {
case "month":
self._changeMonth(changeValue);
break;
case "day":
self._changeDay(changeValue);
break;
case "year":
self._changeYear(changeValue);
break;
}
};
/**
* Change value of spin included in dataPicker
* @method _onSpinChange
* @param {number} value
* @memberof ns.widget.wearable.DatePicker
* @protected
*/
prototype._onSpinChange = function (newValue) {
var self = this,
value = self.value(),
currentValue;
switch (self._activeSelector) {
case "month":
currentValue = value.getMonth() + 1,
self._changeMonth(newValue - currentValue);
break;
case "day":
currentValue = value.getDate(),
self._changeDay(newValue - currentValue);
break;
case "year":
currentValue = value.getFullYear(),
self._changeYear(newValue - currentValue);
break;
}
};
DatePicker.prototype = prototype;
DatePicker.prototype.constructor = DatePicker;
ns.widget.wearable.DatePicker = DatePicker;
engine.defineWidget(
"DatePicker",
WIDGET_SELECTOR,
[],
DatePicker,
""
);
}(window, window.document));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns*/
/**
* #TextInput Widget
*
* @class ns.widget.wearable.TextInput
* @since 4.0
* @extends ns.widget.BaseWidget
*/
(function (document, ns) {
"use strict";
var BaseWidget = ns.widget.BaseWidget,
engine = ns.engine,
utilEvent = ns.event,
selectors = ns.util.selectors,
TextInput = function () {
var self = this;
self._initialWindowHeight = null;
self._hasFocus = false;
self._isInputPaneVisible = false;
self._ui = {};
},
prototype = new BaseWidget();
TextInput.events = {};
/**
* Build TextInput
* @method _build
* @param {HTMLElement} element
* @return {HTMLElement}
* @protected
* @member ns.widget.wearable.TextInput
*/
prototype._build = function (element) {
var self = this,
ui = self._ui,
pane,
page;
page = selectors.getClosestByClass(element, "ui-page");
if (page) {
pane = selectors.getChildrenByClass(page, "ui-textinput-pane")[0];
if (!pane) {
pane = document.createElement("div");
pane.classList.add("ui-textinput-pane")
page.appendChild(pane);
}
}
ui.page = page;
ui.pane = pane;
this._initialWindowHeight = window.innerHeight;
return element;
};
prototype._init = function (element) {
var self = this;
self._hideInputPaneBound = self._hideInputPane.bind(self);
self._windowResizeBound = self._onWindowResize.bind(self);
self._onHWKeyBound = self._onHWKey.bind(self);
return element;
};
prototype._bindEvents = function (element) {
var self = this;
utilEvent.on(element, "focus", self, true);
utilEvent.on(element, "blur", self, true);
};
prototype._showInputPane = function () {
var self = this,
ui = self._ui,
pane = ui.pane,
element = self.element,
inputElement = element.cloneNode(true);
pane.appendChild(inputElement);
pane.style.display = "block";
self._isInputPaneVisible = true;
inputElement.focus();
utilEvent.on(inputElement, "blur", self._hideInputPaneBound, true);
utilEvent.on(window, "resize", self._windowResizeBound, true);
utilEvent.on(window, "tizenhwkey", self._onHWKeyBound, true);
};
prototype._hideInputPane = function () {
var self = this,
ui = self._ui,
pane = ui.pane,
element = self.element,
inputElement;
if (self._isInputPaneVisible) {
inputElement = pane.lastChild;
element.value = inputElement.value;
utilEvent.off(inputElement, "blur", self._hideInputPaneBound, true);
pane.removeChild(inputElement);
pane.style.display = "none";
utilEvent.off(window, "resize", self._windowResizeBound, true);
utilEvent.off(window, "tizenhwkey", self._onHWKeyBound, true);
self._isInputPaneVisible = false;
}
};
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "focus":
self._onFocus(event);
break;
case "blur":
self._onBlur(event);
break;
}
};
prototype._onFocus = function (event) {
var self = this;
event.preventDefault();
self.element.blur();
if (!self._isInputPaneVisible) {
self._showInputPane();
}
};
prototype._onWindowResize = function () {
var self = this,
currentWindowHeight = window.innerHeight;
if (currentWindowHeight === self._initialWindowHeight) {
if (self._isInputPaneVisible) {
self._hideInputPane();
}
}
};
prototype._onBlur = function (event) {
var self = this;
event.preventDefault();
if (self._isInputPaneVisible) {
self._hideInputPane();
}
};
prototype._onHWKey = function (event) {
if (event.keyName === "back") {
event.preventDefault();
event.stopPropagation();
this._hideInputPane();
}
}
prototype.focus = function () {
this.element.focus();
};
prototype.blur = function () {
this.element.blur();
}
TextInput.prototype = prototype;
ns.widget.wearable.TextInput = TextInput;
engine.defineWidget(
"TextInput",
"input[type='text']" +
", input[type='number']" +
", input[type='password']" +
", input[type='email']" +
", input[type='url']" +
", input[type='tel']" +
", input[type='search']",
[],
TextInput,
"wearable"
);
}(window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint plusplus: true, nomen: true */
/**
* @class tau.helper
* @author Heeju Joo <heeju.joo@samsung.com>
*/
(function (ns) {
"use strict";
ns.helper = ns.helper || {};
}(ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #SnapListStyle Helper Script
* Helper script using SnapListview.
* @class ns.helper.SnapListStyle
* @author Junyoung Park <jy-.park@samsung.com>
*/
(function (document, window, ns) {
"use strict";
var engine = ns.engine,
SnapListStyle = function (listDomElement, options) {
this._snapListviewWidget = engine.instanceWidget(listDomElement, "SnapListview", options);
},
prototype = SnapListStyle.prototype;
/**
* Destroy helper
* @method destroy
* @member ns.helper.SnapListStyle
*/
prototype.destroy = function () {
var self = this;
if (self._snapListviewWidget) {
self._snapListviewWidget.destroy();
}
self._snapListviewWidget = null;
};
/**
* Return Snap list
* @method getSnapList
* @member ns.helper.SnapListStyle
*/
prototype.getSnapList = function () {
return this._snapListviewWidget;
};
/**
* Create helper
* @method create
* @param {HTMLElement} listDomElement
* @param {Object} options
* @static
* @member ns.helper.SnapListStyle
*/
SnapListStyle.create = function (listDomElement, options) {
return new SnapListStyle(listDomElement, options);
};
ns.helper.SnapListStyle = SnapListStyle;
}(document, window, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns */
/**
* #SnapListMarqueeStyle Helper Script
*
* Helper script using SnapListview and Marquee.
* @class ns.helper.SnapListMarqueeStyle
* @author Heeju Joo <heeju.joo@samsung.com>
*/
(function (document, window, ns) {
"use strict";
var engine = ns.engine,
helper = ns.helper,
objectUtils = ns.util.object,
defaults = {
marqueeDelay: 0,
marqueeStyle: "slide",
speed: 60,
iteration: 1,
timingFunction: "linear",
ellipsisEffect: "gradient",
runOnlyOnEllipsisText: true,
autoRun: false,
snapListview: true
},
ListMarqueeStyle = function (listElement, options) {
var self = this;
self.options = objectUtils.fastMerge({}, defaults);
objectUtils.fastMerge(self.options, options);
self._listviewWidget = null;
self._selectedMarqueeWidget = null;
self.element = listElement;
},
prototype = ListMarqueeStyle.prototype;
/**
* Destroy previous Marquee and create new.
* @method _instanceMarquee
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._instanceMarquee = function () {
var self = this,
marqueeElement = self._marqueeElement,
selectedMarqueeWidget;
self._destroyMarqueeWidget();
if (marqueeElement) {
selectedMarqueeWidget = engine.instanceWidget(marqueeElement, "Marquee", self.options);
selectedMarqueeWidget.start();
self._marqueeElement = null;
self._selectedMarqueeWidget = selectedMarqueeWidget;
}
};
/**
* Handler for click event on rectangle version
* @method _clickHandlerForRectangular
* @param {Event} event
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._clickHandlerForRectangular = function (event) {
var self = this,
eventTarget = event.target,
selectedMarqueeWidget = self._selectedMarqueeWidget;
if (selectedMarqueeWidget &&
eventTarget.parentElement === selectedMarqueeWidget.element) {
if (selectedMarqueeWidget._state === "running") {
selectedMarqueeWidget.reset();
} else {
selectedMarqueeWidget.start();
}
} else {
if (eventTarget && eventTarget.classList.contains("ui-marquee")) {
self._marqueeElement = eventTarget;
requestAnimationFrame(self._instanceMarquee.bind(self));
}
}
};
/**
* Handler for scroll event on rectangular version
* @method _scrollHandlerForRectangular
* @member ns.helper.SnapListMarqueeStyle
* @protected
*/
prototype._scrollHandlerForRectangular = function () {
this._destroyMarqueeWidget();
};
/**
* Destroy Marquee widget on element
* @method _destroyMarqueeWidget
* @member ns.helper.SnapListMarqueeStyle
* @protected
*/
prototype._destroyMarqueeWidget = function () {
var selectedMarqueeWidget = this._selectedMarqueeWidget;
if (selectedMarqueeWidget) {
selectedMarqueeWidget.stop();
selectedMarqueeWidget.reset();
selectedMarqueeWidget.destroy();
this._selectedMarqueeWidget = null;
}
};
/**
* Handler for touch start event
* @method _touchStartHandler
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._touchStartHandler = function () {
if (this._selectedMarqueeWidget) {
this._selectedMarqueeWidget.reset();
}
};
/**
* Handler for scrollend event
* @method _scrollEndHandler
* @member ns.helper.SnapListMarqueeStyle
* @protected
*/
prototype._scrollEndHandler = function () {
this._destroyMarqueeWidget();
};
/**
* Handler for selected event
* @method _selectedHandler
* @param {Event} event
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._selectedHandler = function (event) {
var self = this,
marqueeElement = event.target.querySelector(".ui-marquee");
if (marqueeElement) {
self._marqueeElement = marqueeElement;
requestAnimationFrame(self._instanceMarquee.bind(self));
}
};
/**
* Handler for all events
* @method handleEvent
* @param {Event} event
* @member ns.helper.SnapListMarqueeStyle
*/
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "click":
self._clickHandlerForRectangular(event);
break;
case "scroll":
self._scrollHandlerForRectangular(event);
break;
case "rotarydetent":
case "touchstart":
self._touchStartHandler(event);
break;
case "scrollend":
self._scrollEndHandler(event);
break;
case "selected":
self._selectedHandler(event);
break;
}
};
/**
* Init helper
* @method init
* @member ns.helper.SnapListMarqueeStyle
*/
prototype.init = function () {
var self = this,
listElement = self.element,
listWidgetName,
options = self.options;
options.delay = options.delay || options.marqueeDelay;
if (ns.support.shape.circle) {
self._bindEventsForCircular();
} else {
self._bindEventsForRectangular();
options.snapListview = false;
}
// create SnapListStyle helper
if (options.snapListview) {
listWidgetName = "SnapListview";
} else {
listWidgetName = "Listview";
}
self._listviewWidget = engine.instanceWidget(listElement, listWidgetName, options);
};
/**
* Bind events for rectangle version
* @method _bindEventsForRectangular
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._bindEventsForRectangular = function () {
document.addEventListener("click", this, false);
document.addEventListener("scroll", this, true);
};
/**
* Unbind events for rectangle version
* @method _unbindEventsForRectangular
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._unbindEventsForRectangular = function () {
document.removeEventListener("click", this, false);
document.removeEventListener("scroll", this, true);
};
/**
* Bind events for circular version
* @method _bindEventsForCircular
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._bindEventsForCircular = function () {
var self = this;
document.addEventListener("touchstart", self, false);
document.addEventListener("scrollend", self, false);
document.addEventListener("rotarydetent", self, false);
document.addEventListener("selected", self, false);
};
/**
* Unbind events for circular version
* @method _unbindEventsForCircular
* @protected
* @member ns.helper.SnapListMarqueeStyle
*/
prototype._unbindEventsForCircular = function () {
var self = this;
document.removeEventListener("touchstart", self, false);
document.removeEventListener("scrollend", self, false);
document.removeEventListener("rotarydetent", self, false);
document.removeEventListener("selected", self, false);
};
/**
* Destroy helper and all widgets
* @method destroy
* @member ns.helper.SnapListMarqueeStyle
*/
prototype.destroy = function () {
var self = this;
if (ns.support.shape.circle) {
self._unbindEventsForCircular();
} else {
self._unbindEventsForRectangular();
}
self._destroyMarqueeWidget();
if (self._listviewWidget) {
self._listviewWidget.destroy();
self._listviewWidget = null;
}
self.options = null;
};
ListMarqueeStyle.create = function (listElement, options) {
var instance = new ListMarqueeStyle(listElement, options);
instance.init();
return instance;
};
helper.SnapListMarqueeStyle = ListMarqueeStyle;
helper.ListMarqueeStyle = ListMarqueeStyle;
}(document, window, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #DrawerMoreStyle Helper Script
* Helper script using drawer, sectionChanger.
* @class ns.helper.DrawerMoreStyle
* @author Hyeoncheol Choi <hc7.choi@samsung.com>
*/
(function (document, window, ns) {
"use strict";
var engine = ns.engine,
objectUtils = ns.util.object,
events = ns.event,
selectors = ns.util.selectors,
defaults = {
more: ".ui-more",
selector: ".ui-selector"
},
classes = {
page: "ui-page"
},
DrawerMoreStyle = function (element, options) {
var self = this;
self.options = objectUtils.merge({}, defaults);
self._drawerWidget = null;
self._handlerElement = null;
self._selectorWidget = null;
self.init(element, options);
},
prototype = DrawerMoreStyle.prototype;
function bindDragEvents(element) {
events.on(element, "touchstart touchend mousedown mouseup", this, false);
}
function unBindDragEvents(element) {
events.off(element, "touchstart touchend mousedown mouseup", this, false);
}
prototype.handleEvent = function (event) {
var self = this;
switch (event.type) {
case "touchstart":
case "mousedown":
self._onTouchStart(event);
break;
case "touchend":
case "mouseup":
self._onTouchEnd(event);
break;
}
};
prototype._onTouchStart = function (event) {
event.preventDefault();
event.stopPropagation();
};
prototype._onTouchEnd = function () {
this._drawerWidget.close();
};
prototype.init = function (element, options) {
var self = this,
pageElement = selectors.getClosestByClass(element, classes.page),
handlerElement,
selectorElement;
objectUtils.fastMerge(self.options, options);
handlerElement = pageElement.querySelector(self.options.handler);
selectorElement = element.querySelector(self.options.selector);
self._drawerWidget = engine.instanceWidget(element, "Drawer");
if (handlerElement) {
self._drawerWidget.setDragHandler(handlerElement);
self._handlerElement = handlerElement;
self._bindEvents();
}
if (selectorElement) {
self._selectorWidget = engine.instanceWidget(selectorElement, "Selector");
}
};
prototype._bindEvents = function () {
var self = this;
bindDragEvents.call(self, self._handlerElement);
};
prototype._unbindEvents = function () {
var self = this;
unBindDragEvents.call(self, self._handlerElement);
};
prototype.destroy = function () {
var self = this;
if (self._handlerElement) {
self._unbindEvents();
}
self._drawerWidget = null;
self._handlerElement = null;
self._selectorWidget = null;
};
DrawerMoreStyle.create = function (element, options) {
return new DrawerMoreStyle(element, options);
};
ns.helper.DrawerMoreStyle = DrawerMoreStyle;
}(document, window, ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #RotaryEventBinder
* Utility for scroll by rotary detent
* @class ns.helper.RotaryEventBinder
* @author Hagun Kim <hagun.kim@samsung.com>
*/
(function (document, window, ns) {
"use strict";
var objectUtils = ns.util.object,
selectors = ns.util.selectors,
animationTimer = null,
RotaryEventBinder = function (scroller, options) {
var self = this;
self._elScroller = null;
self._scrollTop = 0;
self._dest = 0;
self._scrollMax = 0;
self._callbacks = {};
self.options = {
scrollDistance: 119,
scrollDuration: 450
};
self.init(scroller, options);
},
prototype = RotaryEventBinder.prototype;
function cubicBezier(x1, y1, x2, y2) {
return function (t) {
var rp = 1 - t,
rp3 = 3 * rp,
p2 = t * t,
p3 = p2 * t,
a1 = rp3 * t * rp,
a2 = rp3 * p2;
if (t > 1) {
return 1;
}
return a1 * y1 + a2 * y2 + p3;
};
}
function scrollAnimation(element, from, to, duration) {
var easeOut = cubicBezier(0.25, 0.46, 0.45, 1),
startTime = 0,
currentTime = 0,
progress = 0,
easeProgress = 0,
distance = to - from,
scrollTop = from;
startTime = window.performance.now();
animationTimer = window.requestAnimationFrame(function animation() {
var gap;
currentTime = window.performance.now();
progress = (currentTime - startTime) / duration;
easeProgress = easeOut(progress);
gap = distance * easeProgress;
element.scrollTop = scrollTop + gap;
if (progress < 1 && progress >= 0) {
animationTimer = window.requestAnimationFrame(animation);
} else {
animationTimer = null;
}
});
}
function showEdgeEffect(direction) {
if (window.addEdgeEffectONSCROLLTizenUIF) {
if (direction === "CW") {
window.addEdgeEffectONSCROLLTizenUIF(false, true, false, false);
} else {
window.addEdgeEffectONSCROLLTizenUIF(true, false, false, false);
}
}
}
function clearScrollAnimation() {
if (animationTimer !== null) {
window.cancelAnimationFrame(animationTimer);
animationTimer = null;
}
}
prototype._rotaryDetentHandler = function (e) {
var self = this,
elScroller = self._elScroller,
options = self.options,
direction = e.detail.direction;
if (direction === "CW") {
if (elScroller.scrollTop === self._scrollMax) {
showEdgeEffect(direction);
return;
}
self._dest = self._scrollTop + options.scrollDistance > self._scrollMax ? self._scrollMax : self._scrollTop + options.scrollDistance;
if (self._scrollTop === self._scrollMax && self._dest === self._scrollMax) {
return;
}
clearScrollAnimation();
} else if (direction === "CCW") {
if (elScroller.scrollTop === 0) {
showEdgeEffect(direction);
return;
}
self._dest = self._scrollTop - options.scrollDistance < 0 ? 0 : self._scrollTop - options.scrollDistance;
if (self._scrollTop === 0 && self._dest === 0) {
return;
}
clearScrollAnimation();
}
scrollAnimation(elScroller, elScroller.scrollTop, self._dest, options.scrollDuration);
self._scrollTop = self._dest;
};
prototype._scrollEndEventHandler = function (e) {
this._scrollTop = e.currentTarget.scrollTop;
};
prototype.init = function (scroller, options) {
var self = this,
elScroller;
elScroller = scroller instanceof HTMLElement ? scroller : document.getElementById(scroller);
if (elScroller === null) {
ns.warn("Scrollable element parameter should be HTML element or id of the element.");
return undefined;
}
elScroller = selectors.getScrollableParent(elScroller);
if (elScroller === null) {
ns.warn("There is no scrollable element.");
return undefined;
}
self._elScroller = elScroller;
self._scrollTop = elScroller.scrollTop;
self._scrollMax = elScroller.scrollHeight - elScroller.offsetHeight;
objectUtils.merge(self.options, options);
self.bindEvents();
};
prototype.bindEvents = function () {
var self = this,
rotaryDetentCallback,
scrollEventCallback;
rotaryDetentCallback = self._rotaryDetentHandler.bind(self);
scrollEventCallback = self._scrollEndEventHandler.bind(self);
self._callbacks.rotarydetent = rotaryDetentCallback;
self._callbacks.scrollend = scrollEventCallback;
window.addEventListener("rotarydetent", rotaryDetentCallback, false);
self._elScroller.addEventListener("scrollend", scrollEventCallback, false);
};
prototype.unbindEvents = function () {
var self = this;
window.removeEventListener("rotarydetent", self._callbacks.rotarydetent);
self._elScroller.removeEventListener("scrollend", self._callbacks.scrollend);
self._callbacks.rotarydetent = null;
};
prototype.destroy = function () {
var self = this;
self.unbindEvents();
self._elScroller = null;
self.options = null;
self._callbacks = null;
};
prototype.getScroller = function () {
return this._elScroller;
};
RotaryEventBinder.create = function (scroller, options) {
return new RotaryEventBinder(scroller, options);
};
ns.helper.RotaryEventBinder = RotaryEventBinder;
}(document, window, ns));
/*global window, ns, define, ns */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Route CircularIndexScrollbar
* Support class for router to control circularindexscrollbar widget in profile Wearable.
* @class ns.router.route.circularindexscrollbar
* @author Junyoung Park <jy-.park@samsung.com>
*/
(function (document, ns) {
"use strict";
var util = ns.util,
path = util.path,
history = ns.router.history,
routeCircularIndexScrollbar = {},
circularindexscrollbarHashKey = "circularindexscrollbar=true",
circularindexscrollbarHashKeyReg = /([&|\?]circularindexscrollbar=true)/,
INDEXSCROLLBAR_SELECTOR = ".ui-circularindexscrollbar";
routeCircularIndexScrollbar.orderNumber = 2000;
/**
* Property defining selector for filtering only circularIndexScrollbar elements
* @property {string} filter
* @member ns.router.route.circularindexscrollbar
* @static
*/
routeCircularIndexScrollbar.filter = INDEXSCROLLBAR_SELECTOR;
/**
* Returns default route options used inside Router.
* But, circularindexscrollbar router has not options.
* @method option
* @static
* @member ns.router.route.circularindexscrollbar
* @return {null}
*/
routeCircularIndexScrollbar.option = function () {
return null;
};
/**
* This method opens the circularindexscrollbar.
* @method open
* @return {null}
* @member ns.router.route.circularindexscrollbar
*/
routeCircularIndexScrollbar.open = function () {
return null;
};
/**
* This method determines target circularIndexScrollbar to open.
* @method find
* @param {string} absUrl Absolute path to opened circularIndexScrollbar widget
* @member ns.router.route.circularindexscrollbar
* @return {?HTMLElement} circularIndexScrollbarElement
*/
routeCircularIndexScrollbar.find = function (absUrl) {
var dataUrl = path.convertUrlToDataUrl(absUrl),
activePage = ns.router.Router.getInstance().getContainer().getActivePage(),
circularIndexScrollbar;
circularIndexScrollbar = activePage.element.querySelector("#" + dataUrl);
return circularIndexScrollbar;
};
/**
* This method parses HTML and runs scripts from parsed code.
* But, circularIndexScrollbar router doesn't need to that.
* @method parse
* @member ns.router.route.circularindexscrollbar
* @return {?HTMLElement} Element of page in parsed document.
*/
routeCircularIndexScrollbar.parse = function () {
return null;
};
/**
* This method sets active circularIndexScrollbar and manages history.
* @method setActive
* @param {Object} activeWidget
* @member ns.router.route.circularindexscrollbar
* @static
*/
routeCircularIndexScrollbar.setActive = function (activeWidget) {
var url,
pathLocation = path.getLocation(),
documentUrl = pathLocation.replace(circularindexscrollbarHashKeyReg, "");
this._activeWidget = activeWidget;
if (activeWidget) {
url = path.addHashSearchParams(documentUrl, circularindexscrollbarHashKey);
history.replace({}, "", url);
} else if (pathLocation !== documentUrl) {
history.back();
}
this.active = true;
};
/**
* This method handles hash change.
* @method onHashChange
* @param {string} url
* @param {Object} options
* @param {Object} prev
* @static
* @member ns.router.route.circularindexscrollbar
* @return {null}
*/
routeCircularIndexScrollbar.onHashChange = function (url, options, prev) {
var self = this,
activeWidget = self._activeWidget,
stateUrl = prev.stateUrl;
if (activeWidget && stateUrl.search(circularindexscrollbarHashKey) > 0 && url.search(circularindexscrollbarHashKey) < 0) {
activeWidget.hide(options);
self.active = false;
return true;
}
return null;
};
ns.router.route.circularindexscrollbar = routeCircularIndexScrollbar;
}(window.document, ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, define, ns */
/**
* #Route grid
* Support class for router to control grid widget in profile Wearable.
* @class ns.router.route.grid
* @author Tomasz Lukawski <t.lukawski@samsung.com>
*/
(function () {
"use strict";
var history = ns.history,
routeGrid = {
orderNumber: 1000,
filter: ".ui-grid",
/**
* Returns default route options used inside Router.
* But, grid router has not options.
* @method option
* @static
* @member ns.router.route.grid
* @return {null}
*/
option: function () {
return null;
},
open: function (toPage, options) {
history.replace({
url: options.url,
rel: options.rel
},
options.url,
options.title
);
},
onHashChange: function () {
return null;
},
find: function () {
return null;
}
};
ns.router.route.grid = routeGrid;
}());
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global window, ns, define, ns */
/**
* @class tau.expose
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function (document) {
"use strict";
document.addEventListener("beforerouterinit", function () {
if (ns.autoInitializePage !== undefined) {
ns.setConfig("autoInitializePage", ns.autoInitializePage);
}
}, false);
document.addEventListener("routerinit", function (evt) {
var router = evt.detail,
utilObject = ns.util.object,
routePage = router.getRoute("page"),
routePopup = router.getRoute("popup"),
history = ns.history,
back = history.back.bind(router),
classes = ns.widget.core.Page.classes,
pageActiveClass = classes.uiPageActive;
/**
* @method changePage
* @inheritdoc ns.router.Router#open
* @member tau
*/
ns.changePage = router.open.bind(router);
document.addEventListener("pageshow", function () {
/**
* Current active page
* @property {HTMLElement} activePage
* @member tau
*/
ns.activePage = document.querySelector("." + pageActiveClass);
});
/**
* First page element
* @inheritdoc ns.router.Router#firstPage
* @property {HTMLElement} firstPage
* @member tau
*/
ns.firstPage = routePage.getFirstElement();
/**
* Returns active page element
* @inheritdoc ns.router.Router#getActivePageElement
* @method getActivePage
* @member tau
*/
ns.getActivePage = routePage.getActiveElement.bind(routePage);
/**
* @inheritdoc ns.router.history#back
* @method back
* @member tau
*/
ns.back = back;
/**
* @inheritdoc ns.router.Router#init
* @method initializePage
* @member tau
*/
ns.initializePage = router.init.bind(router);
/**
* Page Container widget
* @property {HTMLElement} pageContainer
* @inheritdoc ns.router.Router#container
* @member tau
*/
ns.pageContainer = router.container;
/**
* @method openPopup
* @inheritdoc ns.router.Router#openPopup
* @member tau
*/
ns.openPopup = function (to, options) {
var htmlElementTo;
if (to && to.length !== undefined && typeof to === "object") {
htmlElementTo = to[0];
} else {
htmlElementTo = to;
}
options = utilObject.merge({}, options, {rel: "popup"});
router.open(htmlElementTo, options);
};
/**
* @method closePopup
* @inheritdoc ns.router.Router#closePopup
* @member tau
*/
ns.closePopup = routePopup.close.bind(routePopup, null);
}, false);
}(window.document));
/*global define, ns */
(function (ns) {
"use strict";
var engine = ns.engine;
ns.IndexScrollbar = function (element, options) {
ns.warn("tau.IndexScrollbar is deprecated. you have to use tau.widget.IndexScrollbar.");
return engine.instanceWidget(element, "IndexScrollbar", options);
};
ns.SectionChanger = function (element, options) {
ns.warn("tau.SectionChanger is deprecated. you have to use tau.widget.SectionChanger.");
return engine.instanceWidget(element, "SectionChanger", options);
};
ns.SwipeList = function (element, options) {
ns.warn("tau.SwipeList is deprecated. you have to use tau.widget.SwipeList.");
return engine.instanceWidget(element, "SwipeList", options);
};
ns.VirtualListview = function (element, options) {
ns.warn("tau.VirtualListview is deprecated. you have to use tau.widget.VirtualListview.");
return engine.instanceWidget(element, "VirtualListview", options);
};
}(ns));
/*global window, define, ns */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* #Event scrolledtoedge
* Namespace to support scrolledtoedge event
* @class ns.event.scrolledtoedge
*/
/**
* Event scrolledtoedge
* @event scrolledtoedge
* @member ns.event.scrolledtoedge
*/
(function (window, document, ns) {
"use strict";
var eventUtils = ns.event,
onScroll = function (ev) {
var target = ev.target,
edgeReached = false,
result = {
left: false,
right: false,
top: false,
bottom: false
};
if (target.scrollHeight > target.clientHeight) {
if (target.scrollTop === 0) {
edgeReached = true;
result.top = true;
} else if (target.scrollTop === target.scrollHeight - target.clientHeight) {
edgeReached = true;
result.bottom = true;
}
}
if (target.scrollWidth > target.clientWidth) {
if (target.scrollLeft === 0) {
edgeReached = true;
result.left = true;
} else if (target.scrollLeft === target.scrollWidth - target.clientWidth) {
edgeReached = true;
result.right = true;
}
}
// trigger event
if (edgeReached) {
eventUtils.trigger(target, "scrolledtoedge", result);
}
},
scrolledToEdge = {
enable: function () {
window.addEventListener("scroll", onScroll, true);
},
disable: function () {
window.removeEventListener("scroll", onScroll, true);
}
};
ns.event.scrolledtoedge = scrolledToEdge;
}(window, window.document, ns));
/*global window, ns, define */
/*
* Copyright (c) 2013 - 2014 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*jslint nomen: true*/
/**
* #Event pinch
* Object supports pinch event.
* @class ns.event.pinch
*/
(function (window, document, ns) {
"use strict";
var rotaryemulation = {
enabled: true,
bind: function () {
document.addEventListener("mousewheel", handleEvent, true);
},
unbind: function () {
document.removeEventListener("mousewheel", handleEvent, true);
}
},
utilsEvents = ns.event;
/**
* Handle touch move event. Triggers rotaryemulation event if occurs
* @param {Event} event
* @private
* @static
* @member ns.event.rotaryemulation
*/
function handleEvent(event) {
var direction = "CCW";
if (event.deltaY > 0) {
direction = "CW";
}
utilsEvents.trigger(event.target, "rotarydetent", {
direction: direction
});
}
// Init rotaryemulation event
rotaryemulation.bind();
ns.event.pinch = rotaryemulation;
}(window, window.document, ns));
/*global ns, window, define */
/*jslint nomen: true */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* # Gesture Plugin: pinch
* Plugin enables pinch event.
*
* @class ns.event.gesture.Pinch
*/
(function (ns) {
"use strict";
/**
* Local alias for {@link ns.event.gesture}
* @property {Object}
* @member ns.event.gesture.Pinch
* @private
* @static
*/
var gesture = ns.event.gesture,
/**
* Local alias for {@link ns.event.gesture.Detector}
* @property {Object}
* @member ns.event.gesture.Pinch
* @private
* @static
*/
Result = gesture.Result,
Detector = ns.event.gesture.Detector,
eventNames = {
start: "pinchstart",
move: "pinchmove",
end: "pinchend",
cancel: "pinchcancel",
in: "pinchin",
out: "pinchout"
},
Pinch = Detector.plugin.create({
/**
* Gesture name
* @property {string} [name="pinch"]
* @member ns.event.gesture.Pinch
*/
name: "pinch",
/**
* Gesture Index
* @property {number} [index=300]
* @member ns.event.gesture.Pinch
*/
index: 300,
/**
* Array of possible pinch events
* @property {Object} eventNames
* @member ns.event.gesture.Pinch
*/
eventNames: eventNames,
/**
* Default values for pinch gesture
* @property {Object} defaults
* @property {number} [defaults.velocity=0.6]
* @property {number} [defaults.timeThreshold=400]
* @member ns.event.gesture.Pinch
*/
defaults: {
velocity: 0.6,
timeThreshold: 400
},
/**
* Triggered
* @property {boolean} [isTriggered=false]
* @member ns.event.gesture.Pinch
*/
isTriggered: false,
/**
* Handler for pinch gesture
* @method handler
* @param {Event} gestureEvent gesture event
* @param {Object} sender event's sender
* @param {Object} options options
* @return {number}
* @member ns.event.gesture.Pinch
*/
handler: function (gestureEvent, sender, options) {
var result = Result.PENDING,
prevented;
switch (gestureEvent.eventType) {
case gesture.Event.MOVE:
if (gestureEvent.pointers.length === 1 && gestureEvent.distance > 35) {
result = Result.FINISHED;
} else if (!this.isTriggered && gestureEvent.pointers.length >= 2) {
this.isTriggered = true;
if (sender.sendEvent(eventNames.start, gestureEvent) === false) {
gestureEvent.preventDefault();
}
result = Result.RUNNING;
} else if (this.isTriggered) {
if ((gestureEvent.deltaTime < options.timeThreshold) &&
(gestureEvent.velocityX > options.velocity || gestureEvent.velocityY > options.velocity)) {
if (gestureEvent.scale < 1) {
prevented = sender.sendEvent(eventNames.in, gestureEvent);
} else {
prevented = sender.sendEvent(eventNames.out, gestureEvent);
}
if (prevented === false) {
gestureEvent.preventDefault();
}
this.isTriggered = false;
result = Result.FINISHED | Result.BLOCK;
return result;
} else {
if (sender.sendEvent(eventNames.move, gestureEvent) === false) {
gestureEvent.preventDefault();
}
result = Result.RUNNING;
}
}
break;
case gesture.Event.BLOCKED:
case gesture.Event.END:
if (this.isTriggered) {
if (sender.sendEvent(eventNames.end, gestureEvent) === false) {
gestureEvent.preventDefault();
}
this.isTriggered = false;
result = Result.FINISHED;
}
break;
case gesture.Event.CANCEL:
if (this.isTriggered) {
if (sender.sendEvent(eventNames.cancel, gestureEvent) === false) {
gestureEvent.preventDefault();
}
this.isTriggered = false;
result = Result.FINISHED;
}
break;
}
return result;
}
});
ns.event.gesture.Pinch = Pinch;
}(ns));
/*global define, XMLHttpRequest, ns*/
/**
* #HTML template engine
*
* Parser for HTML files.
*
* This class hasn't public interface. This class is registered as template engine
* in template manager.
*
* This engine give support of load HTML files for give URL.
*
* @class ns.template.html
* @author Maciej Urbanski <m.urbanski@samsung.com>
*/
(function () {
"use strict";
var template = ns.template,
util = ns.util,
utilPath = util.path;
/**
* Callback for event load and error on XMLHttpRequest
* @param {Function} callback Function called after parse response
* @param {Object} data Data passed to render function
* @param {Event} event event object
*/
function callbackFunction(callback, data, event) {
var request = event.target,
status = {},
element;
if (request.readyState === 4) {
status.success = (request.status === 200 || (request.status === 0 && request.responseXML));
element = request.responseXML;
// if option fullDocument is set then return document element
// Router require full document
if (!data.fullDocument) {
// otherwise return first child of body
// controller require only element
element = element.body.firstChild;
}
callback(status, element);
}
}
/**
* Function process given path, get file by XMLHttpRequest and return
* HTML element.
* @param {Object} globalOptions
* @param {string} path
* @param {Object} data
* @param {Function} callback
*/
function htmlTemplate(globalOptions, path, data, callback) {
var absUrl = path,
request,
eventCallback = callbackFunction.bind(null, callback, data);
// If the caller provided data append the data to the URL.
if (data) {
absUrl = utilPath.addSearchParams(path, data);
}
// Load the new content.
request = new XMLHttpRequest();
request.responseType = "document";
request.overrideMimeType("text/html");
request.open("GET", absUrl);
request.addEventListener("error", eventCallback);
request.addEventListener("load", eventCallback);
request.send();
}
template.register("html", htmlTemplate);
}());
/*global define, ns, window */
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* @author Maciej Urbanski <m.urbanski@samsung.com>
* @author Krzysztof Antoszek <k.antoszek@samsung.com>
*/
(function (ns) {
"use strict";
if (ns.getConfig("autorun", true) === true) {
ns.engine.run();
}
}(ns));
/*
* Copyright (c) 2015 Samsung Electronics Co., Ltd
*
* Licensed under the Flora License, Version 1.1 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://floralicense.org/license/
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*global define, ns */
// setup profile info
ns.info.profile = "wearable";
}(window, window.document));