Merge pull request ChinaIceF#68 from ChinaIceF/reconst

修改 README，移除pyside6支持

Author: ChinaIceF

README.md

@@ -6,9 +6,8 @@
   </a>
 
   <h2 align="center">PyQt-SiliconUI</h2>
-  <p align="center">基于 PyQt5 / PySide6 的UI框架，灵动、优雅而轻便</p>
-  
-</p>   
+  <p align="center">基于 PyQt5 的UI框架，灵动、优雅而轻便</p>
+
 
 ## 写在最前面
 ### 注意：重构进行中
@@ -21,17 +20,12 @@
   为你造成的不便敬请谅解，欢迎你参与项目重构  
 
 ## 如何使用
-### 下载合适的代码
-**当前分支 main**  
-如果你希望运行 PyQt5，请下载 main 分支的代码  
-如果你希望运行 PySide6，请下载 PySide6 分支的代码，为了保证兼容性，本项目在 PySide6 6.1.3 上开发
-
 ### 运行 Silicon Gallery
-下载源代码，解压并安装包  
+* 下载源代码，解压并安装  
 ```cmd
 python setup.py install
 ```
-运行`./examples/Gallery/start.py`即可体验 Silicon UI 现有的功能和效果  
+* 运行`./examples/Gallery/start.py`即可体验 Silicon UI 现有的功能和效果  
 
 在 Silicon Gallery 中，你可以了解：
 * 各种控件以及其样式
@@ -40,29 +34,14 @@ python setup.py install
 * ***更多内容等待我们共同创造***
 
 ### 创建相似的 Silicon 应用
-在 ``./examples/Gallery/ui.py`` 中，展示了一般 Silicon 应用的构建方法，其工作目录应具有以下结构：  
-* **components文件夹**，其中存放各个选项卡的界面
-* **ui.py**，文件名取决于你的调用方式，重要的是其中应包含 Silicon 应用的构建类，并调用 components 文件夹以构建各个界面
-同时，你也需注意控件和对象间的从属关系，以 Glaze 为例，它中控件的从属关系如下
-
-> silicon.SiTabArea  
->> silicon.SiTab
->>> silicon.SiFrame   
->>>> silicon.SiCategory  
->>>>> silicon.SiOptionButton  
->>>>> silicon.SiOptionSwitch  
->>>>> silicon.SiOptionComboBox  
->>>>> ......  
+* 根据我们提供的模板，你可以轻松创建于 Silicon Gallery 风格相似的应用，只需要用 `siui.templates.application.SiliconApplication` 代替正常项目中 `QMainWindow`，并调用方法来创建页面即可
 
 ### 在其他项目中使用
-Silicon UI 的控件并不仅限于在 Silicon 应用中使用，你可以在任意项目中调用它们，并据你喜好进行自定义
-
-## 更新日志
-更新日志现在已经移动到 Silicon Gallery 中，日志从 2024.6.25 开始记录
+* Silicon UI 的控件并不仅限于在 Silicon 应用中使用，你可以在任意项目中调用它们，并据你喜好进行自定义
 
 ## License
