paris 다운로드 - paris 소스 코드 다운로드

paris

기타 소스코드

2.0.2

다운로드

파리

Paris를 사용하면 맞춤 속성을 포함하여 Android 뷰에 프로그래밍 방식으로 스타일을 정의하고 적용할 수 있습니다.

언제든지 프로그래밍 방식으로 스타일을 적용할 수 있습니다.
여러 스타일을 함께 결합하세요.
XML을 사용하는 것과 반대로 프로그래밍 방식으로 스타일을 만듭니다.
주석을 사용하여 사용자 정의 속성을 쉽게 지원하십시오(Barber에서 영감을 얻음).
사용자 정의 뷰에 대해 명시적으로 지원되는 스타일을 선언하세요.
그리고 훨씬 더...

설치

프로젝트의 build.gradle 에서:

 dependencies {
    implementation ' com.airbnb.android:paris:2.0.0 '
    // Apply the Paris processor if you're using Paris annotations for code gen.
    kapt ' com.airbnb.android:paris-processor:2.0.0 '
    // or if you are using Kotlin Symbol Processing
    ksp ' com.airbnb.android:paris-processor:2.0.0 '
}

라이브러리 모듈에서 Paris를 사용하려면 라이브러리 모듈을 참조하세요.

빠른 시작

XML 정의 스타일 적용

myView.style( R .style. MyStyle )

Java 예제를 보려면 클릭하세요.

 Paris . style ( myView ). apply ( R . style . MyStyle );

myView 임의의 뷰 인스턴스이고, MyStyle XML 정의 스타일이며, style Paris에서 제공하는 확장 기능입니다. 전부는 아니지만 많은 속성이 지원됩니다. 자세한 내용은 지원되는 보기 유형 및 속성을 참조하세요.

2개 이상의 스타일 결합

myView.style {
    add( R .style. StyleA )
    add( R .style. StyleB )
    …
}

Java 예제를 보려면 클릭하세요.

 Paris . styleBuilder ( myView )
        . add ( R . style . StyleA )
        . add ( R . style . StyleB )
        …
        . apply ();

일부 겹치는 부분이 있는 경우 마지막으로 추가된 스타일의 속성 값이 우선합니다. 자세한 내용은 스타일 결합을 참조하세요.

프로그래밍 방식으로 스타일 정의

textView.style {
    // Using an actual value.
    textColor( Color . GREEN )
    // Or a resource.
    textSizeRes( R .dimen.my_text_size_small)
}

Java 예제를 보려면 클릭하세요.

 Paris . styleBuilder ( textView )
        // Using an actual value.
        . textColor ( Color . GREEN )
        // Or a resource.
        . textSizeRes ( R . dimen . my_text_size_small )
        . apply ();

스타일 리소스와도 결합할 수 있습니다.

textView.style {
    // Adds all the attributes defined in the MyGreenTextView style.
    add( R .style. MyGreenTextView )
    textSizeRes( R .dimen.my_text_size_small)
}

Java 예제를 보려면 클릭하세요.

 Paris . styleBuilder ( textView )
        // Adds all the attributes defined in the MyGreenTextView style.
        . add ( R . style . MyGreenTextView )
        . textSizeRes ( R . dimen . my_text_size_small )
        . apply ();

자세한 내용은 프로그래밍 방식으로 스타일 정의를 참조하세요.

사용자 정의 보기 속성

속성은 다음과 같이 선언됩니다.

< declare-styleable name = " MyView " >
    < attr name = " title " format = " string " />
    < attr name = " image " format = " reference " />
    < attr name = " imageSize " format = " dimension " />
</ declare-styleable >

사용자 정의 보기에는 @Styleable 및 @Attr 주석이 추가됩니다.

 // The value here corresponds to the name chosen in declare-styleable.
@Styleable( " MyView " )
class MyView (…) : ViewGroup(…) {

    init {
        // This call enables the custom attributes when used in XML layouts. It
        // extracts styling information from AttributeSet like it would a StyleRes.
        style(attrs)
    }

    @Attr( R .styleable. MyView_title )
    fun setTitle ( title : String ) {
        // Automatically called with the title value (if any) when an AttributeSet
        // or StyleRes is applied to the MyView instance.
    }

    @Attr( R .styleable. MyView_image )
    fun setImage ( image : Drawable ? ) {
        // Automatically called with the image value (if any) when an AttributeSet
        // or StyleRes is applied to the MyView instance.
    }

    @Attr( R .styleable. MyView_imageSize )
    fun setImageSize (@Px imageSize : Int ) {
        // Automatically called with the imageSize value (if any) when an
        // AttributeSet or StyleRes is applied to the MyView instance.
    }
}

Java 예제를 보려면 클릭하세요.

 // The value here corresponds to the name chosen in declare-styleable.
@ Styleable ( "MyView" )
public class MyView extends ViewGroup {

    public MyView ( Context context ) {
        super ( context );
    }

    public MyView ( Context context , AttributeSet attrs ) {
        this ( context , attrs , 0 );
    }

    public MyView ( Context context , AttributeSet attrs , int defStyle ) {
        this ( context , attrs , defStyle );
        // This call enables the custom attributes when used in XML layouts. It
        // extracts styling information from AttributeSet like it would a StyleRes.
        Paris . style ( this ). apply ( attrs );
    }

    @ Attr ( R . styleable . MyView_title )
    public void setTitle ( String title ) {
        // Automatically called with the title value (if any) when an AttributeSet
        // or StyleRes is applied to the MyView instance.
    }

