FBLoginView is a custom UIView that renders a button to login or logout based on the
state of FBSession.activeSession
This view is closely associated with FBSession.activeSession
. Upon initialization,
it will attempt to open an active session without UI if the current active session is not open.
The FBLoginView instance also monitors for changes to the active session.
Please note: Since FBLoginView observes the active session, using multiple FBLoginView instances in different parts of your app can result in each instance's delegates being notified of changes for one event.
Inherits from: | UIView |
Declared in: | FBLoginView.h |
defaultAudience
The default audience to use, if publish permissions are requested at login time.
@property (nonatomic,
assign) FBSessionDefaultAudience defaultAudience;
FBLoginView.h
delegate
The delegate object that receives updates for selection and display control.
@property (nonatomic,
assign) IBOutlet id<FBLoginViewDelegate> delegate;
FBLoginView.h
loginBehavior
The login behavior for the active session if the user logs in via this view
@property (nonatomic) FBSessionLoginBehavior loginBehavior;
The default value is FBSessionLoginBehaviorWithFallbackToWebView.
FBLoginView.h
permissions
The permissions to login with. Defaults to nil, meaning basic permissions.
@property (readwrite,
copy) NSArray *permissions __attribute__((deprecated
Methods and properties that specify permissions without a read or publish qualification are deprecated; use of a read-qualified or publish-qualified alternative is preferred.
FBLoginView.h
publishPermissions
The publish permissions to request if the user logs in via this view.
@property (nonatomic,
copy) NSArray *publishPermissions;
Note, that a defaultAudience value of FBSessionDefaultAudienceOnlyMe, FBSessionDefaultAudienceEveryone, or FBSessionDefaultAudienceFriends should be set if publish permissions are specified. Additionally, when publish permissions are specified, then read should not be specified.
FBLoginView.h
readPermissions
The read permissions to request if the user logs in via this view.
@property (nonatomic,
copy) NSArray *readPermissions;
Note, that if read permissions are specified, then publish permissions should not be specified.
FBLoginView.h
tooltipBehavior
Gets or sets the desired tooltip behavior.
@property (nonatomic,
assign) FBLoginViewTooltipBehavior tooltipBehavior;
FBLoginView.h
tooltipColorStyle
Gets or sets the desired tooltip color style.
@property (nonatomic,
assign) FBTooltipColorStyle tooltipColorStyle;
FBLoginView.h
init
Initializes and returns an FBLoginView
object. The underlying session has basic permissions granted to it.
- (instancetype)
init;
FBLoginView.h
initWithPermissions:
Initializes and returns an FBLoginView
object constructed with the specified permissions.
Parameter | Description |
---|---|
permissions | An array of strings representing the permissions to request during the authentication flow. A value of nil will indicates basic permissions. |
- (instancetype)
initWithPermissions:(NSArray *)permissions __attribute__((deprecated));
Methods and properties that specify permissions without a read or publish qualification are deprecated; use of a read-qualified or publish-qualified alternative is preferred.
FBLoginView.h
initWithPublishPermissions:defaultAudience:
Initializes and returns an FBLoginView
object constructed with the specified permissions.
Parameter | Description |
---|---|
publishPermissions | An array of strings representing the publish permissions to request during the authentication flow. |
defaultAudience | An audience for published posts; note that FBSessionDefaultAudienceNone is not valid for permission requests that include publish or manage permissions. |
- (instancetype)
initWithPublishPermissions: | (NSArray *)publishPermissions |
defaultAudience: | (FBSessionDefaultAudience)defaultAudience; |
FBLoginView.h
initWithReadPermissions:
Initializes and returns an FBLoginView
object constructed with the specified permissions.
Parameter | Description |
---|---|
readPermissions | An array of strings representing the read permissions to request during the authentication flow. A value of nil will indicates basic permissions. |
- (instancetype)
initWithReadPermissions:(NSArray *)readPermissions;
FBLoginView.h
NS_ENUM
Indicates the desired login tooltip behavior.
typedef NS_ENUM(NSUInteger, FBLoginViewTooltipBehavior) { FBLoginViewTooltipBehaviorDefault = 0, FBLoginViewTooltipBehaviorForceDisplay = 1, FBLoginViewTooltipBehaviorDisable = 2 };
Constant | Description |
---|---|
FBLoginViewTooltipBehaviorDefault | The default behavior. The tooltip will only be displayed if the app is eligible (determined by server round trip) |
FBLoginViewTooltipBehaviorForceDisplay | Force display of the tooltip (typically for UI testing) |
FBLoginViewTooltipBehaviorDisable | Force disable. In this case you can still exert more refined
control by manually constructing a |
FBLoginView.h