Скачать SwiftyFitsize - SwiftyFitsize исходный код скачать

Swiftyfitsize

Пример

После клонирования или загрузки репозитория в локальную область сначала запустите pod install , а затем откройте SwiftyFitsize.xcworkspace

Требования

iOS 9,0+
Xcode 10.2+
Swift 5+

Установка

Кокопод

 use_frameworks!
pod 'SwiftyFitsize'

Swift Package Manager

 1. File > Add Packages
2. Search https://github.com/LinXunFeng/SwiftyFitsize.git
3. Select "Up to Next Major" with "1.4.1"

Выставка

iPhone

iPad

Использование

1. Оператор

Будь то ~ или ≈ эффект адаптации для iPhone одинаков. Для iPad , ≈ ширина iPad слишком велика, он все равно будет рассчитывать в соответствии с соотношением ширины, а дисплей будет особенно раздутым. В настоящее ~ это будет более подходящим для дисплея.
~ На основе ≈ , умножьте iPad iPadFitMultiple .
Как правило, используйте его ~ .
То же самое относится и к другим операторам. Пожалуйста, обратитесь к инструкциям ниже для получения подробной информации.

Операторы	иллюстрировать
`~`	Сравните ширину. Когда устройство является `iPad` , `value` после адаптации будет умножено на `iPadFitMultiple`
`≈`	Сравните ширину, адаптация силы, ни `iPhone` , ни `iPad` не будут умножены на `iPadFitMultiple`
`∣`	Высота сравнения, соответствующая `~` , вся высота экрана
`∥`	Сравнительная высота, соответствующая `≈` , вся высота экрана
`∣=`	Высота сравнения, соответствующая `∣` , высота в безопасной области
`∥=`	Высота сравнения, соответствующая `∥` , высота внутри безопасной области
`∣-`	Высота сравнения, соответствующая `∣` , удалите высоту в безопасной области зоны взрыва
`∥-`	Высота сравнения, соответствующая `∥` , удалите высоту в безопасной области зоны взрыва

Сравнение адаптации высоты

Красный: ∣ и ∥ , адаптируйтесь к высоте всего экрана
Синий: ∣= и ∥= адаптироваться к высоте центральной области безопасности
Зеленый: ∣- и ∥- адаптируется к безопасной области, включая дно

Сравнение высоты

Привести пример

~ : Когда устройство является iPad , адаптированное значение будет умножено на iPadFitMultiple

 100 ~
UIFont . systemFont ( ofSize : 14 ) ~
CGPoint ( x : 10 , y : 10 ) ~
CGRect ( x : 10 , y : 10 , width : 100 , height : 100 ) ~
UIEdgeInsetsMake ( 10 , 10 , 10 , 10 ) ~

≈ : (опция + x) Адаптированное значение не будет умножено на iPadFitMultiple

 100 ≈
UIFont . systemFont ( ofSize : 14 ) ≈
CGPoint ( x : 10 , y : 10 ) ≈
CGRect ( x : 10 , y : 10 , width : 100 , height : 100 ) ≈
UIEdgeInsetsMake ( 10 , 10 , 10 , 10 ) ≈

Измените参照宽度,参照高度,是否为iPhoneX系列的参照高度, и iPadFitMultiple может вызвать следующий метод

/// 设置参照的相关参数
///
/// - Parameters:
///   - width: 参照的宽度
///   - height: 参照的高度
///   - isIPhoneXSeriesHeight: 是否为iPhoneX系列的参照高度
///   - iPadFitMultiple: iPad 在适配后所得值的倍数 (0 , 1]
SwiftyFitsize . reference (
  width : 414 , 
  height : 896 , 
  isIPhoneXSeriesHeight : true , 
  iPadFitMultiple : 0.5
)

2. Поддержите XIB и раскадровку

 enum SwiftyFitType : Int {
    /// Original Value
    case none = 0
    /// ~
    case flexibleWidth = 1
    /// ≈
    case forceWidth = 2
    /// ∣
    case flexibleHeight = 3
    /// ∥
    case forceHeight = 4
    /// ∣=
    case flexibleSafeAreaCenterHeight = 5
    /// ∥=
    case forceSafeAreaCenterHeight = 6
    /// ∣-
    case flexibleSafeAreaWithoutTopHeight = 7
    /// ∥-
    case forceSafeAreaWithoutTopHeight = 8
}