    @ Attr ( R . styleable . MyView_image )
    public void setImage ( Drawable image ) {
        // Automatically called with the image value (if any) when an AttributeSet
        // or StyleRes is applied to the MyView instance.
    }

    @ Attr ( R . styleable . MyView_imageSize )
    public void setImageSize ( @ Px int imageSize ) {
        // Automatically called with the imageSize value (if any) when an
        // AttributeSet or StyleRes is applied to the MyView instance.
    }
}

@Attr 주석이 달린 메서드는 뷰가 AttributeSet 로 확장되거나 스타일이 적용될 때 Paris에서 호출됩니다.

자세한 내용은 사용자 정의 보기 속성을 참조하세요.

하위 뷰 스타일 지정

스타일을 지정하려는 2개의 하위 뷰에 대해 속성은 다음과 같이 선언됩니다.

< declare-styleable name = " MyHeader " >
    < attr name = " titleStyle " format = " reference " />
    < attr name = " subtitleStyle " format = " reference " />
    ...
</ declare-styleable >

하위 뷰 필드에는 @StyleableChild 주석이 추가됩니다.

@Styleable( " MyHeader " )
class MyHeader (…) : ViewGroup(…) {

    @StyleableChild( R .styleable. MyHeader_titleStyle )
    internal val title : TextView …
    
    @StyleableChild( R .styleable. MyHeader_subtitleStyle )
    internal val subtitle : TextView …
    
    init {
        style(attrs)
    }
}

Java 예제를 보려면 클릭하세요.

 @ Styleable ( "MyHeader" )
public class MyHeader extends ViewGroup {

    @ StyleableChild ( R . styleable . MyHeader_titleStyle )
    TextView title ;
    
    @ StyleableChild ( R . styleable . MyHeader_subtitleStyle )
    TextView subtitle ;
    
    …
    // Make sure to call Paris.style(this).apply(attrs) during initialization.
}

이제 제목 및 부제목 스타일이 MyHeader 스타일의 일부가 될 수 있습니다.

< MyHeader
    ...
    app : titleStyle = " @style/Title2 "
    app : subtitleStyle = " @style/Regular " />

myHeader.style {
    // Defined in XML.
    titleStyle( R .style. Title2 )
    // Defined programmatically.
    subtitleStyle {
        textColorRes( R .color.text_color_regular)
        textSizeRes( R .dimen.text_size_regular)
    }
}

Java 예제를 보려면 클릭하세요.

 Paris . styleBuilder ( myHeader )
        // Defined in XML.
        . titleStyle ( R . style . Title2 )
        // Defined programmatically.
        . subtitleStyle (( builder ) -> builder
                . textColorRes ( R . color . text_color_regular )
                . textSizeRes ( R . dimen . text_size_regular ))
        . apply ();

주의: titleStyle 및 subtitleStyle 과 같은 확장 기능은 Paris 주석 프로세서에서 컴파일하는 동안 생성됩니다. 새로운 @StyleableChild 주석이 추가되면 관련 기능을 사용할 수 있으려면 프로젝트를 한 번 (재)컴파일해야 합니다.

자세한 내용은 하위 뷰 스타일링을 참조하세요.

스타일을 뷰에 연결하기

@Styleable
class MyView (…) : View(…) {

    companion object {
        // For styles defined in XML.
        @Style
        val RED_STYLE = R .style. MyView_Red

        // For styles defined programmatically.
        @Style
        val GREEN_STYLE = myViewStyle {
            background( R .color.green)
        }
    }
}

Java 예제를 보려면 클릭하세요.

 @ Styleable
public class MyView extends View {

    // For styles defined in XML.
    @ Style
    static final int RED_STYLE = R . style . MyView_Red ;

    // For styles defined programmatically.
    @ Style
    static void greenStyle ( MyViewStyleApplier . StyleBuilder builder ) {
        builder . background ( R . color . green );
    }
}

연결된 각 스타일에 대해 도우미 메서드가 생성됩니다.

myView.style { addRed() } // Equivalent to style(R.style.MyView_Red)
myView.style { addGreen() } // Equivalent to add(MyView.GREEN_STYLE)

myView.style {
    addRed() // Equivalent to add(R.style.MyView_Red)
    addGreen() // Equivalent to add(MyView.GREEN_STYLE)
    …
}

Java 예제를 보려면 클릭하세요.

 Paris . style ( myView ). applyRed (); // Equivalent to apply(R.style.MyView_Red)
Paris . style ( myView ). applyGreen (); // No equivalent.

Paris . styleBuilder ( myView )
        . addRed () // Equivalent to add(R.style.MyView_Red)
        . addGreen () // No equivalent.
        …
        . apply ();

주의: addRed 및 addGreen 과 같은 확장 기능은 Paris 주석 프로세서에서 컴파일하는 동안 생성됩니다. 새로운 @Style 주석이 추가되면 관련 기능을 사용할 수 있으려면 프로젝트를 한 번 (재)컴파일해야 합니다.

자세한 내용은 사용자 정의 보기에 스타일 연결을 참조하세요.

선적 서류 비치

Paris Wiki에서 예제를 확인하고 전체 문서를 찾아보세요.

여전히 궁금한 점이 있으면 언제든지 새 이슈를 생성해 주세요.

기여

우리는 기여를 좋아합니다! 우리의 기여 지침을 확인하고 우리의 행동 강령을 반드시 따르십시오.

특허

 Copyright 2018 Airbnb, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

확장하다

추가 정보