From d1d1f93239aab1262c35a0055d76a69b0b3026cc Mon Sep 17 00:00:00 2001
From: daniAlvarezMM <79452393+daniAlvarezMM@users.noreply.github.com>
Date: Mon, 2 Oct 2023 12:44:34 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20mediamon?=
=?UTF-8?q?ks/MMMCommonUI@fa5e32ba3f1354e5c7e213bd3f1267061a24b0bc=20?=
=?UTF-8?q?=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
Categories.html | 538 ------
Categories/NSLayoutConstraint(MMMTemple).html | 722 --------
Categories/UILayoutGuide(MMMTemple).html | 495 ------
.../UIView(MMMPreferredSizeChanges).html | 363 ----
Categories/UIView(MMMTemple).html | 1340 --------------
Classes.html | 1516 ----------------
Classes/MMMAnimation.html | 611 -------
Classes/MMMAnimationHandle.html | 421 -----
Classes/MMMAnimator.html | 528 ------
Classes/MMMAutoLayoutIsolator.html | 483 -----
Classes/MMMAutoLayoutScrollView.html | 503 ------
Classes/MMMCollectionView.html | 482 -----
Classes/MMMContainerView.html | 422 -----
Classes/MMMHorizontalStackContainer.html | 393 -----
Classes/MMMImageView.html | 583 ------
Classes/MMMLayoutUtils.html | 509 ------
Classes/MMMNavigation.html | 473 -----
Classes/MMMNavigationHop.html | 491 ------
Classes/MMMNavigationPath.html | 517 ------
Classes/MMMNavigationRequest.html | 456 -----
Classes/MMMNavigationStack.html | 447 -----
Classes/MMMPaddedView.html | 514 ------
Classes/MMMScrollViewShadowView.html | 453 -----
Classes/MMMScrollViewShadows.html | 491 ------
Classes/MMMScrollViewShadowsSettings.html | 663 -------
Classes/MMMShadowView.html | 515 ------
Classes/MMMShadowViewSetting.html | 613 -------
Classes/MMMSpacerView.html | 422 -----
Classes/MMMStackContainer.html | 490 -----
Classes/MMMStubView.html | 452 -----
Classes/MMMStubViewController.html | 450 -----
Classes/MMMStylesheet.html | 931 ----------
Classes/MMMStylesheetScaleConverter.html | 433 -----
Classes/MMMTableView.html | 548 ------
Classes/MMMTableViewCell.html | 482 -----
Classes/MMMVelocityMeter.html | 455 -----
Classes/MMMVerticalGradientView.html | 483 -----
Classes/MMMVerticalStackContainer.html | 393 -----
Classes/MMMViewWrappingCell.html | 457 -----
Constants.html | 537 ------
Enums.html | 562 ------
Enums/MMMAnimationCurve.html | 964 ----------
Enums/MMMLayoutAlignment.html | 517 ------
Enums/MMMLayoutDirection.html | 392 ----
Enums/MMMLayoutHorizontalAlignment.html | 524 ------
Enums/MMMLayoutVerticalAlignment.html | 524 ------
Enums/MMMScrollViewShadowAlignment.html | 392 ----
Functions.html | 524 ------
Protocols.html | 490 -----
Protocols/MMMNavigationHandler.html | 359 ----
Protocols/MMMNavigationStackItem.html | 430 -----
Protocols/MMMNavigationStackItemDelegate.html | 363 ----
Protocols/MMMPreferredSizeChanges.html | 363 ----
Protocols/MMMStylesheetConverter.html | 362 ----
Type Definitions.html | 542 ------
badge.svg | 16 +-
.../Resources/Documents/Categories.html | 538 ------
.../NSLayoutConstraint(MMMTemple).html | 722 --------
.../Categories/UILayoutGuide(MMMTemple).html | 495 ------
.../UIView(MMMPreferredSizeChanges).html | 363 ----
.../Categories/UIView(MMMTemple).html | 1340 --------------
.../Contents/Resources/Documents/Classes.html | 1516 ----------------
.../Documents/Classes/MMMAnimation.html | 611 -------
.../Documents/Classes/MMMAnimationHandle.html | 421 -----
.../Documents/Classes/MMMAnimator.html | 528 ------
.../Classes/MMMAutoLayoutIsolator.html | 483 -----
.../Classes/MMMAutoLayoutScrollView.html | 503 ------
.../Documents/Classes/MMMCollectionView.html | 482 -----
.../Documents/Classes/MMMContainerView.html | 422 -----
.../Classes/MMMHorizontalStackContainer.html | 393 -----
.../Documents/Classes/MMMImageView.html | 583 ------
.../Documents/Classes/MMMLayoutUtils.html | 509 ------
.../Documents/Classes/MMMNavigation.html | 473 -----
.../Documents/Classes/MMMNavigationHop.html | 491 ------
.../Documents/Classes/MMMNavigationPath.html | 517 ------
.../Classes/MMMNavigationRequest.html | 456 -----
.../Documents/Classes/MMMNavigationStack.html | 447 -----
.../Documents/Classes/MMMPaddedView.html | 514 ------
.../Classes/MMMScrollViewShadowView.html | 453 -----
.../Classes/MMMScrollViewShadows.html | 491 ------
.../Classes/MMMScrollViewShadowsSettings.html | 663 -------
.../Documents/Classes/MMMShadowView.html | 515 ------
.../Classes/MMMShadowViewSetting.html | 613 -------
.../Documents/Classes/MMMSpacerView.html | 422 -----
.../Documents/Classes/MMMStackContainer.html | 490 -----
.../Documents/Classes/MMMStubView.html | 452 -----
.../Classes/MMMStubViewController.html | 450 -----
.../Documents/Classes/MMMStylesheet.html | 931 ----------
.../Classes/MMMStylesheetScaleConverter.html | 433 -----
.../Documents/Classes/MMMTableView.html | 548 ------
.../Documents/Classes/MMMTableViewCell.html | 482 -----
.../Documents/Classes/MMMVelocityMeter.html | 455 -----
.../Classes/MMMVerticalGradientView.html | 483 -----
.../Classes/MMMVerticalStackContainer.html | 393 -----
.../Classes/MMMViewWrappingCell.html | 457 -----
.../Resources/Documents/Constants.html | 537 ------
.../Contents/Resources/Documents/Enums.html | 562 ------
.../Documents/Enums/MMMAnimationCurve.html | 964 ----------
.../Documents/Enums/MMMLayoutAlignment.html | 517 ------
.../Documents/Enums/MMMLayoutDirection.html | 392 ----
.../Enums/MMMLayoutHorizontalAlignment.html | 524 ------
.../Enums/MMMLayoutVerticalAlignment.html | 524 ------
.../Enums/MMMScrollViewShadowAlignment.html | 392 ----
.../Resources/Documents/Functions.html | 524 ------
.../Resources/Documents/Protocols.html | 490 -----
.../Protocols/MMMNavigationHandler.html | 359 ----
.../Protocols/MMMNavigationStackItem.html | 430 -----
.../MMMNavigationStackItemDelegate.html | 363 ----
.../Protocols/MMMPreferredSizeChanges.html | 363 ----
.../Protocols/MMMStylesheetConverter.html | 362 ----
.../Resources/Documents/Type Definitions.html | 542 ------
.../Contents/Resources/Documents/index.html | 241 +--
.../Contents/Resources/Documents/search.json | 2 +-
.../Contents/Resources/docSet.dsidx | Bin 94208 -> 12288 bytes
docsets/MMMCommonUI.tgz | Bin 199186 -> 85498 bytes
index.html | 241 +--
search.json | 2 +-
undocumented.json | 1569 +----------------
118 files changed, 13 insertions(+), 60824 deletions(-)
delete mode 100644 Categories.html
delete mode 100644 Categories/NSLayoutConstraint(MMMTemple).html
delete mode 100644 Categories/UILayoutGuide(MMMTemple).html
delete mode 100644 Categories/UIView(MMMPreferredSizeChanges).html
delete mode 100644 Categories/UIView(MMMTemple).html
delete mode 100644 Classes.html
delete mode 100644 Classes/MMMAnimation.html
delete mode 100644 Classes/MMMAnimationHandle.html
delete mode 100644 Classes/MMMAnimator.html
delete mode 100644 Classes/MMMAutoLayoutIsolator.html
delete mode 100644 Classes/MMMAutoLayoutScrollView.html
delete mode 100644 Classes/MMMCollectionView.html
delete mode 100644 Classes/MMMContainerView.html
delete mode 100644 Classes/MMMHorizontalStackContainer.html
delete mode 100644 Classes/MMMImageView.html
delete mode 100644 Classes/MMMLayoutUtils.html
delete mode 100644 Classes/MMMNavigation.html
delete mode 100644 Classes/MMMNavigationHop.html
delete mode 100644 Classes/MMMNavigationPath.html
delete mode 100644 Classes/MMMNavigationRequest.html
delete mode 100644 Classes/MMMNavigationStack.html
delete mode 100644 Classes/MMMPaddedView.html
delete mode 100644 Classes/MMMScrollViewShadowView.html
delete mode 100644 Classes/MMMScrollViewShadows.html
delete mode 100644 Classes/MMMScrollViewShadowsSettings.html
delete mode 100644 Classes/MMMShadowView.html
delete mode 100644 Classes/MMMShadowViewSetting.html
delete mode 100644 Classes/MMMSpacerView.html
delete mode 100644 Classes/MMMStackContainer.html
delete mode 100644 Classes/MMMStubView.html
delete mode 100644 Classes/MMMStubViewController.html
delete mode 100644 Classes/MMMStylesheet.html
delete mode 100644 Classes/MMMStylesheetScaleConverter.html
delete mode 100644 Classes/MMMTableView.html
delete mode 100644 Classes/MMMTableViewCell.html
delete mode 100644 Classes/MMMVelocityMeter.html
delete mode 100644 Classes/MMMVerticalGradientView.html
delete mode 100644 Classes/MMMVerticalStackContainer.html
delete mode 100644 Classes/MMMViewWrappingCell.html
delete mode 100644 Constants.html
delete mode 100644 Enums.html
delete mode 100644 Enums/MMMAnimationCurve.html
delete mode 100644 Enums/MMMLayoutAlignment.html
delete mode 100644 Enums/MMMLayoutDirection.html
delete mode 100644 Enums/MMMLayoutHorizontalAlignment.html
delete mode 100644 Enums/MMMLayoutVerticalAlignment.html
delete mode 100644 Enums/MMMScrollViewShadowAlignment.html
delete mode 100644 Functions.html
delete mode 100644 Protocols.html
delete mode 100644 Protocols/MMMNavigationHandler.html
delete mode 100644 Protocols/MMMNavigationStackItem.html
delete mode 100644 Protocols/MMMNavigationStackItemDelegate.html
delete mode 100644 Protocols/MMMPreferredSizeChanges.html
delete mode 100644 Protocols/MMMStylesheetConverter.html
delete mode 100644 Type Definitions.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories/NSLayoutConstraint(MMMTemple).html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories/UILayoutGuide(MMMTemple).html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories/UIView(MMMPreferredSizeChanges).html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories/UIView(MMMTemple).html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMAnimation.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMAnimationHandle.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMAnimator.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMAutoLayoutIsolator.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMAutoLayoutScrollView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMCollectionView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMContainerView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMHorizontalStackContainer.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMImageView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMLayoutUtils.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMNavigation.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMNavigationHop.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMNavigationPath.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMNavigationRequest.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMNavigationStack.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMPaddedView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMScrollViewShadowView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMScrollViewShadows.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMScrollViewShadowsSettings.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMShadowView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMShadowViewSetting.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMSpacerView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMStackContainer.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMStubView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMStubViewController.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMStylesheet.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMStylesheetScaleConverter.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMTableView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMTableViewCell.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMVelocityMeter.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMVerticalGradientView.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMVerticalStackContainer.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Classes/MMMViewWrappingCell.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Constants.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums/MMMAnimationCurve.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums/MMMLayoutAlignment.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums/MMMLayoutDirection.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums/MMMLayoutHorizontalAlignment.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums/MMMLayoutVerticalAlignment.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Enums/MMMScrollViewShadowAlignment.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Functions.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Protocols.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Protocols/MMMNavigationHandler.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Protocols/MMMNavigationStackItem.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Protocols/MMMNavigationStackItemDelegate.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Protocols/MMMPreferredSizeChanges.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Protocols/MMMStylesheetConverter.html
delete mode 100644 docsets/MMMCommonUI.docset/Contents/Resources/Documents/Type Definitions.html
diff --git a/Categories.html b/Categories.html
deleted file mode 100644
index 2a6fb0c..0000000
--- a/Categories.html
+++ /dev/null
@@ -1,538 +0,0 @@
-
-
-
- Categories Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Categories
-
The following categories are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@interface UIView ( MMMPreferredSizeChanges )
-
-/// Signals to one of the interested parent views (supporting `MMMPreferredSizeChanges`)
-/// that the size of this view could have potentially changed and they should measure things again.
-///
-/// This helps with containers that do not primarily rely on Auto Layout, like UITableView.
- - ( void ) mmm_setPreferredSizeCouldChange ;
-
-@end
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@interface UILayoutGuide ( MMMTemple )
-
-/// Convenience initializer setting the guide's identifier.
- - ( id ) initWithIdentifier :( NSString * ) identifier ;
-
-/**
- * Not yet activated constraints anchoring the given view within the receiver according to horizontal
- * and vertical alignment flags.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) view
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-/**
- * Not yet activated constraints implementing a common layout idiom used with text:
- * - the given view is centered within the receiver,
- * - certain minimum padding is ensured on the sides,
- * - if `maxWidth > 0`, then the width of the view is limited to `maxWidth`, so it does not grow too wide e.g. on iPad.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsHorizontallyCenteringView :( UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth NS_SWIFT_NAME ( mmm_constraints ( horizontallyCentering : minPadding : maxWidth : ));
-
-@end
-
-
-
-
-
-
-
-
-
-
-
-
A few shorthands for UIView.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface UIView ( MMMTemple )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@interface NSLayoutConstraint ( MMMTemple )
-
-/**
- * Our wrapper over the corresponding method of NSLayoutConstraint extending the visual layout language a bit to support
- * `safeAreaLayoutGuide` property introduced in iOS 11 and still be compatible with older versions of iOS.
- * (See also `mmm_safeAreaLayoutGuide` in our extension of UIView.)
- *
- * To use it simply replace a reference to the superview edge "|" with a reference to a safe edge "<|".
- *
- * For example, if you have the following pre iOS 9 code:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * And now you want to make sure that the button sits above the safe bottom margin on iPhone X, then do this:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * mmm_constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-<|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * That's it. It'll anchor the button to the bottom of its superview on iOS 9 and 10, but anchor it to the bottom of
- * its safeAreaLayoutGuide on iOS 11.
- *
- * Please note that using "|>" to pin to the top won't exclude the status bar on iOS 9 and 10.
- */
-+ ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** A shortcut for `[NSLayoutConstraint activateConstraints:[NSLayoutConstraint mmm_constraintsWithVisualFormat:...`. */
-+ ( void ) mmm_activateConstraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** Missing counterparts for (de)activateConstraints, so constraint activation code looks the same for individual constraints. */
-+ ( void ) activateConstraint :( NSLayoutConstraint * ) constraint ;
-+ ( void ) deactivateConstraint :( NSLayoutConstraint * ) constraint ;
-
-/** A missing convenience initializer including priority. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority ;
-
-/** A missing convenience initializer allowing to set identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to set both priority and identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to tag a bunch of visual constraints with the same identifier. */
-+ ( NSArray < __kindof NSLayoutConstraint *> * ) constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views
- identifier :( NSString * ) identifier DEPRECATED_ATTRIBUTE ;
-
-@end
-
-
-
-
-
-
-
-
-
-
NSLayoutConstraint(MMMTemple) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
NSLayoutConstraint(MMMTemple)
-
-
-
-
@interface NSLayoutConstraint ( MMMTemple )
-
-/**
- * Our wrapper over the corresponding method of NSLayoutConstraint extending the visual layout language a bit to support
- * `safeAreaLayoutGuide` property introduced in iOS 11 and still be compatible with older versions of iOS.
- * (See also `mmm_safeAreaLayoutGuide` in our extension of UIView.)
- *
- * To use it simply replace a reference to the superview edge "|" with a reference to a safe edge "<|".
- *
- * For example, if you have the following pre iOS 9 code:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * And now you want to make sure that the button sits above the safe bottom margin on iPhone X, then do this:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * mmm_constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-<|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * That's it. It'll anchor the button to the bottom of its superview on iOS 9 and 10, but anchor it to the bottom of
- * its safeAreaLayoutGuide on iOS 11.
- *
- * Please note that using "|>" to pin to the top won't exclude the status bar on iOS 9 and 10.
- */
-+ ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** A shortcut for `[NSLayoutConstraint activateConstraints:[NSLayoutConstraint mmm_constraintsWithVisualFormat:...`. */
-+ ( void ) mmm_activateConstraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** Missing counterparts for (de)activateConstraints, so constraint activation code looks the same for individual constraints. */
-+ ( void ) activateConstraint :( NSLayoutConstraint * ) constraint ;
-+ ( void ) deactivateConstraint :( NSLayoutConstraint * ) constraint ;
-
-/** A missing convenience initializer including priority. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority ;
-
-/** A missing convenience initializer allowing to set identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to set both priority and identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to tag a bunch of visual constraints with the same identifier. */
-+ ( NSArray < __kindof NSLayoutConstraint *> * ) constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views
- identifier :( NSString * ) identifier DEPRECATED_ATTRIBUTE ;
-
-@end
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Our wrapper over the corresponding method of NSLayoutConstraint extending the visual layout language a bit to support
- safeAreaLayoutGuide property introduced in iOS 11 and still be compatible with older versions of iOS.
- (See also mmm_safeAreaLayoutGuide in our extension of UIView.)
-
-
To use it simply replace a reference to the superview edge “|” with a reference to a safe edge “<|”.
-
-
For example, if you have the following pre iOS 9 code:
-
-
\code
- [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- constraintsWithVisualFormat:@“V:[_button]-(normalPadding)-|”
- options:0 metrics:metrics views:views
- ]];
- \endcode
-
-
And now you want to make sure that the button sits above the safe bottom margin on iPhone X, then do this:
-
-
\code
- [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- mmm_constraintsWithVisualFormat:@“V:[_button]-(normalPadding)-<|”
- options:0 metrics:metrics views:views
- ]];
- \endcode
-
-
That’s it. It’ll anchor the button to the bottom of its superview on iOS 9 and 10, but anchor it to the bottom of
- its safeAreaLayoutGuide on iOS 11.
-
-
Please note that using “|>” to pin to the top won’t exclude the status bar on iOS 9 and 10.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsWithVisualFormat :( nonnull NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :
- ( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * )
- views ;
-
-
-
-
Swift
-
class func mmm_constraints ( withVisualFormat format : String , options opts : NSLayoutConstraint . FormatOptions = [], metrics : [ String : Any ]?, views : [ String : Any ]?) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut for [NSLayoutConstraint activateConstraints:[NSLayoutConstraint mmm_constraintsWithVisualFormat:....
-
-
-
Declaration
-
-
Objective-C
-
+ ( void )
- mmm_activateConstraintsWithVisualFormat :( nonnull NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * ,
- id > * ) metrics
- views : ( nullable NSDictionary < NSString * ,
- id > * ) views ;
-
-
-
-
Swift
-
class func mmm_activateConstraints ( withVisualFormat format : String , options opts : NSLayoutConstraint . FormatOptions = [], metrics : [ String : Any ]?, views : [ String : Any ]?)
-
-
-
-
-
-
-
-
-
-
-
-
Missing counterparts for (de)activateConstraints, so constraint activation code looks the same for individual constraints.
-
-
-
Declaration
-
-
Objective-C
-
+ ( void ) activateConstraint :( nonnull NSLayoutConstraint * ) constraint ;
-
-
-
-
Swift
-
class func activate ( _ constraint : NSLayoutConstraint )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( void ) deactivateConstraint :( NSLayoutConstraint * ) constraint ;
-
-
-
-
Swift
-
class func deactivate ( _ constraint : NSLayoutConstraint )
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer including priority.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull instancetype ) constraintWithItem :( nonnull id ) view1
- attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2
- attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier
- constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
convenience init ( item view1 : Any , attribute attr1 : NSLayoutConstraint . Attribute , relatedBy relation : NSLayoutConstraint . Relation , toItem view2 : Any ?, attribute attr2 : NSLayoutConstraint . Attribute , multiplier : CGFloat , constant c : CGFloat , priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer allowing to set identifier for this constraint.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull instancetype ) constraintWithItem :( nonnull id ) view1
- attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2
- attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier
- constant :( CGFloat ) c
- identifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
convenience init ( item view1 : Any , attribute attr1 : NSLayoutConstraint . Attribute , relatedBy relation : NSLayoutConstraint . Relation , toItem view2 : Any ?, attribute attr2 : NSLayoutConstraint . Attribute , multiplier : CGFloat , constant c : CGFloat , identifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer allowing to set both priority and identifier for this constraint.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull instancetype ) constraintWithItem :( nonnull id ) view1
- attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2
- attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier
- constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority
- identifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
convenience init ( item view1 : Any , attribute attr1 : NSLayoutConstraint . Attribute , relatedBy relation : NSLayoutConstraint . Relation , toItem view2 : Any ?, attribute attr2 : NSLayoutConstraint . Attribute , multiplier : CGFloat , constant c : CGFloat , priority : UILayoutPriority , identifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer allowing to tag a bunch of visual constraints with the same identifier.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull NSArray < __kindof NSLayoutConstraint *> * )
- constraintsWithVisualFormat :( nonnull NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views
- identifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
class func constraints ( withVisualFormat format : String , options opts : NSLayoutConstraint . FormatOptions = [], metrics : [ String : Any ]?, views : [ String : Any ]?, identifier : String ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
UILayoutGuide(MMMTemple) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
UILayoutGuide(MMMTemple)
-
-
-
-
@interface UILayoutGuide ( MMMTemple )
-
-/// Convenience initializer setting the guide's identifier.
- - ( id ) initWithIdentifier :( NSString * ) identifier ;
-
-/**
- * Not yet activated constraints anchoring the given view within the receiver according to horizontal
- * and vertical alignment flags.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) view
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-/**
- * Not yet activated constraints implementing a common layout idiom used with text:
- * - the given view is centered within the receiver,
- * - certain minimum padding is ensured on the sides,
- * - if `maxWidth > 0`, then the width of the view is limited to `maxWidth`, so it does not grow too wide e.g. on iPad.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsHorizontallyCenteringView :( UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth NS_SWIFT_NAME ( mmm_constraints ( horizontallyCentering : minPadding : maxWidth : ));
-
-@end
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer setting the guide’s identifier.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithIdentifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
init ( identifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
Not yet activated constraints anchoring the given view within the receiver according to horizontal
-and vertical alignment flags.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsAligningView :( nonnull UIView * ) view
- horizontally :
- ( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-
-
-
-
-
-
-
-
-
-
-
-
Not yet activated constraints implementing a common layout idiom used with text:
-
-
-the given view is centered within the receiver,
-certain minimum padding is ensured on the sides,
-if maxWidth > 0, then the width of the view is limited to maxWidth, so it does not grow too wide e.g. on iPad.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth ;
-
-
-
-
Swift
-
func mmm_constraints ( horizontallyCentering view : UIView , minPadding : CGFloat , maxWidth : CGFloat ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
UIView(MMMPreferredSizeChanges) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
UIView(MMMPreferredSizeChanges)
-
-
-
-
@interface UIView ( MMMPreferredSizeChanges )
-
-/// Signals to one of the interested parent views (supporting `MMMPreferredSizeChanges`)
-/// that the size of this view could have potentially changed and they should measure things again.
-///
-/// This helps with containers that do not primarily rely on Auto Layout, like UITableView.
- - ( void ) mmm_setPreferredSizeCouldChange ;
-
-@end
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Signals to one of the interested parent views (supporting MMMPreferredSizeChanges
-
-
This helps with containers that do not primarily rely on Auto Layout, like UITableView.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setPreferredSizeCouldChange ;
-
-
-
-
Swift
-
func mmm_setPreferredSizeCouldChange ()
-
-
-
-
-
-
-
-
-
-
UIView(MMMTemple) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
UIView(MMMTemple)
-
-
-
-
@interface UIView ( MMMTemple )
-
-
-
-
A few shorthands for UIView.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A wrapper for the center and bounds.size properties similar to ‘frame’, but not taking the current transform into account.
-
-
-Handy when there is a transform applied to a view already, but we want to set its frame in normal state.
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , setter = mmm_setRect : ) CGRect mmm_rect ;
-
-
-
-
Swift
-
var mmm_rect : CGRect { get set }
-
-
-
-
-
-
-
-
-
-
-
-
A wrapper for the size component of bounds property.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , setter = mmm_setSize : ) CGSize mmm_size ;
-
-
-
-
Swift
-
var mmm_size : CGSize { get set }
-
-
-
-
-
-
-
-
-
-
-
-
A safer version of safeAreaLayoutGuide that attempts to avoid layout loops happening when a view using it
-
-
-is transformed in certain “inconvenient” way. (Apple Feedback ID: FB7609936.)
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UILayoutGuide * _Nonnull mmm_safeAreaLayoutGuide ;
-
-
-
-
Swift
-
var mmm_safeAreaLayoutGuide : UILayoutGuide { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIEdgeInsets mmm_safeAreaInsets ;
-
-
-
-
Swift
-
var mmm_safeAreaInsets : UIEdgeInsets { get }
-
-
-
-
-
-
-
-
-
-
-
-
Constraints anchoring the given view within the receiver according to horizontal and vertical alignment flags.
-Note that constrains are not added into the reciever automatically.
-It is recommended to use this method instead of the mmm_addConstraintsForSubview:* bunch.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsAligningView :( nonnull UIView * ) subview
- horizontally :
- ( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) subview
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_constraintsAligningView ( _ subview : UIView , horizontally horizontalAlignment : MMMLayoutHorizontalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) subview
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_constraintsAligningView ( _ subview : UIView , vertically verticalAlignment : MMMLayoutVerticalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds contraints anchoring the given view within the receiver according to horizontal and vertical alignment flags.
-(This is a shortcut for calling mmm_constraintsAligningView:horizontally:vertically:insets: and adding the contraints returned.)
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_addConstraintsAligningView :( nonnull UIView * ) subview
- horizontally :
- ( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_addConstraintsAligningView :( UIView * ) subview
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_addConstraintsAligningView ( _ subview : UIView , horizontally horizontalAlignment : MMMLayoutHorizontalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_addConstraintsAligningView :( UIView * ) subview
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_addConstraintsAligningView ( _ subview : UIView , vertically verticalAlignment : MMMLayoutVerticalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
Not yet activated constraints implementing a common layout idiom used with text:
-
-
-the given view is centered within the receiver,
-certain minimum padding is ensured on the sides,
-if maxWidth > 0, then the width of the view is limited to maxWidth, so it does not grow too wide e.g. on iPad.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth ;
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut activating constraints returned by mmm_constraintsHorizontallyCenteringView:minPadding:maxWidth:.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addConstraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth ;
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut activating constraints returned by mmm_constraintsHorizontallyCenteringView:minPadding:maxWidth:
-
-
-setting maxWidth to zero.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addConstraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding ;
-
-
-
-
-
-
-
-
-
-
-
-
-
To be deprecated soon
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds constraints anchoring the given subview within the receiver according to horizontal and vertical alignment flags.
-The constraints are also returned, so the caller can remove them later, for example.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_addConstraintsForSubview :( nonnull UIView * ) subview
- horizontalAlignment :
- ( UIControlContentHorizontalAlignment ) horizontalAlignment
- verticalAlignment :
- ( UIControlContentVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
Swift
-
func mmm_addConstraints ( forSubview subview : UIView , horizontalAlignment : UIControl . ContentHorizontalAlignment , verticalAlignment : UIControl . ContentVerticalAlignment , insets : UIEdgeInsets ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_addConstraintsForSubview :( UIView * ) subview
- horizontalAlignment :( UIControlContentHorizontalAlignment ) horizontalAlignment
- verticalAlignment :( UIControlContentVerticalAlignment ) verticalAlignment
- DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_addConstraints ( forSubview subview : UIView , horizontalAlignment : UIControl . ContentHorizontalAlignment , verticalAlignment : UIControl . ContentVerticalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds constraints and two hidden auxiliary views ensuring that the space between the top of the subview and
- topAttribute of topItem is in ‘ratio’ proportion to the space between the bottom of the subview
- and bottomAttribute of bottomItem.
-
-
To be clear:
- ratio = (top space) / (bottom space)
-
-
So you need to use 1 when you want the same size, not 0.5, for example.
-
-
The given priority will be used for the constraints between the heights of the aux views.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addVerticalSpaceRatioConstraintsForSubview :( nonnull UIView * ) subview
- topItem :( nonnull id ) topItem
- topAttribute :
- ( NSLayoutAttribute ) topAttribute
- bottomItem :( nonnull id ) bottomItem
- bottomAttribute :
- ( NSLayoutAttribute ) bottomAttribute
- ratio :( CGFloat ) ratio
- priority :
- ( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_addVerticalSpaceRatioConstraints ( forSubview subview : UIView , topItem : Any , topAttribute : NSLayoutConstraint . Attribute , bottomItem : Any , bottomAttribute : NSLayoutConstraint . Attribute , ratio : CGFloat , priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addVerticalSpaceRatioConstraintsForSubview :( UIView * ) subview
- topItem :( id ) topItem topAttribute :( NSLayoutAttribute ) topAttribute
- bottomItem :( id ) bottomItem bottomAttribute :( NSLayoutAttribute ) bottomAttribute
- ratio :( CGFloat ) ratio ;
-
-
-
-
Swift
-
func mmm_addVerticalSpaceRatioConstraints ( forSubview subview : UIView , topItem : Any , topAttribute : NSLayoutConstraint . Attribute , bottomItem : Any , bottomAttribute : NSLayoutConstraint . Attribute , ratio : CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds constrains and a hidden auxiliary view ensuring that specified item / attribute vertically divides
-the subview in the specified ratio.
-Unlike the previous function the ratio here is given not as (top space / bottom space), but as
-(top space / (top space + bottom space)). Sorry for the confusion, deprecating this one for now.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addVerticalSpaceRatioConstraintsForSubview :( nonnull UIView * ) subview
- item :( nonnull id ) item
- attribute :
- ( NSLayoutAttribute ) attribute
- ratio :( CGFloat ) ratio ;
-
-
-
-
Swift
-
func mmm_addVerticalSpaceRatioConstraints ( forSubview subview : UIView , item : Any , attribute : NSLayoutConstraint . Attribute , ratio : CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
Shortcuts for compression resistance and hugging priorities.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setVerticalCompressionResistance :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setVerticalCompressionResistance ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHorizontalCompressionResistance :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setHorizontalCompressionResistance ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setVerticalHuggingPriority :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setVerticalHuggingPriority ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHorizontalHuggingPriority :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setHorizontalHuggingPriority ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setVerticalCompressionResistance :( UILayoutPriority ) compressionResistance hugging :( UILayoutPriority ) hugging DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_setVerticalCompressionResistance ( _ compressionResistance : UILayoutPriority , hugging : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHorizontalCompressionResistance :( UILayoutPriority ) compressionResistance hugging :( UILayoutPriority ) hugging DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_setHorizontalCompressionResistance ( _ compressionResistance : UILayoutPriority , hugging : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setCompressionResistanceHorizontal :( UILayoutPriority ) horizontal
- vertical :( UILayoutPriority ) vertical NS_SWIFT_NAME ( mmm_setCompressionResistance ( horizontal : vertical : ));
-
-
-
-
Swift
-
func mmm_setCompressionResistance ( horizontal : UILayoutPriority , vertical : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHuggingHorizontal :( UILayoutPriority ) horizontal
- vertical :( UILayoutPriority ) vertical NS_SWIFT_NAME ( mmm_setHugging ( horizontal : vertical : ));
-
-
-
-
Swift
-
func mmm_setHugging ( horizontal : UILayoutPriority , vertical : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
Classes Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Classes
-
The following classes are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A base for table view cells redeclareing the designated initializer into the one we typically use,
-so subclasses do not have to.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMTableViewCell : UITableViewCell
-
-
-
-
Swift
-
class MMMTableViewCell : UITableViewCell
-
-
-
-
-
-
-
-
-
-
-
-
A simple table view cell wrapping the given view.
-
-
This is handy when you have a view already and just want to show it as one more cell.
-
-
The view being wrapped should support Auto Layout and inflate its height properly. The cell has its selectionStyle
- set to UITableViewCellSelectionStyleNone as these kind of cells typically do not appear selected.
-
-
See more
-
-
Declaration
-
-
-
Swift
-
class MMMViewWrappingCell < ViewType > : MMMTableViewCell where ViewType : AnyObject
-
-
-
-
-
-
-
-
-
-
-
-
A helper for adding top and bottom shadows into any UIScrollView-based class.
-You create an instance in your subclass and forward calls from layoutSubviews.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMScrollViewShadows : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadows : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Holds configuration for MMMScrollViewShadows that can be set only on initialization time.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMScrollViewShadowsSettings : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadowsSettings : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A view that’s used internally to render shadows in MMMAutoLayoutScrollView.
-Open for reuse in cases we want to display compatible shadows but differntly controlled.
-Note that this does not support Auto Layout, you have to manage its frame.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMScrollViewShadowView : UIView
-
-
-
-
Swift
-
class MMMScrollViewShadowView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Opening a deep link can involve following through one or more steps, for example:
-
-
1) make sure the main screen is visible and can switch between the pages;
- 2) move to the recipes page;
- 3) open recipe with ID N;
- 4) scroll to ingredients, etc.
-
-
This is a single step in such a chain.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationHop : NSObject
-
-
-
-
Swift
-
class MMMNavigationHop : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A navigation path is just a collection of one or more “hops”.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationPath : NSObject
-
-
-
-
Swift
-
class MMMNavigationPath : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Manages switching between different sections of the app (kind of internal URL router).
-It’s like a central hub accepting navigation requests and then passing them to the entities that able to perform them.
-(The entities that are able to open requests should register themselves as handlers.)
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigation : NSObject
-
-
-
-
Swift
-
class MMMNavigation : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Info about a navigation request that is passed to handlers.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationRequest : NSObject
-
-
-
-
Swift
-
class MMMNavigationRequest : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
This is to be used during development to stub not ready yet parts of the app.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStubViewController : UIViewController
-
-
-
-
Swift
-
class MMMStubViewController : UIViewController
-
-
-
-
-
-
-
-
-
-
-
-
A limited replacement for UIImageView fixing its inability to properly work with images having
- non-zero alignmentRectInsets when scaled.
-
-
Note that this view is already constrained to the aspect ratio of the image’s alignment rect,
- so you should not use hard (equal) pins against both width and height or against all edges.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMImageView : UIView
-
-
-
-
Swift
-
class MMMImageView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A vertical scroll view with a content view and preconfigured constraints, so there is no need in creating
- a scroll view / content view sandwitch manually every time.
-
-
It also supports top and bottom shadows that are displayed only when the content is clipped.
- The shadows can be enabled individually and they can sit either flush with the edges of the scroll view
- or can be inset according to adjustedContentInset, which can be handy when vertical safeAreaInsets need
- to be taken into account. (Note that contentInsetAdjustmentBehavior has to be either None or Always
- on this view since “automatic” options can lead to cyclic calculations.) Also note that scroll indicators
- are disabled here by default.
-
-
Begin by adding your controls and constraints into the contentView ensuring that its size can be derived from your
- constraints alone. Avoid constraints to the scroll view itself or outside views unless you are prepared to deal
- with the consequences.
-
-
Note that the width of the contentView will be constrainted hard to be equal to the width of the scroll view
- and its height will be constrained with prio 251 to be at least as large as the height of the scroll view.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
Swift
-
class MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
-
-
-
-
-
-
-
-
A subview of MMMAutoLayoutScrollView where all the subviews should be added.
-
-
-(It’s not different from UIView, but making it of its own class helps when browsing view hierarchies.)
-
-
-
-
Declaration
-
-
Objective-C
-
@interface MMMAutoLayoutScrollViewContentView : UIView
-
-
-
-
Swift
-
class MMMAutoLayoutScrollViewContentView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
To be used during development as a placeholder for not yet implemented views.
-It inherits a vertical scroll view so it’s possible to see that gesture recognizers of the container do not interfere
-with a typical scrolling.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStubView : UIScrollView
-
-
-
-
Swift
-
class MMMStubView : UIScrollView
-
-
-
-
-
-
-
-
-
-
-
-
This is to track the navigation state of the app and have the possibility to programmatically return to registered points of
- the navigation path. The actual navigation entities of the app (usually view controllers) must cooperate in order to
- achieve this.
-
-
The possibility to go back is needed to properly handle in-app links. We have a basic mechanism for this (MMMNavigation)
- which allows to “open” a part of a link and forward the remaining parts to the corresponding handler down the navigation tree.
- The handlers thus need to be able to “close” current navigation path before opening something new.
-
-
Although navigation in the app is better represented by a tree, we assume here that at least the current path in this tree
- can be represented as a stack. Each element of the stack can correspond to a modal view controller or alert view, for example,
- but it can also correspond to a special state of the app or a screen.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationStack : NSObject
-
-
-
-
Swift
-
class MMMNavigationStack : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A table view supporting top and bottom shadows.
-
-
See more
-
-
-
-
-
-
-
-
-
-
Holds configuration for MMMShadowView.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMShadowViewSetting : NSObject
-
-
-
-
Swift
-
class MMMShadowViewSetting : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Helper view for adding custom layer shadows, while taking the the shadow sizes in conserderation for its final frame.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMShadowView : UIView
-
-
-
-
Swift
-
class MMMShadowView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Auto Layout does not support constraints against groups of items, so this is for the cases a normal UIView is
-typically used as a container for such a group.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-Also MMMContainerView does not intercept touches but subviews still do.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMContainerView : UIView
-
-
-
-
Swift
-
class MMMContainerView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
This is to group a few simple layout helpers.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMLayoutUtils : NSObject
-
-
-
-
Swift
-
class MMMLayoutUtils : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A little helper for velocity/acceleration calculations: you feed it values with timestamps and can get the most recent
-acceleration/velocity values.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMVelocityMeter : NSObject
-
-
-
-
Swift
-
class MMMVelocityMeter : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Minimalistic animation helpers.
-
-
Terminology:
-
-
-Normalized time — time value from the [0; 1] range.
-Curved time — normalized time transformed using one of the predefined animation curves.
-
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAnimation : NSObject
-
-
-
-
Swift
-
class MMMAnimation : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Minimalistic animator object in the spirit of helpers defined in MMMAnimation.
-
-
You add animation items, which are basically a set of blocks that will be called every frame on the main run loop and
- when it’s done or cancelled.
-
-
It’s not for every case, it’s for those moments when you know the duration in advance and just need to animate a
- simple custom property and don’t want to subclass CALayer or mess with its multithreaded delegates.
-
-
The animator object does not take care of interpolation of values nor time curves, the normalized time passed into
- update blocks can be transformed and values can be interpolated using simple helpers in MMMAnimation.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAnimator : NSObject
-
-
-
-
Swift
-
class MMMAnimator : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Sort of a handle returned by MMMAnimator when a new animation is scheduled.
-Keep it around, otherwise the animation will be cancelled.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAnimationHandle : NSObject
-
-
-
-
Swift
-
class MMMAnimationHandle : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Collection view supporting top & bottom shadows.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMCollectionView : UICollectionView
-
-
-
-
Swift
-
class MMMCollectionView : UICollectionView
-
-
-
-
-
-
-
-
-
-
-
-
Auto Layout does not support relationships between empty spaces, so we need to use spacer views and set such
-constraints between them. This one is a transparent and by default hidden view which can be used as such a spacer.
-It has no intrinsic size and low content hugging and compression resistance priorities.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMSpacerView : UIView
-
-
-
-
Swift
-
class MMMSpacerView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A container which lays out its subviews in certain direction one after another using fixed spacing between them.
-It also aligns all the items along the layout line according to the given alignment settings.
-Note that you must use setSubviews: method instead of feeding them one by one via addSubview:.
-This is kind of a UIStackView that we understand the internals of.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStackContainer : UIView
-
-
-
-
Swift
-
class MMMStackContainer : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Vertical version of MMMStackContainer.
-
-
See more
-
-
-
-
-
-
-
-
-
-
Horizontal version of MMMStackContainer.
-
-
See more
-
-
-
-
-
-
-
-
-
-
Wraps a view that uses Auto Layout into a manual layout view providing sizeThatFits: for the outside world.
-Can be handy with old APIs that do not fully support Auto Layout.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAutoLayoutIsolator : UIView
-
-
-
-
Swift
-
class MMMAutoLayoutIsolator : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Wraps a view padding it from all the sides.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMPaddedView : UIView
-
-
-
-
Swift
-
class MMMPaddedView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A view displaying a gradient from top to bottom. The linearity of the gradient can be controlled.
-Can be handy for shadow overlays, etc.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMVerticalGradientView : UIView
-
-
-
-
Swift
-
class MMMVerticalGradientView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A base for app-specific stylesheets: commonly used paddings, colors, fonts, etc in a single place.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStylesheet : NSObject
-
-
-
-
Swift
-
class MMMStylesheet : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Dimension converter that uses a table of scales.
-
-
See more
-
-
-
-
-
-
-
-
MMMAnimation Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimation
-
-
-
Objective-C
-
@interface MMMAnimation : NSObject
-
-
-
-
Swift
-
class MMMAnimation : NSObject
-
-
-
-
Minimalistic animation helpers.
-
-
Terminology:
-
-
-Normalized time — time value from the [0; 1] range.
-Curved time — normalized time transformed using one of the predefined animation curves.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Time obtained by curving the given normalized time (from [0; 1] range).
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) curvedTimeForTime :( CGFloat ) time curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func curvedTime ( forTime time : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Inverse function for curvedTimeForTime:curve:, i.e. when we know the value returned by curvedTimeForTime:curve:
-and want the time value passed there.
-This should be used sparingly (not every frame) as the implementation is no very efficient.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) timeForCurvedTime :( CGFloat ) time curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func time ( forCurvedTime time : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Time obtained by clamping the given time into [startTime; startTime + duration], normalizing to [0; 1] range,
-and then curving using a preset curve.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) curvedTimeForTime :( CGFloat ) t
- startTime :( CGFloat ) startTime
- duration :( CGFloat ) duration
- curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func curvedTime ( forTime t : CGFloat , startTime : CGFloat , duration : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
A float between ‘from’ and ‘to’ corresponding to already normalized and curved time.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) interpolateFrom :( CGFloat ) from to :( CGFloat ) to time :( CGFloat ) time ;
-
-
-
-
Swift
-
class func interpolate ( from : CGFloat , to : CGFloat , time : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
-
This has been renamed. Use the version above.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) interpolateFrom :( CGFloat ) from
- to :( CGFloat ) to
- curvedTime :( CGFloat ) time ;
-
-
-
-
Swift
-
class func interpolate ( from : CGFloat , to : CGFloat , curvedTime time : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Value between two floats corresponding to the given time and timing curve.
-If the time is less then startTime, then ‘from’ is returned.
-If the time is greater then startTime + duration, then ‘to’ is returned.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) interpolateFrom :( CGFloat ) from
- to :( CGFloat ) to
- time :( CGFloat ) time
- startTime :( CGFloat ) startTime
- duration :( CGFloat ) duration
- curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func interpolate ( from : CGFloat , to : CGFloat , time : CGFloat , startTime : CGFloat , duration : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
A color between ‘from’ and ‘to’ corresponding to already normalized and curved time.
-Only RGB colors are supported.
-Interpolation is done along a straight line in the RGB space.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull UIColor * ) colorFrom :( nonnull UIColor * ) from
- to :( nonnull UIColor * ) to
- time :( CGFloat ) time ;
-
-
-
-
Swift
-
class func color ( from : UIColor , to : UIColor , time : CGFloat ) -> UIColor
-
-
-
-
-
-
-
-
-
-
-
-
A point on the line between given points corresponding to already normalized and curved time.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGPoint ) pointFrom :( CGPoint ) from to :( CGPoint ) to time :( CGFloat ) time ;
-
-
-
-
Swift
-
class func point ( from : CGPoint , to : CGPoint , time : CGFloat ) -> CGPoint
-
-
-
-
-
-
-
-
-
-
MMMAnimationHandle Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimationHandle
-
-
-
Objective-C
-
@interface MMMAnimationHandle : NSObject
-
-
-
-
Swift
-
class MMMAnimationHandle : NSObject
-
-
-
-
Sort of a handle returned by MMMAnimator when a new animation is scheduled.
-Keep it around, otherwise the animation will be cancelled.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
YES, if the animation has not been finished yet.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) BOOL inProgress ;
-
-
-
-
Swift
-
var inProgress : Bool { get }
-
-
-
-
-
-
-
-
-
-
-
-
Finishes animation before its designated end time.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) cancel ;
-
-
-
-
Swift
-
func cancel ()
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMAnimator Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimator
-
-
-
Objective-C
-
@interface MMMAnimator : NSObject
-
-
-
-
Swift
-
class MMMAnimator : NSObject
-
-
-
-
Minimalistic animator object in the spirit of helpers defined in MMMAnimation.
-
-
You add animation items, which are basically a set of blocks that will be called every frame on the main run loop and
- when it’s done or cancelled.
-
-
It’s not for every case, it’s for those moments when you know the duration in advance and just need to animate a
- simple custom property and don’t want to subclass CALayer or mess with its multithreaded delegates.
-
-
The animator object does not take care of interpolation of values nor time curves, the normalized time passed into
- update blocks can be transformed and values can be interpolated using simple helpers in MMMAnimation.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( instancetype ) shared ;
-
-
-
-
Swift
-
class func shared () -> Self
-
-
-
-
-
-
-
-
-
-
-
-
Schedules a new animation item.
-
-
The updateBlock is called on every update cycle within the animation’s duration. It is guaranteed to be called with
- zero time even if cancelled before the next run loop cycle. The update block is also guaranteed to be called with
- time being 1 unless is cancelled earlier.
-
-
The doneBlock is called after the animation finishes or is cancelled.
-
-
The repeatCount parameter can be set to 0 to mean infinite repeat count.
-
-
In case repeatCount is different from 1, then autoreverse influences the way the time changes when passed to
- the updateBlock: if YES, then it’ll grow from 0 to 1 and then from 1 to 0 on the next repeat, changing back to
- from 0 to 1 after this, etc; if NO, then it’ll always from from 0 to 1 on every repeat step.
-
-
The animation will start on the next cycle of the refresh timer and will have the timestamp of this cycle as its
- actual start time, so there is no need in explicit transactions: all animation added on the same run loop cycle are
- guaranteed to be run in sync.
-
-
Keep the object returned. The animation stops when the reference to this object is released.
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( MMMAnimationHandle * ) addAnimationWithDuration :( CGFloat ) duration
- repeatCount :( NSInteger ) repeatCount
- autoreverse :( BOOL ) autoreverse
- updateBlock :( MMMAnimatorUpdateBlock ) updateBlock
- doneBlock :( nullable MMMAnimatorDoneBlock ) doneBlock
- NS_SWIFT_NAME ( addAnimation ( duration : repeatCount : autoreverse : update : completion : ));
-
-
-
-
-
-
-
-
-
-
-
-
-
Despite the +shared method defined above you can still create own instances of this class.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init ;
-
-
-
-
-
-
-
-
-
-
-
-
-
For unit tests only: will synchronously run all the animations already in the animator and the ones added within
- the given block in the specified number of steps, executing the given block after each step.
- This is used in view-based tests for those views that run all their animations using MMMAnimator.
-
-
The idea is that an animated action is triggered in the animationsBlock (e.g. hideAnimated:YES) and then the
- stepBlock is called in the very beginning and in exactly numberOfSteps - 1 moments afterwards. The moments will be
- selected, so they are spaced equally and the last one is exactly at the end of the longest animation item.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) _testRunInNumberOfSteps :( NSInteger ) numberOfSteps
- animations :( nonnull void ( ^ )( void )) animationsBlock
- forEachStep :( nonnull void ( ^ )( NSInteger )) stepBlock ;
-
-
-
-
Swift
-
func _testRun ( numberOfSteps : Int , animations animationsBlock : () -> Void , stepBlock : ( Int ) -> Void )
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutIsolator Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutIsolator
-
-
-
Objective-C
-
@interface MMMAutoLayoutIsolator : UIView
-
-
-
-
Swift
-
class MMMAutoLayoutIsolator : UIView
-
-
-
-
Wraps a view that uses Auto Layout into a manual layout view providing sizeThatFits: for the outside world.
-Can be handy with old APIs that do not fully support Auto Layout.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The view being wrapped.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIView * _Nonnull view ;
-
-
-
-
Swift
-
var view : UIView { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( UIView * ) view NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( view : UIView )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) coder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutScrollView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutScrollView
-
-
-
Objective-C
-
@interface MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
Swift
-
class MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
A vertical scroll view with a content view and preconfigured constraints, so there is no need in creating
- a scroll view / content view sandwitch manually every time.
-
-
It also supports top and bottom shadows that are displayed only when the content is clipped.
- The shadows can be enabled individually and they can sit either flush with the edges of the scroll view
- or can be inset according to adjustedContentInset, which can be handy when vertical safeAreaInsets need
- to be taken into account. (Note that contentInsetAdjustmentBehavior has to be either None or Always
- on this view since “automatic” options can lead to cyclic calculations.) Also note that scroll indicators
- are disabled here by default.
-
-
Begin by adding your controls and constraints into the contentView ensuring that its size can be derived from your
- constraints alone. Avoid constraints to the scroll view itself or outside views unless you are prepared to deal
- with the consequences.
-
-
Note that the width of the contentView will be constrainted hard to be equal to the width of the scroll view
- and its height will be constrained with prio 251 to be at least as large as the height of the scroll view.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
This is where your content subviews should be added.
-
-
-
-
-
-
-
-
-
-
-
Initializes with the given config.
-
-
Note
- Note that changing the config after the initialization has no effect on the view.
-
-
-
-
-
-
-
-
-
-
-
-
-
Initializes with default settings, a shortcut for initWithSettings:[[MMMScrollViewShadowsSettings alloc] init].
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init ;
-
-
-
-
Swift
-
convenience init ()
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMCollectionView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMCollectionView
-
-
-
Objective-C
-
@interface MMMCollectionView : UICollectionView
-
-
-
-
Swift
-
class MMMCollectionView : UICollectionView
-
-
-
-
Collection view supporting top & bottom shadows.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Uses UICollectionViewFlowLayout by default.
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame collectionViewLayout :( UICollectionViewLayout * ) layout NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMContainerView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMContainerView
-
-
-
Objective-C
-
@interface MMMContainerView : UIView
-
-
-
-
Swift
-
class MMMContainerView : UIView
-
-
-
-
Auto Layout does not support constraints against groups of items, so this is for the cases a normal UIView is
-typically used as a container for such a group.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-Also MMMContainerView does not intercept touches but subviews still do.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMHorizontalStackContainer Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMHorizontalStackContainer
-
-
Horizontal version of MMMStackContainer.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithInsets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutVerticalAlignment ) alignment
- spacing :( CGFloat ) spacing NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithDirection :( MMMLayoutDirection ) direction
- insets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutAlignment ) alignment
- spacing :( CGFloat ) spacing ;
-
-
-
-
-
-
-
-
-
-
MMMImageView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMImageView
-
-
-
Objective-C
-
@interface MMMImageView : UIView
-
-
-
-
Swift
-
class MMMImageView : UIView
-
-
-
-
A limited replacement for UIImageView fixing its inability to properly work with images having
- non-zero alignmentRectInsets when scaled.
-
-
Note that this view is already constrained to the aspect ratio of the image’s alignment rect,
- so you should not use hard (equal) pins against both width and height or against all edges.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , nullable ) UIImage * image
-
-
-
-
Swift
-
var image : UIImage ? { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , nullable ) UIImage * highlightedImage
-
-
-
-
Swift
-
var highlightedImage : UIImage ? { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , getter = isHighlighted ) BOOL highlighted
-
-
-
-
Swift
-
var isHighlighted : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithImage :( nullable UIImage * ) image highlightedImage :( nullable UIImage * ) highlightedImage NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( image : UIImage ?, highlightedImage : UIImage ?)
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init ;
-
-
-
-
Swift
-
convenience init ()
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithImage :( nullable UIImage * ) image ;
-
-
-
-
Swift
-
convenience init ( image : UIImage ?)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMLayoutUtils Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutUtils
-
-
-
Objective-C
-
@interface MMMLayoutUtils : NSObject
-
-
-
-
Swift
-
class MMMLayoutUtils : NSObject
-
-
-
-
This is to group a few simple layout helpers.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A rect with the given size positioned inside of the target rect in such a way that anchor points of both rects align.
-
-
Anchor points are given relative to the sizes of the corresponding rects, similar to CALayer’s anchorPoint
- property. For example, CGPointMake(0.5, 0.5) represents a center of any rect; CGPointMake(1, 0.5) means
- the center point of the right vertical edge.
-
-
Note that the origin of the rect returned is rounded to the nearest pixels (not points!).
-
-
See rectWithSize:inRect:contentMode: for a shortcut supporting UIViewContentMode.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- anchor :( CGPoint ) anchor
- withinRect :( CGRect ) targetRect
- anchor :( CGPoint ) targetAnchor ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , anchor : CGPoint , withinRect targetRect : CGRect , anchor targetAnchor : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut for the above method with anchors being the same for both source and target rect.
-(This way the resulting rect will be always inside of the target one, assuming anchors are within [0; 1] range.)
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- withinRect :( CGRect ) targetRect
- anchor :( CGPoint ) anchor ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , withinRect targetRect : CGRect , anchor : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
A frame for the sourceRect positioned within the targetRect according to standard UIViewContentMode flags
- related to the layout (i.e. all except UIViewContentModeRedraw).
-
-
Note that the origin of the resulting rectangle is always rounded to the nearest pixel.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- withinRect :( CGRect ) targetRect
- contentMode :( UIViewContentMode ) contentMode ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , withinRect targetRect : CGRect , contentMode : UIView . ContentMode ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
A frame of the given size with its center at the specified point (assuming the center is defined by the given anchor
- point).
-
-
Note that the origin of the resulting rectangle is rounded to the nearest pixel boundary.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- atPoint :( CGPoint ) center
- anchor :( CGPoint ) anchor ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , atPoint center : CGPoint , anchor : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
Same as rectWithSize:center:anchor: with anchor set to (0.5, 0.5).
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size center :( CGPoint ) center ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , center : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
MMMNavigation Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigation
-
-
-
Objective-C
-
@interface MMMNavigation : NSObject
-
-
-
-
Swift
-
class MMMNavigation : NSObject
-
-
-
-
Manages switching between different sections of the app (kind of internal URL router).
-It’s like a central hub accepting navigation requests and then passing them to the entities that able to perform them.
-(The entities that are able to open requests should register themselves as handlers.)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( instancetype ) root ;
-
-
-
-
Swift
-
class func root () -> Self
-
-
-
-
-
-
-
-
-
-
-
-
Starts the process of opening of the given path. Calls the completion block when done, the block receives ID of the
-corresponding request. Links are opened one by one. Any navigation request received while handling the current one
-will be queued.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds a handler and returns a cookie/ID object that can be later used to remove it.
-
-
-
-
-
-
-
-
-
-
-
Removes a handler by its ID assigned by addHandler.
-
-
-
Declaration
-
-
-
Swift
-
func removeHandler ( withId handlerId : Any )
-
-
-
-
-
-
-
-
-
-
MMMNavigationHop Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationHop
-
-
-
Objective-C
-
@interface MMMNavigationHop : NSObject
-
-
-
-
Swift
-
class MMMNavigationHop : NSObject
-
-
-
-
Opening a deep link can involve following through one or more steps, for example:
-
-
1) make sure the main screen is visible and can switch between the pages;
- 2) move to the recipes page;
- 3) open recipe with ID N;
- 4) scroll to ingredients, etc.
-
-
This is a single step in such a chain.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Name/ID of the hop. Supposed to be a flat string, like ‘recipes’, not a path.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) NSString * _Nonnull action ;
-
-
-
-
Swift
-
var action : String { get }
-
-
-
-
-
-
-
-
-
-
-
-
Optional parameters for this hop only.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly , nullable ) NSDictionary < NSString * , id > * params ;
-
-
-
-
Swift
-
var params : [ String : Any ]? { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithAction :( NSString * ) action params :( nullable NSDictionary < NSString * , id > * ) params NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( action : String , params : [ String : Any ]?)
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithAction :( NSString * ) action ;
-
-
-
-
Swift
-
convenience init ( action : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMNavigationPath Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationPath
-
-
-
Objective-C
-
@interface MMMNavigationPath : NSObject
-
-
-
-
Swift
-
class MMMNavigationPath : NSObject
-
-
-
-
A navigation path is just a collection of one or more “hops”.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
All the “hops” the link consists of.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) NSArray < MMMNavigationHop *> * _Nonnull hops ;
-
-
-
-
-
-
-
-
-
-
-
-
-
A new path obtained from the current one by removing the first hop.
-
-
-
Declaration
-
-
Objective-C
-
- ( nullable MMMNavigationPath * ) pathWithoutFirstHop ;
-
-
-
-
Swift
-
func pathWithoutFirstHop () -> MMMNavigationPath ?
-
-
-
-
-
-
-
-
-
-
-
-
The first hop in the path or nil if the path is empty.
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithHops :( NSArray < MMMNavigationHop *> * ) hops NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer. Allows to use URIs like “main/recipes”, to construct hops out of it.
-Note that it does not currently support hop parameters.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithURI :( nonnull NSString * ) uri ;
-
-
-
-
Swift
-
convenience init ( uri : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMNavigationRequest Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationRequest
-
-
-
Objective-C
-
@interface MMMNavigationRequest : NSObject
-
-
-
-
Swift
-
class MMMNavigationRequest : NSObject
-
-
-
-
Info about a navigation request that is passed to handlers.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A sequence of hops the request has started with. This is never changed during lifetime of the request.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) MMMNavigationPath * _Nonnull originalPath ;
-
-
-
-
-
-
-
-
-
-
-
-
-
The current sequence of hops to follow. Handlers can adjust this.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) MMMNavigationPath * _Nonnull path ;
-
-
-
-
-
-
-
-
-
-
-
-
-
Called by the handler when all the hops in the path were followed through.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) didFinishSuccessfully :( BOOL ) successfully ;
-
-
-
-
Swift
-
func didFinishSuccessfully ( _ successfully : Bool )
-
-
-
-
-
-
-
-
-
-
-
-
Called by the handler to indicate that the sequence of hops (possibly changed) should be continued by another handler.
-The handler is supposed to conform to MMMNavigationHandler to make it more convenient to call this method.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) continueWithPath :( nonnull MMMNavigationPath * ) path
- handler :( nonnull id ) handler ;
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStack Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStack
-
-
-
Objective-C
-
@interface MMMNavigationStack : NSObject
-
-
-
-
Swift
-
class MMMNavigationStack : NSObject
-
-
-
-
This is to track the navigation state of the app and have the possibility to programmatically return to registered points of
- the navigation path. The actual navigation entities of the app (usually view controllers) must cooperate in order to
- achieve this.
-
-
The possibility to go back is needed to properly handle in-app links. We have a basic mechanism for this (MMMNavigation)
- which allows to “open” a part of a link and forward the remaining parts to the corresponding handler down the navigation tree.
- The handlers thus need to be able to “close” current navigation path before opening something new.
-
-
Although navigation in the app is better represented by a tree, we assume here that at least the current path in this tree
- can be represented as a stack. Each element of the stack can correspond to a modal view controller or alert view, for example,
- but it can also correspond to a special state of the app or a screen.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( instancetype ) shared ;
-
-
-
-
Swift
-
class func shared () -> Self
-
-
-
-
-
-
-
-
-
-
-
-
Notifies the stack about a new modal navigation context facing the user now, such as a modal view controller being presented or
- any other special state of the UI which would require either the assistance from the user or navigation items’ delegate
- in order to return to the previous navigation step.
-
-
Again, navigation steps are not limited to modal view controllers, there can be any entity responsible for the current
- state of the UI which wants to clean it up properly when asked for via the corresponding delegate.
-
-
The optional controller parameter might be a view controller corresponding to the new navigation item. This can be used by
- this controller with popAllAfterController:completion: method in order to cancel/pop all the navigation items added after it.
-
-
A nil is returned if it’s not possible to push anything now (because the stack is in the middle of a change).
-
-
For now trying to push something when “popping” is in progress is considered a programmer’s error however and it will crash
- in Debug.
-
-
-
-
-
-
-
-
-
-
-
-
-
MMMPaddedView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMPaddedView
-
-
-
Objective-C
-
@interface MMMPaddedView : UIView
-
-
-
-
Swift
-
class MMMPaddedView : UIView
-
-
-
-
Wraps a view padding it from all the sides.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The view being wrapped.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIView * _Nonnull view ;
-
-
-
-
Swift
-
var view : UIView { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIEdgeInsets insets
-
-
-
-
Swift
-
var insets : UIEdgeInsets { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( UIView * ) view insets :( UIEdgeInsets ) insets NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( view : UIView , insets : UIEdgeInsets )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) coder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowView
-
-
-
Objective-C
-
@interface MMMScrollViewShadowView : UIView
-
-
-
-
Swift
-
class MMMScrollViewShadowView : UIView
-
-
-
-
A view that’s used internally to render shadows in MMMAutoLayoutScrollView.
-Open for reuse in cases we want to display compatible shadows but differntly controlled.
-Note that this does not support Auto Layout, you have to manage its frame.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadows Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadows
-
-
-
Objective-C
-
@interface MMMScrollViewShadows : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadows : NSObject
-
-
-
-
A helper for adding top and bottom shadows into any UIScrollView-based class.
-You create an instance in your subclass and forward calls from layoutSubviews.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithScrollView :( nonnull UIScrollView * ) scrollView
- settings :( nonnull MMMScrollViewShadowsSettings * ) settings NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
Have to be called from layoutSubviews of our scroll view subclass to update the state of the shadows.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) layoutSubviews ;
-
-
-
-
Swift
-
func layoutSubviews ()
-
-
-
-
-
-
-
-
-
-
-
-
YES, if additional content view clipping might be needed for the current shadow settings.
-
-
-
Declaration
-
-
Objective-C
-
- ( BOOL ) mightNeedClippingView ;
-
-
-
-
Swift
-
func mightNeedClippingView () -> Bool
-
-
-
-
-
-
-
-
-
-
-
-
Same as layoutSubviews above but also updates clipToBounds property of the given view in case there are visible
-
-
-shadows that are not flush with the edges of our scroll view, i.e. when top/bottomShadowShouldUseContentInsets
-are used with settings and the corresponding insets are not zero now.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) layoutSubviewsWithClippingView :( nullable UIView * ) clippingView ;
-
-
-
-
Swift
-
func layoutSubviews ( withClippingView clippingView : UIView ?)
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowsSettings Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowsSettings
-
-
-
Objective-C
-
@interface MMMScrollViewShadowsSettings : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadowsSettings : NSObject
-
-
-
-
Holds configuration for MMMScrollViewShadows that can be set only on initialization time.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The base shadow color is black with this amount of transparency applied to it.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat shadowAlpha ;
-
-
-
-
Swift
-
var shadowAlpha : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The base shadow color, ensure this is an RGB color. Note that the alpha channel is ignored, use shadowAlpha
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIColor * _Nonnull shadowColor ;
-
-
-
-
Swift
-
var shadowColor : UIColor { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The value between 0 and 1 telling how close to an elliptical curve the shadow’s border should be.
-
-
-when it’s 0, then the shadow is a normal rectangular one.
when it’s 1, then the gradient of the top (bottom) shadow forms an arc crossing the center of a shadow view and
-its both corners.
-
-
All values in-between adjust the point at which the gradient crosses the sides of the shadow views.
-
-
(The default value is 0.5.)
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat shadowCurvature ;
-
-
-
-
Swift
-
var shadowCurvature : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
Disabled by default.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL topShadowEnabled ;
-
-
-
-
Swift
-
var topShadowEnabled : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The height of the top shadow view. (5px by default.)
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat topShadowHeight ;
-
-
-
-
Swift
-
var topShadowHeight : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
YES, if the top shadow should be offset from the top edge of the scroll view by the top offset of content insets.
-
-
-The default value is NO.
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL topShadowShouldUseContentInsets ;
-
-
-
-
Swift
-
var topShadowShouldUseContentInsets : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
Disabled by default.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL bottomShadowEnabled ;
-
-
-
-
Swift
-
var bottomShadowEnabled : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The height of the bottom shadow view. (10px by default.)
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat bottomShadowHeight ;
-
-
-
-
Swift
-
var bottomShadowHeight : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
YES, if the bottom shadow should be offset from the bottom edge of the scroll view by the bottom offset of content insets.
-
-
-The default value is NO.
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL bottomShadowShouldUseContentInsets ;
-
-
-
-
Swift
-
var bottomShadowShouldUseContentInsets : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
MMMShadowView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMShadowView
-
-
-
Objective-C
-
@interface MMMShadowView : UIView
-
-
-
-
Swift
-
class MMMShadowView : UIView
-
-
-
-
Helper view for adding custom layer shadows, while taking the the shadow sizes in conserderation for its final frame.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
View that can accepts and lay out subviews.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIView * _Nonnull contentView ;
-
-
-
-
Swift
-
var contentView : UIView { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) coder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMShadowViewSetting Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMShadowViewSetting
-
-
-
Objective-C
-
@interface MMMShadowViewSetting : NSObject
-
-
-
-
Swift
-
class MMMShadowViewSetting : NSObject
-
-
-
-
Holds configuration for MMMShadowView.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Default is black color.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIColor * _Nonnull color ;
-
-
-
-
Swift
-
var color : UIColor { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat opacity ;
-
-
-
-
Swift
-
var opacity : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGSize offset ;
-
-
-
-
Swift
-
var offset : CGSize { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat radius ;
-
-
-
-
Swift
-
var radius : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIEdgeInsets insets ;
-
-
-
-
Swift
-
var insets : UIEdgeInsets { get set }
-
-
-
-
-
-
-
-
-
-
-
-
Default is white color.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIColor * _Nonnull backgroundColor ;
-
-
-
-
Swift
-
var backgroundColor : UIColor { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat cornerRadius ;
-
-
-
-
Swift
-
var cornerRadius : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
MMMSpacerView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMSpacerView
-
-
-
Objective-C
-
@interface MMMSpacerView : UIView
-
-
-
-
Swift
-
class MMMSpacerView : UIView
-
-
-
-
Auto Layout does not support relationships between empty spaces, so we need to use spacer views and set such
-constraints between them. This one is a transparent and by default hidden view which can be used as such a spacer.
-It has no intrinsic size and low content hugging and compression resistance priorities.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStackContainer Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStackContainer
-
-
-
Objective-C
-
@interface MMMStackContainer : UIView
-
-
-
-
Swift
-
class MMMStackContainer : UIView
-
-
-
-
A container which lays out its subviews in certain direction one after another using fixed spacing between them.
-It also aligns all the items along the layout line according to the given alignment settings.
-Note that you must use setSubviews: method instead of feeding them one by one via addSubview:.
-This is kind of a UIStackView that we understand the internals of.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Sets subviews to be laid out. Previously set subviews will be removed from this container first.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) setSubviews :( nonnull NSArray < UIView *> * ) subviews ;
-
-
-
-
Swift
-
func setSubviews ( _ subviews : [ UIView ])
-
-
-
-
-
-
-
-
-
-
-
-
Insets define the padding around all the subviews.
-Alignment influences horizontal constraints added for the subviews.
-Spacing is the fixed distance to set between items.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithDirection :( MMMLayoutDirection ) direction
- insets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutAlignment ) alignment
- spacing :( CGFloat ) spacing ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStubView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStubView
-
-
-
Objective-C
-
@interface MMMStubView : UIScrollView
-
-
-
-
Swift
-
class MMMStubView : UIScrollView
-
-
-
-
To be used during development as a placeholder for not yet implemented views.
-It inherits a vertical scroll view so it’s possible to see that gesture recognizers of the container do not interfere
-with a typical scrolling.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The text is optional, the index influences the background color.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithText :( nullable NSString * ) text index :( NSInteger ) index ;
-
-
-
-
Swift
-
init ( text : String ?, index : Int )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStubViewController Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStubViewController
-
-
-
Objective-C
-
@interface MMMStubViewController : UIViewController
-
-
-
-
Swift
-
class MMMStubViewController : UIViewController
-
-
-
-
This is to be used during development to stub not ready yet parts of the app.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithText :( NSString * ) text index :( NSInteger ) index NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( text : String , index : Int )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithNibName :( nullable NSString * ) nibNameOrNil bundle :( nullable NSBundle * ) nibBundleOrNil NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStylesheet Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStylesheet
-
-
-
Objective-C
-
@interface MMMStylesheet : NSObject
-
-
-
-
Swift
-
class MMMStylesheet : NSObject
-
-
-
-
A base for app-specific stylesheets: commonly used paddings, colors, fonts, etc in a single place.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The size class of the current device. See the MMSize* string constants below.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) NSString * _Nonnull currentSizeClass ;
-
-
-
-
Swift
-
var currentSizeClass : String { get }
-
-
-
-
-
-
-
-
-
-
-
-
Allows to avoid code that picks values (fonts, sizes, etc) by explicitely matching currentSizeClass
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) valueForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , id > * ) sizeClassToValue ;
-
-
-
-
Swift
-
func value ( forCurrentSizeClass sizeClassToValue : [ String : Any ]) -> Any
-
-
-
-
-
-
-
-
-
-
-
-
A version of valueForCurrentSizeClass: unwrapping the result as a float, which is handy for numeric values.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) floatForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) sizeClassToValue ;
-
-
-
-
Swift
-
func float ( forCurrentSizeClass sizeClassToValue : [ String : NSNumber ]) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Deprecated
-
Try using widthBasedConverter
-
-
-
Deprecated.
-Similar to floatForCurrentSizeClass: but instead of falling back to the value under MMMSizeRest key
-it tries to extrapolate the requested dimension using 1 or 2 values provided for other size classes using
-the widthBasedConverter
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) extrapolatedFloatForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) sizeClassToValue ;
-
-
-
-
Swift
-
func extrapolatedFloat ( forCurrentSizeClass sizeClassToValue : [ String : NSNumber ]) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Deprecated
-
The code using this might be confusing and/or hard to support. If you need to specify values for different size classes, then list them all explicitly in a call to floatForCurrentSizeClass:
-
-
-
Deprecated.
-Similar to extrapolatedFloatForCurrentSizeClass:, but allows to override values for certain size classes
-in the exceptions paramater.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) extrapolatedFloatForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) sizeClassToValue
- except :
- ( nonnull NSDictionary * ) exceptions ;
-
-
-
-
Swift
-
func extrapolatedFloat ( forCurrentSizeClass sizeClassToValue : [ String : NSNumber ], except exceptions : [ AnyHashable : Any ]) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Converts dimensions given for one size class into dimensions suitable for the current size class
-based on the ratio of screen widths associated with the current and source size classes.
-
-
-
-
-
-
-
-
-
-
-
A standard set of paddings.
-The actual stylesheet should override all these or at least the normalPadding insetsFromRelativeInsets can be defined here as well.
-In case only normalPadding
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat extraExtraSmallPadding ;
-
-
-
-
Swift
-
var extraExtraSmallPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat extraSmallPadding
-
-
-
-
Swift
-
var extraSmallPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat smallPadding
-
-
-
-
Swift
-
var smallPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat normalPadding
-
-
-
-
Swift
-
var normalPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat largePadding
-
-
-
-
Swift
-
var largePadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat extraLargePadding
-
-
-
-
Swift
-
var extraLargePadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
Actual insets from relative ones.
-
-
Each offset in relative insets is a fixed number corresponding to the actual paddings defined above:
-
-
-.125 - extraExtraSmallPadding
-.25 — extraSmallPadding
-.5 — smallPadding
-1 — normalPadding
-2 — largePadding
-4 — extraLargePadding
-
-
-
Note that the large padding is not necessarily 2x larger than the normal one, etc (by default the extra large is),
- but we intentionally use them here like this to allow more compact notation for insets which is easy to remember and
- easy to tweak. Compare, for example:
-
-
\code
- UIEdgeInsetsMake([MHStylesheet shared].normalPadding, [MHStylesheet shared].largePadding, [MHStylesheet shared].normalPadding, [MHStylesheet shared].largePadding)
- \endcode
-
-
and the equivalent:
-
-
\code
- [[MHStylesheet shared] insetsFromRelativeInsets:UIEdgeInsetsMake(1, 2, 1, 2)]
- \endcode
-
-
-
Declaration
-
-
Objective-C
-
- ( UIEdgeInsets ) insetsFromRelativeInsets :( UIEdgeInsets ) insets ;
-
-
-
-
Swift
-
func insets ( fromRelativeInsets insets : UIEdgeInsets ) -> UIEdgeInsets
-
-
-
-
-
-
-
-
-
-
-
-
This is what insetsFromRelativeInsets: is using internally. Might be useful when making similar methods.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) paddingFromRelativePadding :( CGFloat ) padding ;
-
-
-
-
Swift
-
func padding ( fromRelativePadding padding : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
A metrics dictionary that can be used with Auto Layout with keys/values corresponding to all the paddings we support,
-e.g. “extraSmallPadding”, etc.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) dictionaryWithPaddings ;
-
-
-
-
Swift
-
func dictionaryWithPaddings () -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
-
-
A dictionary with 4 values under keys “Top”, “Bottom”, “Left”, “Right”
-corresponding to the insets obtained from the provided relative ones via insetsFromRelativeInsets:.
-(A shortcut composing insetsFromRelativeInsets method with MMMDictinaryFromUIEdgeInsets().)
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSDictionary < NSString * , NSNumber *> * )
- dictionaryFromRelativeInsets :( UIEdgeInsets ) insets
- keyPrefix :( nonnull NSString * ) keyPrefix ;
-
-
-
-
Swift
-
func dictionary ( fromRelativeInsets insets : UIEdgeInsets , keyPrefix : String ) -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
-
-
A dictionary with 4 values obtained from the insets returned by insetsFromRelativeInsets:insets
-under the keys “paddingTop”, “paddingBottom”, “paddingLeft”, “paddingRight”,
-i.e. it’s a shortcut for dictionaryFromRelativeInsets:insets keyPrefix:@"padding".
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSDictionary < NSString * , NSNumber *> * )
- paddingDictionaryFromRelativeInsets :( UIEdgeInsets ) insets ;
-
-
-
-
Swift
-
func paddingDictionary ( fromRelativeInsets insets : UIEdgeInsets ) -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
MMMStylesheetScaleConverter Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStylesheetScaleConverter
-
-
Dimension converter that uses a table of scales.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Initializes the converter with an explicit table of scales.
-Every value coming to convertFloat:fromSizeClass: will be returned multiplied by scales[sourceSizeClass].
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithScales :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) scales ;
-
-
-
-
Swift
-
init ( scales : [ String : NSNumber ])
-
-
-
-
-
-
-
-
-
-
-
-
Initializes the converter with a target size class and a table of dimensions associated with every size class
- (e.g screen width).
-
-
Every value coming to convertFloat:fromSizeClass: will be returned adjusted proportionally to the ratio of the
- dimensions associated with target and source size classes, i.e. it will be multiplied by
- scales[targetSizeClass] / scales[sourceSizeClass].
-
-
So for a table of screen widths the converter will upscale or downscale dimensions between size classes
- proprtionally to the ratios of screen width associated with size classes.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithTargetSizeClass :( nonnull NSString * ) targetSizeClass
- dimensions :
- ( nonnull NSDictionary < NSString * , NSNumber *> * )
- dimensions ;
-
-
-
-
Swift
-
convenience init ( targetSizeClass : String , dimensions : [ String : NSNumber ])
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMTableView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMTableView
-
-
A table view supporting top and bottom shadows.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Note that UITableViewStylePlain is used.
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame style :( UITableViewStyle ) style NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
When enabled, then reloadData is automatically called whenever any of the cells report potential size
-changes via mmm_setPreferredSizeCouldChange. See MMMPreferredSizeChanges
-
-
This feature is disabled by default for compatibility with the current code.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL shouldHandlePotentialCellSizeChanges ;
-
-
-
-
Swift
-
var shouldHandlePotentialCellSizeChanges : Bool { get set }
-
-
-
-
-
-
-
-
-
-
MMMTableViewCell Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMTableViewCell
-
-
-
Objective-C
-
@interface MMMTableViewCell : UITableViewCell
-
-
-
-
Swift
-
class MMMTableViewCell : UITableViewCell
-
-
-
-
A base for table view cells redeclareing the designated initializer into the one we typically use,
-so subclasses do not have to.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithReuseIdentifier :( NSString * ) reuseIdentifier NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ! ( reuseIdentifier : String ! )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithStyle :( UITableViewCellStyle ) style reuseIdentifier :( NSString * ) reuseIdentifier NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMVelocityMeter Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMVelocityMeter
-
-
-
Objective-C
-
@interface MMMVelocityMeter : NSObject
-
-
-
-
Swift
-
class MMMVelocityMeter : NSObject
-
-
-
-
A little helper for velocity/acceleration calculations: you feed it values with timestamps and can get the most recent
-acceleration/velocity values.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Resets the state of the meter, all values added before are forgotten.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) reset ;
-
-
-
-
Swift
-
func reset ()
-
-
-
-
-
-
-
-
-
-
-
-
Adds a coordinate and a corresponding timestamp.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) addValue :( CGFloat ) value timestamp :( NSTimeInterval ) timestamp ;
-
-
-
-
Swift
-
func addValue ( _ value : CGFloat , timestamp : TimeInterval )
-
-
-
-
-
-
-
-
-
-
-
-
Adds a coordinate with the current timstamp.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) addValue :( CGFloat ) value ;
-
-
-
-
Swift
-
func addValue ( _ value : CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
Calculates velocity and acceleration based on recently added values.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) calculateVelocity :( nonnull CGFloat * ) velocity
- acceleration :( nonnull CGFloat * ) acceleration ;
-
-
-
-
Swift
-
func calculateVelocity ( _ velocity : UnsafeMutablePointer < CGFloat > , acceleration : UnsafeMutablePointer < CGFloat > )
-
-
-
-
-
-
-
-
-
-
MMMVerticalGradientView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMVerticalGradientView
-
-
-
Objective-C
-
@interface MMMVerticalGradientView : UIView
-
-
-
-
Swift
-
class MMMVerticalGradientView : UIView
-
-
-
-
A view displaying a gradient from top to bottom. The linearity of the gradient can be controlled.
-Can be handy for shadow overlays, etc.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithTopColor :( UIColor * ) topColor bottomColor :( UIColor * ) bottomColor curve :( MMMAnimationCurve ) curve NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( topColor : UIColor , bottomColor : UIColor , curve : MMMAnimationCurve )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithTopColor :( UIColor * ) topColor bottomColor :( UIColor * ) bottomColor ;
-
-
-
-
Swift
-
convenience init ( topColor : UIColor , bottomColor : UIColor )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMVerticalStackContainer Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMVerticalStackContainer
-
-
Vertical version of MMMStackContainer.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithInsets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutHorizontalAlignment ) alignment
- spacing :( CGFloat ) spacing NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithDirection :( MMMLayoutDirection ) direction
- insets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutAlignment ) alignment
- spacing :( CGFloat ) spacing ;
-
-
-
-
-
-
-
-
-
-
MMMViewWrappingCell Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMViewWrappingCell
-
-
-
-
Swift
-
class MMMViewWrappingCell < ViewType > : MMMTableViewCell where ViewType : AnyObject
-
-
-
-
A simple table view cell wrapping the given view.
-
-
This is handy when you have a view already and just want to show it as one more cell.
-
-
The view being wrapped should support Auto Layout and inflate its height properly. The cell has its selectionStyle
- set to UITableViewCellSelectionStyleNone as these kind of cells typically do not appear selected.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The view this cell wraps. It is added into the contentView and is laid out to fully fill it.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) ViewType _Nonnull wrappedView ;
-
-
-
-
Swift
-
var wrappedView : ViewType { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( ViewType ) view reuseIdentifier :( NSString * ) reuseIdentifier ;
-
-
-
-
Swift
-
init ( view : ViewType , reuseIdentifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( ViewType ) view reuseIdentifier :( NSString * ) reuseIdentifier inset :( UIEdgeInsets ) inset ;
-
-
-
-
Swift
-
init ( view : ViewType , reuseIdentifier : String , inset : UIEdgeInsets )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithReuseIdentifier :( NSString * ) reuseIdentifier NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
Constants Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Constants
-
The following constants are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Golden ratio constant.
-
-
-
Declaration
-
-
Objective-C
-
extern const CGFloat MMMGolden
-
-
-
-
Swift
-
class let golden : CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
1 divided by golden ratio.
-
-
-
Declaration
-
-
Objective-C
-
extern const CGFloat MMMInverseGolden
-
-
-
-
Swift
-
class let inverseGolden : CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Small screen phones: iPhone 4/4s/5/5s/SE.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSizeClassic
-
-
-
-
Swift
-
let MMMSizeClassic : String
-
-
-
-
-
-
-
-
-
-
-
-
Regular phones: iPhone 6/6s/7/8 and X as well.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSize6
-
-
-
-
Swift
-
let MMMSize6 : String
-
-
-
-
-
-
-
-
-
-
-
-
Pluse-sized phones: iPhone 6/7/8 Plus.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSize6Plus
-
-
-
-
Swift
-
let MMMSize6Plus : String
-
-
-
-
-
-
-
-
-
-
-
-
iPads: regular and pros.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSizePad
-
-
-
-
Swift
-
let MMMSizePad : String
-
-
-
-
-
-
-
-
-
-
-
-
Not the actual size class, but can be used as a key valueForCurrentSizeClass: and related methods for a fallback value.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSizeRest
-
-
-
-
Swift
-
let MMMSizeRest : String
-
-
-
-
-
-
-
-
-
-
Enumerations Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Enumerations
-
The following enumerations are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMScrollViewShadowAlignment ) {
- MMMScrollViewShadowAlignmentTop ,
- MMMScrollViewShadowAlignmentBottom
-}
-
-
-
-
Swift
-
enum MMMScrollViewShadowAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMAnimationCurve ) {
-
- MMMAnimationCurveLinear ,
- MMMAnimationCurveEaseOut ,
- MMMAnimationCurveEaseIn ,
- MMMAnimationCurveEaseInOut ,
-
- // "Softer" versions are closer to the linear curve.
- MMMAnimationCurveSofterEaseIn ,
- MMMAnimationCurveSofterEaseOut ,
- MMMAnimationCurveSofterEaseInOut ,
-
- // Quad animations (e.g. https://easings.net/#easeInQuad)
- MMMAnimationCurveEaseInQuad ,
- MMMAnimationCurveEaseOutQuad ,
- MMMAnimationCurveEaseInOutQuad ,
-
- // Cubic animations (e.g. https://easings.net/#easeInCubic)
- MMMAnimationCurveEaseInCubic ,
- MMMAnimationCurveEaseOutCubic ,
- MMMAnimationCurveEaseInOutCubic ,
-
- // Quart animations (e.g. https://easings.net/#easeInQuart)
- MMMAnimationCurveEaseInQuart ,
- MMMAnimationCurveEaseOutQuart ,
- MMMAnimationCurveEaseInOutQuart ,
-
- // Quint animations (e.g. https://easings.net/#easeInQuint)
- MMMAnimationCurveEaseInQuint ,
- MMMAnimationCurveEaseOutQuint ,
- MMMAnimationCurveEaseInOutQuint
-}
-
-
-
-
Swift
-
enum MMMAnimationCurve : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
General alignment flags used when it’s not important which direction (vertical or horizontal) the alignment is for.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
enum MMMLayoutAlignment : NSInteger {}
-
-
-
-
Swift
-
enum MMMLayoutAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutDirection ) {
- MMMLayoutDirectionHorizontal ,
- MMMLayoutDirectionVertical
-}
-
-
-
-
Swift
-
enum MMMLayoutDirection : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutHorizontalAlignment ) {
- MMMLayoutHorizontalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutHorizontalAlignmentLeft = MMMLayoutAlignmentLeading ,
- MMMLayoutHorizontalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutHorizontalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutHorizontalAlignmentRight = MMMLayoutAlignmentTrailing ,
- MMMLayoutHorizontalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutHorizontalAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutVerticalAlignment ) {
- MMMLayoutVerticalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutVerticalAlignmentTop = MMMLayoutAlignmentLeading ,
- MMMLayoutVerticalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutVerticalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutVerticalAlignmentBottom = MMMLayoutAlignmentTrailing ,
- MMMLayoutVerticalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutVerticalAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
MMMAnimationCurve Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimationCurve
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMAnimationCurve ) {
-
- MMMAnimationCurveLinear ,
- MMMAnimationCurveEaseOut ,
- MMMAnimationCurveEaseIn ,
- MMMAnimationCurveEaseInOut ,
-
- // "Softer" versions are closer to the linear curve.
- MMMAnimationCurveSofterEaseIn ,
- MMMAnimationCurveSofterEaseOut ,
- MMMAnimationCurveSofterEaseInOut ,
-
- // Quad animations (e.g. https://easings.net/#easeInQuad)
- MMMAnimationCurveEaseInQuad ,
- MMMAnimationCurveEaseOutQuad ,
- MMMAnimationCurveEaseInOutQuad ,
-
- // Cubic animations (e.g. https://easings.net/#easeInCubic)
- MMMAnimationCurveEaseInCubic ,
- MMMAnimationCurveEaseOutCubic ,
- MMMAnimationCurveEaseInOutCubic ,
-
- // Quart animations (e.g. https://easings.net/#easeInQuart)
- MMMAnimationCurveEaseInQuart ,
- MMMAnimationCurveEaseOutQuart ,
- MMMAnimationCurveEaseInOutQuart ,
-
- // Quint animations (e.g. https://easings.net/#easeInQuint)
- MMMAnimationCurveEaseInQuint ,
- MMMAnimationCurveEaseOutQuint ,
- MMMAnimationCurveEaseInOutQuint
-}
-
-
-
-
Swift
-
enum MMMAnimationCurve : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveLinear
-
-
-
-
Swift
-
case linear = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOut
-
-
-
-
Swift
-
case easeOut = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseIn
-
-
-
-
Swift
-
case easeIn = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOut
-
-
-
-
Swift
-
case easeInOut = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveSofterEaseIn
-
-
-
-
Swift
-
case softerEaseIn = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveSofterEaseOut
-
-
-
-
Swift
-
case softerEaseOut = 5
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveSofterEaseInOut
-
-
-
-
Swift
-
case softerEaseInOut = 6
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInQuad
-
-
-
-
Swift
-
case easeInQuad = 7
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutQuad
-
-
-
-
Swift
-
case easeOutQuad = 8
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutQuad
-
-
-
-
Swift
-
case easeInOutQuad = 9
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInCubic
-
-
-
-
Swift
-
case easeInCubic = 10
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutCubic
-
-
-
-
Swift
-
case easeOutCubic = 11
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutCubic
-
-
-
-
Swift
-
case easeInOutCubic = 12
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInQuart
-
-
-
-
Swift
-
case easeInQuart = 13
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutQuart
-
-
-
-
Swift
-
case easeOutQuart = 14
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutQuart
-
-
-
-
Swift
-
case easeInOutQuart = 15
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInQuint
-
-
-
-
Swift
-
case easeInQuint = 16
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutQuint
-
-
-
-
Swift
-
case easeOutQuint = 17
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutQuint
-
-
-
-
Swift
-
case easeInOutQuint = 18
-
-
-
-
-
-
-
-
-
-
MMMLayoutAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutAlignment
-
-
-
Objective-C
-
enum MMMLayoutAlignment : NSInteger {}
-
-
-
-
Swift
-
enum MMMLayoutAlignment : Int , @unchecked Sendable
-
-
-
-
General alignment flags used when it’s not important which direction (vertical or horizontal) the alignment is for.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentNone
-
-
-
-
Swift
-
case none = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentLeading
-
-
-
-
Swift
-
case leading = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentGolden
-
-
-
-
Swift
-
case golden = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentCenter
-
-
-
-
Swift
-
case center = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentTrailing
-
-
-
-
Swift
-
case trailing = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentFill
-
-
-
-
Swift
-
case fill = 5
-
-
-
-
-
-
-
-
-
-
MMMLayoutDirection Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutDirection
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutDirection ) {
- MMMLayoutDirectionHorizontal ,
- MMMLayoutDirectionVertical
-}
-
-
-
-
Swift
-
enum MMMLayoutDirection : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutDirectionHorizontal
-
-
-
-
Swift
-
case horizontal = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutDirectionVertical
-
-
-
-
Swift
-
case vertical = 1
-
-
-
-
-
-
-
-
-
-
MMMLayoutHorizontalAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutHorizontalAlignment
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutHorizontalAlignment ) {
- MMMLayoutHorizontalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutHorizontalAlignmentLeft = MMMLayoutAlignmentLeading ,
- MMMLayoutHorizontalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutHorizontalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutHorizontalAlignmentRight = MMMLayoutAlignmentTrailing ,
- MMMLayoutHorizontalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutHorizontalAlignment : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentNone = MMMLayoutAlignmentNone
-
-
-
-
Swift
-
case none = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentLeft = MMMLayoutAlignmentLeading
-
-
-
-
Swift
-
case left = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentGolden = MMMLayoutAlignmentGolden
-
-
-
-
Swift
-
case golden = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentCenter = MMMLayoutAlignmentCenter
-
-
-
-
Swift
-
case center = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentRight = MMMLayoutAlignmentTrailing
-
-
-
-
Swift
-
case right = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentFill = MMMLayoutAlignmentFill
-
-
-
-
Swift
-
case fill = 5
-
-
-
-
-
-
-
-
-
-
MMMLayoutVerticalAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutVerticalAlignment
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutVerticalAlignment ) {
- MMMLayoutVerticalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutVerticalAlignmentTop = MMMLayoutAlignmentLeading ,
- MMMLayoutVerticalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutVerticalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutVerticalAlignmentBottom = MMMLayoutAlignmentTrailing ,
- MMMLayoutVerticalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutVerticalAlignment : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentNone = MMMLayoutAlignmentNone
-
-
-
-
Swift
-
case none = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentTop = MMMLayoutAlignmentLeading
-
-
-
-
Swift
-
case top = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentGolden = MMMLayoutAlignmentGolden
-
-
-
-
Swift
-
case golden = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentCenter = MMMLayoutAlignmentCenter
-
-
-
-
Swift
-
case center = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentBottom = MMMLayoutAlignmentTrailing
-
-
-
-
Swift
-
case bottom = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentFill = MMMLayoutAlignmentFill
-
-
-
-
Swift
-
case fill = 5
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowAlignment
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMScrollViewShadowAlignment ) {
- MMMScrollViewShadowAlignmentTop ,
- MMMScrollViewShadowAlignmentBottom
-}
-
-
-
-
Swift
-
enum MMMScrollViewShadowAlignment : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMScrollViewShadowAlignmentTop
-
-
-
-
Swift
-
case top = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMScrollViewShadowAlignmentBottom
-
-
-
-
Swift
-
case bottom = 1
-
-
-
-
-
-
-
-
-
-
Functions Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Functions
-
The following functions are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Suppose you need to contrain a view so its center divides its container in certain ratio different from 1:1
- (e.g. golden section):
-
-
┌─────────┐ ◆
- │ │ │
- │ │ │ a
- │┌───────┐│ │
- ─│┼ ─ ─ ─ ┼│─◆ ratio = a / b
- │└───────┘│ │
- │ │ │
- │ │ │
- │ │ │ b
- │ │ │
- │ │ │
- │ │ │
- └─────────┘ ◆
-
-
You cannot put this ratio directly into the multiplier parameter of the corresponding NSLayoutConstraints relating
- the centers of the views, because the multiplier would be the ratio between the distance to the center
- of the view (h) and the distance to the center of the container (H) instead:
-
-
◆ ┌─────────┐ ◆
- │ │ │ │
- │ │ │ │ a = h
- H │ │┌───────┐│ │
- │ │├ ─ ─ ─ ┼│─◆ multiplier = h / H
- │ │└───────┘│ │ ratio = a / b = h / (2 * H - h)
- ◆─│─ ─ ─ ─ ─│ │
- │ │ │
- │ │ │ b = 2 * H - h
- │ │ │
- │ │ │
- │ │ │
- └─────────┘ ◆
-
-
I.e. the multiplier is h / H (assuming the view is the first in the definition of the constraint),
- but the ratio we are interested would be h / (2 * H - h) if expressed in the distances to centers.
-
-
If you have a desired ratio and want to get a multiplier, which when applied, results in the layout dividing
- the container in this ratio, then you can use this function as shortcut.
-
-
Detailed calculations:
- ratio = h / (2 * H - h) ==> 2 * H * ratio - h * ratio = h ==> 2 * H * ratio / h - ratio = 1
- ==> 1 + ratio = 2 * H * ratio / h ==> (1 + ratio) / (2 * ratio) = H / h
- where H / h is the inverse of our multiplier, so the actual multiplier is (2 * ratio) / (1 + ratio).
-
-
-
Declaration
-
-
Objective-C
-
static inline CGFloat MMMCenterMultiplierForRatio ( CGFloat ratio )
-
-
-
-
Swift
-
class func centerMultiplier ( forRatio ratio : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Animation curve opposite to the given one, e.g. EaseIn for EaseOut.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A dictionary built from UIEdgeInsets suitable for AutoLayout metrics.
-The dictionary will have 4 values under the keys named “Top”, “Left”, “Bottom”, “Right”.
-
-
-
Declaration
-
-
Objective-C
-
extern NSDictionary < NSString * , NSNumber *>
- * _Nonnull MMMDictionaryFromUIEdgeInsets ( NSString * _Nonnull prefix ,
- UIEdgeInsets insets )
-
-
-
-
Swift
-
func MMMDictionaryFromUIEdgeInsets ( _ prefix : String , _ insets : UIEdgeInsets ) -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
Protocols Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Protocols
-
The following protocols are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Protocol for entities able to fulfill in-app navigation requests.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMNavigationHandler < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationHandler : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
This is the delegate corresponding to each navigation item in the stack.
-Its main purpose is to be able to handle popping of the corresponding navigation item.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMNavigationStackItemDelegate < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItemDelegate : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
A token corresponding to a single node (item) of the current UI navigation path.
-Note that a reference to the token must be stored somewhere or the corresponding item will be popped right away.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMNavigationStackItem < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItem : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
A view supporting this will be notified when one of the child views indicates potential changes in its contents
-that might influence its size via mmm_setPreferredSizeCouldChange.
-
-
This is handy with views that do not fully rely on Auto Layout, like UITableView,
-where a change in the size of a cell would require it to reload this cell.
-
-
The implementation is responsible for coalescing notification and avoiding notification loops.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMPreferredSizeChanges < NSObject >
-
-
-
-
Swift
-
protocol MMMPreferredSizeChanges : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
Something that converts dimensions given for one size class (e.g. font sizes from the design made for iPhone 6)
- into dimensions for another size class (e.g. font size for iPhone 5 that were not explicitely mentioned in the design).
-
-
Different converters can be used for different kinds of values. For example, it might make sense to scale paddings
- proportionally to screen widths, but keep font sizes the same.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMStylesheetConverter < NSObject >
-
-
-
-
Swift
-
protocol MMMStylesheetConverter : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
MMMNavigationHandler Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationHandler
-
-
-
Objective-C
-
@protocol MMMNavigationHandler < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationHandler : NSObjectProtocol
-
-
-
-
Protocol for entities able to fulfill in-app navigation requests.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Returns NO, in case the handler is unable to perform the given request. (Another handler will be tried then.)
-Returns YES, if the request has been accepted by the handler.
-The handler must call -didFinishSuccessfully: when it’s done performing the request.
-
-
-
-
-
-
-
-
-
MMMNavigationStackItem Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStackItem
-
-
-
Objective-C
-
@protocol MMMNavigationStackItem < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItem : NSObjectProtocol
-
-
-
-
A token corresponding to a single node (item) of the current UI navigation path.
-Note that a reference to the token must be stored somewhere or the corresponding item will be popped right away.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Should be called by the item’s delegate when the navigation item has been popped as a result of user’s action
-and must be called when MMMNavigationStack calling popNavigationStackItem of the corresponding delegate.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) didPop ;
-
-
-
-
Swift
-
func didPop ()
-
-
-
-
-
-
-
-
-
-
-
-
Should be called by the navigation item’s delegate in rare caes when the corresponding item cannot be popped.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) didFailToPop ;
-
-
-
-
Swift
-
func didFailToPop ()
-
-
-
-
-
-
-
-
-
-
-
-
Pops all the items currently on the stack above this item, so this one becomes the top. This is an asynchronous operation
- because it might involving several navigation steps.
-
-
Returns YES, if the request to pop was accepted for execution; NO otherwise. The latter means programmers error (such as
- popping while another pop is in progress) and will terminate the app when assertions are enabled.
-
-
Note that the completion handler is executed only if the request has been accepted.
-
-
-
-
-
-
-
-
-
MMMNavigationStackItemDelegate Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStackItemDelegate
-
-
-
Objective-C
-
@protocol MMMNavigationStackItemDelegate < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItemDelegate : NSObjectProtocol
-
-
-
-
This is the delegate corresponding to each navigation item in the stack.
-Its main purpose is to be able to handle popping of the corresponding navigation item.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Should perform all the work necessary to pop the corresponding UI navigation item and must call didPop method
- on the corresponding item when done.
-
-
Note that when the delegate is asked to pop, then all the items on top of it in the stack have been popped already,
- so the delegate should not ask the stack to do it. In fact asking for it and waiting for completion might freeze the popping
- process as pop completion callbacks are called only after all the whole popping process completes.
-
-
-
-
-
-
-
-
-
MMMPreferredSizeChanges Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMPreferredSizeChanges
-
-
-
Objective-C
-
@protocol MMMPreferredSizeChanges < NSObject >
-
-
-
-
Swift
-
protocol MMMPreferredSizeChanges : NSObjectProtocol
-
-
-
-
A view supporting this will be notified when one of the child views indicates potential changes in its contents
-that might influence its size via mmm_setPreferredSizeCouldChange.
-
-
This is handy with views that do not fully rely on Auto Layout, like UITableView,
-where a change in the size of a cell would require it to reload this cell.
-
-
The implementation is responsible for coalescing notification and avoiding notification loops.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_preferredSizeCouldChangeForSubview :( UIView * ) subview ;
-
-
-
-
Swift
-
func mmm_preferredSizeCouldChange ( forSubview subview : UIView )
-
-
-
-
-
-
-
-
-
-
MMMStylesheetConverter Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStylesheetConverter
-
-
-
Objective-C
-
@protocol MMMStylesheetConverter < NSObject >
-
-
-
-
Swift
-
protocol MMMStylesheetConverter : NSObjectProtocol
-
-
-
-
Something that converts dimensions given for one size class (e.g. font sizes from the design made for iPhone 6)
- into dimensions for another size class (e.g. font size for iPhone 5 that were not explicitely mentioned in the design).
-
-
Different converters can be used for different kinds of values. For example, it might make sense to scale paddings
- proportionally to screen widths, but keep font sizes the same.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Converts a dimension know for certain size class according to the rules of the converter.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) convertFloat :( CGFloat ) value
- fromSizeClass :( nonnull NSString * ) sourceSizeClass ;
-
-
-
-
Swift
-
func convert ( _ value : CGFloat , fromSizeClass sourceSizeClass : String ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
Type Definitions Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Type Definitions
-
The following type definitions are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef id MMMNavigationRequestId
-
-
-
-
Swift
-
typealias MMMNavigationRequestId = AnyObject
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMNavigationCompletionBlock )( MMMNavigationRequestId requestId , BOOL finished )
-
-
-
-
Swift
-
typealias MMMNavigationCompletionBlock = ( Any , Bool ) -> Void
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef id MMMNavigationHandlerId
-
-
-
-
Swift
-
typealias MMMNavigationHandlerId = AnyObject
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMNavigationStackCompletion )( BOOL success )
-
-
-
-
Swift
-
typealias MMMNavigationStackCompletion = ( Bool ) -> Void
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ _Nonnull MMMShadowViewSettingBlock
-
-
-
-
-
-
-
-
-
-
-
-
-
Called on every update cycle of MMMAnimator for the given animation item.
-
-
The time is always within [0; 1] range here, which will correspond to the the [start; start + duration] interval of
- real time clock.
-
-
Unless the item is cancelled it is guaranteed that the block will be called for 0 and 1 values.
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMAnimatorUpdateBlock )( MMMAnimationHandle * _Nonnull , CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
-
Called when the animation item has been finished.
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMAnimatorDoneBlock )( MMMAnimationHandle * _Nonnull , BOOL )
-
-
-
-
-
-
-
-
-
-
-
+
-
@@ -18,11 +18,11 @@
documentation
-
- 50%
+
+ 0%
-
- 50%
+
+ 0%
diff --git a/docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories.html b/docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories.html
deleted file mode 100644
index 2a6fb0c..0000000
--- a/docsets/MMMCommonUI.docset/Contents/Resources/Documents/Categories.html
+++ /dev/null
@@ -1,538 +0,0 @@
-
-
-
- Categories Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Categories
-
The following categories are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@interface UIView ( MMMPreferredSizeChanges )
-
-/// Signals to one of the interested parent views (supporting `MMMPreferredSizeChanges`)
-/// that the size of this view could have potentially changed and they should measure things again.
-///
-/// This helps with containers that do not primarily rely on Auto Layout, like UITableView.
- - ( void ) mmm_setPreferredSizeCouldChange ;
-
-@end
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@interface UILayoutGuide ( MMMTemple )
-
-/// Convenience initializer setting the guide's identifier.
- - ( id ) initWithIdentifier :( NSString * ) identifier ;
-
-/**
- * Not yet activated constraints anchoring the given view within the receiver according to horizontal
- * and vertical alignment flags.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) view
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-/**
- * Not yet activated constraints implementing a common layout idiom used with text:
- * - the given view is centered within the receiver,
- * - certain minimum padding is ensured on the sides,
- * - if `maxWidth > 0`, then the width of the view is limited to `maxWidth`, so it does not grow too wide e.g. on iPad.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsHorizontallyCenteringView :( UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth NS_SWIFT_NAME ( mmm_constraints ( horizontallyCentering : minPadding : maxWidth : ));
-
-@end
-
-
-
-
-
-
-
-
-
-
-
-
A few shorthands for UIView.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface UIView ( MMMTemple )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@interface NSLayoutConstraint ( MMMTemple )
-
-/**
- * Our wrapper over the corresponding method of NSLayoutConstraint extending the visual layout language a bit to support
- * `safeAreaLayoutGuide` property introduced in iOS 11 and still be compatible with older versions of iOS.
- * (See also `mmm_safeAreaLayoutGuide` in our extension of UIView.)
- *
- * To use it simply replace a reference to the superview edge "|" with a reference to a safe edge "<|".
- *
- * For example, if you have the following pre iOS 9 code:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * And now you want to make sure that the button sits above the safe bottom margin on iPhone X, then do this:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * mmm_constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-<|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * That's it. It'll anchor the button to the bottom of its superview on iOS 9 and 10, but anchor it to the bottom of
- * its safeAreaLayoutGuide on iOS 11.
- *
- * Please note that using "|>" to pin to the top won't exclude the status bar on iOS 9 and 10.
- */
-+ ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** A shortcut for `[NSLayoutConstraint activateConstraints:[NSLayoutConstraint mmm_constraintsWithVisualFormat:...`. */
-+ ( void ) mmm_activateConstraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** Missing counterparts for (de)activateConstraints, so constraint activation code looks the same for individual constraints. */
-+ ( void ) activateConstraint :( NSLayoutConstraint * ) constraint ;
-+ ( void ) deactivateConstraint :( NSLayoutConstraint * ) constraint ;
-
-/** A missing convenience initializer including priority. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority ;
-
-/** A missing convenience initializer allowing to set identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to set both priority and identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to tag a bunch of visual constraints with the same identifier. */
-+ ( NSArray < __kindof NSLayoutConstraint *> * ) constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views
- identifier :( NSString * ) identifier DEPRECATED_ATTRIBUTE ;
-
-@end
-
-
-
-
-
-
-
-
-
-
NSLayoutConstraint(MMMTemple) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
NSLayoutConstraint(MMMTemple)
-
-
-
-
@interface NSLayoutConstraint ( MMMTemple )
-
-/**
- * Our wrapper over the corresponding method of NSLayoutConstraint extending the visual layout language a bit to support
- * `safeAreaLayoutGuide` property introduced in iOS 11 and still be compatible with older versions of iOS.
- * (See also `mmm_safeAreaLayoutGuide` in our extension of UIView.)
- *
- * To use it simply replace a reference to the superview edge "|" with a reference to a safe edge "<|".
- *
- * For example, if you have the following pre iOS 9 code:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * And now you want to make sure that the button sits above the safe bottom margin on iPhone X, then do this:
- *
- * \code
- * [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- * mmm_constraintsWithVisualFormat:@"V:[_button]-(normalPadding)-<|"
- * options:0 metrics:metrics views:views
- * ]];
- * \endcode
- *
- * That's it. It'll anchor the button to the bottom of its superview on iOS 9 and 10, but anchor it to the bottom of
- * its safeAreaLayoutGuide on iOS 11.
- *
- * Please note that using "|>" to pin to the top won't exclude the status bar on iOS 9 and 10.
- */
-+ ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** A shortcut for `[NSLayoutConstraint activateConstraints:[NSLayoutConstraint mmm_constraintsWithVisualFormat:...`. */
-+ ( void ) mmm_activateConstraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views ;
-
-/** Missing counterparts for (de)activateConstraints, so constraint activation code looks the same for individual constraints. */
-+ ( void ) activateConstraint :( NSLayoutConstraint * ) constraint ;
-+ ( void ) deactivateConstraint :( NSLayoutConstraint * ) constraint ;
-
-/** A missing convenience initializer including priority. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority ;
-
-/** A missing convenience initializer allowing to set identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to set both priority and identifier for this constraint. */
-+ ( instancetype ) constraintWithItem :( id ) view1 attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2 attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority
- identifier :( NSString * ) identifier ;
-
-/** A missing convenience initializer allowing to tag a bunch of visual constraints with the same identifier. */
-+ ( NSArray < __kindof NSLayoutConstraint *> * ) constraintsWithVisualFormat :( NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views
- identifier :( NSString * ) identifier DEPRECATED_ATTRIBUTE ;
-
-@end
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Our wrapper over the corresponding method of NSLayoutConstraint extending the visual layout language a bit to support
- safeAreaLayoutGuide property introduced in iOS 11 and still be compatible with older versions of iOS.
- (See also mmm_safeAreaLayoutGuide in our extension of UIView.)
-
-
To use it simply replace a reference to the superview edge “|” with a reference to a safe edge “<|”.
-
-
For example, if you have the following pre iOS 9 code:
-
-
\code
- [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- constraintsWithVisualFormat:@“V:[_button]-(normalPadding)-|”
- options:0 metrics:metrics views:views
- ]];
- \endcode
-
-
And now you want to make sure that the button sits above the safe bottom margin on iPhone X, then do this:
-
-
\code
- [NSLayoutConstraint activateConstraints:[NSLayoutConstraint
- mmm_constraintsWithVisualFormat:@“V:[_button]-(normalPadding)-<|”
- options:0 metrics:metrics views:views
- ]];
- \endcode
-
-
That’s it. It’ll anchor the button to the bottom of its superview on iOS 9 and 10, but anchor it to the bottom of
- its safeAreaLayoutGuide on iOS 11.
-
-
Please note that using “|>” to pin to the top won’t exclude the status bar on iOS 9 and 10.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsWithVisualFormat :( nonnull NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :
- ( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * )
- views ;
-
-
-
-
Swift
-
class func mmm_constraints ( withVisualFormat format : String , options opts : NSLayoutConstraint . FormatOptions = [], metrics : [ String : Any ]?, views : [ String : Any ]?) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut for [NSLayoutConstraint activateConstraints:[NSLayoutConstraint mmm_constraintsWithVisualFormat:....
-
-
-
Declaration
-
-
Objective-C
-
+ ( void )
- mmm_activateConstraintsWithVisualFormat :( nonnull NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * ,
- id > * ) metrics
- views : ( nullable NSDictionary < NSString * ,
- id > * ) views ;
-
-
-
-
Swift
-
class func mmm_activateConstraints ( withVisualFormat format : String , options opts : NSLayoutConstraint . FormatOptions = [], metrics : [ String : Any ]?, views : [ String : Any ]?)
-
-
-
-
-
-
-
-
-
-
-
-
Missing counterparts for (de)activateConstraints, so constraint activation code looks the same for individual constraints.
-
-
-
Declaration
-
-
Objective-C
-
+ ( void ) activateConstraint :( nonnull NSLayoutConstraint * ) constraint ;
-
-
-
-
Swift
-
class func activate ( _ constraint : NSLayoutConstraint )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( void ) deactivateConstraint :( NSLayoutConstraint * ) constraint ;
-
-
-
-
Swift
-
class func deactivate ( _ constraint : NSLayoutConstraint )
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer including priority.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull instancetype ) constraintWithItem :( nonnull id ) view1
- attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2
- attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier
- constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
convenience init ( item view1 : Any , attribute attr1 : NSLayoutConstraint . Attribute , relatedBy relation : NSLayoutConstraint . Relation , toItem view2 : Any ?, attribute attr2 : NSLayoutConstraint . Attribute , multiplier : CGFloat , constant c : CGFloat , priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer allowing to set identifier for this constraint.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull instancetype ) constraintWithItem :( nonnull id ) view1
- attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2
- attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier
- constant :( CGFloat ) c
- identifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
convenience init ( item view1 : Any , attribute attr1 : NSLayoutConstraint . Attribute , relatedBy relation : NSLayoutConstraint . Relation , toItem view2 : Any ?, attribute attr2 : NSLayoutConstraint . Attribute , multiplier : CGFloat , constant c : CGFloat , identifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer allowing to set both priority and identifier for this constraint.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull instancetype ) constraintWithItem :( nonnull id ) view1
- attribute :( NSLayoutAttribute ) attr1
- relatedBy :( NSLayoutRelation ) relation
- toItem :( nullable id ) view2
- attribute :( NSLayoutAttribute ) attr2
- multiplier :( CGFloat ) multiplier
- constant :( CGFloat ) c
- priority :( UILayoutPriority ) priority
- identifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
convenience init ( item view1 : Any , attribute attr1 : NSLayoutConstraint . Attribute , relatedBy relation : NSLayoutConstraint . Relation , toItem view2 : Any ?, attribute attr2 : NSLayoutConstraint . Attribute , multiplier : CGFloat , constant c : CGFloat , priority : UILayoutPriority , identifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
A missing convenience initializer allowing to tag a bunch of visual constraints with the same identifier.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull NSArray < __kindof NSLayoutConstraint *> * )
- constraintsWithVisualFormat :( nonnull NSString * ) format
- options :( NSLayoutFormatOptions ) opts
- metrics :( nullable NSDictionary < NSString * , id > * ) metrics
- views :( nullable NSDictionary < NSString * , id > * ) views
- identifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
class func constraints ( withVisualFormat format : String , options opts : NSLayoutConstraint . FormatOptions = [], metrics : [ String : Any ]?, views : [ String : Any ]?, identifier : String ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
UILayoutGuide(MMMTemple) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
UILayoutGuide(MMMTemple)
-
-
-
-
@interface UILayoutGuide ( MMMTemple )
-
-/// Convenience initializer setting the guide's identifier.
- - ( id ) initWithIdentifier :( NSString * ) identifier ;
-
-/**
- * Not yet activated constraints anchoring the given view within the receiver according to horizontal
- * and vertical alignment flags.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) view
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-/**
- * Not yet activated constraints implementing a common layout idiom used with text:
- * - the given view is centered within the receiver,
- * - certain minimum padding is ensured on the sides,
- * - if `maxWidth > 0`, then the width of the view is limited to `maxWidth`, so it does not grow too wide e.g. on iPad.
- */
-- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsHorizontallyCenteringView :( UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth NS_SWIFT_NAME ( mmm_constraints ( horizontallyCentering : minPadding : maxWidth : ));
-
-@end
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer setting the guide’s identifier.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithIdentifier :( nonnull NSString * ) identifier ;
-
-
-
-
Swift
-
init ( identifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
Not yet activated constraints anchoring the given view within the receiver according to horizontal
-and vertical alignment flags.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsAligningView :( nonnull UIView * ) view
- horizontally :
- ( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-
-
-
-
-
-
-
-
-
-
-
-
Not yet activated constraints implementing a common layout idiom used with text:
-
-
-the given view is centered within the receiver,
-certain minimum padding is ensured on the sides,
-if maxWidth > 0, then the width of the view is limited to maxWidth, so it does not grow too wide e.g. on iPad.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth ;
-
-
-
-
Swift
-
func mmm_constraints ( horizontallyCentering view : UIView , minPadding : CGFloat , maxWidth : CGFloat ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
UIView(MMMPreferredSizeChanges) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
UIView(MMMPreferredSizeChanges)
-
-
-
-
@interface UIView ( MMMPreferredSizeChanges )
-
-/// Signals to one of the interested parent views (supporting `MMMPreferredSizeChanges`)
-/// that the size of this view could have potentially changed and they should measure things again.
-///
-/// This helps with containers that do not primarily rely on Auto Layout, like UITableView.
- - ( void ) mmm_setPreferredSizeCouldChange ;
-
-@end
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Signals to one of the interested parent views (supporting MMMPreferredSizeChanges
-
-
This helps with containers that do not primarily rely on Auto Layout, like UITableView.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setPreferredSizeCouldChange ;
-
-
-
-
Swift
-
func mmm_setPreferredSizeCouldChange ()
-
-
-
-
-
-
-
-
-
-
UIView(MMMTemple) Category Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
UIView(MMMTemple)
-
-
-
-
@interface UIView ( MMMTemple )
-
-
-
-
A few shorthands for UIView.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A wrapper for the center and bounds.size properties similar to ‘frame’, but not taking the current transform into account.
-
-
-Handy when there is a transform applied to a view already, but we want to set its frame in normal state.
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , setter = mmm_setRect : ) CGRect mmm_rect ;
-
-
-
-
Swift
-
var mmm_rect : CGRect { get set }
-
-
-
-
-
-
-
-
-
-
-
-
A wrapper for the size component of bounds property.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , setter = mmm_setSize : ) CGSize mmm_size ;
-
-
-
-
Swift
-
var mmm_size : CGSize { get set }
-
-
-
-
-
-
-
-
-
-
-
-
A safer version of safeAreaLayoutGuide that attempts to avoid layout loops happening when a view using it
-
-
-is transformed in certain “inconvenient” way. (Apple Feedback ID: FB7609936.)
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UILayoutGuide * _Nonnull mmm_safeAreaLayoutGuide ;
-
-
-
-
Swift
-
var mmm_safeAreaLayoutGuide : UILayoutGuide { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIEdgeInsets mmm_safeAreaInsets ;
-
-
-
-
Swift
-
var mmm_safeAreaInsets : UIEdgeInsets { get }
-
-
-
-
-
-
-
-
-
-
-
-
Constraints anchoring the given view within the receiver according to horizontal and vertical alignment flags.
-Note that constrains are not added into the reciever automatically.
-It is recommended to use this method instead of the mmm_addConstraintsForSubview:* bunch.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsAligningView :( nonnull UIView * ) subview
- horizontally :
- ( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) subview
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_constraintsAligningView ( _ subview : UIView , horizontally horizontalAlignment : MMMLayoutHorizontalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningView :( UIView * ) subview
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_constraintsAligningView ( _ subview : UIView , vertically verticalAlignment : MMMLayoutVerticalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_constraintsAligningGuide :( UILayoutGuide * ) guide
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets NS_SWIFT_NAME ( mmm_constraints ( aligning : horizontally : vertically : insets : ));
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds contraints anchoring the given view within the receiver according to horizontal and vertical alignment flags.
-(This is a shortcut for calling mmm_constraintsAligningView:horizontally:vertically:insets: and adding the contraints returned.)
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_addConstraintsAligningView :( nonnull UIView * ) subview
- horizontally :
- ( MMMLayoutHorizontalAlignment ) horizontalAlignment
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_addConstraintsAligningView :( UIView * ) subview
- horizontally :( MMMLayoutHorizontalAlignment ) horizontalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_addConstraintsAligningView ( _ subview : UIView , horizontally horizontalAlignment : MMMLayoutHorizontalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_addConstraintsAligningView :( UIView * ) subview
- vertically :( MMMLayoutVerticalAlignment ) verticalAlignment DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_addConstraintsAligningView ( _ subview : UIView , vertically verticalAlignment : MMMLayoutVerticalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
Not yet activated constraints implementing a common layout idiom used with text:
-
-
-the given view is centered within the receiver,
-certain minimum padding is ensured on the sides,
-if maxWidth > 0, then the width of the view is limited to maxWidth, so it does not grow too wide e.g. on iPad.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_constraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth ;
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut activating constraints returned by mmm_constraintsHorizontallyCenteringView:minPadding:maxWidth:.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addConstraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding
- maxWidth :( CGFloat ) maxWidth ;
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut activating constraints returned by mmm_constraintsHorizontallyCenteringView:minPadding:maxWidth:
-
-
-setting maxWidth to zero.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addConstraintsHorizontallyCenteringView :( nonnull UIView * ) view
- minPadding :( CGFloat ) minPadding ;
-
-
-
-
-
-
-
-
-
-
-
-
-
To be deprecated soon
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds constraints anchoring the given subview within the receiver according to horizontal and vertical alignment flags.
-The constraints are also returned, so the caller can remove them later, for example.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSArray < NSLayoutConstraint *> * )
- mmm_addConstraintsForSubview :( nonnull UIView * ) subview
- horizontalAlignment :
- ( UIControlContentHorizontalAlignment ) horizontalAlignment
- verticalAlignment :
- ( UIControlContentVerticalAlignment ) verticalAlignment
- insets :( UIEdgeInsets ) insets ;
-
-
-
-
Swift
-
func mmm_addConstraints ( forSubview subview : UIView , horizontalAlignment : UIControl . ContentHorizontalAlignment , verticalAlignment : UIControl . ContentVerticalAlignment , insets : UIEdgeInsets ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( NSArray < NSLayoutConstraint *> * ) mmm_addConstraintsForSubview :( UIView * ) subview
- horizontalAlignment :( UIControlContentHorizontalAlignment ) horizontalAlignment
- verticalAlignment :( UIControlContentVerticalAlignment ) verticalAlignment
- DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_addConstraints ( forSubview subview : UIView , horizontalAlignment : UIControl . ContentHorizontalAlignment , verticalAlignment : UIControl . ContentVerticalAlignment ) -> [ NSLayoutConstraint ]
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds constraints and two hidden auxiliary views ensuring that the space between the top of the subview and
- topAttribute of topItem is in ‘ratio’ proportion to the space between the bottom of the subview
- and bottomAttribute of bottomItem.
-
-
To be clear:
- ratio = (top space) / (bottom space)
-
-
So you need to use 1 when you want the same size, not 0.5, for example.
-
-
The given priority will be used for the constraints between the heights of the aux views.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addVerticalSpaceRatioConstraintsForSubview :( nonnull UIView * ) subview
- topItem :( nonnull id ) topItem
- topAttribute :
- ( NSLayoutAttribute ) topAttribute
- bottomItem :( nonnull id ) bottomItem
- bottomAttribute :
- ( NSLayoutAttribute ) bottomAttribute
- ratio :( CGFloat ) ratio
- priority :
- ( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_addVerticalSpaceRatioConstraints ( forSubview subview : UIView , topItem : Any , topAttribute : NSLayoutConstraint . Attribute , bottomItem : Any , bottomAttribute : NSLayoutConstraint . Attribute , ratio : CGFloat , priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addVerticalSpaceRatioConstraintsForSubview :( UIView * ) subview
- topItem :( id ) topItem topAttribute :( NSLayoutAttribute ) topAttribute
- bottomItem :( id ) bottomItem bottomAttribute :( NSLayoutAttribute ) bottomAttribute
- ratio :( CGFloat ) ratio ;
-
-
-
-
Swift
-
func mmm_addVerticalSpaceRatioConstraints ( forSubview subview : UIView , topItem : Any , topAttribute : NSLayoutConstraint . Attribute , bottomItem : Any , bottomAttribute : NSLayoutConstraint . Attribute , ratio : CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds constrains and a hidden auxiliary view ensuring that specified item / attribute vertically divides
-the subview in the specified ratio.
-Unlike the previous function the ratio here is given not as (top space / bottom space), but as
-(top space / (top space + bottom space)). Sorry for the confusion, deprecating this one for now.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_addVerticalSpaceRatioConstraintsForSubview :( nonnull UIView * ) subview
- item :( nonnull id ) item
- attribute :
- ( NSLayoutAttribute ) attribute
- ratio :( CGFloat ) ratio ;
-
-
-
-
Swift
-
func mmm_addVerticalSpaceRatioConstraints ( forSubview subview : UIView , item : Any , attribute : NSLayoutConstraint . Attribute , ratio : CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
Shortcuts for compression resistance and hugging priorities.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setVerticalCompressionResistance :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setVerticalCompressionResistance ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHorizontalCompressionResistance :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setHorizontalCompressionResistance ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setVerticalHuggingPriority :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setVerticalHuggingPriority ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHorizontalHuggingPriority :( UILayoutPriority ) priority ;
-
-
-
-
Swift
-
func mmm_setHorizontalHuggingPriority ( _ priority : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setVerticalCompressionResistance :( UILayoutPriority ) compressionResistance hugging :( UILayoutPriority ) hugging DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_setVerticalCompressionResistance ( _ compressionResistance : UILayoutPriority , hugging : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHorizontalCompressionResistance :( UILayoutPriority ) compressionResistance hugging :( UILayoutPriority ) hugging DEPRECATED_ATTRIBUTE ;
-
-
-
-
Swift
-
func mmm_setHorizontalCompressionResistance ( _ compressionResistance : UILayoutPriority , hugging : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setCompressionResistanceHorizontal :( UILayoutPriority ) horizontal
- vertical :( UILayoutPriority ) vertical NS_SWIFT_NAME ( mmm_setCompressionResistance ( horizontal : vertical : ));
-
-
-
-
Swift
-
func mmm_setCompressionResistance ( horizontal : UILayoutPriority , vertical : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_setHuggingHorizontal :( UILayoutPriority ) horizontal
- vertical :( UILayoutPriority ) vertical NS_SWIFT_NAME ( mmm_setHugging ( horizontal : vertical : ));
-
-
-
-
Swift
-
func mmm_setHugging ( horizontal : UILayoutPriority , vertical : UILayoutPriority )
-
-
-
-
-
-
-
-
-
-
Classes Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Classes
-
The following classes are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A base for table view cells redeclareing the designated initializer into the one we typically use,
-so subclasses do not have to.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMTableViewCell : UITableViewCell
-
-
-
-
Swift
-
class MMMTableViewCell : UITableViewCell
-
-
-
-
-
-
-
-
-
-
-
-
A simple table view cell wrapping the given view.
-
-
This is handy when you have a view already and just want to show it as one more cell.
-
-
The view being wrapped should support Auto Layout and inflate its height properly. The cell has its selectionStyle
- set to UITableViewCellSelectionStyleNone as these kind of cells typically do not appear selected.
-
-
See more
-
-
Declaration
-
-
-
Swift
-
class MMMViewWrappingCell < ViewType > : MMMTableViewCell where ViewType : AnyObject
-
-
-
-
-
-
-
-
-
-
-
-
A helper for adding top and bottom shadows into any UIScrollView-based class.
-You create an instance in your subclass and forward calls from layoutSubviews.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMScrollViewShadows : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadows : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Holds configuration for MMMScrollViewShadows that can be set only on initialization time.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMScrollViewShadowsSettings : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadowsSettings : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A view that’s used internally to render shadows in MMMAutoLayoutScrollView.
-Open for reuse in cases we want to display compatible shadows but differntly controlled.
-Note that this does not support Auto Layout, you have to manage its frame.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMScrollViewShadowView : UIView
-
-
-
-
Swift
-
class MMMScrollViewShadowView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Opening a deep link can involve following through one or more steps, for example:
-
-
1) make sure the main screen is visible and can switch between the pages;
- 2) move to the recipes page;
- 3) open recipe with ID N;
- 4) scroll to ingredients, etc.
-
-
This is a single step in such a chain.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationHop : NSObject
-
-
-
-
Swift
-
class MMMNavigationHop : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A navigation path is just a collection of one or more “hops”.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationPath : NSObject
-
-
-
-
Swift
-
class MMMNavigationPath : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Manages switching between different sections of the app (kind of internal URL router).
-It’s like a central hub accepting navigation requests and then passing them to the entities that able to perform them.
-(The entities that are able to open requests should register themselves as handlers.)
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigation : NSObject
-
-
-
-
Swift
-
class MMMNavigation : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Info about a navigation request that is passed to handlers.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationRequest : NSObject
-
-
-
-
Swift
-
class MMMNavigationRequest : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
This is to be used during development to stub not ready yet parts of the app.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStubViewController : UIViewController
-
-
-
-
Swift
-
class MMMStubViewController : UIViewController
-
-
-
-
-
-
-
-
-
-
-
-
A limited replacement for UIImageView fixing its inability to properly work with images having
- non-zero alignmentRectInsets when scaled.
-
-
Note that this view is already constrained to the aspect ratio of the image’s alignment rect,
- so you should not use hard (equal) pins against both width and height or against all edges.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMImageView : UIView
-
-
-
-
Swift
-
class MMMImageView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A vertical scroll view with a content view and preconfigured constraints, so there is no need in creating
- a scroll view / content view sandwitch manually every time.
-
-
It also supports top and bottom shadows that are displayed only when the content is clipped.
- The shadows can be enabled individually and they can sit either flush with the edges of the scroll view
- or can be inset according to adjustedContentInset, which can be handy when vertical safeAreaInsets need
- to be taken into account. (Note that contentInsetAdjustmentBehavior has to be either None or Always
- on this view since “automatic” options can lead to cyclic calculations.) Also note that scroll indicators
- are disabled here by default.
-
-
Begin by adding your controls and constraints into the contentView ensuring that its size can be derived from your
- constraints alone. Avoid constraints to the scroll view itself or outside views unless you are prepared to deal
- with the consequences.
-
-
Note that the width of the contentView will be constrainted hard to be equal to the width of the scroll view
- and its height will be constrained with prio 251 to be at least as large as the height of the scroll view.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
Swift
-
class MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
-
-
-
-
-
-
-
-
A subview of MMMAutoLayoutScrollView where all the subviews should be added.
-
-
-(It’s not different from UIView, but making it of its own class helps when browsing view hierarchies.)
-
-
-
-
Declaration
-
-
Objective-C
-
@interface MMMAutoLayoutScrollViewContentView : UIView
-
-
-
-
Swift
-
class MMMAutoLayoutScrollViewContentView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
To be used during development as a placeholder for not yet implemented views.
-It inherits a vertical scroll view so it’s possible to see that gesture recognizers of the container do not interfere
-with a typical scrolling.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStubView : UIScrollView
-
-
-
-
Swift
-
class MMMStubView : UIScrollView
-
-
-
-
-
-
-
-
-
-
-
-
This is to track the navigation state of the app and have the possibility to programmatically return to registered points of
- the navigation path. The actual navigation entities of the app (usually view controllers) must cooperate in order to
- achieve this.
-
-
The possibility to go back is needed to properly handle in-app links. We have a basic mechanism for this (MMMNavigation)
- which allows to “open” a part of a link and forward the remaining parts to the corresponding handler down the navigation tree.
- The handlers thus need to be able to “close” current navigation path before opening something new.
-
-
Although navigation in the app is better represented by a tree, we assume here that at least the current path in this tree
- can be represented as a stack. Each element of the stack can correspond to a modal view controller or alert view, for example,
- but it can also correspond to a special state of the app or a screen.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMNavigationStack : NSObject
-
-
-
-
Swift
-
class MMMNavigationStack : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A table view supporting top and bottom shadows.
-
-
See more
-
-
-
-
-
-
-
-
-
-
Holds configuration for MMMShadowView.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMShadowViewSetting : NSObject
-
-
-
-
Swift
-
class MMMShadowViewSetting : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Helper view for adding custom layer shadows, while taking the the shadow sizes in conserderation for its final frame.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMShadowView : UIView
-
-
-
-
Swift
-
class MMMShadowView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Auto Layout does not support constraints against groups of items, so this is for the cases a normal UIView is
-typically used as a container for such a group.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-Also MMMContainerView does not intercept touches but subviews still do.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMContainerView : UIView
-
-
-
-
Swift
-
class MMMContainerView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
This is to group a few simple layout helpers.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMLayoutUtils : NSObject
-
-
-
-
Swift
-
class MMMLayoutUtils : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
A little helper for velocity/acceleration calculations: you feed it values with timestamps and can get the most recent
-acceleration/velocity values.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMVelocityMeter : NSObject
-
-
-
-
Swift
-
class MMMVelocityMeter : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Minimalistic animation helpers.
-
-
Terminology:
-
-
-Normalized time — time value from the [0; 1] range.
-Curved time — normalized time transformed using one of the predefined animation curves.
-
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAnimation : NSObject
-
-
-
-
Swift
-
class MMMAnimation : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Minimalistic animator object in the spirit of helpers defined in MMMAnimation.
-
-
You add animation items, which are basically a set of blocks that will be called every frame on the main run loop and
- when it’s done or cancelled.
-
-
It’s not for every case, it’s for those moments when you know the duration in advance and just need to animate a
- simple custom property and don’t want to subclass CALayer or mess with its multithreaded delegates.
-
-
The animator object does not take care of interpolation of values nor time curves, the normalized time passed into
- update blocks can be transformed and values can be interpolated using simple helpers in MMMAnimation.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAnimator : NSObject
-
-
-
-
Swift
-
class MMMAnimator : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Sort of a handle returned by MMMAnimator when a new animation is scheduled.
-Keep it around, otherwise the animation will be cancelled.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAnimationHandle : NSObject
-
-
-
-
Swift
-
class MMMAnimationHandle : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Collection view supporting top & bottom shadows.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMCollectionView : UICollectionView
-
-
-
-
Swift
-
class MMMCollectionView : UICollectionView
-
-
-
-
-
-
-
-
-
-
-
-
Auto Layout does not support relationships between empty spaces, so we need to use spacer views and set such
-constraints between them. This one is a transparent and by default hidden view which can be used as such a spacer.
-It has no intrinsic size and low content hugging and compression resistance priorities.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMSpacerView : UIView
-
-
-
-
Swift
-
class MMMSpacerView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A container which lays out its subviews in certain direction one after another using fixed spacing between them.
-It also aligns all the items along the layout line according to the given alignment settings.
-Note that you must use setSubviews: method instead of feeding them one by one via addSubview:.
-This is kind of a UIStackView that we understand the internals of.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStackContainer : UIView
-
-
-
-
Swift
-
class MMMStackContainer : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Vertical version of MMMStackContainer.
-
-
See more
-
-
-
-
-
-
-
-
-
-
Horizontal version of MMMStackContainer.
-
-
See more
-
-
-
-
-
-
-
-
-
-
Wraps a view that uses Auto Layout into a manual layout view providing sizeThatFits: for the outside world.
-Can be handy with old APIs that do not fully support Auto Layout.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMAutoLayoutIsolator : UIView
-
-
-
-
Swift
-
class MMMAutoLayoutIsolator : UIView
-
-
-
-
-
-
-
-
-
-
-
-
Wraps a view padding it from all the sides.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMPaddedView : UIView
-
-
-
-
Swift
-
class MMMPaddedView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A view displaying a gradient from top to bottom. The linearity of the gradient can be controlled.
-Can be handy for shadow overlays, etc.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMVerticalGradientView : UIView
-
-
-
-
Swift
-
class MMMVerticalGradientView : UIView
-
-
-
-
-
-
-
-
-
-
-
-
A base for app-specific stylesheets: commonly used paddings, colors, fonts, etc in a single place.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@interface MMMStylesheet : NSObject
-
-
-
-
Swift
-
class MMMStylesheet : NSObject
-
-
-
-
-
-
-
-
-
-
-
-
Dimension converter that uses a table of scales.
-
-
See more
-
-
-
-
-
-
-
-
MMMAnimation Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimation
-
-
-
Objective-C
-
@interface MMMAnimation : NSObject
-
-
-
-
Swift
-
class MMMAnimation : NSObject
-
-
-
-
Minimalistic animation helpers.
-
-
Terminology:
-
-
-Normalized time — time value from the [0; 1] range.
-Curved time — normalized time transformed using one of the predefined animation curves.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Time obtained by curving the given normalized time (from [0; 1] range).
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) curvedTimeForTime :( CGFloat ) time curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func curvedTime ( forTime time : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Inverse function for curvedTimeForTime:curve:, i.e. when we know the value returned by curvedTimeForTime:curve:
-and want the time value passed there.
-This should be used sparingly (not every frame) as the implementation is no very efficient.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) timeForCurvedTime :( CGFloat ) time curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func time ( forCurvedTime time : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Time obtained by clamping the given time into [startTime; startTime + duration], normalizing to [0; 1] range,
-and then curving using a preset curve.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) curvedTimeForTime :( CGFloat ) t
- startTime :( CGFloat ) startTime
- duration :( CGFloat ) duration
- curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func curvedTime ( forTime t : CGFloat , startTime : CGFloat , duration : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
A float between ‘from’ and ‘to’ corresponding to already normalized and curved time.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) interpolateFrom :( CGFloat ) from to :( CGFloat ) to time :( CGFloat ) time ;
-
-
-
-
Swift
-
class func interpolate ( from : CGFloat , to : CGFloat , time : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
-
This has been renamed. Use the version above.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) interpolateFrom :( CGFloat ) from
- to :( CGFloat ) to
- curvedTime :( CGFloat ) time ;
-
-
-
-
Swift
-
class func interpolate ( from : CGFloat , to : CGFloat , curvedTime time : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Value between two floats corresponding to the given time and timing curve.
-If the time is less then startTime, then ‘from’ is returned.
-If the time is greater then startTime + duration, then ‘to’ is returned.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGFloat ) interpolateFrom :( CGFloat ) from
- to :( CGFloat ) to
- time :( CGFloat ) time
- startTime :( CGFloat ) startTime
- duration :( CGFloat ) duration
- curve :( MMMAnimationCurve ) curve ;
-
-
-
-
Swift
-
class func interpolate ( from : CGFloat , to : CGFloat , time : CGFloat , startTime : CGFloat , duration : CGFloat , curve : MMMAnimationCurve ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
A color between ‘from’ and ‘to’ corresponding to already normalized and curved time.
-Only RGB colors are supported.
-Interpolation is done along a straight line in the RGB space.
-
-
-
Declaration
-
-
Objective-C
-
+ ( nonnull UIColor * ) colorFrom :( nonnull UIColor * ) from
- to :( nonnull UIColor * ) to
- time :( CGFloat ) time ;
-
-
-
-
Swift
-
class func color ( from : UIColor , to : UIColor , time : CGFloat ) -> UIColor
-
-
-
-
-
-
-
-
-
-
-
-
A point on the line between given points corresponding to already normalized and curved time.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGPoint ) pointFrom :( CGPoint ) from to :( CGPoint ) to time :( CGFloat ) time ;
-
-
-
-
Swift
-
class func point ( from : CGPoint , to : CGPoint , time : CGFloat ) -> CGPoint
-
-
-
-
-
-
-
-
-
-
MMMAnimationHandle Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimationHandle
-
-
-
Objective-C
-
@interface MMMAnimationHandle : NSObject
-
-
-
-
Swift
-
class MMMAnimationHandle : NSObject
-
-
-
-
Sort of a handle returned by MMMAnimator when a new animation is scheduled.
-Keep it around, otherwise the animation will be cancelled.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
YES, if the animation has not been finished yet.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) BOOL inProgress ;
-
-
-
-
Swift
-
var inProgress : Bool { get }
-
-
-
-
-
-
-
-
-
-
-
-
Finishes animation before its designated end time.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) cancel ;
-
-
-
-
Swift
-
func cancel ()
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMAnimator Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimator
-
-
-
Objective-C
-
@interface MMMAnimator : NSObject
-
-
-
-
Swift
-
class MMMAnimator : NSObject
-
-
-
-
Minimalistic animator object in the spirit of helpers defined in MMMAnimation.
-
-
You add animation items, which are basically a set of blocks that will be called every frame on the main run loop and
- when it’s done or cancelled.
-
-
It’s not for every case, it’s for those moments when you know the duration in advance and just need to animate a
- simple custom property and don’t want to subclass CALayer or mess with its multithreaded delegates.
-
-
The animator object does not take care of interpolation of values nor time curves, the normalized time passed into
- update blocks can be transformed and values can be interpolated using simple helpers in MMMAnimation.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( instancetype ) shared ;
-
-
-
-
Swift
-
class func shared () -> Self
-
-
-
-
-
-
-
-
-
-
-
-
Schedules a new animation item.
-
-
The updateBlock is called on every update cycle within the animation’s duration. It is guaranteed to be called with
- zero time even if cancelled before the next run loop cycle. The update block is also guaranteed to be called with
- time being 1 unless is cancelled earlier.
-
-
The doneBlock is called after the animation finishes or is cancelled.
-
-
The repeatCount parameter can be set to 0 to mean infinite repeat count.
-
-
In case repeatCount is different from 1, then autoreverse influences the way the time changes when passed to
- the updateBlock: if YES, then it’ll grow from 0 to 1 and then from 1 to 0 on the next repeat, changing back to
- from 0 to 1 after this, etc; if NO, then it’ll always from from 0 to 1 on every repeat step.
-
-
The animation will start on the next cycle of the refresh timer and will have the timestamp of this cycle as its
- actual start time, so there is no need in explicit transactions: all animation added on the same run loop cycle are
- guaranteed to be run in sync.
-
-
Keep the object returned. The animation stops when the reference to this object is released.
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( MMMAnimationHandle * ) addAnimationWithDuration :( CGFloat ) duration
- repeatCount :( NSInteger ) repeatCount
- autoreverse :( BOOL ) autoreverse
- updateBlock :( MMMAnimatorUpdateBlock ) updateBlock
- doneBlock :( nullable MMMAnimatorDoneBlock ) doneBlock
- NS_SWIFT_NAME ( addAnimation ( duration : repeatCount : autoreverse : update : completion : ));
-
-
-
-
-
-
-
-
-
-
-
-
-
Despite the +shared method defined above you can still create own instances of this class.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init ;
-
-
-
-
-
-
-
-
-
-
-
-
-
For unit tests only: will synchronously run all the animations already in the animator and the ones added within
- the given block in the specified number of steps, executing the given block after each step.
- This is used in view-based tests for those views that run all their animations using MMMAnimator.
-
-
The idea is that an animated action is triggered in the animationsBlock (e.g. hideAnimated:YES) and then the
- stepBlock is called in the very beginning and in exactly numberOfSteps - 1 moments afterwards. The moments will be
- selected, so they are spaced equally and the last one is exactly at the end of the longest animation item.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) _testRunInNumberOfSteps :( NSInteger ) numberOfSteps
- animations :( nonnull void ( ^ )( void )) animationsBlock
- forEachStep :( nonnull void ( ^ )( NSInteger )) stepBlock ;
-
-
-
-
Swift
-
func _testRun ( numberOfSteps : Int , animations animationsBlock : () -> Void , stepBlock : ( Int ) -> Void )
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutIsolator Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutIsolator
-
-
-
Objective-C
-
@interface MMMAutoLayoutIsolator : UIView
-
-
-
-
Swift
-
class MMMAutoLayoutIsolator : UIView
-
-
-
-
Wraps a view that uses Auto Layout into a manual layout view providing sizeThatFits: for the outside world.
-Can be handy with old APIs that do not fully support Auto Layout.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The view being wrapped.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIView * _Nonnull view ;
-
-
-
-
Swift
-
var view : UIView { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( UIView * ) view NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( view : UIView )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) coder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutScrollView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAutoLayoutScrollView
-
-
-
Objective-C
-
@interface MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
Swift
-
class MMMAutoLayoutScrollView : UIScrollView
-
-
-
-
A vertical scroll view with a content view and preconfigured constraints, so there is no need in creating
- a scroll view / content view sandwitch manually every time.
-
-
It also supports top and bottom shadows that are displayed only when the content is clipped.
- The shadows can be enabled individually and they can sit either flush with the edges of the scroll view
- or can be inset according to adjustedContentInset, which can be handy when vertical safeAreaInsets need
- to be taken into account. (Note that contentInsetAdjustmentBehavior has to be either None or Always
- on this view since “automatic” options can lead to cyclic calculations.) Also note that scroll indicators
- are disabled here by default.
-
-
Begin by adding your controls and constraints into the contentView ensuring that its size can be derived from your
- constraints alone. Avoid constraints to the scroll view itself or outside views unless you are prepared to deal
- with the consequences.
-
-
Note that the width of the contentView will be constrainted hard to be equal to the width of the scroll view
- and its height will be constrained with prio 251 to be at least as large as the height of the scroll view.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
This is where your content subviews should be added.
-
-
-
-
-
-
-
-
-
-
-
Initializes with the given config.
-
-
Note
- Note that changing the config after the initialization has no effect on the view.
-
-
-
-
-
-
-
-
-
-
-
-
-
Initializes with default settings, a shortcut for initWithSettings:[[MMMScrollViewShadowsSettings alloc] init].
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init ;
-
-
-
-
Swift
-
convenience init ()
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMCollectionView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMCollectionView
-
-
-
Objective-C
-
@interface MMMCollectionView : UICollectionView
-
-
-
-
Swift
-
class MMMCollectionView : UICollectionView
-
-
-
-
Collection view supporting top & bottom shadows.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Uses UICollectionViewFlowLayout by default.
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame collectionViewLayout :( UICollectionViewLayout * ) layout NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMContainerView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMContainerView
-
-
-
Objective-C
-
@interface MMMContainerView : UIView
-
-
-
-
Swift
-
class MMMContainerView : UIView
-
-
-
-
Auto Layout does not support constraints against groups of items, so this is for the cases a normal UIView is
-typically used as a container for such a group.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-Also MMMContainerView does not intercept touches but subviews still do.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMHorizontalStackContainer Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMHorizontalStackContainer
-
-
Horizontal version of MMMStackContainer.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithInsets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutVerticalAlignment ) alignment
- spacing :( CGFloat ) spacing NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithDirection :( MMMLayoutDirection ) direction
- insets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutAlignment ) alignment
- spacing :( CGFloat ) spacing ;
-
-
-
-
-
-
-
-
-
-
MMMImageView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMImageView
-
-
-
Objective-C
-
@interface MMMImageView : UIView
-
-
-
-
Swift
-
class MMMImageView : UIView
-
-
-
-
A limited replacement for UIImageView fixing its inability to properly work with images having
- non-zero alignmentRectInsets when scaled.
-
-
Note that this view is already constrained to the aspect ratio of the image’s alignment rect,
- so you should not use hard (equal) pins against both width and height or against all edges.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , nullable ) UIImage * image
-
-
-
-
Swift
-
var image : UIImage ? { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , nullable ) UIImage * highlightedImage
-
-
-
-
Swift
-
var highlightedImage : UIImage ? { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , getter = isHighlighted ) BOOL highlighted
-
-
-
-
Swift
-
var isHighlighted : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithImage :( nullable UIImage * ) image highlightedImage :( nullable UIImage * ) highlightedImage NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( image : UIImage ?, highlightedImage : UIImage ?)
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init ;
-
-
-
-
Swift
-
convenience init ()
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithImage :( nullable UIImage * ) image ;
-
-
-
-
Swift
-
convenience init ( image : UIImage ?)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMLayoutUtils Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutUtils
-
-
-
Objective-C
-
@interface MMMLayoutUtils : NSObject
-
-
-
-
Swift
-
class MMMLayoutUtils : NSObject
-
-
-
-
This is to group a few simple layout helpers.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A rect with the given size positioned inside of the target rect in such a way that anchor points of both rects align.
-
-
Anchor points are given relative to the sizes of the corresponding rects, similar to CALayer’s anchorPoint
- property. For example, CGPointMake(0.5, 0.5) represents a center of any rect; CGPointMake(1, 0.5) means
- the center point of the right vertical edge.
-
-
Note that the origin of the rect returned is rounded to the nearest pixels (not points!).
-
-
See rectWithSize:inRect:contentMode: for a shortcut supporting UIViewContentMode.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- anchor :( CGPoint ) anchor
- withinRect :( CGRect ) targetRect
- anchor :( CGPoint ) targetAnchor ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , anchor : CGPoint , withinRect targetRect : CGRect , anchor targetAnchor : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
A shortcut for the above method with anchors being the same for both source and target rect.
-(This way the resulting rect will be always inside of the target one, assuming anchors are within [0; 1] range.)
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- withinRect :( CGRect ) targetRect
- anchor :( CGPoint ) anchor ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , withinRect targetRect : CGRect , anchor : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
A frame for the sourceRect positioned within the targetRect according to standard UIViewContentMode flags
- related to the layout (i.e. all except UIViewContentModeRedraw).
-
-
Note that the origin of the resulting rectangle is always rounded to the nearest pixel.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- withinRect :( CGRect ) targetRect
- contentMode :( UIViewContentMode ) contentMode ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , withinRect targetRect : CGRect , contentMode : UIView . ContentMode ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
A frame of the given size with its center at the specified point (assuming the center is defined by the given anchor
- point).
-
-
Note that the origin of the resulting rectangle is rounded to the nearest pixel boundary.
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size
- atPoint :( CGPoint ) center
- anchor :( CGPoint ) anchor ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , atPoint center : CGPoint , anchor : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
-
-
Same as rectWithSize:center:anchor: with anchor set to (0.5, 0.5).
-
-
-
Declaration
-
-
Objective-C
-
+ ( CGRect ) rectWithSize :( CGSize ) size center :( CGPoint ) center ;
-
-
-
-
Swift
-
class func rect ( withSize size : CGSize , center : CGPoint ) -> CGRect
-
-
-
-
-
-
-
-
-
-
MMMNavigation Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigation
-
-
-
Objective-C
-
@interface MMMNavigation : NSObject
-
-
-
-
Swift
-
class MMMNavigation : NSObject
-
-
-
-
Manages switching between different sections of the app (kind of internal URL router).
-It’s like a central hub accepting navigation requests and then passing them to the entities that able to perform them.
-(The entities that are able to open requests should register themselves as handlers.)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( instancetype ) root ;
-
-
-
-
Swift
-
class func root () -> Self
-
-
-
-
-
-
-
-
-
-
-
-
Starts the process of opening of the given path. Calls the completion block when done, the block receives ID of the
-corresponding request. Links are opened one by one. Any navigation request received while handling the current one
-will be queued.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Adds a handler and returns a cookie/ID object that can be later used to remove it.
-
-
-
-
-
-
-
-
-
-
-
Removes a handler by its ID assigned by addHandler.
-
-
-
Declaration
-
-
-
Swift
-
func removeHandler ( withId handlerId : Any )
-
-
-
-
-
-
-
-
-
-
MMMNavigationHop Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationHop
-
-
-
Objective-C
-
@interface MMMNavigationHop : NSObject
-
-
-
-
Swift
-
class MMMNavigationHop : NSObject
-
-
-
-
Opening a deep link can involve following through one or more steps, for example:
-
-
1) make sure the main screen is visible and can switch between the pages;
- 2) move to the recipes page;
- 3) open recipe with ID N;
- 4) scroll to ingredients, etc.
-
-
This is a single step in such a chain.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Name/ID of the hop. Supposed to be a flat string, like ‘recipes’, not a path.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) NSString * _Nonnull action ;
-
-
-
-
Swift
-
var action : String { get }
-
-
-
-
-
-
-
-
-
-
-
-
Optional parameters for this hop only.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly , nullable ) NSDictionary < NSString * , id > * params ;
-
-
-
-
Swift
-
var params : [ String : Any ]? { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithAction :( NSString * ) action params :( nullable NSDictionary < NSString * , id > * ) params NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( action : String , params : [ String : Any ]?)
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithAction :( NSString * ) action ;
-
-
-
-
Swift
-
convenience init ( action : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMNavigationPath Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationPath
-
-
-
Objective-C
-
@interface MMMNavigationPath : NSObject
-
-
-
-
Swift
-
class MMMNavigationPath : NSObject
-
-
-
-
A navigation path is just a collection of one or more “hops”.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
All the “hops” the link consists of.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) NSArray < MMMNavigationHop *> * _Nonnull hops ;
-
-
-
-
-
-
-
-
-
-
-
-
-
A new path obtained from the current one by removing the first hop.
-
-
-
Declaration
-
-
Objective-C
-
- ( nullable MMMNavigationPath * ) pathWithoutFirstHop ;
-
-
-
-
Swift
-
func pathWithoutFirstHop () -> MMMNavigationPath ?
-
-
-
-
-
-
-
-
-
-
-
-
The first hop in the path or nil if the path is empty.
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithHops :( NSArray < MMMNavigationHop *> * ) hops NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
Convenience initializer. Allows to use URIs like “main/recipes”, to construct hops out of it.
-Note that it does not currently support hop parameters.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithURI :( nonnull NSString * ) uri ;
-
-
-
-
Swift
-
convenience init ( uri : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMNavigationRequest Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationRequest
-
-
-
Objective-C
-
@interface MMMNavigationRequest : NSObject
-
-
-
-
Swift
-
class MMMNavigationRequest : NSObject
-
-
-
-
Info about a navigation request that is passed to handlers.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A sequence of hops the request has started with. This is never changed during lifetime of the request.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) MMMNavigationPath * _Nonnull originalPath ;
-
-
-
-
-
-
-
-
-
-
-
-
-
The current sequence of hops to follow. Handlers can adjust this.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) MMMNavigationPath * _Nonnull path ;
-
-
-
-
-
-
-
-
-
-
-
-
-
Called by the handler when all the hops in the path were followed through.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) didFinishSuccessfully :( BOOL ) successfully ;
-
-
-
-
Swift
-
func didFinishSuccessfully ( _ successfully : Bool )
-
-
-
-
-
-
-
-
-
-
-
-
Called by the handler to indicate that the sequence of hops (possibly changed) should be continued by another handler.
-The handler is supposed to conform to MMMNavigationHandler to make it more convenient to call this method.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) continueWithPath :( nonnull MMMNavigationPath * ) path
- handler :( nonnull id ) handler ;
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStack Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStack
-
-
-
Objective-C
-
@interface MMMNavigationStack : NSObject
-
-
-
-
Swift
-
class MMMNavigationStack : NSObject
-
-
-
-
This is to track the navigation state of the app and have the possibility to programmatically return to registered points of
- the navigation path. The actual navigation entities of the app (usually view controllers) must cooperate in order to
- achieve this.
-
-
The possibility to go back is needed to properly handle in-app links. We have a basic mechanism for this (MMMNavigation)
- which allows to “open” a part of a link and forward the remaining parts to the corresponding handler down the navigation tree.
- The handlers thus need to be able to “close” current navigation path before opening something new.
-
-
Although navigation in the app is better represented by a tree, we assume here that at least the current path in this tree
- can be represented as a stack. Each element of the stack can correspond to a modal view controller or alert view, for example,
- but it can also correspond to a special state of the app or a screen.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
+ ( instancetype ) shared ;
-
-
-
-
Swift
-
class func shared () -> Self
-
-
-
-
-
-
-
-
-
-
-
-
Notifies the stack about a new modal navigation context facing the user now, such as a modal view controller being presented or
- any other special state of the UI which would require either the assistance from the user or navigation items’ delegate
- in order to return to the previous navigation step.
-
-
Again, navigation steps are not limited to modal view controllers, there can be any entity responsible for the current
- state of the UI which wants to clean it up properly when asked for via the corresponding delegate.
-
-
The optional controller parameter might be a view controller corresponding to the new navigation item. This can be used by
- this controller with popAllAfterController:completion: method in order to cancel/pop all the navigation items added after it.
-
-
A nil is returned if it’s not possible to push anything now (because the stack is in the middle of a change).
-
-
For now trying to push something when “popping” is in progress is considered a programmer’s error however and it will crash
- in Debug.
-
-
-
-
-
-
-
-
-
-
-
-
-
MMMPaddedView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMPaddedView
-
-
-
Objective-C
-
@interface MMMPaddedView : UIView
-
-
-
-
Swift
-
class MMMPaddedView : UIView
-
-
-
-
Wraps a view padding it from all the sides.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The view being wrapped.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIView * _Nonnull view ;
-
-
-
-
Swift
-
var view : UIView { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIEdgeInsets insets
-
-
-
-
Swift
-
var insets : UIEdgeInsets { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( UIView * ) view insets :( UIEdgeInsets ) insets NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( view : UIView , insets : UIEdgeInsets )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) coder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowView
-
-
-
Objective-C
-
@interface MMMScrollViewShadowView : UIView
-
-
-
-
Swift
-
class MMMScrollViewShadowView : UIView
-
-
-
-
A view that’s used internally to render shadows in MMMAutoLayoutScrollView.
-Open for reuse in cases we want to display compatible shadows but differntly controlled.
-Note that this does not support Auto Layout, you have to manage its frame.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadows Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadows
-
-
-
Objective-C
-
@interface MMMScrollViewShadows : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadows : NSObject
-
-
-
-
A helper for adding top and bottom shadows into any UIScrollView-based class.
-You create an instance in your subclass and forward calls from layoutSubviews.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithScrollView :( nonnull UIScrollView * ) scrollView
- settings :( nonnull MMMScrollViewShadowsSettings * ) settings NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
Have to be called from layoutSubviews of our scroll view subclass to update the state of the shadows.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) layoutSubviews ;
-
-
-
-
Swift
-
func layoutSubviews ()
-
-
-
-
-
-
-
-
-
-
-
-
YES, if additional content view clipping might be needed for the current shadow settings.
-
-
-
Declaration
-
-
Objective-C
-
- ( BOOL ) mightNeedClippingView ;
-
-
-
-
Swift
-
func mightNeedClippingView () -> Bool
-
-
-
-
-
-
-
-
-
-
-
-
Same as layoutSubviews above but also updates clipToBounds property of the given view in case there are visible
-
-
-shadows that are not flush with the edges of our scroll view, i.e. when top/bottomShadowShouldUseContentInsets
-are used with settings and the corresponding insets are not zero now.
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) layoutSubviewsWithClippingView :( nullable UIView * ) clippingView ;
-
-
-
-
Swift
-
func layoutSubviews ( withClippingView clippingView : UIView ?)
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowsSettings Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowsSettings
-
-
-
Objective-C
-
@interface MMMScrollViewShadowsSettings : NSObject
-
-
-
-
Swift
-
class MMMScrollViewShadowsSettings : NSObject
-
-
-
-
Holds configuration for MMMScrollViewShadows that can be set only on initialization time.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The base shadow color is black with this amount of transparency applied to it.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat shadowAlpha ;
-
-
-
-
Swift
-
var shadowAlpha : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The base shadow color, ensure this is an RGB color. Note that the alpha channel is ignored, use shadowAlpha
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIColor * _Nonnull shadowColor ;
-
-
-
-
Swift
-
var shadowColor : UIColor { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The value between 0 and 1 telling how close to an elliptical curve the shadow’s border should be.
-
-
-when it’s 0, then the shadow is a normal rectangular one.
when it’s 1, then the gradient of the top (bottom) shadow forms an arc crossing the center of a shadow view and
-its both corners.
-
-
All values in-between adjust the point at which the gradient crosses the sides of the shadow views.
-
-
(The default value is 0.5.)
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat shadowCurvature ;
-
-
-
-
Swift
-
var shadowCurvature : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
Disabled by default.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL topShadowEnabled ;
-
-
-
-
Swift
-
var topShadowEnabled : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The height of the top shadow view. (5px by default.)
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat topShadowHeight ;
-
-
-
-
Swift
-
var topShadowHeight : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
YES, if the top shadow should be offset from the top edge of the scroll view by the top offset of content insets.
-
-
-The default value is NO.
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL topShadowShouldUseContentInsets ;
-
-
-
-
Swift
-
var topShadowShouldUseContentInsets : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
Disabled by default.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL bottomShadowEnabled ;
-
-
-
-
Swift
-
var bottomShadowEnabled : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
The height of the bottom shadow view. (10px by default.)
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat bottomShadowHeight ;
-
-
-
-
Swift
-
var bottomShadowHeight : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
YES, if the bottom shadow should be offset from the bottom edge of the scroll view by the bottom offset of content insets.
-
-
-The default value is NO.
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL bottomShadowShouldUseContentInsets ;
-
-
-
-
Swift
-
var bottomShadowShouldUseContentInsets : Bool { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
MMMShadowView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMShadowView
-
-
-
Objective-C
-
@interface MMMShadowView : UIView
-
-
-
-
Swift
-
class MMMShadowView : UIView
-
-
-
-
Helper view for adding custom layer shadows, while taking the the shadow sizes in conserderation for its final frame.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
View that can accepts and lay out subviews.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) UIView * _Nonnull contentView ;
-
-
-
-
Swift
-
var contentView : UIView { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) coder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMShadowViewSetting Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMShadowViewSetting
-
-
-
Objective-C
-
@interface MMMShadowViewSetting : NSObject
-
-
-
-
Swift
-
class MMMShadowViewSetting : NSObject
-
-
-
-
Holds configuration for MMMShadowView.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Default is black color.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIColor * _Nonnull color ;
-
-
-
-
Swift
-
var color : UIColor { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat opacity ;
-
-
-
-
Swift
-
var opacity : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGSize offset ;
-
-
-
-
Swift
-
var offset : CGSize { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat radius ;
-
-
-
-
Swift
-
var radius : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIEdgeInsets insets ;
-
-
-
-
Swift
-
var insets : UIEdgeInsets { get set }
-
-
-
-
-
-
-
-
-
-
-
-
Default is white color.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) UIColor * _Nonnull backgroundColor ;
-
-
-
-
Swift
-
var backgroundColor : UIColor { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) CGFloat cornerRadius ;
-
-
-
-
Swift
-
var cornerRadius : CGFloat { get set }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
MMMSpacerView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMSpacerView
-
-
-
Objective-C
-
@interface MMMSpacerView : UIView
-
-
-
-
Swift
-
class MMMSpacerView : UIView
-
-
-
-
Auto Layout does not support relationships between empty spaces, so we need to use spacer views and set such
-constraints between them. This one is a transparent and by default hidden view which can be used as such a spacer.
-It has no intrinsic size and low content hugging and compression resistance priorities.
-Unlike UIView we have translatesAutoresizingMaskIntoConstraints set to NO already.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) init NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStackContainer Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStackContainer
-
-
-
Objective-C
-
@interface MMMStackContainer : UIView
-
-
-
-
Swift
-
class MMMStackContainer : UIView
-
-
-
-
A container which lays out its subviews in certain direction one after another using fixed spacing between them.
-It also aligns all the items along the layout line according to the given alignment settings.
-Note that you must use setSubviews: method instead of feeding them one by one via addSubview:.
-This is kind of a UIStackView that we understand the internals of.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Sets subviews to be laid out. Previously set subviews will be removed from this container first.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) setSubviews :( nonnull NSArray < UIView *> * ) subviews ;
-
-
-
-
Swift
-
func setSubviews ( _ subviews : [ UIView ])
-
-
-
-
-
-
-
-
-
-
-
-
Insets define the padding around all the subviews.
-Alignment influences horizontal constraints added for the subviews.
-Spacing is the fixed distance to set between items.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithDirection :( MMMLayoutDirection ) direction
- insets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutAlignment ) alignment
- spacing :( CGFloat ) spacing ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStubView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStubView
-
-
-
Objective-C
-
@interface MMMStubView : UIScrollView
-
-
-
-
Swift
-
class MMMStubView : UIScrollView
-
-
-
-
To be used during development as a placeholder for not yet implemented views.
-It inherits a vertical scroll view so it’s possible to see that gesture recognizers of the container do not interfere
-with a typical scrolling.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The text is optional, the index influences the background color.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithText :( nullable NSString * ) text index :( NSInteger ) index ;
-
-
-
-
Swift
-
init ( text : String ?, index : Int )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStubViewController Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStubViewController
-
-
-
Objective-C
-
@interface MMMStubViewController : UIViewController
-
-
-
-
Swift
-
class MMMStubViewController : UIViewController
-
-
-
-
This is to be used during development to stub not ready yet parts of the app.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithText :( NSString * ) text index :( NSInteger ) index NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( text : String , index : Int )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithNibName :( nullable NSString * ) nibNameOrNil bundle :( nullable NSBundle * ) nibBundleOrNil NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMStylesheet Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStylesheet
-
-
-
Objective-C
-
@interface MMMStylesheet : NSObject
-
-
-
-
Swift
-
class MMMStylesheet : NSObject
-
-
-
-
A base for app-specific stylesheets: commonly used paddings, colors, fonts, etc in a single place.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The size class of the current device. See the MMSize* string constants below.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) NSString * _Nonnull currentSizeClass ;
-
-
-
-
Swift
-
var currentSizeClass : String { get }
-
-
-
-
-
-
-
-
-
-
-
-
Allows to avoid code that picks values (fonts, sizes, etc) by explicitely matching currentSizeClass
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) valueForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , id > * ) sizeClassToValue ;
-
-
-
-
Swift
-
func value ( forCurrentSizeClass sizeClassToValue : [ String : Any ]) -> Any
-
-
-
-
-
-
-
-
-
-
-
-
A version of valueForCurrentSizeClass: unwrapping the result as a float, which is handy for numeric values.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) floatForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) sizeClassToValue ;
-
-
-
-
Swift
-
func float ( forCurrentSizeClass sizeClassToValue : [ String : NSNumber ]) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Deprecated
-
Try using widthBasedConverter
-
-
-
Deprecated.
-Similar to floatForCurrentSizeClass: but instead of falling back to the value under MMMSizeRest key
-it tries to extrapolate the requested dimension using 1 or 2 values provided for other size classes using
-the widthBasedConverter
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) extrapolatedFloatForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) sizeClassToValue ;
-
-
-
-
Swift
-
func extrapolatedFloat ( forCurrentSizeClass sizeClassToValue : [ String : NSNumber ]) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Deprecated
-
The code using this might be confusing and/or hard to support. If you need to specify values for different size classes, then list them all explicitly in a call to floatForCurrentSizeClass:
-
-
-
Deprecated.
-Similar to extrapolatedFloatForCurrentSizeClass:, but allows to override values for certain size classes
-in the exceptions paramater.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) extrapolatedFloatForCurrentSizeClass :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) sizeClassToValue
- except :
- ( nonnull NSDictionary * ) exceptions ;
-
-
-
-
Swift
-
func extrapolatedFloat ( forCurrentSizeClass sizeClassToValue : [ String : NSNumber ], except exceptions : [ AnyHashable : Any ]) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Converts dimensions given for one size class into dimensions suitable for the current size class
-based on the ratio of screen widths associated with the current and source size classes.
-
-
-
-
-
-
-
-
-
-
-
A standard set of paddings.
-The actual stylesheet should override all these or at least the normalPadding insetsFromRelativeInsets can be defined here as well.
-In case only normalPadding
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat extraExtraSmallPadding ;
-
-
-
-
Swift
-
var extraExtraSmallPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat extraSmallPadding
-
-
-
-
Swift
-
var extraSmallPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat smallPadding
-
-
-
-
Swift
-
var smallPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat normalPadding
-
-
-
-
Swift
-
var normalPadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat largePadding
-
-
-
-
Swift
-
var largePadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) CGFloat extraLargePadding
-
-
-
-
Swift
-
var extraLargePadding : CGFloat { get }
-
-
-
-
-
-
-
-
-
-
-
-
Actual insets from relative ones.
-
-
Each offset in relative insets is a fixed number corresponding to the actual paddings defined above:
-
-
-.125 - extraExtraSmallPadding
-.25 — extraSmallPadding
-.5 — smallPadding
-1 — normalPadding
-2 — largePadding
-4 — extraLargePadding
-
-
-
Note that the large padding is not necessarily 2x larger than the normal one, etc (by default the extra large is),
- but we intentionally use them here like this to allow more compact notation for insets which is easy to remember and
- easy to tweak. Compare, for example:
-
-
\code
- UIEdgeInsetsMake([MHStylesheet shared].normalPadding, [MHStylesheet shared].largePadding, [MHStylesheet shared].normalPadding, [MHStylesheet shared].largePadding)
- \endcode
-
-
and the equivalent:
-
-
\code
- [[MHStylesheet shared] insetsFromRelativeInsets:UIEdgeInsetsMake(1, 2, 1, 2)]
- \endcode
-
-
-
Declaration
-
-
Objective-C
-
- ( UIEdgeInsets ) insetsFromRelativeInsets :( UIEdgeInsets ) insets ;
-
-
-
-
Swift
-
func insets ( fromRelativeInsets insets : UIEdgeInsets ) -> UIEdgeInsets
-
-
-
-
-
-
-
-
-
-
-
-
This is what insetsFromRelativeInsets: is using internally. Might be useful when making similar methods.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) paddingFromRelativePadding :( CGFloat ) padding ;
-
-
-
-
Swift
-
func padding ( fromRelativePadding padding : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
A metrics dictionary that can be used with Auto Layout with keys/values corresponding to all the paddings we support,
-e.g. “extraSmallPadding”, etc.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) dictionaryWithPaddings ;
-
-
-
-
Swift
-
func dictionaryWithPaddings () -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
-
-
A dictionary with 4 values under keys “Top”, “Bottom”, “Left”, “Right”
-corresponding to the insets obtained from the provided relative ones via insetsFromRelativeInsets:.
-(A shortcut composing insetsFromRelativeInsets method with MMMDictinaryFromUIEdgeInsets().)
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSDictionary < NSString * , NSNumber *> * )
- dictionaryFromRelativeInsets :( UIEdgeInsets ) insets
- keyPrefix :( nonnull NSString * ) keyPrefix ;
-
-
-
-
Swift
-
func dictionary ( fromRelativeInsets insets : UIEdgeInsets , keyPrefix : String ) -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
-
-
A dictionary with 4 values obtained from the insets returned by insetsFromRelativeInsets:insets
-under the keys “paddingTop”, “paddingBottom”, “paddingLeft”, “paddingRight”,
-i.e. it’s a shortcut for dictionaryFromRelativeInsets:insets keyPrefix:@"padding".
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull NSDictionary < NSString * , NSNumber *> * )
- paddingDictionaryFromRelativeInsets :( UIEdgeInsets ) insets ;
-
-
-
-
Swift
-
func paddingDictionary ( fromRelativeInsets insets : UIEdgeInsets ) -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
MMMStylesheetScaleConverter Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStylesheetScaleConverter
-
-
Dimension converter that uses a table of scales.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Initializes the converter with an explicit table of scales.
-Every value coming to convertFloat:fromSizeClass: will be returned multiplied by scales[sourceSizeClass].
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithScales :
- ( nonnull NSDictionary < NSString * , NSNumber *> * ) scales ;
-
-
-
-
Swift
-
init ( scales : [ String : NSNumber ])
-
-
-
-
-
-
-
-
-
-
-
-
Initializes the converter with a target size class and a table of dimensions associated with every size class
- (e.g screen width).
-
-
Every value coming to convertFloat:fromSizeClass: will be returned adjusted proportionally to the ratio of the
- dimensions associated with target and source size classes, i.e. it will be multiplied by
- scales[targetSizeClass] / scales[sourceSizeClass].
-
-
So for a table of screen widths the converter will upscale or downscale dimensions between size classes
- proprtionally to the ratios of screen width associated with size classes.
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithTargetSizeClass :( nonnull NSString * ) targetSizeClass
- dimensions :
- ( nonnull NSDictionary < NSString * , NSNumber *> * )
- dimensions ;
-
-
-
-
Swift
-
convenience init ( targetSizeClass : String , dimensions : [ String : NSNumber ])
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMTableView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMTableView
-
-
A table view supporting top and bottom shadows.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Note that UITableViewStylePlain is used.
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame style :( UITableViewStyle ) style NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( instancetype ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
When enabled, then reloadData is automatically called whenever any of the cells report potential size
-changes via mmm_setPreferredSizeCouldChange. See MMMPreferredSizeChanges
-
-
This feature is disabled by default for compatibility with the current code.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic ) BOOL shouldHandlePotentialCellSizeChanges ;
-
-
-
-
Swift
-
var shouldHandlePotentialCellSizeChanges : Bool { get set }
-
-
-
-
-
-
-
-
-
-
MMMTableViewCell Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMTableViewCell
-
-
-
Objective-C
-
@interface MMMTableViewCell : UITableViewCell
-
-
-
-
Swift
-
class MMMTableViewCell : UITableViewCell
-
-
-
-
A base for table view cells redeclareing the designated initializer into the one we typically use,
-so subclasses do not have to.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithReuseIdentifier :( NSString * ) reuseIdentifier NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ! ( reuseIdentifier : String ! )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithStyle :( UITableViewCellStyle ) style reuseIdentifier :( NSString * ) reuseIdentifier NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMVelocityMeter Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMVelocityMeter
-
-
-
Objective-C
-
@interface MMMVelocityMeter : NSObject
-
-
-
-
Swift
-
class MMMVelocityMeter : NSObject
-
-
-
-
A little helper for velocity/acceleration calculations: you feed it values with timestamps and can get the most recent
-acceleration/velocity values.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Resets the state of the meter, all values added before are forgotten.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) reset ;
-
-
-
-
Swift
-
func reset ()
-
-
-
-
-
-
-
-
-
-
-
-
Adds a coordinate and a corresponding timestamp.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) addValue :( CGFloat ) value timestamp :( NSTimeInterval ) timestamp ;
-
-
-
-
Swift
-
func addValue ( _ value : CGFloat , timestamp : TimeInterval )
-
-
-
-
-
-
-
-
-
-
-
-
Adds a coordinate with the current timstamp.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) addValue :( CGFloat ) value ;
-
-
-
-
Swift
-
func addValue ( _ value : CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
Calculates velocity and acceleration based on recently added values.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) calculateVelocity :( nonnull CGFloat * ) velocity
- acceleration :( nonnull CGFloat * ) acceleration ;
-
-
-
-
Swift
-
func calculateVelocity ( _ velocity : UnsafeMutablePointer < CGFloat > , acceleration : UnsafeMutablePointer < CGFloat > )
-
-
-
-
-
-
-
-
-
-
MMMVerticalGradientView Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMVerticalGradientView
-
-
-
Objective-C
-
@interface MMMVerticalGradientView : UIView
-
-
-
-
Swift
-
class MMMVerticalGradientView : UIView
-
-
-
-
A view displaying a gradient from top to bottom. The linearity of the gradient can be controlled.
-Can be handy for shadow overlays, etc.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithTopColor :( UIColor * ) topColor bottomColor :( UIColor * ) bottomColor curve :( MMMAnimationCurve ) curve NS_DESIGNATED_INITIALIZER ;
-
-
-
-
Swift
-
init ( topColor : UIColor , bottomColor : UIColor , curve : MMMAnimationCurve )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithTopColor :( UIColor * ) topColor bottomColor :( UIColor * ) bottomColor ;
-
-
-
-
Swift
-
convenience init ( topColor : UIColor , bottomColor : UIColor )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) init NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithCoder :( NSCoder * ) aDecoder NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithFrame :( CGRect ) frame NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
MMMVerticalStackContainer Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMVerticalStackContainer
-
-
Vertical version of MMMStackContainer.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithInsets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutHorizontalAlignment ) alignment
- spacing :( CGFloat ) spacing NS_DESIGNATED_INITIALIZER ;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( nonnull id ) initWithDirection :( MMMLayoutDirection ) direction
- insets :( UIEdgeInsets ) insets
- alignment :( MMMLayoutAlignment ) alignment
- spacing :( CGFloat ) spacing ;
-
-
-
-
-
-
-
-
-
-
MMMViewWrappingCell Class Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMViewWrappingCell
-
-
-
-
Swift
-
class MMMViewWrappingCell < ViewType > : MMMTableViewCell where ViewType : AnyObject
-
-
-
-
A simple table view cell wrapping the given view.
-
-
This is handy when you have a view already and just want to show it as one more cell.
-
-
The view being wrapped should support Auto Layout and inflate its height properly. The cell has its selectionStyle
- set to UITableViewCellSelectionStyleNone as these kind of cells typically do not appear selected.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
The view this cell wraps. It is added into the contentView and is laid out to fully fill it.
-
-
-
Declaration
-
-
Objective-C
-
@property ( nonatomic , readonly ) ViewType _Nonnull wrappedView ;
-
-
-
-
Swift
-
var wrappedView : ViewType { get }
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( ViewType ) view reuseIdentifier :( NSString * ) reuseIdentifier ;
-
-
-
-
Swift
-
init ( view : ViewType , reuseIdentifier : String )
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithView :( ViewType ) view reuseIdentifier :( NSString * ) reuseIdentifier inset :( UIEdgeInsets ) inset ;
-
-
-
-
Swift
-
init ( view : ViewType , reuseIdentifier : String , inset : UIEdgeInsets )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( id ) initWithReuseIdentifier :( NSString * ) reuseIdentifier NS_UNAVAILABLE ;
-
-
-
-
-
-
-
-
-
-
Constants Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Constants
-
The following constants are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Golden ratio constant.
-
-
-
Declaration
-
-
Objective-C
-
extern const CGFloat MMMGolden
-
-
-
-
Swift
-
class let golden : CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
1 divided by golden ratio.
-
-
-
Declaration
-
-
Objective-C
-
extern const CGFloat MMMInverseGolden
-
-
-
-
Swift
-
class let inverseGolden : CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Small screen phones: iPhone 4/4s/5/5s/SE.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSizeClassic
-
-
-
-
Swift
-
let MMMSizeClassic : String
-
-
-
-
-
-
-
-
-
-
-
-
Regular phones: iPhone 6/6s/7/8 and X as well.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSize6
-
-
-
-
Swift
-
let MMMSize6 : String
-
-
-
-
-
-
-
-
-
-
-
-
Pluse-sized phones: iPhone 6/7/8 Plus.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSize6Plus
-
-
-
-
Swift
-
let MMMSize6Plus : String
-
-
-
-
-
-
-
-
-
-
-
-
iPads: regular and pros.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSizePad
-
-
-
-
Swift
-
let MMMSizePad : String
-
-
-
-
-
-
-
-
-
-
-
-
Not the actual size class, but can be used as a key valueForCurrentSizeClass: and related methods for a fallback value.
-
-
-
Declaration
-
-
Objective-C
-
extern NSString * const _Nonnull MMMSizeRest
-
-
-
-
Swift
-
let MMMSizeRest : String
-
-
-
-
-
-
-
-
-
-
Enumerations Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Enumerations
-
The following enumerations are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMScrollViewShadowAlignment ) {
- MMMScrollViewShadowAlignmentTop ,
- MMMScrollViewShadowAlignmentBottom
-}
-
-
-
-
Swift
-
enum MMMScrollViewShadowAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMAnimationCurve ) {
-
- MMMAnimationCurveLinear ,
- MMMAnimationCurveEaseOut ,
- MMMAnimationCurveEaseIn ,
- MMMAnimationCurveEaseInOut ,
-
- // "Softer" versions are closer to the linear curve.
- MMMAnimationCurveSofterEaseIn ,
- MMMAnimationCurveSofterEaseOut ,
- MMMAnimationCurveSofterEaseInOut ,
-
- // Quad animations (e.g. https://easings.net/#easeInQuad)
- MMMAnimationCurveEaseInQuad ,
- MMMAnimationCurveEaseOutQuad ,
- MMMAnimationCurveEaseInOutQuad ,
-
- // Cubic animations (e.g. https://easings.net/#easeInCubic)
- MMMAnimationCurveEaseInCubic ,
- MMMAnimationCurveEaseOutCubic ,
- MMMAnimationCurveEaseInOutCubic ,
-
- // Quart animations (e.g. https://easings.net/#easeInQuart)
- MMMAnimationCurveEaseInQuart ,
- MMMAnimationCurveEaseOutQuart ,
- MMMAnimationCurveEaseInOutQuart ,
-
- // Quint animations (e.g. https://easings.net/#easeInQuint)
- MMMAnimationCurveEaseInQuint ,
- MMMAnimationCurveEaseOutQuint ,
- MMMAnimationCurveEaseInOutQuint
-}
-
-
-
-
Swift
-
enum MMMAnimationCurve : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
General alignment flags used when it’s not important which direction (vertical or horizontal) the alignment is for.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
enum MMMLayoutAlignment : NSInteger {}
-
-
-
-
Swift
-
enum MMMLayoutAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutDirection ) {
- MMMLayoutDirectionHorizontal ,
- MMMLayoutDirectionVertical
-}
-
-
-
-
Swift
-
enum MMMLayoutDirection : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutHorizontalAlignment ) {
- MMMLayoutHorizontalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutHorizontalAlignmentLeft = MMMLayoutAlignmentLeading ,
- MMMLayoutHorizontalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutHorizontalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutHorizontalAlignmentRight = MMMLayoutAlignmentTrailing ,
- MMMLayoutHorizontalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutHorizontalAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutVerticalAlignment ) {
- MMMLayoutVerticalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutVerticalAlignmentTop = MMMLayoutAlignmentLeading ,
- MMMLayoutVerticalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutVerticalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutVerticalAlignmentBottom = MMMLayoutAlignmentTrailing ,
- MMMLayoutVerticalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutVerticalAlignment : Int , @unchecked Sendable
-
-
-
-
-
-
-
-
-
-
MMMAnimationCurve Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMAnimationCurve
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMAnimationCurve ) {
-
- MMMAnimationCurveLinear ,
- MMMAnimationCurveEaseOut ,
- MMMAnimationCurveEaseIn ,
- MMMAnimationCurveEaseInOut ,
-
- // "Softer" versions are closer to the linear curve.
- MMMAnimationCurveSofterEaseIn ,
- MMMAnimationCurveSofterEaseOut ,
- MMMAnimationCurveSofterEaseInOut ,
-
- // Quad animations (e.g. https://easings.net/#easeInQuad)
- MMMAnimationCurveEaseInQuad ,
- MMMAnimationCurveEaseOutQuad ,
- MMMAnimationCurveEaseInOutQuad ,
-
- // Cubic animations (e.g. https://easings.net/#easeInCubic)
- MMMAnimationCurveEaseInCubic ,
- MMMAnimationCurveEaseOutCubic ,
- MMMAnimationCurveEaseInOutCubic ,
-
- // Quart animations (e.g. https://easings.net/#easeInQuart)
- MMMAnimationCurveEaseInQuart ,
- MMMAnimationCurveEaseOutQuart ,
- MMMAnimationCurveEaseInOutQuart ,
-
- // Quint animations (e.g. https://easings.net/#easeInQuint)
- MMMAnimationCurveEaseInQuint ,
- MMMAnimationCurveEaseOutQuint ,
- MMMAnimationCurveEaseInOutQuint
-}
-
-
-
-
Swift
-
enum MMMAnimationCurve : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveLinear
-
-
-
-
Swift
-
case linear = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOut
-
-
-
-
Swift
-
case easeOut = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseIn
-
-
-
-
Swift
-
case easeIn = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOut
-
-
-
-
Swift
-
case easeInOut = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveSofterEaseIn
-
-
-
-
Swift
-
case softerEaseIn = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveSofterEaseOut
-
-
-
-
Swift
-
case softerEaseOut = 5
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveSofterEaseInOut
-
-
-
-
Swift
-
case softerEaseInOut = 6
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInQuad
-
-
-
-
Swift
-
case easeInQuad = 7
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutQuad
-
-
-
-
Swift
-
case easeOutQuad = 8
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutQuad
-
-
-
-
Swift
-
case easeInOutQuad = 9
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInCubic
-
-
-
-
Swift
-
case easeInCubic = 10
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutCubic
-
-
-
-
Swift
-
case easeOutCubic = 11
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutCubic
-
-
-
-
Swift
-
case easeInOutCubic = 12
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInQuart
-
-
-
-
Swift
-
case easeInQuart = 13
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutQuart
-
-
-
-
Swift
-
case easeOutQuart = 14
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutQuart
-
-
-
-
Swift
-
case easeInOutQuart = 15
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInQuint
-
-
-
-
Swift
-
case easeInQuint = 16
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseOutQuint
-
-
-
-
Swift
-
case easeOutQuint = 17
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMAnimationCurveEaseInOutQuint
-
-
-
-
Swift
-
case easeInOutQuint = 18
-
-
-
-
-
-
-
-
-
-
MMMLayoutAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutAlignment
-
-
-
Objective-C
-
enum MMMLayoutAlignment : NSInteger {}
-
-
-
-
Swift
-
enum MMMLayoutAlignment : Int , @unchecked Sendable
-
-
-
-
General alignment flags used when it’s not important which direction (vertical or horizontal) the alignment is for.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentNone
-
-
-
-
Swift
-
case none = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentLeading
-
-
-
-
Swift
-
case leading = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentGolden
-
-
-
-
Swift
-
case golden = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentCenter
-
-
-
-
Swift
-
case center = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentTrailing
-
-
-
-
Swift
-
case trailing = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutAlignmentFill
-
-
-
-
Swift
-
case fill = 5
-
-
-
-
-
-
-
-
-
-
MMMLayoutDirection Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutDirection
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutDirection ) {
- MMMLayoutDirectionHorizontal ,
- MMMLayoutDirectionVertical
-}
-
-
-
-
Swift
-
enum MMMLayoutDirection : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutDirectionHorizontal
-
-
-
-
Swift
-
case horizontal = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutDirectionVertical
-
-
-
-
Swift
-
case vertical = 1
-
-
-
-
-
-
-
-
-
-
MMMLayoutHorizontalAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutHorizontalAlignment
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutHorizontalAlignment ) {
- MMMLayoutHorizontalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutHorizontalAlignmentLeft = MMMLayoutAlignmentLeading ,
- MMMLayoutHorizontalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutHorizontalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutHorizontalAlignmentRight = MMMLayoutAlignmentTrailing ,
- MMMLayoutHorizontalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutHorizontalAlignment : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentNone = MMMLayoutAlignmentNone
-
-
-
-
Swift
-
case none = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentLeft = MMMLayoutAlignmentLeading
-
-
-
-
Swift
-
case left = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentGolden = MMMLayoutAlignmentGolden
-
-
-
-
Swift
-
case golden = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentCenter = MMMLayoutAlignmentCenter
-
-
-
-
Swift
-
case center = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentRight = MMMLayoutAlignmentTrailing
-
-
-
-
Swift
-
case right = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutHorizontalAlignmentFill = MMMLayoutAlignmentFill
-
-
-
-
Swift
-
case fill = 5
-
-
-
-
-
-
-
-
-
-
MMMLayoutVerticalAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMLayoutVerticalAlignment
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMLayoutVerticalAlignment ) {
- MMMLayoutVerticalAlignmentNone = MMMLayoutAlignmentNone ,
- MMMLayoutVerticalAlignmentTop = MMMLayoutAlignmentLeading ,
- MMMLayoutVerticalAlignmentGolden = MMMLayoutAlignmentGolden ,
- MMMLayoutVerticalAlignmentCenter = MMMLayoutAlignmentCenter ,
- MMMLayoutVerticalAlignmentBottom = MMMLayoutAlignmentTrailing ,
- MMMLayoutVerticalAlignmentFill = MMMLayoutAlignmentFill
-}
-
-
-
-
Swift
-
enum MMMLayoutVerticalAlignment : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentNone = MMMLayoutAlignmentNone
-
-
-
-
Swift
-
case none = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentTop = MMMLayoutAlignmentLeading
-
-
-
-
Swift
-
case top = 1
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentGolden = MMMLayoutAlignmentGolden
-
-
-
-
Swift
-
case golden = 2
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentCenter = MMMLayoutAlignmentCenter
-
-
-
-
Swift
-
case center = 3
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentBottom = MMMLayoutAlignmentTrailing
-
-
-
-
Swift
-
case bottom = 4
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMLayoutVerticalAlignmentFill = MMMLayoutAlignmentFill
-
-
-
-
Swift
-
case fill = 5
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowAlignment Enumeration Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMScrollViewShadowAlignment
-
-
-
Objective-C
-
NS_ENUM ( NSInteger , MMMScrollViewShadowAlignment ) {
- MMMScrollViewShadowAlignmentTop ,
- MMMScrollViewShadowAlignmentBottom
-}
-
-
-
-
Swift
-
enum MMMScrollViewShadowAlignment : Int , @unchecked Sendable
-
-
-
-
Undocumented
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMScrollViewShadowAlignmentTop
-
-
-
-
Swift
-
case top = 0
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
MMMScrollViewShadowAlignmentBottom
-
-
-
-
Swift
-
case bottom = 1
-
-
-
-
-
-
-
-
-
-
Functions Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Functions
-
The following functions are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Suppose you need to contrain a view so its center divides its container in certain ratio different from 1:1
- (e.g. golden section):
-
-
┌─────────┐ ◆
- │ │ │
- │ │ │ a
- │┌───────┐│ │
- ─│┼ ─ ─ ─ ┼│─◆ ratio = a / b
- │└───────┘│ │
- │ │ │
- │ │ │
- │ │ │ b
- │ │ │
- │ │ │
- │ │ │
- └─────────┘ ◆
-
-
You cannot put this ratio directly into the multiplier parameter of the corresponding NSLayoutConstraints relating
- the centers of the views, because the multiplier would be the ratio between the distance to the center
- of the view (h) and the distance to the center of the container (H) instead:
-
-
◆ ┌─────────┐ ◆
- │ │ │ │
- │ │ │ │ a = h
- H │ │┌───────┐│ │
- │ │├ ─ ─ ─ ┼│─◆ multiplier = h / H
- │ │└───────┘│ │ ratio = a / b = h / (2 * H - h)
- ◆─│─ ─ ─ ─ ─│ │
- │ │ │
- │ │ │ b = 2 * H - h
- │ │ │
- │ │ │
- │ │ │
- └─────────┘ ◆
-
-
I.e. the multiplier is h / H (assuming the view is the first in the definition of the constraint),
- but the ratio we are interested would be h / (2 * H - h) if expressed in the distances to centers.
-
-
If you have a desired ratio and want to get a multiplier, which when applied, results in the layout dividing
- the container in this ratio, then you can use this function as shortcut.
-
-
Detailed calculations:
- ratio = h / (2 * H - h) ==> 2 * H * ratio - h * ratio = h ==> 2 * H * ratio / h - ratio = 1
- ==> 1 + ratio = 2 * H * ratio / h ==> (1 + ratio) / (2 * ratio) = H / h
- where H / h is the inverse of our multiplier, so the actual multiplier is (2 * ratio) / (1 + ratio).
-
-
-
Declaration
-
-
Objective-C
-
static inline CGFloat MMMCenterMultiplierForRatio ( CGFloat ratio )
-
-
-
-
Swift
-
class func centerMultiplier ( forRatio ratio : CGFloat ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
-
-
Animation curve opposite to the given one, e.g. EaseIn for EaseOut.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
A dictionary built from UIEdgeInsets suitable for AutoLayout metrics.
-The dictionary will have 4 values under the keys named “Top”, “Left”, “Bottom”, “Right”.
-
-
-
Declaration
-
-
Objective-C
-
extern NSDictionary < NSString * , NSNumber *>
- * _Nonnull MMMDictionaryFromUIEdgeInsets ( NSString * _Nonnull prefix ,
- UIEdgeInsets insets )
-
-
-
-
Swift
-
func MMMDictionaryFromUIEdgeInsets ( _ prefix : String , _ insets : UIEdgeInsets ) -> [ String : NSNumber ]
-
-
-
-
-
-
-
-
-
-
Protocols Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Protocols
-
The following protocols are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Protocol for entities able to fulfill in-app navigation requests.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMNavigationHandler < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationHandler : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
This is the delegate corresponding to each navigation item in the stack.
-Its main purpose is to be able to handle popping of the corresponding navigation item.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMNavigationStackItemDelegate < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItemDelegate : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
A token corresponding to a single node (item) of the current UI navigation path.
-Note that a reference to the token must be stored somewhere or the corresponding item will be popped right away.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMNavigationStackItem < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItem : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
A view supporting this will be notified when one of the child views indicates potential changes in its contents
-that might influence its size via mmm_setPreferredSizeCouldChange.
-
-
This is handy with views that do not fully rely on Auto Layout, like UITableView,
-where a change in the size of a cell would require it to reload this cell.
-
-
The implementation is responsible for coalescing notification and avoiding notification loops.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMPreferredSizeChanges < NSObject >
-
-
-
-
Swift
-
protocol MMMPreferredSizeChanges : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
-
-
Something that converts dimensions given for one size class (e.g. font sizes from the design made for iPhone 6)
- into dimensions for another size class (e.g. font size for iPhone 5 that were not explicitely mentioned in the design).
-
-
Different converters can be used for different kinds of values. For example, it might make sense to scale paddings
- proportionally to screen widths, but keep font sizes the same.
-
-
See more
-
-
Declaration
-
-
Objective-C
-
@protocol MMMStylesheetConverter < NSObject >
-
-
-
-
Swift
-
protocol MMMStylesheetConverter : NSObjectProtocol
-
-
-
-
-
-
-
-
-
-
MMMNavigationHandler Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationHandler
-
-
-
Objective-C
-
@protocol MMMNavigationHandler < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationHandler : NSObjectProtocol
-
-
-
-
Protocol for entities able to fulfill in-app navigation requests.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Returns NO, in case the handler is unable to perform the given request. (Another handler will be tried then.)
-Returns YES, if the request has been accepted by the handler.
-The handler must call -didFinishSuccessfully: when it’s done performing the request.
-
-
-
-
-
-
-
-
-
MMMNavigationStackItem Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStackItem
-
-
-
Objective-C
-
@protocol MMMNavigationStackItem < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItem : NSObjectProtocol
-
-
-
-
A token corresponding to a single node (item) of the current UI navigation path.
-Note that a reference to the token must be stored somewhere or the corresponding item will be popped right away.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Should be called by the item’s delegate when the navigation item has been popped as a result of user’s action
-and must be called when MMMNavigationStack calling popNavigationStackItem of the corresponding delegate.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) didPop ;
-
-
-
-
Swift
-
func didPop ()
-
-
-
-
-
-
-
-
-
-
-
-
Should be called by the navigation item’s delegate in rare caes when the corresponding item cannot be popped.
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) didFailToPop ;
-
-
-
-
Swift
-
func didFailToPop ()
-
-
-
-
-
-
-
-
-
-
-
-
Pops all the items currently on the stack above this item, so this one becomes the top. This is an asynchronous operation
- because it might involving several navigation steps.
-
-
Returns YES, if the request to pop was accepted for execution; NO otherwise. The latter means programmers error (such as
- popping while another pop is in progress) and will terminate the app when assertions are enabled.
-
-
Note that the completion handler is executed only if the request has been accepted.
-
-
-
-
-
-
-
-
-
MMMNavigationStackItemDelegate Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMNavigationStackItemDelegate
-
-
-
Objective-C
-
@protocol MMMNavigationStackItemDelegate < NSObject >
-
-
-
-
Swift
-
protocol MMMNavigationStackItemDelegate : NSObjectProtocol
-
-
-
-
This is the delegate corresponding to each navigation item in the stack.
-Its main purpose is to be able to handle popping of the corresponding navigation item.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Should perform all the work necessary to pop the corresponding UI navigation item and must call didPop method
- on the corresponding item when done.
-
-
Note that when the delegate is asked to pop, then all the items on top of it in the stack have been popped already,
- so the delegate should not ask the stack to do it. In fact asking for it and waiting for completion might freeze the popping
- process as pop completion callbacks are called only after all the whole popping process completes.
-
-
-
-
-
-
-
-
-
MMMPreferredSizeChanges Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMPreferredSizeChanges
-
-
-
Objective-C
-
@protocol MMMPreferredSizeChanges < NSObject >
-
-
-
-
Swift
-
protocol MMMPreferredSizeChanges : NSObjectProtocol
-
-
-
-
A view supporting this will be notified when one of the child views indicates potential changes in its contents
-that might influence its size via mmm_setPreferredSizeCouldChange.
-
-
This is handy with views that do not fully rely on Auto Layout, like UITableView,
-where a change in the size of a cell would require it to reload this cell.
-
-
The implementation is responsible for coalescing notification and avoiding notification loops.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
- ( void ) mmm_preferredSizeCouldChangeForSubview :( UIView * ) subview ;
-
-
-
-
Swift
-
func mmm_preferredSizeCouldChange ( forSubview subview : UIView )
-
-
-
-
-
-
-
-
-
-
MMMStylesheetConverter Protocol Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
MMMStylesheetConverter
-
-
-
Objective-C
-
@protocol MMMStylesheetConverter < NSObject >
-
-
-
-
Swift
-
protocol MMMStylesheetConverter : NSObjectProtocol
-
-
-
-
Something that converts dimensions given for one size class (e.g. font sizes from the design made for iPhone 6)
- into dimensions for another size class (e.g. font size for iPhone 5 that were not explicitely mentioned in the design).
-
-
Different converters can be used for different kinds of values. For example, it might make sense to scale paddings
- proportionally to screen widths, but keep font sizes the same.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Converts a dimension know for certain size class according to the rules of the converter.
-
-
-
Declaration
-
-
Objective-C
-
- ( CGFloat ) convertFloat :( CGFloat ) value
- fromSizeClass :( nonnull NSString * ) sourceSizeClass ;
-
-
-
-
Swift
-
func convert ( _ value : CGFloat , fromSizeClass sourceSizeClass : String ) -> CGFloat
-
-
-
-
-
-
-
-
-
-
Type Definitions Reference
-
- MMMCommonUI
-
-
-
-
-
-
-
-
-
-
-
Type Definitions
-
The following type definitions are available globally.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef id MMMNavigationRequestId
-
-
-
-
Swift
-
typealias MMMNavigationRequestId = AnyObject
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMNavigationCompletionBlock )( MMMNavigationRequestId requestId , BOOL finished )
-
-
-
-
Swift
-
typealias MMMNavigationCompletionBlock = ( Any , Bool ) -> Void
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef id MMMNavigationHandlerId
-
-
-
-
Swift
-
typealias MMMNavigationHandlerId = AnyObject
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMNavigationStackCompletion )( BOOL success )
-
-
-
-
Swift
-
typealias MMMNavigationStackCompletion = ( Bool ) -> Void
-
-
-
-
-
-
-
-
-
-
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ _Nonnull MMMShadowViewSettingBlock
-
-
-
-
-
-
-
-
-
-
-
-
-
Called on every update cycle of MMMAnimator for the given animation item.
-
-
The time is always within [0; 1] range here, which will correspond to the the [start; start + duration] interval of
- real time clock.
-
-
Unless the item is cancelled it is guaranteed that the block will be called for 0 and 1 values.
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMAnimatorUpdateBlock )( MMMAnimationHandle * _Nonnull , CGFloat )
-
-
-
-
-
-
-
-
-
-
-
-
-
Called when the animation item has been finished.
-
-
-
Declaration
-
-
Objective-C
-
typedef void ( ^ MMMAnimatorDoneBlock )( MMMAnimationHandle * _Nonnull , BOOL )
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docsets/MMMCommonUI.docset/Contents/Resources/Documents/search.json b/docsets/MMMCommonUI.docset/Contents/Resources/Documents/search.json
index c48681a..9e26dfe 100644
--- a/docsets/MMMCommonUI.docset/Contents/Resources/Documents/search.json
+++ b/docsets/MMMCommonUI.docset/Contents/Resources/Documents/search.json
@@ -1 +1 @@
-{"Functions.html#/c:MMMLayoutUtils.h@F@MMMCenterMultiplierForRatio":{"name":"MMMCenterMultiplierForRatio","abstract":"
- 
- View on GitHub
- 
- Categories Reference
- 
- 
- View on GitHub
- 
- NSLayoutConstraint(MMMTemple) Category Reference
-