dragonbones-runtime
Version:
the tools to build dragonbones file for diffrent framework
337 lines (310 loc) • 10.3 kB
text/typescript
//////////////////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2014-present, Egret Technology.
// All rights reserved.
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright
// notice, this list of conditions and the following disclaimer in the
// documentation and/or other materials provided with the distribution.
// * Neither the name of the Egret nor the
// names of its contributors may be used to endorse or promote products
// derived from this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY EGRET AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
// OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
// OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
// IN NO EVENT SHALL EGRET AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA,
// OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
//////////////////////////////////////////////////////////////////////////////////////
namespace eui {
/**
* @private
* 存储根据groupName自动创建的RadioButtonGroup列表
*/
let automaticRadioButtonGroups = {};
/**
* The RadioButton component allows the user make a single choice
* within a set of mutually exclusive choices.
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @includeExample extension/eui/components/RadioButtonExample.ts
* @language en_US
*/
/**
* RadioButton 组件使用户可在一组互相排斥的选择中做出一种选择
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @includeExample extension/eui/components/RadioButtonExample.ts
* @language zh_CN
*/
export class RadioButton extends ToggleButton {
/**
* Constructor.
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language en_US
*/
/**
* 构造函数。
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language zh_CN
*/
public constructor() {
super();
this.groupName = "radioGroup";
}
/**
* @private
* 在RadioButtonGroup中的索引
*/
$indexNumber:number = 0;
/**
* @private
* 所属的RadioButtonGroup
*/
$radioButtonGroup:RadioButtonGroup = null;
/**
* The RadioButton component is enabled if the
* RadioButtonGroup is enabled and the RadioButton itself is enabled.
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language en_US
*/
/**
* 如果 RadioButtonGroup 启用且 RadioButton 本身也启用，则 RadioButton 组件启用。
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language zh_CN
*/
public get enabled():boolean {
if (!this.$Component[sys.ComponentKeys.enabled]) {
return false;
}
return !this.$radioButtonGroup ||
this.$radioButtonGroup.$enabled;
}
public set enabled(value:boolean) {
this.$setEnabled(value);
}
/**
* @private
*/
private _group:RadioButtonGroup = null;
/**
* The RadioButtonGroup component to which this RadioButton belongs.
* If this property is not set,
* a unique RadioButtonGroup is created automatically based on the groupName property.
*
* @see eui.RadioButton#groupName
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language en_US
*/
/**
* 此 RadioButton 所属的 RadioButtonGroup 组件。
* 若不设置此属性，则根据groupName属性自动创建一个唯一的RadioButtonGroup。
*
* @see eui.RadioButton#groupName
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language zh_CN
*/
public get group():RadioButtonGroup {
if (!this._group && this._groupName) {
let g:RadioButtonGroup = automaticRadioButtonGroups[this._groupName];
if (!g) {
g = new RadioButtonGroup();
g.$name = this._groupName;
automaticRadioButtonGroups[this._groupName] = g;
}
this._group = g;
}
return this._group;
}
public set group(value:RadioButtonGroup) {
if (this._group == value)
return;
if (this.$radioButtonGroup)
this.$radioButtonGroup.$removeInstance(this, false);
this._group = value;
this._groupName = value ? this.group.$name : "radioGroup";
this.groupChanged = true;
this.invalidateProperties();
this.invalidateDisplayList();
}
/**
* @private
*/
private groupChanged:boolean = false;
/**
* @private
*/
private _groupName:string = "radioGroup";
/**
* Specifies the name of the group to which this RadioButton component belongs
*
* @default “radioGroup”
*
* @see eui.RadioButton#group
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language en_US
*/
/**
* RadioButton 组件所属的组的名称
*
* @default “radioGroup”
*
* @see eui.RadioButton#group
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language zh_CN
*/
public get groupName():string {
return this._groupName;
}
public set groupName(value:string) {
if (!value || value == "")
return;
this._groupName = value;
if (this.$radioButtonGroup)
this.$radioButtonGroup.$removeInstance(this, false);
this._group = null;
this.groupChanged = true;
this.invalidateProperties();
this.invalidateDisplayList();
}
/**
* @private
*
* @param value
*/
$setSelected(value:boolean):boolean{
let result:boolean = super.$setSelected(value);
this.invalidateDisplayList();
return result;
}
/**
* @private
*/
private _value:any = null;
/**
* Optional user-defined value
* that is associated with a RadioButton component.
*
* @default null
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language en_US
*/
/**
* 与 RadioButton 组件关联的可选用户定义值。
*
* @default null
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
* @language zh_CN
*/
public get value():any {
return this._value;
}
public set value(value:any) {
if (this._value == value)
return;
this._value = value;
if (this.$selected && this.group){
PropertyEvent.dispatchPropertyEvent(this.group,PropertyEvent.PROPERTY_CHANGE,"selectedValue");
}
}
/**
* @inheritDoc
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
*/
protected commitProperties():void {
if (this.groupChanged) {
this.addToGroup();
this.groupChanged = false;
}
super.commitProperties();
}
/**
* @inheritDoc
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
*/
protected updateDisplayList(unscaledWidth:number, unscaledHeight:number):void {
super.updateDisplayList(unscaledWidth, unscaledHeight);
if (this.group) {
if (this.$selected)
this._group.$setSelection(this, false);
else if (this.group.selection == this)
this._group.$setSelection(null, false);
}
}
/**
* @inheritDoc
*
* @version Egret 2.4
* @version eui 1.0
* @platform Web,Native
*/
protected buttonReleased():void {
if (!this.enabled || this.selected)
return;
if (!this.$radioButtonGroup)
this.addToGroup();
super.buttonReleased();
this.group.$setSelection(this, true);
}
/**
* @private
* 添此单选按钮加到组
*/
private addToGroup():RadioButtonGroup {
let g:RadioButtonGroup = this.group;
if (g)
g.$addInstance(this);
return g;
}
}
}