Skip to content

NSShadow ​

NSShadow represents a text shadow: its offset, blur radius, and color. Once set up, it goes into an attributed string as the shadow attribute.

What goes into the attributed string is a copy as of that moment: changing this object afterward does not change attributed strings already created. A shadow read back from an attributed string is also a copy.

NSShadow fires no events. Its values are only changed by the app's own code, so there are no change notifications.

Inheritance: EventTarget → NSObject → NSShadow

Constructor ​

NSShadow()

Creates a shadow with an offset of (0, 0), no blur, and a color of black at one-third opacity.

Instance properties ​

Also inherits the properties of NSObject.

PropertyDescription
shadowOffsetHow far the shadow is offset from the text
shadowBlurRadiusThe blur radius
shadowColorThe shadow's color

Instance methods ​

NSShadow has no instance methods of its own.

Examples ​

js
const shadow = new NSShadow();
shadow.shadowOffset = new CGSize(0, 1);
shadow.shadowBlurRadius = 2;
shadow.shadowColor = 'rgba(0, 0, 0, 0.4)';

const label = new UILabel();
label.attributedText = new NSAttributedString('With shadow', { shadow });

Effect (not verified in the simulator): 1 pt below the text is a faint black shadow with blurred edges.

Corresponding iOS API ​

ObjCJS
[[NSShadow alloc] init]new NSShadow()
shadow.shadowOffset = CGSizeMake(0, 1)shadow.shadowOffset = new CGSize(0, 1)
shadow.shadowColor = [UIColor colorWithWhite:0 alpha:0.4]shadow.shadowColor = 'rgba(0, 0, 0, 0.4)'
NSShadowAttributeName: shadow{ shadow }

See also ​