Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucasr/dspec
[DEPRECATED] Define and render UI specs on top of your Android UI
https://github.com/lucasr/dspec
Last synced: 2 months ago
JSON representation
[DEPRECATED] Define and render UI specs on top of your Android UI
- Host: GitHub
- URL: https://github.com/lucasr/dspec
- Owner: lucasr
- License: apache-2.0
- Archived: true
- Created: 2014-09-08T12:46:20.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2016-09-04T16:53:58.000Z (over 8 years ago)
- Last Synced: 2024-07-31T18:17:27.444Z (5 months ago)
- Language: Java
- Homepage:
- Size: 575 KB
- Stars: 551
- Watchers: 30
- Forks: 53
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- -awesome-android-ui - Dspec - 2.0) | <img src="/art/dspec.png" width="100%"> (Index `(light-weight pages)`)
- awesome-android-ui - Dspec - 2.0) | <img src="/art/dspec.png" width="100%"> (Index `(light-weight pages)`)
- awesome-android-ui - Dspec - 2.0) | <img src="/art/dspec.png" width="100%"> (Index)
README
dspec
=====
A simple way to define and render UI specs on top of your Android UI.
Usage
-----
Enclose the target UI with a `DesignSpecFrameLayout`, usually the root of your view hierarchy.
Get the associated `DesignSpec` instance with `getDesignSpec` and then you can:
* Toggle baseline grid visibility with `setBaselineGridVisible(boolean)`.
* Change baseline grid cell width with `setBaselineGridCellSize(int)`.
* Change baseline grid color with `setBaselineGridColor(int)`.
* Toggle keylines visibility with `setKeylinesVisible(boolean)`.
* Change keylines color with `setKeylinesColor(int)`.
* Add keylines with `addKeyline(int, From)`.
* Toggle spacing markers visibility with `setSpacingsVisible(boolean)`.
* Change spacing markers color with `setSpacingsColor(int)`.
* Add spacing marker with `addSpacing(int, int, From)`.
You can also specify the design spec in a raw JSON resource like:
```json
{
"baselineGridVisible": true,
"baselineGridCellSize": 8,
"keylines": [
{ "offset": 16,
"from": "LEFT" },
{ "offset": 72,
"from": "LEFT" },
{ "offset": 16,
"from": "RIGHT" }
],
"spacings": [
{ "offset": 0,
"size": 16,
"from": "LEFT" },
{ "offset": 56,
"size": 16,
"from": "LEFT" },
{ "offset": 0,
"size": 16,
"from": "RIGHT" }
]
}
```
Because `DesignSpec` is a `Drawable`, you can simply add it to a
`ViewOverlay` if you're running your app on API level >= 18:
```java
DesignSpec designSpec = DesignSpec.fromResource(someView, R.raw.some_spec);
someView.getOverlay().add(designSpec);
```
Download
--------
Download [the latest JAR][1] or grab via Gradle:
```groovy
compile 'org.lucasr.dspec:dspec:0.1.1'
```
or Maven:
```xml
org.lucasr.dspec
dspec
0.1.1
```
License
--------
Copyright 2014 Lucas Rocha
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.
[1]: https://oss.sonatype.org/service/local/artifact/maven/redirect?r=releases&g=org.lucasr.dspec&a=dspec&e=aar&v=LATEST