Name | tkadw JSON |
Version |
0.4.9
JSON |
| download |
home_page | |
Summary | extra for tkinter |
upload_time | 2023-12-23 00:59:17 |
maintainer | |
docs_url | None |
author | XiangQinxi |
requires_python | >=3.6,<4.0 |
license | MIT |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# <span style="background: linear-gradient(to right, #8FF0A4, #3584E4); -webkit-background-clip: text; -webkit-text-fill-color: transparent;">tkadw 简介&文档</span>
> `tkinter`扩展界面库
---




---
使用[`tkinter.Canvas`](https://tkdocs.com/tutorial/canvas.html)、[`tcltk`](https://wiki.tcl-lang.org/)扩展自绘技术实现的扩展界面
> - `轻量`
>> 仅用`python`代码实现,不掺杂大型数据文件
> - `支持圆角`
>> 运用`DrawEngine`引擎快速画出圆角矩形
> - `跨平台`
>> `tkinter.Canvas`的跨平台性
> - `主题系统`
>> 新版加入了`tkadw.theme`模块,可快速制作主题和快速使用主题
## 简介
使用`tkinter.Canvas`自绘的界面库
项目是从6月放假那段时间开始
## 作者
一个初中生(绝对不是出生),十分热爱tkinter,完全是自学出来的
> QQ
>> 1379773753
> E-Mail
>> XiangQinxi@outlook.com
>
>> 1379773753@qq.com
## 安装
安装使用的途径仅在`pypi.org`平台上,所以可以直接使用`pip`
```bash
python -m pip install -U tkadw
```
`Requirement already satisfied: tkadw in $pythonpath\lib\site-packages (0.1.4)`
对于`windows`平台,安装时需勾选`tcl/tk`选项安装`tkinter`
对于`linux`平台,需自行查询`python3-tk`的安装步骤
## 支持
此项目使用[`poetry`](https://python-poetry.org/docs/)包管理,所以先安装[`poetry`](https://python-poetry.org/docs/)
```bash
pip install poetry
```
编译
```bash
poetry build
```
## 更新记录
> `<=0.2.0`:
>> 作者都没记下来
> `0.2.0`:
>> `201`主题配置
>
>> `202`改变修复`AdwDrawEntry`的`Entry`组件在`Linux`平台下出现边框
>
>> `203`修复各别解释器类似注释的错误
> `0.2.1`
>> `211`扩充README文档
>
>> `212`新增组件`Adw`
>
>> `213`删除多余文件
> `0.2.2`
>> `221`扩展额外界面库`BiliBili`,根据`BiliBili桌面版`设计
>
>> `222`修复`palette`修改完后没完全修改配色的问题
>
>> `223`扩展额外界面库`Win11`,根据`Sunvalley`设计
>
>> `224`修复`AdwDrawButton`类边框遮挡的问题
> `0.2.3`
>> `231` `AdwDrawEngine`添加绘画渐变图形的方法
>
>> `232`扩展额外界面库`Fluent`,作者制作设计
> `0.2.4`
>> `241`补充导入
> `0.3.0`
>> `301`新增`AdwSeparator`分割线组件 新增`AdwWidget`简化组件绘制流程
>
>> `302`分支`widgets`库,将加入仅使用组件组合起来的控件,而非用canvas绘出来的组件
>
>> `303`调改`AdwDrawEntry`和`AdwDrawText`的焦点事件绑定
>
>> `304`新增主题类组件,只需使用`set_default_theme`设置主题。对于经过特殊设计和特殊样式的组件,比如`Fluent`主题组件、`Win11`主题控件`AccentButton`,将不加入主题变量内
> `0.3.2`
>> `321` 新增`AdwMDI`组件
>
>> `322` 添加`metro`主题
> `0.3.3`
>> `331` 修复`AdwDrawFrame`的边框宽度问题
>
>> `332` 增加主题属性`AdwDrawFrame` `padding`
> `0.3.4`
>> `341` 为`AdwTButton`增添新样式`win11_accent_light` `win11_accent_dark`
> `0.3.5`
>> `351`补充`AdwTCircularButton`主题组件
>
>> `352`增添新快速布局`row`、`coloumn`以及高级布局`put`,所有可视化组件已继承布局类。
> `0.3.6`
>> `361` 添加`AdwDragArea`控件,快速制作标题栏
> `0.3.7`
>> 发布包时有些小问题,内容与`361`一样
> `0.3.8`
>> `381`修改示例,添加获取`tkadw版本号`方法`get_version()`
> `0.3.9`
>> `391`添加`pypi`官网设计主题
>
>> `392`准备着手制作设计器,添加组件AdwDesignerFrame
> `0.4.0`
>> `401`新增`AdwListBox`组件,并也加入主题组件中
>
>> `402`补充`pypi`暗色主题
>
>> `403`新增`AdwStack`组件,并也加入主题组件中
> `0.4.1`
>> `411`补充`AdwToplevel`,主题组件`Adwitew`
> `0.4.2`
>> `421`添加`AdwTTabs`未加入基础组件仅在主题组件中可用
> `0.4.3`
>> `431`添加`<<SystemSwitchTheme>>`绑定(前提是解释器安装了darkdetect)
>
>> `432`如果安装了`tkadw-material`库,将会自动导入
>
>> `433`修复`AdwRun().run()`无法关闭的错误
>
>> `434`补充`Adw`修改窗口样式的功能(窗口标题栏颜色仅限Windows),后续将补充其它方法,现在懒得动
> `0.4.4`
>> `441` `Adw`不会自动刷新窗口以修改窗口
> `0.4.5`
>> `451` 添加基于`tkinterflow`的布局`flow`
> `0.4.6`
>> `461` 修复`AdwListBox`圆角无法正常设置的问题
>
>> `462` 简化主题组件主题化
>
>> `463` 修改`AdwMDI`样式
>
>> `464` 尝试制作`pygubu`插件 *可惜文档太少,并且教程太老了,很难继续实现*
> `0.4.7` - `0.4.9`
>> `471` 为了让代码更加整洁,Windows平台下的高级窗口选项已变为`pywinstyles`功能库方法
>
>> `472` 全新的主题设置,将主题的浅色主题和深色主题合在一起,修改只需要改`default_theme_mode`即可
>
>> `473` 添加`Adw.style_dark`的`macos`支持
>
>> `474` `Windows`平台下默认开启`High DPI`
Raw data
{
"_id": null,
"home_page": "",
"name": "tkadw",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "XiangQinxi",
"author_email": "1379773753@qq.com",
"download_url": "https://files.pythonhosted.org/packages/f9/47/6f93d1684da58b40a17df6a943637dfdd01697c1a605a99baa49f1145ff6/tkadw-0.4.9.tar.gz",
"platform": null,
"description": "# <span style=\"background: linear-gradient(to right, #8FF0A4, #3584E4); -webkit-background-clip: text; -webkit-text-fill-color: transparent;\">tkadw \u7b80\u4ecb&\u6587\u6863</span>\n\n\n\n\n> `tkinter`\u6269\u5c55\u754c\u9762\u5e93\n\n---\n\n\n\n\n\n---\n\n\u4f7f\u7528[`tkinter.Canvas`](https://tkdocs.com/tutorial/canvas.html)\u3001[`tcltk`](https://wiki.tcl-lang.org/)\u6269\u5c55\u81ea\u7ed8\u6280\u672f\u5b9e\u73b0\u7684\u6269\u5c55\u754c\u9762\n\n> - `\u8f7b\u91cf`\n>> \u4ec5\u7528`python`\u4ee3\u7801\u5b9e\u73b0\uff0c\u4e0d\u63ba\u6742\u5927\u578b\u6570\u636e\u6587\u4ef6\n> - `\u652f\u6301\u5706\u89d2`\n>> \u8fd0\u7528`DrawEngine`\u5f15\u64ce\u5feb\u901f\u753b\u51fa\u5706\u89d2\u77e9\u5f62\n> - `\u8de8\u5e73\u53f0`\n>> `tkinter.Canvas`\u7684\u8de8\u5e73\u53f0\u6027\n> - `\u4e3b\u9898\u7cfb\u7edf`\n>> \u65b0\u7248\u52a0\u5165\u4e86`tkadw.theme`\u6a21\u5757\uff0c\u53ef\u5feb\u901f\u5236\u4f5c\u4e3b\u9898\u548c\u5feb\u901f\u4f7f\u7528\u4e3b\u9898\n\n\n## \u7b80\u4ecb\n\u4f7f\u7528`tkinter.Canvas`\u81ea\u7ed8\u7684\u754c\u9762\u5e93\n\u9879\u76ee\u662f\u4ece6\u6708\u653e\u5047\u90a3\u6bb5\u65f6\u95f4\u5f00\u59cb\n\n\n## \u4f5c\u8005\n\u4e00\u4e2a\u521d\u4e2d\u751f\uff08\u7edd\u5bf9\u4e0d\u662f\u51fa\u751f\uff09\uff0c\u5341\u5206\u70ed\u7231tkinter\uff0c\u5b8c\u5168\u662f\u81ea\u5b66\u51fa\u6765\u7684\n\n> QQ\n>> 1379773753\n\n> E-Mail\n>> XiangQinxi@outlook.com\n> \n>> 1379773753@qq.com\n \n\n\n## \u5b89\u88c5\n\u5b89\u88c5\u4f7f\u7528\u7684\u9014\u5f84\u4ec5\u5728`pypi.org`\u5e73\u53f0\u4e0a\uff0c\u6240\u4ee5\u53ef\u4ee5\u76f4\u63a5\u4f7f\u7528`pip`\n```bash\npython -m pip install -U tkadw\n```\n`Requirement already satisfied: tkadw in $pythonpath\\lib\\site-packages (0.1.4)`\n\n\u5bf9\u4e8e`windows`\u5e73\u53f0\uff0c\u5b89\u88c5\u65f6\u9700\u52fe\u9009`tcl/tk`\u9009\u9879\u5b89\u88c5`tkinter`\n\n\u5bf9\u4e8e`linux`\u5e73\u53f0\uff0c\u9700\u81ea\u884c\u67e5\u8be2`python3-tk`\u7684\u5b89\u88c5\u6b65\u9aa4\n\n\n## \u652f\u6301\n\u6b64\u9879\u76ee\u4f7f\u7528[`poetry`](https://python-poetry.org/docs/)\u5305\u7ba1\u7406\uff0c\u6240\u4ee5\u5148\u5b89\u88c5[`poetry`](https://python-poetry.org/docs/)\n```bash\npip install poetry\n```\n\u7f16\u8bd1\n```bash\npoetry build\n```\n\n## \u66f4\u65b0\u8bb0\u5f55\n> `<=0.2.0`:\n>> \u4f5c\u8005\u90fd\u6ca1\u8bb0\u4e0b\u6765\n\n> `0.2.0`:\n>> `201`\u4e3b\u9898\u914d\u7f6e\n> \n>> `202`\u6539\u53d8\u4fee\u590d`AdwDrawEntry`\u7684`Entry`\u7ec4\u4ef6\u5728`Linux`\u5e73\u53f0\u4e0b\u51fa\u73b0\u8fb9\u6846\n> \n>> `203`\u4fee\u590d\u5404\u522b\u89e3\u91ca\u5668\u7c7b\u4f3c\u6ce8\u91ca\u7684\u9519\u8bef\n\n> `0.2.1`\n>> `211`\u6269\u5145README\u6587\u6863\n>\n>> `212`\u65b0\u589e\u7ec4\u4ef6`Adw`\n> \n>> `213`\u5220\u9664\u591a\u4f59\u6587\u4ef6\n\n> `0.2.2` \n>> `221`\u6269\u5c55\u989d\u5916\u754c\u9762\u5e93`BiliBili`\uff0c\u6839\u636e`BiliBili\u684c\u9762\u7248`\u8bbe\u8ba1\n> \n>> `222`\u4fee\u590d`palette`\u4fee\u6539\u5b8c\u540e\u6ca1\u5b8c\u5168\u4fee\u6539\u914d\u8272\u7684\u95ee\u9898\n> \n>> `223`\u6269\u5c55\u989d\u5916\u754c\u9762\u5e93`Win11`\uff0c\u6839\u636e`Sunvalley`\u8bbe\u8ba1\n> \n>> `224`\u4fee\u590d`AdwDrawButton`\u7c7b\u8fb9\u6846\u906e\u6321\u7684\u95ee\u9898\n\n> `0.2.3`\n>> `231` `AdwDrawEngine`\u6dfb\u52a0\u7ed8\u753b\u6e10\u53d8\u56fe\u5f62\u7684\u65b9\u6cd5\n> \n>> `232`\u6269\u5c55\u989d\u5916\u754c\u9762\u5e93`Fluent`\uff0c\u4f5c\u8005\u5236\u4f5c\u8bbe\u8ba1\n\n> `0.2.4`\n>> `241`\u8865\u5145\u5bfc\u5165\n\n> `0.3.0`\n>> `301`\u65b0\u589e`AdwSeparator`\u5206\u5272\u7ebf\u7ec4\u4ef6 \u65b0\u589e`AdwWidget`\u7b80\u5316\u7ec4\u4ef6\u7ed8\u5236\u6d41\u7a0b\n> \n>> `302`\u5206\u652f`widgets`\u5e93\uff0c\u5c06\u52a0\u5165\u4ec5\u4f7f\u7528\u7ec4\u4ef6\u7ec4\u5408\u8d77\u6765\u7684\u63a7\u4ef6\uff0c\u800c\u975e\u7528canvas\u7ed8\u51fa\u6765\u7684\u7ec4\u4ef6\n> \n>> `303`\u8c03\u6539`AdwDrawEntry`\u548c`AdwDrawText`\u7684\u7126\u70b9\u4e8b\u4ef6\u7ed1\u5b9a\n> \n>> `304`\u65b0\u589e\u4e3b\u9898\u7c7b\u7ec4\u4ef6\uff0c\u53ea\u9700\u4f7f\u7528`set_default_theme`\u8bbe\u7f6e\u4e3b\u9898\u3002\u5bf9\u4e8e\u7ecf\u8fc7\u7279\u6b8a\u8bbe\u8ba1\u548c\u7279\u6b8a\u6837\u5f0f\u7684\u7ec4\u4ef6\uff0c\u6bd4\u5982`Fluent`\u4e3b\u9898\u7ec4\u4ef6\u3001`Win11`\u4e3b\u9898\u63a7\u4ef6`AccentButton`\uff0c\u5c06\u4e0d\u52a0\u5165\u4e3b\u9898\u53d8\u91cf\u5185\n\n> `0.3.2`\n>> `321` \u65b0\u589e`AdwMDI`\u7ec4\u4ef6\n> \n>> `322` \u6dfb\u52a0`metro`\u4e3b\u9898\n\n> `0.3.3`\n>> `331` \u4fee\u590d`AdwDrawFrame`\u7684\u8fb9\u6846\u5bbd\u5ea6\u95ee\u9898\n> \n>> `332` \u589e\u52a0\u4e3b\u9898\u5c5e\u6027`AdwDrawFrame` `padding`\n\n> `0.3.4`\n>> `341` \u4e3a`AdwTButton`\u589e\u6dfb\u65b0\u6837\u5f0f`win11_accent_light` `win11_accent_dark`\n\n> `0.3.5`\n>> `351`\u8865\u5145`AdwTCircularButton`\u4e3b\u9898\u7ec4\u4ef6\n> \n>> `352`\u589e\u6dfb\u65b0\u5feb\u901f\u5e03\u5c40`row`\u3001`coloumn`\u4ee5\u53ca\u9ad8\u7ea7\u5e03\u5c40`put`\uff0c\u6240\u6709\u53ef\u89c6\u5316\u7ec4\u4ef6\u5df2\u7ee7\u627f\u5e03\u5c40\u7c7b\u3002\n\n> `0.3.6`\n>> `361` \u6dfb\u52a0`AdwDragArea`\u63a7\u4ef6\uff0c\u5feb\u901f\u5236\u4f5c\u6807\u9898\u680f\n\n> `0.3.7`\n>> \u53d1\u5e03\u5305\u65f6\u6709\u4e9b\u5c0f\u95ee\u9898\uff0c\u5185\u5bb9\u4e0e`361`\u4e00\u6837\n\n> `0.3.8`\n>> `381`\u4fee\u6539\u793a\u4f8b\uff0c\u6dfb\u52a0\u83b7\u53d6`tkadw\u7248\u672c\u53f7`\u65b9\u6cd5`get_version()`\n\n> `0.3.9`\n>> `391`\u6dfb\u52a0`pypi`\u5b98\u7f51\u8bbe\u8ba1\u4e3b\u9898\n> \n>> `392`\u51c6\u5907\u7740\u624b\u5236\u4f5c\u8bbe\u8ba1\u5668\uff0c\u6dfb\u52a0\u7ec4\u4ef6AdwDesignerFrame\n\n> `0.4.0`\n>> `401`\u65b0\u589e`AdwListBox`\u7ec4\u4ef6\uff0c\u5e76\u4e5f\u52a0\u5165\u4e3b\u9898\u7ec4\u4ef6\u4e2d\n>\n>> `402`\u8865\u5145`pypi`\u6697\u8272\u4e3b\u9898\n> \n>> `403`\u65b0\u589e`AdwStack`\u7ec4\u4ef6\uff0c\u5e76\u4e5f\u52a0\u5165\u4e3b\u9898\u7ec4\u4ef6\u4e2d\n\n> `0.4.1`\n>> `411`\u8865\u5145`AdwToplevel`\uff0c\u4e3b\u9898\u7ec4\u4ef6`Adwitew`\n\n> `0.4.2`\n>> `421`\u6dfb\u52a0`AdwTTabs`\u672a\u52a0\u5165\u57fa\u7840\u7ec4\u4ef6\u4ec5\u5728\u4e3b\u9898\u7ec4\u4ef6\u4e2d\u53ef\u7528\n\n> `0.4.3`\n>> `431`\u6dfb\u52a0`<<SystemSwitchTheme>>`\u7ed1\u5b9a\uff08\u524d\u63d0\u662f\u89e3\u91ca\u5668\u5b89\u88c5\u4e86darkdetect\uff09\n>\n>> `432`\u5982\u679c\u5b89\u88c5\u4e86`tkadw-material`\u5e93\uff0c\u5c06\u4f1a\u81ea\u52a8\u5bfc\u5165\n>\n>> `433`\u4fee\u590d`AdwRun().run()`\u65e0\u6cd5\u5173\u95ed\u7684\u9519\u8bef\n> \n>> `434`\u8865\u5145`Adw`\u4fee\u6539\u7a97\u53e3\u6837\u5f0f\u7684\u529f\u80fd\uff08\u7a97\u53e3\u6807\u9898\u680f\u989c\u8272\u4ec5\u9650Windows\uff09\uff0c\u540e\u7eed\u5c06\u8865\u5145\u5176\u5b83\u65b9\u6cd5\uff0c\u73b0\u5728\u61d2\u5f97\u52a8\n\n> `0.4.4`\n>> `441` `Adw`\u4e0d\u4f1a\u81ea\u52a8\u5237\u65b0\u7a97\u53e3\u4ee5\u4fee\u6539\u7a97\u53e3\n\n> `0.4.5`\n>> `451` \u6dfb\u52a0\u57fa\u4e8e`tkinterflow`\u7684\u5e03\u5c40`flow`\n\n> `0.4.6`\n>> `461` \u4fee\u590d`AdwListBox`\u5706\u89d2\u65e0\u6cd5\u6b63\u5e38\u8bbe\u7f6e\u7684\u95ee\u9898\n> \n>> `462` \u7b80\u5316\u4e3b\u9898\u7ec4\u4ef6\u4e3b\u9898\u5316\n> \n>> `463` \u4fee\u6539`AdwMDI`\u6837\u5f0f\n> \n>> `464` \u5c1d\u8bd5\u5236\u4f5c`pygubu`\u63d2\u4ef6 *\u53ef\u60dc\u6587\u6863\u592a\u5c11\uff0c\u5e76\u4e14\u6559\u7a0b\u592a\u8001\u4e86\uff0c\u5f88\u96be\u7ee7\u7eed\u5b9e\u73b0*\n\n> `0.4.7` - `0.4.9`\n>> `471` \u4e3a\u4e86\u8ba9\u4ee3\u7801\u66f4\u52a0\u6574\u6d01\uff0cWindows\u5e73\u53f0\u4e0b\u7684\u9ad8\u7ea7\u7a97\u53e3\u9009\u9879\u5df2\u53d8\u4e3a`pywinstyles`\u529f\u80fd\u5e93\u65b9\u6cd5\n> \n>> `472` \u5168\u65b0\u7684\u4e3b\u9898\u8bbe\u7f6e\uff0c\u5c06\u4e3b\u9898\u7684\u6d45\u8272\u4e3b\u9898\u548c\u6df1\u8272\u4e3b\u9898\u5408\u5728\u4e00\u8d77\uff0c\u4fee\u6539\u53ea\u9700\u8981\u6539`default_theme_mode`\u5373\u53ef\n> \n>> `473` \u6dfb\u52a0`Adw.style_dark`\u7684`macos`\u652f\u6301\n> \n>> `474` `Windows`\u5e73\u53f0\u4e0b\u9ed8\u8ba4\u5f00\u542f`High DPI`",
"bugtrack_url": null,
"license": "MIT",
"summary": "extra for tkinter",
"version": "0.4.9",
"project_urls": {
"Documentation": "https://tkadwite.netlify.app/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b4d3aa2f547925fdb14b5ab7c159f4f6a364336312d854dcdcccb56163db6940",
"md5": "203113539efb35e4f663ce2209a90409",
"sha256": "cce1f7b094128a2002cae9be2bbead8622361341095ba0c454ec0541ac2b7d80"
},
"downloads": -1,
"filename": "tkadw-0.4.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "203113539efb35e4f663ce2209a90409",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6,<4.0",
"size": 107154,
"upload_time": "2023-12-23T00:59:14",
"upload_time_iso_8601": "2023-12-23T00:59:14.588950Z",
"url": "https://files.pythonhosted.org/packages/b4/d3/aa2f547925fdb14b5ab7c159f4f6a364336312d854dcdcccb56163db6940/tkadw-0.4.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f9476f93d1684da58b40a17df6a943637dfdd01697c1a605a99baa49f1145ff6",
"md5": "9120d65908a22837ce274c83fbc1ffa6",
"sha256": "cd20cf2d63194cf0c6e9af23c6a46dcefa1b8909bae1539830ad5a820ea354e7"
},
"downloads": -1,
"filename": "tkadw-0.4.9.tar.gz",
"has_sig": false,
"md5_digest": "9120d65908a22837ce274c83fbc1ffa6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6,<4.0",
"size": 329962,
"upload_time": "2023-12-23T00:59:17",
"upload_time_iso_8601": "2023-12-23T00:59:17.864794Z",
"url": "https://files.pythonhosted.org/packages/f9/47/6f93d1684da58b40a17df6a943637dfdd01697c1a605a99baa49f1145ff6/tkadw-0.4.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-23 00:59:17",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tkadw"
}