Шрифт приходит в силу

Поддерживаемые элементы управления пользовательским интерфейсом: UILabel UIButton UITextView UITextField

Пожалуйста, обратитесь к enum SwiftyFitType выше FontFitType

Xib-font

Ограничение подходит

Адаптация ограничения

Xib-font

iPad о ~ и ≈ в использовании

~ и ≈

3. объектив-c

Поскольку OC не поддерживает перегрузку оператора, он может быть адаптирован только с макросами.
Xib и Storyboard используются так же, как упомянуто выше.

Swift运算符соответствуют OC宏

Swift Operator	OC Macro
`~`	`SF_xx`
`≈`	`SFZ_xx`
`∣`	`SF_FH_xx`
`∥`	`SFZ_FH_xx`
`∣=`	`SF_SCH_xx`
`∥=`	`SFZ_SCH_xx`
`∣-`	`SF_SBH_xx`
`∥-`	`SFZ_SBH_xx`

Примечание: xx поддерживает следующие типы Font , Int , Float , Point , Size , Rect , EdgeInsets

Импорт

@import SwiftyFitsize;

ПРИМЕЧАНИЕ. Если вы используете зависимость, добавленную SPM , и необходимо использовать макрос (например: SF_Float ),
Вам необходимо импортировать SwiftyFitsizeOCSupport , в то время как SwiftyFitsize не может быть импортирован.

@import SwiftyFitsizeOCSupport;

Измените参照宽度,参照高度,是否为iPhoneX系列的参照高度и iPadFitMultiple

[SwiftyFitsize referenceWithWidth: 414
                           height: 896
            isIPhoneXSeriesHeight: YES
                  iPadFitMultiple: 0.6 ];

UIFont *font = [UIFont systemFontOfSize: 14 ];

UIFont *font1 = font.sf;
UIFont *font2 = SF_Font(font);

CGFloat num = SF_Float( 14 );
CGPoint point = SF_Point(CGPointMake( 10 , 10 ));
CGSize size = SF_Size(CGSizeMake( 100 , 100 ));
CGRect rect = SF_Rect(CGRectMake( 10 , 10 , 100 , 100 ));
UIEdgeInsets edge = SF_EdgeInsets(UIEdgeInsetsMake( 0 , 0 , 100 , 100 ));

≈

UIFont *font1 = font.sfz;
UIFont *font2 = SFZ_Font(font);

CGFloat num = SFZ_Float( 14 );
CGPoint point = SFZ_Point(CGPointMake( 10 , 10 ));
CGSize size = SFZ_Size(CGSizeMake( 100 , 100 ));
CGRect rect = SFZ_Rect(CGRectMake( 10 , 10 , 100 , 100 ));
UIEdgeInsets edge = SFZ_EdgeInsets(UIEdgeInsetsMake( 0 , 0 , 100 , 100 ));

То же самое относится и к другим операторам

4. Снимите указанный размер и адаптируйте

Сценарий: левый и правый интервал tableView составляет 10 , когда размер экрана отличается. После исключения левого и правого расстояния 10 Cell адаптирована одинаковым образом.
Идея использования: минус ширина 20 и адаптируется к оставшимся размерам.

Быстрый

Рекомендуется использовать схему PropertyWrapper для следующих методов вызова: один и два.

 struct Metric {
    static let tableViewLeftRightMargin : CGFloat = 10 // 定义 tableView 的左右间距
    ...
    static let tableViewHeight : CGFloat = Fit . $width ( 30 ) // 去掉左右边距后进行适配的值
    static let rowLeftViewWidth : CGFloat = Fit . $width ( 177.5 )
    static let rowCenterViewWidth : CGFloat = Fit . $width ( 100.5 )
    static let rowRightViewWidth : CGFloat = Fit . $width ( 77 )
    ...
}

struct Fit {
//    @WrappedSwiftyFitsize(fitType: .flexibleWidth, reduceValue: Metric.tableViewLeftRightMargin)
//    fitType 默认值是 .flexibleWidth，所以可以不传
    @ WrappedSwiftyFitsize ( reduceValue : Metric . tableViewLeftRightMargin * 2 )
    static var width : CGFloat = 375
}

