AndroidSlidingUpPanel - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #go #nodejs #macos #java #awesome-list #vue #security #pytorch #mcp #openai #open-source

AndroidSlidingUpPanel

(★ 9,448)

이 라이브러리는 안드로이드 애플리케이션에 (Google Music과 Google Maps로 대중화된) 드래그 가능한 슬라이딩 업 패널을 쉽게 추가할 수 있는 방법을 제공합니다. Umano에서 제공합니다.

파일 탐색기

최종 버전 다운로드 (.zip)

- build.gradle
- ic_launcher-web.png
- settings.gradle
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- build.gradle
- gradle.properties
.gitignore
.travis.yml
build.gradle
gradle.properties
gradlew
gradlew.bat
LICENSE.txt
maven_push.gradle
README.md
settings.gradle
slidinguppanel.png

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/umano/AndroidSlidingUpPanel

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd AndroidSlidingUpPanel

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.sothree.slidinguppanel/library/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.sothree.slidinguppanel/library)
[![Badge](http://www.libtastic.com/static/osbadges/30.png)](http://www.libtastic.com/technology/30/)
\*\*참고:\*\* 현재 저희는 이슈에 대해 적극적으로 대응하지 \*\*않고\*\* 있습니다. 버그를 발견하시면 PR을 제출해 주세요.

Android Sliding Up Panel
=========================
이 라이브러리는 안드로이드 애플리케이션에 (Google Music과 Google Maps로 대중화된) 드래그 가능한 슬라이딩 업 패널을 쉽게 추가할 수 있는 방법을 제공합니다.

(현재 Dropbox에 인수된) Umano 안드로이드 앱에서 볼 수 있는 모습:
![SlidingUpPanelLayout](https://raw.github.com/umano/AndroidSlidingUpPanelDemo/master/slidinguppanel.png)

### 유명 앱에서의 주요 사용 사례
\* [Soundcloud] (https://play.google.com/store/apps/details?id=com.soundcloud.android)
\* [Dropbox Paper] (https://play.google.com/store/apps/details?id=com.dropbox.paper)
\* [Snaptee] (https://play.google.com/store/apps/details?id=co.snaptee.android)

이 라이브러리를 사용하고 계시고 앱을 목록에 추가하고 싶으시다면 언제든 알려주세요.

### 라이브러리 가져오기
최신 버전을 사용하려면 `build.gradle` 파일에 다음 의존성을 추가하기만 하면 됩니다:
```groovy
dependencies {
repositories {
mavenCentral()
}
compile 'com.sothree.slidinguppanel:library:3.4.0'
}
```

### 사용법
\* 액티비티 레이아웃의 최상위 요소로 `com.sothree.slidinguppanel.SlidingUpPanelLayout`을 포함합니다.
\* 레이아웃의 `gravity`는 `top` 또는 `bottom`으로 설정해야 합니다.
\* 반드시 두 개의 하위 뷰(child)를 가져야 합니다. 첫 번째 하위 뷰는 메인 레이아웃입니다. 두 번째 하위 뷰는 슬라이딩 업 패널을 위한 레이아웃입니다.
\* 메인 레이아웃의 너비와 높이는 `match\_parent`로 설정해야 합니다.
\* 슬라이딩 레이아웃의 너비는 `match\_parent`로 설정하고, 높이는 `match\_parent`, `wrap\_content` 또는 원하는 최대 높이 중 하나로 설정해야 합니다. 높이를 화면의 백분율로 정의하려면 `match\_parent`로 설정하고 슬라이딩 뷰에 `layout\_weight` 속성도 함께 정의하세요.
\* 기본적으로 패널 전체가 드래그 영역으로 작동하며 클릭 및 드래그 이벤트를 가로챕니다. `setDragView` 메서드나 `umanoDragView` 속성을 사용하여 드래그 영역을 특정 뷰로 제한할 수 있습니다.

자세한 내용은 예제 코드를 참조하세요.
```xml

```
ActionBar와의 원활한 상호작용을 위해 스타일에서 `windowActionBarOverlay`가 `true`로 설정되어 있는지 확인하세요:
```xml
```
그러나 이 경우, 구버전 API 버전을 지원하기 위해 메인 레이아웃에 `?android:attr/actionBarSize` 또는 `?attr/actionBarSize`의 상단 여백(top margin)을 추가하고 싶을 것입니다.
### 주의사항, 추가 기능 및 커스텀
\* 커스텀 `umanoDragView`를 사용하는 경우, 패널이 클릭 이벤트를 메인 레이아웃으로 통과시킵니다. 이를 방지하려면 두 번째 레이아웃을 `clickable`로 만드세요.
\* `setPanelHeight` 메서드나 `umanoPanelHeight` 속성을 사용하여 패널 높이를 변경할 수 있습니다.
\* 슬라이딩 패널 위의 그림자를 숨기려면 `shadowHeight` 속성을 0으로 설정하세요.
\* 슬라이딩 패널을 완전히 비활성화하려면(터치 및 프로그래밍 방식의 슬라이딩 모두 포함) `setEnabled(false)`를 사용하세요.
\* 패널의 터치 응답성(드래그 및 클릭)을 비활성화하려면 `setTouchEnabled(false)`를 사용하세요. 여전히 프로그래밍 방식으로 패널을 제어할 수 있습니다.
\* 현재 패널 상태를 가져오려면 `getPanelState`를 사용하세요.
\* 현재 패널 상태를 설정하려면 `setPanelState`를 사용하세요.
\* `umanoParallaxOffset` 속성을 설정하여 메인 뷰에 시차(parallax) 효과를 추가할 수 있습니다(예제는 데모 참고).
\* Google Maps와 유사하게 패널의 중간 확장 상태를 허용하기 위해 `setAnchorPoint`를 사용하여 화면 중간에 앵커 포인트를 설정할 수 있습니다.
\* 슬라이딩 패널에 대한 이벤트를 모니터링하기 위해 `PanelSlideListener`를 설정할 수 있습니다.
\* 레이아웃의 `layout\_gravity` 속성을 `top`으로 변경하여 패널이 위에서 아래로 슬라이드되도록 만들 수도 있습니다.
\* `umanoScrollInterpolator` 속성을 설정하여 패널 움직임을 위한 스크롤 인터폴레이터를 제공할 수 있습니다. 예를 들어, 패널에 바운스 또는 오버슈트 효과를 주고 싶을 때 유용합니다.
\* 기본적으로 패널은 메인 콘텐츠를 위로 밀어냅니다. `setOverlayed` 메서드나 `umanoOverlay` 속성을 사용하여 메인 콘텐츠를 덮도록(overlay) 만들 수 있습니다. 이는 슬라이딩 레이아웃을 반투명하게 만들고 싶을 때 유용합니다. 또한 비오버레이 모드에서 패널을 투명하게 만들려면 `umanoClipPanel`을 false로 설정할 수 있습니다.
\* 기본적으로 패널이 위로 슬라이드될 때 메인 콘텐츠가 어두워집니다(dimmed). `umanoFadeColor`를 변경하여 어두워지는 색상을 바꿀 수 있습니다. 어두워지는 효과를 완전히 제거하려면 `"@android:color/transparent"`로 설정하세요.
### 스크롤 가능한 슬라이딩 뷰
슬라이딩 패널 내부에 스크롤 가능한 뷰가 있는 경우, 중첩 스크롤(nested scrolling)을 지원하도록 패널에 `umanoScrollableView` 속성을 설정해야 합니다. 이 패널은 `ListView`, `ScrollView`, `RecyclerView`를 기본적으로 지원하지만, 커스텀 `ScrollableViewHelper`를 설정하여 모든 유형의 스크롤 가능한 뷰에 대한 지원을 추가할 수 있습니다. 다음은 `NestedScrollView`의 예시입니다:
```
public class NestedScrollableViewHelper extends ScrollableViewHelper {
public int getScrollableViewScrollPosition(View scrollableView, boolean isSlidingUp) {
if (mScrollableView instanceof NestedScrollView) {
if(isSlidingUp){
return mScrollableView.getScrollY();
} else {
NestedScrollView nsv = ((NestedScrollView) mScrollableView);
View child = nsv.getChildAt(0);
return (child.getBottom() - (nsv.getHeight() + nsv.getScrollY()));
}
} else {
return 0;
}
}
}
```
헬퍼를 정의한 후에는 슬라이딩 패널에서 `setScrollableViewHelper`를 사용하여 설정할 수 있습니다.
### 구현
이 라이브러리는 초기에는 Android Support Library r13의 오픈소스 [SlidingPaneLayout](http://developer.android.com/reference/android/support/v4/widget/SlidingPaneLayout.html) 컴포넌트를 기반으로 만들어졌습니다. Android 팀에 감사드립니다!
### 요구 사항
Android 2.2 이상에서 테스트됨
### 기타 기여자
\* Nov 23, 15 - [@kiyeonk](https://github.com/kiyeonk) - umanoScrollInterpolator 지원
\* Jan 21, 14 - ChaYoung You ([@yous](https://github.com/yous)) - 상단 슬라이드 지원
\* Aug 20, 13 - [@gipi](https://github.com/gipi) - Android Studio 지원
\* Jul 24, 13 - Philip Schiffer ([@hameno](https://github.com/hameno)) - Maven 지원
\* Oct 20, 13 - Irina Preșa ([@iriina](https://github.com/iriina)) - 앵커 지원
\* Dec 1, 13 - ([@youchy](ht
```

tps://github.com/youchy)) - XML 속성 지원
\* 13년 12월 22일 - Vladimir Mironov ([@MironovNsk](https://github.com/nsk-mironov)) - 사용자 정의 확장 패널 높이
멋진 풀 리퀘스트가 있다면 언제든 보내주세요!
### 변경 사항 (Changelog)
\* 3.4.0
\* 최신 support library 26을 사용하고 최소 버전을 14로 업데이트합니다.
\* 버그 수정
\* 3.3.1
\* 다양한 풀 리퀘스트의 수많은 버그 수정.
\* nineoldandroids 의존성을 제거했습니다. 대신 ViewCompat을 사용하세요.
\* 3.3.0
\* 메인 콘텐츠의 흐려진 영역을 클릭했을 때 사용할 수 있는 `FadeOnClickListener`를 설정할 수 있습니다.
\* `PanelSlideListener`의 형식이 변경되었습니다 (이제 여러 개를 설정할 수 있음)
\* setTouchEnabled 버그 수정
\* 3.2.1
\* `umanoScrollInterpolator` 지원 추가
\* `layout\_weight` 속성을 사용한 백분율 기반 슬라이딩 패널 높이 지원 추가
\* 사용자가 새로운 유형의 스크롤 가능한 뷰에 대한 지원을 확장할 수 있도록 `ScrollableViewHelper` 추가.
\* 3.2.0
\* `umanoParalaxOffset`을 `umanoParallaxOffset`으로 이름 변경
\* RecyclerView 지원.
\* 3.1.0
\* 자식 뷰의 중첩 스크롤을 지원하기 위해 `umanoScrollableView` 추가 (현재는 ScrollView와 ListView만 지원됨)
\* 3.0.0
\* 모든 속성에 `umano` 접두사 추가
\* 비오버레이 모드에서 투명 패널을 지원하기 위한 `clipPanel` 속성 추가.
\* `setEnabled(false)` - 이제 슬라이딩 패널을 완전히 비활성화합니다 (터치 및 프로그래밍 방식의 슬라이딩 모두 비활성화)
\* `setTouchEnabled(false)` - 패널의 터치 응답성(드래그 및 클릭)을 비활성화하며, 코드를 통한 패널 제어는 여전히 가능합니다.
\* `getPanelState` - 이제 현재 패널 상태를 가져오는 유일한 메서드입니다.
\* `setPanelState` - 이제 코드로 패널 상태를 수정하는 유일한 메서드입니다.
\* 2.0.2 - 슬라이딩 뷰 높이 속성에 `wrap\_content` 허용. 버그 수정.
\* 2.0.1 - 버그 수정.
\* 2.0.0 - 다양한 퍼블릭 메서드 호출 정리. 애니메이션이 적용된 `showPanel`/`hidePanel` 메서드 추가.
\* 1.0.1 - 최초 릴리스
### 라이선스 (Licence)
> Licensed under the Apache License, Version 2.0 (the "License");
> you may not use this work except in compliance with the License.
> You may obtain a copy of the License in the LICENSE file, or at:
>
> [http://www.apache.org/licenses/LICENSE-2.0](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.