mirror of
https://github.com/cappuccino/cappuccino.git
synced 2026-08-25 13:07:02 +00:00
507 lines
15 KiB
Plaintext
507 lines
15 KiB
Plaintext
/*
|
|
* AppKit.j
|
|
* AppKit
|
|
*
|
|
* Created by Alexandre Wilhelm.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
@import <Foundation/Foundation.j>
|
|
@import "CPResponder.j"
|
|
|
|
@import "CPTheme.j"
|
|
|
|
var CPViewThemeClassKey = @"CPViewThemeClassKey",
|
|
CPViewThemeStateKey = @"CPViewThemeStateKey";
|
|
|
|
@protocol CPTheme
|
|
|
|
- (CPString)themeClass;
|
|
- (void)setThemeClass:(CPString)theClass;
|
|
|
|
- (CPTheme)theme;
|
|
- (void)setTheme:(CPTheme)aTheme;
|
|
|
|
- (unsigned)themeState;
|
|
- (BOOL)hasThemeState:(ThemeState)aState;
|
|
- (BOOL)hasThemeStates:(CPArray)states;
|
|
- (BOOL)setThemeState:(ThemeState)aState;
|
|
- (BOOL)setThemeStates:(CPArray)aState;
|
|
- (BOOL)unsetThemeState:(ThemeState)aState;
|
|
- (BOOL)unsetThemeStates:(CPArray)aState;
|
|
- (BOOL)hasThemeAttribute:(CPString)aName;
|
|
|
|
- (void)objectDidChangeTheme;
|
|
|
|
- (void)setValue:(id)aValue forThemeAttribute:(CPString)aName inState:(ThemeState)aState;
|
|
- (void)setValue:(id)aValue forThemeAttribute:(CPString)aName;
|
|
- (id)valueForThemeAttribute:(CPString)aName inState:(ThemeState)aState;
|
|
- (id)valueForThemeAttribute:(CPString)aName;
|
|
- (id)currentValueForThemeAttribute:(CPString)aName;
|
|
- (void)registerThemeValues:(CPArray)themeValues;
|
|
- (void)registerThemeValues:(CPArray)themeValues inherit:(CPArray)inheritedValues;
|
|
|
|
@end
|
|
|
|
@implementation CPObject (ObjectTheming)
|
|
{
|
|
// Theming Support
|
|
CPTheme _theme;
|
|
CPString _themeClass;
|
|
JSObject _themeAttributes;
|
|
unsigned _themeState;
|
|
}
|
|
|
|
|
|
#pragma mark -
|
|
#pragma mark Theme State
|
|
|
|
- (unsigned)themeState
|
|
{
|
|
return _themeState;
|
|
}
|
|
|
|
- (BOOL)hasThemeState:(ThemeState)aState
|
|
{
|
|
#if DEBUG
|
|
// TODO: To allow aState to be an array is now deprecated. An exception is thrown only in Debug version as
|
|
// the preformance cost for this check is to high. We should remove this check in a future release.
|
|
if (aState && aState.isa && [aState isKindOfClass:CPArray])
|
|
[CPException raise:CPInvalidArgumentException reason:@"aState can't be an array. Please use 'hasThemeStates: instead: " + aState];
|
|
#endif
|
|
|
|
return _themeState.hasThemeState(aState);
|
|
}
|
|
|
|
- (BOOL)hasThemeStates:(CPArray)states
|
|
{
|
|
var i = [states count],
|
|
aState = [states objectAtIndex:--i];
|
|
|
|
while (i > 0)
|
|
aState = aState.and([states objectAtIndex:--i]);
|
|
|
|
return _themeState.hasThemeState(aState);
|
|
}
|
|
|
|
- (BOOL)setThemeState:(ThemeState)aState
|
|
{
|
|
#if DEBUG
|
|
// TODO: To allow aState to be an array is now deprecated. An exception is thrown only in Debug version as
|
|
// the preformance cost for this check is to high. We should remove this check in a future release.
|
|
if (aState && aState.isa && [aState isKindOfClass:CPArray])
|
|
[CPException raise:CPInvalidArgumentException reason:@"aState can't be an array. Please use 'setThemeStates: instead: " + aState];
|
|
#endif
|
|
|
|
if (_themeState.hasThemeState(aState))
|
|
return NO;
|
|
|
|
_themeState = _themeState.and(aState);
|
|
|
|
return YES;
|
|
}
|
|
|
|
- (BOOL)unsetThemeState:(ThemeState)aState
|
|
{
|
|
#if DEBUG
|
|
// TODO: To allow aState to be an array is now deprecated. An exception is thrown only in Debug version as
|
|
// the preformance cost for this check is to high. We should remove this check in a future release.
|
|
if (aState && aState.isa && [aState isKindOfClass:CPArray])
|
|
[CPException raise:CPInvalidArgumentException reason:@"aState can't be an array. Please use 'unsetThemeStates: instead: " + aState];
|
|
#endif
|
|
|
|
var oldThemeState = _themeState;
|
|
|
|
_themeState = _themeState.without(aState);
|
|
|
|
if (oldThemeState === _themeState)
|
|
return NO;
|
|
|
|
return YES;
|
|
}
|
|
|
|
- (BOOL)setThemeStates:(CPArray)states
|
|
{
|
|
var i = [states count],
|
|
aState = [states objectAtIndex:--i];
|
|
|
|
while (i > 0)
|
|
aState = aState.and([states objectAtIndex:--i]);
|
|
|
|
return [self setThemeState:aState];
|
|
}
|
|
|
|
- (BOOL)unsetThemeStates:(CPArray)states
|
|
{
|
|
var i = [states count],
|
|
aState = [states objectAtIndex:--i];
|
|
|
|
while (i > 0)
|
|
aState = aState.and([states objectAtIndex:--i]);
|
|
|
|
return [self unsetThemeState:aState];
|
|
}
|
|
|
|
#pragma mark Theme Attributes
|
|
|
|
+ (CPString)defaultThemeClass
|
|
{
|
|
return nil;
|
|
}
|
|
|
|
+ (CPDictionary)themeAttributes
|
|
{
|
|
return nil;
|
|
}
|
|
|
|
- (CPString)themeClass
|
|
{
|
|
if (_themeClass)
|
|
return _themeClass;
|
|
|
|
return [[self class] defaultThemeClass];
|
|
}
|
|
|
|
- (void)setThemeClass:(CPString)theClass
|
|
{
|
|
_themeClass = theClass;
|
|
|
|
[self _loadThemeAttributes];
|
|
}
|
|
|
|
var NULL_THEME = {};
|
|
|
|
+ (CPArray)_themeAttributesForTheme:(CPTheme)theme andThemeClass:(CPString)themeClassName
|
|
{
|
|
var theClass = [self class],
|
|
theClassName = class_getName(theClass),
|
|
themeClassNameCache = theme != nil ? theme._cachedThemeAttributes || (theme._cachedThemeAttributes = {}) : NULL_THEME,
|
|
themedCacheAttributes = themeClassNameCache[themeClassName] || (themeClassNameCache[themeClassName] = {}),
|
|
attributes = themedCacheAttributes[theClassName];
|
|
|
|
if (attributes)
|
|
return attributes;
|
|
else
|
|
attributes = [];
|
|
|
|
var CPObjectClass = [CPObject class];
|
|
|
|
for (; theClass && theClass !== CPObjectClass; theClass = [theClass superclass])
|
|
{
|
|
var cachedAttributes = themedCacheAttributes[class_getName(theClass)];
|
|
|
|
if (cachedAttributes)
|
|
{
|
|
attributes = attributes.length ? attributes.concat(cachedAttributes) : attributes;
|
|
break;
|
|
}
|
|
|
|
var attributeDictionary = [theClass themeAttributes];
|
|
|
|
if (!attributeDictionary)
|
|
continue;
|
|
|
|
var attributeKeys = [attributeDictionary allKeys],
|
|
attributeCount = attributeKeys.length;
|
|
|
|
while (attributeCount--)
|
|
{
|
|
var attributeName = attributeKeys[attributeCount],
|
|
attributeValue = [attributeDictionary objectForKey:attributeName],
|
|
themeAttribute = [[_CPThemeAttribute alloc] initWithName:attributeName defaultValue:attributeValue defaultAttribute:[theme attributeWithName:attributeName forClass:themeClassName]];
|
|
|
|
attributes.push(themeAttribute);
|
|
}
|
|
}
|
|
|
|
themedCacheAttributes[theClassName] = attributes;
|
|
|
|
return attributes;
|
|
}
|
|
|
|
- (void)_loadThemeAttributes
|
|
{
|
|
var theClass = [self class],
|
|
attributes = [theClass _themeAttributesForTheme:[self theme] andThemeClass:[self themeClass]],
|
|
count = attributes.length;
|
|
|
|
if (!count)
|
|
return;
|
|
|
|
_themeAttributes = {};
|
|
|
|
while (count--)
|
|
{
|
|
var attribute = attributes[count];
|
|
|
|
_themeAttributes[attribute._name] = attribute;
|
|
}
|
|
}
|
|
|
|
- (CPTheme)theme
|
|
{
|
|
return _theme;
|
|
}
|
|
|
|
- (void)setTheme:(CPTheme)aTheme
|
|
{
|
|
if (_theme === aTheme)
|
|
return;
|
|
|
|
_theme = aTheme;
|
|
|
|
[self objectDidChangeTheme];
|
|
}
|
|
|
|
- (void)objectDidChangeTheme
|
|
{
|
|
if (!_themeAttributes)
|
|
return;
|
|
|
|
var theme = [self theme],
|
|
themeClass = [self themeClass];
|
|
|
|
for (var attributeName in _themeAttributes)
|
|
{
|
|
if (_themeAttributes.hasOwnProperty(attributeName))
|
|
_themeAttributes[attributeName] = [_themeAttributes[attributeName] attributeBySettingParentAttribute:[theme attributeWithName:attributeName forClass:themeClass]];
|
|
}
|
|
|
|
}
|
|
|
|
- (CPDictionary)_themeAttributeDictionary
|
|
{
|
|
var dictionary = @{};
|
|
|
|
if (_themeAttributes)
|
|
{
|
|
var theme = [self theme];
|
|
|
|
for (var attributeName in _themeAttributes)
|
|
{
|
|
if (_themeAttributes.hasOwnProperty(attributeName))
|
|
[dictionary setObject:_themeAttributes[attributeName] forKey:attributeName];
|
|
}
|
|
}
|
|
|
|
return dictionary;
|
|
}
|
|
|
|
- (void)setValue:(id)aValue forThemeAttribute:(CPString)aName inState:(ThemeState)aState
|
|
{
|
|
#if DEBUG
|
|
// TODO: To allow aState to be an array is now deprecated. An exception is thrown only in Debug version as
|
|
// the preformance cost for this check is to high. We should remove this check in a future release.
|
|
if (aState.isa && [aState isKindOfClass:CPArray])
|
|
[CPException raise:CPInvalidArgumentException reason:self + @": aState can't be an array. Please use 'setValue:forThemeAttribute:inStates:' instead: " + aState];
|
|
#endif
|
|
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
_themeAttributes[aName] = [themeAttr attributeBySettingValue:aValue forState:aState];
|
|
}
|
|
|
|
- (void)setValue:(id)aValue forThemeAttribute:(CPString)aName inStates:(CPArray)states
|
|
{
|
|
var i = [states count],
|
|
aState = [states objectAtIndex:--i];
|
|
|
|
while (i > 0)
|
|
aState = aState.and([states objectAtIndex:--i]);
|
|
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
_themeAttributes[aName] = [themeAttr attributeBySettingValue:aValue forState:aState];
|
|
}
|
|
|
|
- (void)setValue:(id)aValue forThemeAttribute:(CPString)aName
|
|
{
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
_themeAttributes[aName] = [themeAttr attributeBySettingValue:aValue];
|
|
}
|
|
|
|
- (id)valueForThemeAttribute:(CPString)aName inState:(ThemeState)aState
|
|
{
|
|
#if DEBUG
|
|
if (aState.isa && [aState isKindOfClass:CPArray])
|
|
[CPException raise:CPInvalidArgumentException reason:@"aState can't be an array. Please use 'valueForThemeAttribute:inStates:' instead: " + aState];
|
|
#endif
|
|
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
return [themeAttr valueForState:aState];
|
|
}
|
|
|
|
- (id)valueForThemeAttribute:(CPString)aName inStates:(CPArray)states
|
|
{
|
|
var i = [states count],
|
|
aState = [states objectAtIndex:--i];
|
|
|
|
while (i > 0)
|
|
aState = aState.and([states objectAtIndex:--i]);
|
|
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
return [themeAttr valueForState:aState];
|
|
}
|
|
|
|
- (id)valueForThemeAttribute:(CPString)aName
|
|
{
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
return [themeAttr value];
|
|
}
|
|
|
|
- (id)currentValueForThemeAttribute:(CPString)aName
|
|
{
|
|
var themeAttr = _themeAttributes && _themeAttributes[aName];
|
|
|
|
if (!themeAttr)
|
|
[CPException raise:CPInvalidArgumentException reason:[self className] + " does not contain theme attribute '" + aName + "'"];
|
|
|
|
return [themeAttr valueForState:_themeState];
|
|
}
|
|
|
|
- (BOOL)hasThemeAttribute:(CPString)aName
|
|
{
|
|
return (_themeAttributes && _themeAttributes[aName] !== undefined);
|
|
}
|
|
|
|
/*!
|
|
Registers theme values encoded in an array at runtime. The format of the data in the array
|
|
is the same as that used by ThemeDescriptors.j, with the exception that you need to use
|
|
CPColorWithImages() in place of PatternColor(). For more information see the comments
|
|
at the top of ThemeDescriptors.j.
|
|
|
|
@param themeValues array of theme values
|
|
*/
|
|
- (void)registerThemeValues:(CPArray)themeValues
|
|
{
|
|
for (var i = 0; i < themeValues.length; ++i)
|
|
{
|
|
var attributeValueState = themeValues[i],
|
|
attribute = attributeValueState[0],
|
|
value = attributeValueState[1],
|
|
state = attributeValueState[2];
|
|
|
|
if (state)
|
|
if (state.isa && [state isKindOfClass:CPArray])
|
|
[self setValue:value forThemeAttribute:attribute inStates:state];
|
|
else
|
|
[self setValue:value forThemeAttribute:attribute inState:state];
|
|
else
|
|
[self setValue:value forThemeAttribute:attribute];
|
|
}
|
|
}
|
|
|
|
/*!
|
|
Registers theme values encoded in an array at runtime. The format of the data in the array
|
|
is the same as that used by ThemeDescriptors.j, with the exception that you need to use
|
|
CPColorWithImages() in place of PatternColor(). The values in \c inheritedValues are
|
|
registered first, then those in \c themeValues override/augment the inherited values.
|
|
For more information see the comments at the top of ThemeDescriptors.j.
|
|
|
|
@param themeValues array of base theme values
|
|
@param inheritedValues array of overridden/additional theme values
|
|
*/
|
|
- (void)registerThemeValues:(CPArray)themeValues inherit:(CPArray)inheritedValues
|
|
{
|
|
// Register inherited values first, then override those with the subtheme values.
|
|
if (inheritedValues)
|
|
[self registerThemeValues:inheritedValues];
|
|
|
|
if (themeValues)
|
|
[self registerThemeValues:themeValues];
|
|
}
|
|
|
|
- (void)_encodeThemeObjectsWithCoder:(CPCoder)aCoder
|
|
{
|
|
[aCoder encodeObject:[self themeClass] forKey:CPViewThemeClassKey];
|
|
[aCoder encodeObject:String(_themeState) forKey:CPViewThemeStateKey];
|
|
|
|
for (var attributeName in _themeAttributes)
|
|
{
|
|
if (_themeAttributes.hasOwnProperty(attributeName))
|
|
CPThemeAttributeEncode(aCoder, _themeAttributes[attributeName]);
|
|
}
|
|
}
|
|
|
|
- (void)_decodeThemeObjectsWithCoder:(CPCoder)aCoder
|
|
{
|
|
_theme = [CPTheme defaultTheme];
|
|
_themeClass = [aCoder decodeObjectForKey:CPViewThemeClassKey];
|
|
_themeState = CPThemeState([aCoder decodeObjectForKey:CPViewThemeStateKey]);
|
|
_themeAttributes = {};
|
|
|
|
var theClass = [self class],
|
|
themeClass = [self themeClass],
|
|
attributes = [theClass _themeAttributesForTheme:_theme andThemeClass:themeClass],
|
|
count = attributes.length;
|
|
|
|
while (count--)
|
|
{
|
|
var attribute = attributes[count];
|
|
|
|
_themeAttributes[attribute._name] = CPThemeAttributeDecode(aCoder, attribute);
|
|
}
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark CSS styling additions
|
|
|
|
- (CPTheme)actualTheme
|
|
{
|
|
return _theme ? _theme : [CPTheme defaultTheme];
|
|
}
|
|
|
|
// These methods implement inherited theme attributes thru class hierarchy.
|
|
- (id)actualValueForThemeAttribute:(CPString)aName
|
|
{
|
|
return [self actualValueForThemeAttribute:aName inState:CPThemeStateNormal];
|
|
}
|
|
|
|
- (id)actualValueForThemeAttribute:(CPString)aName inState:(ThemeState)aState
|
|
{
|
|
for (var currentClass = [self class], foundAttribute = nil, currentTheme = [self actualTheme]; (currentClass && (currentClass !== CPResponder) && !foundAttribute); currentClass = [currentClass superclass])
|
|
|
|
foundAttribute = [currentTheme attributeWithName:aName forClass:currentClass];
|
|
|
|
return (foundAttribute ? [foundAttribute valueForState:aState] : nil);
|
|
}
|
|
|
|
|
|
|
|
@end
|