Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/correct-syntax/ui-style-lang
CSS-like style language for drawing and styling elements in wxPython
https://github.com/correct-syntax/ui-style-lang
css gui language python stylesheet ui-design ui-style wxpython
Last synced: 1 day ago
JSON representation
CSS-like style language for drawing and styling elements in wxPython
- Host: GitHub
- URL: https://github.com/correct-syntax/ui-style-lang
- Owner: Correct-Syntax
- License: other
- Created: 2020-05-28T21:05:21.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-06T18:56:21.000Z (about 1 year ago)
- Last Synced: 2025-01-18T19:33:13.030Z (8 days ago)
- Topics: css, gui, language, python, stylesheet, ui-design, ui-style, wxpython
- Language: Python
- Homepage:
- Size: 8.3 MB
- Stars: 12
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://ui-style-lang.readthedocs.io/en/latest/?badge=latest)
UI Style Lang is a simple CSS-like language which allows for drawing and styling wxPython elements. Many UI Style Lang properties are the same as the normal (not short-hand) CSS3 properties. This provides a familiar syntax, especially for those with experience with CSS3.
If you are looking for an easy way to:
* **Draw shapes, text and/or images** in wxPython without worrying so much about ids, brushes, pens, etc.
* **Style the native wxPython widgets** from a stylesheet
* **Create your own custom widgets in wxPython** that can be styled with a CSS-like stylesheet
then UI Style Lang is likely the module you're looking for.
## Background
This was originally created as a "scratch-an-itch" project to get an idea I had for using the wxPython drawing API in a CSS way out of my head. Whether or not this is a good idea I don't know, but it's fun creating it.
## Features
* **Written in pure Python with just wxPython and the standard library**
* **Drawing API**
* Includes the ``UIStylePDC`` UI Style Lang class which is a powerful extension of the wxPython ``wx.PseudoDC``
* Over 15 stylesheet properties already supported
* Draw circles, rectangles, squares, images, & text
* Translate & rotate elements
* Load styles from inline styles, string and/or an external stylesheet
* Auto-handles wxPython IDs, with support for manual-handling of IDs
* **Native Widget Styling API**
* Supports loading from a stylesheet for easy theming
* Support for styling app, panels, frames and static text widgets
and more.
## Usage and Examples
See the [documentation](https://ui-style-lang.readthedocs.io/en/latest/) at Read the Docs and [full demo examples](https://github.com/Correct-Syntax/ui-style-lang/tree/master/demo) for information on usage.
## What does the syntax look like?
UI Style Lang (Stylesheet API) example:
```
/* My custom button styles */
@style button {
background-color: #F4F4F4;
top: 20px;
left: 40px;
width: 115px;
height: 35px;
border-color: #D1D1D1;
border-size: 2px;
}
@style button:hover {
background-color: #FDFDFD;
top: 20px;
left: 40px;
width: 115px;
height: 35px;
border-color: #D1D1D1;
border-size: 2px;
}
```
Python API example:
```python
# Intilizing the element:
>> dc.InitElem("button")
# Editing the style with inline styles:
>> dc.UpdateElem('button', styles="border-color: red; border-width: 4px;")
# Update the element with the 'hover' styles:
>> dc.UpdateElem('button:hover')
```
## Contributing
If you would like to help out or have ideas, feel free to open a Github issue.
Pull requests and/or feature suggestions are welcome!
## License
UI Style Lang is licensed under the BSD 3-Clause license.