375 является значением инициализации, и он не имеет особого значения. Просто значение можно получить при вызове Fit.width . Если значение Fit.width не используется, инициализация не будет выполнена.

Метод вызова:

// 移除指定尺寸后的适配，调用方式：
// 以下都是以适配 tableView 为例，移除 tableView 左右两侧固定的边距，以剩余的宽度来做适配

// 方式一：先赋值再取值
// 将 20 进行适配
Fit . width = 20
print ( "适配后的值 -- ( Fit . width ) " )

// 方式二：使用 $ 将 width 当方法用，传入待适配的值
// 将 30 进行适配
let aVal = Fit . $width ( 30 )
print ( "适配后的值 aVal -- ( aVal ) " )

// 方式三：调用 SwiftyFitsize.fit 方法
let bVal = SwiftyFitsize . fit (
  size : 40 ,
  fitType : . flexibleWidth ,
  reduceValue : Metric . tableViewLeftRightMargin * 2
)
print ( "适配后的值 bVal -- ( bVal ) " )

Объектив-c

Является ли это случаем адаптации к tableView , удалите фиксированные поля на левой и правой сторонах таблицы и адаптируйте оставшуюся ширину к обзору таблицы.

 CGFloat fitWidth = [SwiftyFitsize fitWithSize: 40
                                      fitType: SwiftyFitTypeFlexibleWidth
                                  reduceValue: 20 ];

Его можно использовать в качестве макроса для легкого использования

# define kFitWidth ( value ) 
[SwiftyFitsize fitWithSize: value fitType: SwiftyFitTypeFlexibleWidth reduceValue: 20 ]

Используйте макросы для адаптации

 CGFloat fitWidth = kFitWidth ( 40 );
NSLog ( @" fitWidth -- %f " , fitWidth);

Эффект показан в виде стержня, содержащий красные, зеленые и синие:

Сравнение высоты

5. Тип результата расчета

определение

/// 计算结果类型
@ objc public enum SwiftyFitCalcResultType : Int {
    /// 跟随全局配置
    case globalConfig
    /// 原始数据
    case raw
    /// 四舍五入
    case round
    /// 保留一位小数（根据第二位小数进行四舍五入）
    case oneDecimalPlace
}

Диапазон воздействия

.raw : влияние игнорируется
.round : диапазон влияния (-0.5, 0.5]
.oneDecimalPlace : диапазон эффектов (-0.05, 0.05]

Глобальная конфигурация

Если не настроить, то по умолчанию .raw
.globalConfig принимает тип, настроенный здесь
Если он все еще настроен на .globalConfig здесь, он будет сброшен на .raw

 SwiftyFitsize . reference ( width : 375 , calcResultType : . oneDecimalPlace ) // 全局配置计算结果为保留一位小数

использовать

Ниже приведена глобальная конфигурация без указания параметра calcResultType .

Укажите calcResultType отдельно

 SwiftyFitsize . fit (
    size : 35 , // 36
    fitType : . flexibleWidth ,
    reduceValue : 10 * 2 ,
    calcResultType : . raw // .round .oneDecimalPlace
)

PropertyWrapper Метод

// calcResultType: .raw .round .oneDecimalPlace
@ WrappedSwiftyFitsize ( reduceValue : Metric . tableViewLeftRightMargin * 2 , calcResultType : . raw )
static var width : CGFloat = 375

Образец данных

Первый столбец - это значение перед адаптацией
Другие столбцы - это значения, рассчитанные в соответствии с различными SwiftyFitCalcResultType после адаптации

Исходное значение	сырой	круглый	OneDecimalplace
35	36.478873239436616	36.0	36.5
36	37.52112676056338	38.0	37.5

Разное

В следующем перечислены соответствующие разрешения некоторых устройств для удобного поиска

оборудование	Логическое разрешение (точка)	Разрешение устройства (пиксель)
Сельский	320x568	640x1136
6 (s)/7/8/se (второе поколение)	375x667	750x1334
6 (s)+/7+/8+	414x736	1080x1920
X (s) / 11pro	375x812	1125x2436
Xr / 11	414x896	828x1792
Xs max / 11pro max	414x896	1242x2688
12 мини / 13 мини -	360x780	1080x2340
12 (Pro) / 13 (Pro)	390x844	1170x2532
12 Pro Max / 13 Pro Max	428x926	1284x2778