378 lines
11 KiB
JavaScript
378 lines
11 KiB
JavaScript
/* globals ThrowPropsPlugin, Strong */
|
|
|
|
/* Imports */
|
|
import Events from '../events.js'
|
|
|
|
/**
|
|
* Class that represents a PixiJS List.
|
|
*
|
|
* @example
|
|
* const elephant1 = PIXI.Sprite.from('./assets/elephant-1.jpg')
|
|
* const elephant2 = PIXI.Sprite.from('./assets/elephant-2.jpg')
|
|
*
|
|
* // Create the list
|
|
* const list = new List([elephant1, elephant2])
|
|
*
|
|
* app.scene.addChild(list)
|
|
*
|
|
* @class
|
|
* @extends PIXI.Container
|
|
* @see {@link http://pixijs.download/dev/docs/PIXI.Container.html|PixiJS Container}
|
|
* @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/list.html|DocTest}
|
|
*/
|
|
export default class List extends PIXI.Container {
|
|
/**
|
|
* Creates an instance of a Flippable.
|
|
*
|
|
* @constructor
|
|
* @param {PIXI.DisplayObject[]} items - An array of PIXI.DisplayObjects.
|
|
* @param {object} [opts] - An options object which can contain the following properties.
|
|
* @param {number} [opts.width] - The width of the list. If the items are larger than this width, the overflow
|
|
* will be hidden.
|
|
* @param {number} [opts.height] - The height of the list. If the items are larger than this height, the overflow
|
|
* will be hidden.
|
|
* @param {number} [opts.padding=10] - The inner spacing (distance from one item to the previous/next item).
|
|
* @param {number} [opts.margin=10] - The outer spacing (distance from one item to the border).
|
|
* @param {string} [opts.orientation=vertical] - The orientation of the button group. Can be horizontal or vertical.
|
|
* @param {string} [opts.align=left] - The horizontal position of the items. Possible values are
|
|
* left, center and right.
|
|
* @param {string} [opts.verticalAlign=middle] - The vertical position of the items. Possible values are
|
|
* top, middle and bottom.
|
|
* @param {PIXI.Application} [opts.app] - The PixiJS Application. Must be set if you want to use the mousewheel to
|
|
* scroll your list.
|
|
*/
|
|
constructor(items = [], opts = {}) {
|
|
super()
|
|
|
|
this.opts = Object.assign(
|
|
{},
|
|
{
|
|
padding: 10,
|
|
margin: 10,
|
|
orientation: 'vertical',
|
|
align: 'left',
|
|
verticalAlign: 'middle',
|
|
width: null,
|
|
height: null,
|
|
app: null
|
|
},
|
|
opts
|
|
)
|
|
|
|
this.__items = items
|
|
this.__dragging = false
|
|
|
|
// setup
|
|
//--------------------
|
|
this.setup()
|
|
}
|
|
|
|
/**
|
|
* Creates children and instantiates everything.
|
|
*
|
|
* @private
|
|
* @return {List} A reference to the list for chaining.
|
|
*/
|
|
setup() {
|
|
// inner container
|
|
//--------------------
|
|
const container = new PIXI.Container()
|
|
this.addChild(container)
|
|
this.container = container
|
|
|
|
// mask
|
|
//--------------------
|
|
const mask = new PIXI.Graphics()
|
|
this.addChild(mask)
|
|
this.__mask = mask
|
|
|
|
// add items
|
|
//--------------------
|
|
for (let item of this.__items) {
|
|
container.addChild(item)
|
|
}
|
|
|
|
// interaction
|
|
//--------------------
|
|
this.interactive = this.opts.width || this.opts.height
|
|
this.on('pointerdown', this.onStart.bind(this))
|
|
this.on('pointermove', this.onMove.bind(this))
|
|
this.on('pointerup', this.onEnd.bind(this))
|
|
this.on('pointercancel', this.onEnd.bind(this))
|
|
this.on('pointerout', this.onEnd.bind(this))
|
|
this.on('pointerupoutside', this.onEnd.bind(this))
|
|
this.on('scroll', this.onScroll.bind(this))
|
|
|
|
// mousewheel
|
|
//--------------------
|
|
if (this.opts.app) {
|
|
const app = this.opts.app
|
|
app.view.addEventListener('mousewheel', event => {
|
|
const bounds = this.mask ? this.mask.getBounds() : this.getBounds()
|
|
const x = event.clientX - app.view.getBoundingClientRect().left
|
|
const y = event.clientY - app.view.getBoundingClientRect().top
|
|
if (bounds.contains(x, y)) {
|
|
event.preventDefault()
|
|
this.emit('scroll', event)
|
|
}
|
|
})
|
|
}
|
|
|
|
this.layout()
|
|
|
|
return this
|
|
}
|
|
|
|
/**
|
|
* Replaces the existing items and relayouts the list.
|
|
*
|
|
* @param {PIXI.DisplayObject[]} items - An array of PIXI.DisplayObjects.
|
|
* @return {List} A reference to the list for chaining.
|
|
*/
|
|
setItems(items) {
|
|
this.container.removeChildren()
|
|
this.__items = items
|
|
for (let item of this.__items) {
|
|
this.container.addChild(item)
|
|
}
|
|
this.layout()
|
|
}
|
|
|
|
/**
|
|
* Should be called to refresh the layout of the list (the width or the height).
|
|
*
|
|
* @return {List} A reference to the list for chaining.
|
|
*/
|
|
layout() {
|
|
const margin = this.opts.margin
|
|
|
|
let x = margin
|
|
let y = margin
|
|
|
|
for (let item of this.__items) {
|
|
item.x = x
|
|
item.y = y
|
|
|
|
if (this.opts.orientation === 'vertical') {
|
|
y += item.height + this.opts.padding
|
|
} else {
|
|
x += item.width + this.opts.padding
|
|
}
|
|
}
|
|
|
|
// vertical
|
|
//--------------------
|
|
if (this.opts.orientation === 'vertical') {
|
|
switch (this.opts.align) {
|
|
case 'center':
|
|
this.__items.forEach(it => (it.x = margin + this.width / 2 - it.width / 2))
|
|
break
|
|
case 'right':
|
|
this.__items.forEach(it => (it.x = margin + this.width - it.width))
|
|
break
|
|
default:
|
|
this.__items.forEach(it => (it.x = margin))
|
|
break
|
|
}
|
|
|
|
if (this.opts.height) {
|
|
const mask = this.__mask
|
|
mask.clear()
|
|
mask.beginFill(0x000)
|
|
mask.drawRect(0, 0, this.width + 2 * margin, this.opts.height)
|
|
this.mask = mask
|
|
|
|
this.interactive = this.innerHeight > this.opts.height
|
|
}
|
|
}
|
|
|
|
// horizontal
|
|
//--------------------
|
|
if (this.opts.orientation === 'horizontal') {
|
|
switch (this.opts.verticalAlign) {
|
|
case 'top':
|
|
this.__items.forEach(it => (it.y = margin))
|
|
break
|
|
case 'bottom':
|
|
this.__items.forEach(it => (it.y = margin + this.height - it.height))
|
|
break
|
|
default:
|
|
this.__items.forEach(it => (it.y = margin + this.height / 2 - it.height / 2))
|
|
break
|
|
}
|
|
|
|
if (this.opts.width) {
|
|
const mask = this.__mask
|
|
mask.clear()
|
|
mask.beginFill(0x000)
|
|
mask.drawRect(0, 0, this.opts.width, this.height + 2 * margin)
|
|
this.mask = mask
|
|
|
|
this.interactive = this.innerWidth > this.opts.width
|
|
}
|
|
}
|
|
|
|
return this
|
|
}
|
|
|
|
/**
|
|
*
|
|
*/
|
|
get innerWidth() {
|
|
let size = 0
|
|
|
|
this.__items.forEach(it => (size += it.width))
|
|
size += this.opts.padding * (this.__items.length - 1)
|
|
size += 2 * this.opts.margin
|
|
|
|
return size
|
|
}
|
|
|
|
/**
|
|
*
|
|
*/
|
|
get innerHeight() {
|
|
let size = 0
|
|
|
|
this.__items.forEach(it => (size += it.height))
|
|
size += this.opts.padding * (this.__items.length - 1)
|
|
size += 2 * this.opts.margin
|
|
|
|
return size
|
|
}
|
|
|
|
/**
|
|
* Resizes the list.
|
|
*
|
|
* @param {number} widthOrHeight - The new width (if orientation is horizontal) or height (if orientation is vertical) of the list.
|
|
*/
|
|
resize(widthOrHeight) {
|
|
if (this.opts.orientation === 'horizontal') {
|
|
this.opts.width = widthOrHeight
|
|
} else {
|
|
this.opts.height = widthOrHeight
|
|
}
|
|
|
|
this.layout()
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @private
|
|
* @param {*} event
|
|
*/
|
|
onStart(event) {
|
|
this.__dragging = true
|
|
|
|
this.capture(event)
|
|
|
|
this.__delta = {
|
|
x: this.container.position.x - event.data.global.x,
|
|
y: this.container.position.y - event.data.global.y
|
|
}
|
|
|
|
TweenLite.killTweensOf(this.container.position, { x: true, y: true })
|
|
if (typeof ThrowPropsPlugin != 'undefined') {
|
|
ThrowPropsPlugin.track(this.container.position, 'x,y')
|
|
}
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @private
|
|
* @param {*} event
|
|
*/
|
|
onMove(event) {
|
|
if (this.__dragging) {
|
|
this.capture(event)
|
|
|
|
if (this.opts.orientation === 'horizontal') {
|
|
this.container.position.x = event.data.global.x + this.__delta.x
|
|
} else {
|
|
this.container.position.y = event.data.global.y + this.__delta.y
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @private
|
|
* @param {*} event
|
|
*/
|
|
onEnd(event) {
|
|
if (this.__dragging) {
|
|
this.__dragging = false
|
|
|
|
this.capture(event)
|
|
|
|
const throwProps = {}
|
|
|
|
if (this.opts.orientation === 'horizontal') {
|
|
let min = this.opts.width - this.innerWidth
|
|
min = min > 0 ? 0 : min
|
|
throwProps.x = {
|
|
velocity: 'auto',
|
|
min,
|
|
max: 0
|
|
}
|
|
} else {
|
|
let min = this.opts.height - this.innerHeight
|
|
min = min > 0 ? 0 : min
|
|
throwProps.y = {
|
|
velocity: 'auto',
|
|
min,
|
|
max: 0
|
|
}
|
|
}
|
|
|
|
if (typeof ThrowPropsPlugin != 'undefined') {
|
|
ThrowPropsPlugin.to(
|
|
this.container.position,
|
|
{
|
|
throwProps,
|
|
ease: Strong.easeOut,
|
|
onComplete: () => ThrowPropsPlugin.untrack(this.container.position)
|
|
},
|
|
0.8,
|
|
0.4
|
|
)
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @private
|
|
* @param {*} event
|
|
*/
|
|
onScroll(event) {
|
|
this.capture(event)
|
|
|
|
if (this.opts.orientation === 'horizontal') {
|
|
this.container.position.x -= event.deltaX
|
|
if (this.container.position.x > 0) {
|
|
this.container.position.x = 0
|
|
} else if (this.container.position.x + this.innerWidth < this.opts.width) {
|
|
this.container.position.x = this.opts.width - this.innerWidth
|
|
}
|
|
} else {
|
|
this.container.position.y -= event.deltaY
|
|
if (this.container.position.y > 0) {
|
|
this.container.position.y = 0
|
|
} else if (this.container.position.y + this.innerHeight < this.opts.height) {
|
|
this.container.position.y = this.opts.height - this.innerHeight
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Captures an event to inform InteractionMapper about processed events.
|
|
*
|
|
* @param {event|PIXI.InteractionEvent} event - The PIXI event to capture.
|
|
*/
|
|
capture(event) {
|
|
const originalEvent = event.data && event.data.originalEvent ? event.data.originalEvent : event
|
|
Events.capturedBy(originalEvent, this)
|
|
}
|
|
}
|