Zoomable is an android library working with Jetpack Compose. It enables the content zoomable by pinch gesture or by double-tap and drag gesture.
| Pinch | Double-tap and drag |
Zoomable provides a simple Modifier extension function Modifier.zoomable.
Here is a sample code.
Image(
painter = painterResource(id = R.drawable.penguin),
contentDescription = null,
modifier = Modifier.zoomable(rememberZoomState()),
)Zoomable can be used with
- any composable components such as
Image,Text, etc. - asynchronous image composable such as coil's
AsyncImage.
Zoomable also can be used in conjunction with
- Accompanist's
HorizontalPagerandVerticalPager. - Androidx's
HorizontalPagerandVerticalPagerintroduced in Compose v1.4.0.
Zoomable is available on Maven Central.
repositories {
mavenCentral()
}
dependencies {
implementation "net.engawapg.lib:zoomable:$version"
}
The latest version:
You can use Modifier.zoomable to make contents such as an image zoomable.
The zoom state is managed in a ZoomState object that can be created via rememberZoomState.
If contentSize is set, the range of offset will be optimized for the specified size.
val painter = painterResource(id = R.drawable.penguin)
val zoomState = rememberZoomState(contentSize = painter.intrinsicSize)
Image(
painter = painter,
contentDescription = "Zoomable image",
contentScale = ContentScale.Fit,
modifier = Modifier
.fillMaxSize()
.zoomable(zoomState),
)You can try sample app that contains following samples.
- Standard Image composable
- Asynchronous image loading using Coil library
- Text
- Image on
HorizontalPagerandVerticalPagerof Accompanist library - Image on
HorizontalPagerandVerticalPagerof Androidx compose foundation package
Copyright 2022 usuiat
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.
In the sample application, we use open source software:
- Accompanist (https://www.apache.org/licenses/LICENSE-2.0)
- Coil (https://www.apache.org/licenses/LICENSE-2.0)
To publish this library, we use open source software: