Download do SwiftyFitsize - SwiftyFitsize download de código fonte

Swiftyfitsize

Exemplo

Depois de clonar ou fazer o download do repositório para a área local, execute pod install primeiro e depois abra SwiftyFitsize.xcworkspace

Requisitos

iOS 9.0+
Xcode 10.2+
Swift 5+

Instalação

Cocoapods

 use_frameworks!
pod 'SwiftyFitsize'

Gerente de pacotes Swift

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

Exposição

iPhone

iPad

Uso

1. Operador

Seja ~ ou ≈ o efeito de adaptação para iPhone é o mesmo. Para iPad , ≈ a largura do iPad for muito grande, ele ainda será calculado de acordo com a taxa de largura e o visor será particularmente inchado. Neste ~ será mais adequado para a tela.
~ Com base em ≈ , multiplique o iPad iPadFitMultiple .
Geralmente, use -o ~ .
O mesmo vale para outros operadores. Consulte as instruções abaixo para obter detalhes.

Operadores	ilustrar
`~`	Compare a largura. Quando o dispositivo é `iPad` , `value` após a adaptação será multiplicado ao `iPadFitMultiple`
`≈`	Compare a largura, a adaptação da força, nem `iPhone` nem `iPad` serão multiplicados com `iPadFitMultiple`
`∣`	Altura de comparação, correspondente a `~` , toda a altura da tela
`∥`	Altura comparativa, correspondente a `≈` , toda a altura da tela
`∣=`	Altura de comparação, correspondente a `∣` , altura dentro da área segura
`∥=`	Altura de comparação, correspondente a `∥` , altura dentro da área segura
`∣-`	Altura de comparação, correspondente a `∣` , remova a altura dentro da área segura da área de Bang
`∥-`	Altura de comparação, correspondente a `∥` , remova a altura dentro da área segura da área de Bang

Comparação da adaptação de altura

Vermelho: ∣ e ∥ , adapte -se à altura de toda a tela
Azul: ∣= e ∥= adaptação à altura da área de segurança central
Verde: ∣- e ∥- Adaptar-se a uma área segura, incluindo o fundo

Comparação de ajuste de altura

Dê um exemplo

~ : Quando o dispositivo é iPad , o valor adaptado será multiplicado com 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 ) ~

≈ : (opção + x) O valor adaptado não será multiplicado pelo 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 ) ≈

Modifique参照宽度,参照高度,是否为iPhoneX系列的参照高度e iPadFitMultiple pode chamar o seguinte método

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

2. Apoie XIB e Storyboard

 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
}

Fonte Fitsize

Os controles da interface do usuário suportados são: UILabel UIButton UITextView UITextField

Consulte enum SwiftyFitType acima FontFitType

xib-font

Restrição ajuste -se

Adaptação de restrição

xib-font

iPad sobre ~ e ≈ em uso

~ e ≈

3. Objective-C

Como OC não suporta a sobrecarga do operador, ele só pode ser adaptado com macros.
Xib e Storyboard são usados da mesma forma que mencionados acima.

Swift运算符correspondem a OC宏

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

NOTA: xx suporta os seguintes tipos de Font , Int , Float , Point , Size , Rect , EdgeInsets

Importar

@import SwiftyFitsize;

Nota: Se você estiver usando uma dependência adicionada pelo SPM e precisar usar uma macro (como: SF_Float ),
Você precisa importar SwiftyFitsizeOCSupport , enquanto SwiftyFitsize não pode ser importado.

@import SwiftyFitsizeOCSupport;

Modifique参照宽度,参照高度,是否为iPhoneX系列的参照高度e 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 ));

O mesmo vale para outros operadores

4. Remova o tamanho especificado e adapte

Cenário: o espaçamento esquerdo e direito do tableView é 10 quando o tamanho da tela é diferente. Depois de excluir o espaçamento esquerdo e direito de 10 , Cell é adaptada de maneira igual.
Ideia de uso: menos 20 largura no total e se adapte ao tamanho restante.

Swift

Recomenda -se usar o esquema PropertyWrapper para os seguintes métodos de chamada: um e dois.

 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 é um valor de inicialização e não tem significado especial. É apenas que o valor pode ser obtido ao chamar Fit.width . Se o valor do Fit.width não for usado, a inicialização não será executada.

Método de chamada:

// 移除指定尺寸后的适配，调用方式：
// 以下都是以适配 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 ) " )

Objective-C

É esse o caso de se adaptar ao tableView , remova as margens fixas nas laterais esquerda e direita da TableView e adapte a largura restante à visão de tabela.

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

Pode ser usado como macro para facilitar o uso

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

Use macros para adaptar

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

O efeito é mostrado na vista da barra contendo vermelho, verde e azul:

Comparação de ajuste de altura

5. Tipo de resultado do cálculo

definição

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

Gama de impacto

.raw : O impacto é ignorado
.round : Faixa de influência (-0.5, 0.5]
.oneDecimalPlace : faixa de efeito (-0.05, 0.05]

Configuração global

Se não estiver configurado, o padrão é .raw
.globalConfig leva o tipo configurado aqui
Se ainda estiver definido como .globalConfig aqui, será redefinido para .raw internamente

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

usar

A seguir, é apresentada a configuração global sem especificar o parâmetro calcResultType .

Especifique calcResultType separadamente

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

Método PropertyWrapper

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

Dados de amostra

A primeira coluna é o valor antes da adaptação
As outras colunas são valores calculados de acordo com diferentes SwiftyFitCalcResultType após a adaptação

Valor original	cru	redondo	OneDecimalPlace
35	36.478873239436616	36.0	36.5
36	37.52112676056338	38.0	37.5

Misc

O seguinte lista as resoluções correspondentes de alguns dispositivos para facilitar a pesquisa

equipamento	Resolução lógica (ponto)	Resolução do dispositivo (pixel)
SE	320x568	640x1136
6 (s)/7/8/se (segunda geração)	375x667	750x1334
6 (s)+/7+/8+	414x736	1080x1920
X (s) / 11pro	375x812	1125x2436
XR / 11	414x896	828x1792
Xs max / 11pro max	414x896	1242x2688
12 mini / 13 mini	360x780	1080x2340
12 (pro) / 13 (pro)	390x844	1170x2532
12 Pro Max / 13 Pro Max	428x926	1284x2778