-本项目采用 GPL-3.0 License，详见[这里](LICENSE)  
-同时，本项目允许非商业使用。对于商业使用，敬请期待购买商用许可的版本。
+* 本项目遵循 GPL-3.0 License，详见[这里](LICENSE)  
+* 同时，本项目仅允许非商业开源使用。对于商业使用，敬请期待购买商用许可的版本。
 
 ## 声明
 * 请注意，Silicon Gallery 使用了 FLATICON 的图标，**这些图标不应被认为是 Silicon UI 的一部分**，你可以前往 [FLATICON的网站](https://flaticon.com) 免注册、免下载其他文件、免费获取这些图标，但应在使用时注意遵守他们的有关条款规定  

examples/Gallery/components/ExperimentField.py

@@ -213,7 +213,7 @@ def __init__(self, parent):
 
         self.scrollarea = SiScrollArea(self)
         self.scrollarea.setFixedHeight(256)
-        self.scrollarea.setWidget(self.alabel)
+        self.scrollarea.setAttachment(self.alabel)
 
         # 新测试
         self.titled_widget_group = SiTitledWidgetGroup(self)

examples/template_test/start.py

@@ -2,11 +2,12 @@
 
 from PyQt5.QtWidgets import QApplication
 
-from siui.templates.application import SiliconApplication
+from ui import MySiliconApp
+
 
 
 if __name__ == "__main__":
     app = QApplication(sys.argv)
-    window = SiliconApplication()
+    window = MySiliconApp()
     window.show()
     sys.exit(app.exec_())

examples/template_test/ui.py

@@ -0,0 +1,12 @@
+from siui.templates.application import SiliconApplication
+from siui.
+
+
+class MySiliconApp(SiliconApplication):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        self.init_my_app_ui()
+
+    def init_my_app_ui(self):
+        self.page1 =

siui/components/page/__init__.py

@@ -0,0 +1,90 @@
+from PyQt5.QtCore import Qt
+
+from siui.components.widgets.container import SiDenseVContainer
+from siui.components.widgets.label import SiLabel
+from siui.components.widgets.scrollarea import SiScrollArea
+from siui.core.globals import SiGlobal
+
+
+class SiPage(SiDenseVContainer):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.setSpacing(0)
+
+        # 滚动区域宽度限制
+        self.scroll_maximum_width = 10000
+
+        # 左对齐横坐标偏移量
+        self.x_offset_on_align_left = 0
+
+        # 滚动区域对齐方式
+        self.scroll_alignment = Qt.AlignCenter
+
+        # 标题
+        self.title = SiLabel(self)
+        self.title.setFixedStyleSheet("padding-left: 64px")
+        self.title.setFont(SiGlobal.siui.fonts["L_BOLD"])
+        self.title.setFixedHeight(32)
+        self.title.setAlignment(Qt.AlignLeft | Qt.AlignVCenter)
+        self.title.setAutoAdjustSize(True)
+
+        # 滚动区域
+        self.scroll_area = SiScrollArea(self)
+
+        self.addPlaceholder(32)
+        self.addWidget(self.title)
+        self.addPlaceholder(32)
+        self.addWidget(self.scroll_area)
+
+    def setScrollMaximumWidth(self, width: int):
+        """
+        设置滚动区域的子控件的最大宽度
+        :param width: 最大宽度
+        :return:
+        """
+        self.scroll_maximum_width = width
+        self.resize(self.size())
+
+    def setScrollAlignment(self, a0):
+        """
+        设置滚动区域的对齐方式
+        :param a0: Qt 枚举值
+        """
+        if a0 not in [Qt.AlignCenter, Qt.AlignLeft, Qt.AlignRight]:
+            raise ValueError(f"Invalid alignment value: {a0}")
+        self.scroll_alignment = a0
+        self.resize(self.size())
+
+    def setXOffsetOnAlignLeft(self, offset):
+        """
+        当内容中置时，横坐标的偏移量
+        :param offset: 像素数
+        """
+        self.x_offset_on_align_left = offset
+        self.resize(self.size())
+
+    def reloadStyleSheet(self):
+        super().reloadStyleSheet()
+        self.title.setStyleSheet("color: {}".format(SiGlobal.siui.colors["TEXT_A"]))
+
+    def resizeEvent(self, event):
+        super().resizeEvent(event)
+        size = event.size()
+
+        self.scroll_area.resize(size.width(), size.height() - 96)
+        self.scroll_area.attachment().setFixedWidth(min(size.width(), self.scroll_maximum_width))
+
+        # 处理对齐
+        if self.scroll_alignment == Qt.AlignCenter:
+            scroll_widget_x = (size.width() - self.scroll_area.attachment().width())//2 + self.x_offset_on_align_left
+        elif self.scroll_alignment == Qt.AlignLeft:
+            scroll_widget_x = 0
+        elif self.scroll_alignment == Qt.AlignRight:
+            scroll_widget_x = size.width() - self.scroll_area.attachment().width()
+        else:
+            raise ValueError(f"Invalid alignment value: {self.scroll_alignment}")
+
+        self.scroll_area.attachment().move(scroll_widget_x, self.scroll_area.attachment().y())
+
+
+

siui/components/page/page.py

@@ -11,7 +11,7 @@ def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
         # 定义一个占位用的子控件
-        self.widget = SiLabel(self)
+        self.attachment_ = SiLabel(self)
 
         # 定义滚动条的框架
         self.scroll_bar_frame_vertical = SiLabel(self)
@@ -34,7 +34,7 @@ def __init__(self, *args, **kwargs):
         self.widget_scroll_animation.setBias(1)
         self.widget_scroll_animation.setCurrent([0, 0])
         self.widget_scroll_animation.setTarget([0, 0])
-        self.widget_scroll_animation.ticked.connect(lambda pos: self.widget.move(int(pos[0]), int(pos[1])))
+        self.widget_scroll_animation.ticked.connect(lambda pos: self.attachment_.move(int(pos[0]), int(pos[1])))
 
     def reloadStyleSheet(self):
         """
@@ -45,36 +45,43 @@ def reloadStyleSheet(self):
         self.scroll_bar_vertical.setStyleSheet(f"background-color: {SiGlobal.siui.colors['SCROLL_BAR']}")
         self.scroll_bar_horizontal.setStyleSheet(f"background-color: {SiGlobal.siui.colors['SCROLL_BAR']}")
 
-    def setWidget(self, widget):
+    def setAttachment(self, widget):
         """
         绑定子控件，作为滚动的部件
         :param widget:
         :return:
         """
-        self.widget.deleteLater()
+        self.attachment_.deleteLater()
 
-        self.widget = widget
-        self.widget.setParent(self)
-        self.widget.lower()
+        self.attachment_ = widget
+        self.attachment_.setParent(self)
+        self.attachment_.lower()
+
+    def attachment(self):
+        """
+        获取被绑定控件
+        :return: 被绑定控件
+        """
+        return self.attachment_
 
     def _scroll_vertical_handler(self, pos):
         # 计算目标纵坐标
         _, y = pos
         progress = y / (self.height() - self.scroll_bar_vertical.height())
-        target = - int(progress * (self.widget.height() - self.height()))
+        target = - int(progress * (self.attachment_.height() - self.height()))
 
         # 设置目标值并尝试启动
-        self.widget_scroll_animation.setTarget([self.widget.x(), target])
+        self.widget_scroll_animation.setTarget([self.attachment_.x(), target])
         self.widget_scroll_animation.try_to_start()
 
     def _scroll_horizontal_handler(self, pos):
         # 计算目标横坐标
         x, _ = pos
         progress = x / (self.width() - self.scroll_bar_horizontal.width())
-        target = - int(progress * (self.widget.width() - self.width()))
+        target = - int(progress * (self.attachment_.width() - self.width()))
 
         # 设置目标值并尝试启动
-        self.widget_scroll_animation.setTarget([target, self.widget.y()])
+        self.widget_scroll_animation.setTarget([target, self.attachment_.y()])
         self.widget_scroll_animation.try_to_start()
 
     def resizeEvent(self, event):
@@ -87,20 +94,20 @@ def resizeEvent(self, event):
 
         # 判断长宽是否超过自身的长宽，从而确定是否显示滚动条
         # 水平
-        if self.widget.width() <= self.width():
+        if self.attachment_.width() <= self.width():
             self.scroll_bar_horizontal.setVisible(False)
         else:
             self.scroll_bar_horizontal.setVisible(True)
 
         # 竖直
-        if self.widget.height() <= self.height():
+        if self.attachment_.height() <= self.height():
             self.scroll_bar_vertical.setVisible(False)
         else:
             self.scroll_bar_vertical.setVisible(True)
 
         # 根据滚动区域的大小和子控件的大小，计算出滚动条的长度或宽度
-        self.scroll_bar_horizontal.resize(self.width() * self.width() // self.widget.width(), 8)
-        self.scroll_bar_vertical.resize(8, self.height() * self.height() // self.widget.height())
+        self.scroll_bar_horizontal.resize(self.width() * self.width() // self.attachment_.width(), 8)
+        self.scroll_bar_vertical.resize(8, self.height() * self.height() // self.attachment_.height())
 
         # 设置拖动限制
         self.scroll_bar_horizontal.setMoveLimits(0, 0, self.width(), 8)
@@ -118,11 +125,11 @@ def wheelEvent(self, event):
 
         # 根据滚动方向，目标值加或减滚动强度，并更新目标值
         target[1] += strength if event.angleDelta().y() > 0 else -strength
-        target[1] = min(0, max(self.height() - self.widget.height(), target[1]))  # 防止滚出限制范围
+        target[1] = min(0, max(self.height() - self.attachment_.height(), target[1]))  # 防止滚出限制范围
         self.widget_scroll_animation.setTarget(target)
 
         # 计算滚动条的目标位置
-        process = -target[1] / (self.widget.height() - self.height())
+        process = -target[1] / (self.attachment_.height() - self.height())
         scroll_bar_vertical_target_y = int(process * (self.height() - self.scroll_bar_vertical.height()))
 
         # 如果竖直方向滚动条可见，尝试启动动画