본문 바로가기
프로그래밍/Python

[Python] PyWebView 옵션 정리!

by 곰 옥수수 2025. 2. 22.
728x90
반응형

 

 

Create_Window 옵션

webview.create_window(title, url=None, html=None, js_api=None, width=800, height=600,
                      x=None, y=None, screen=None, resizable=True, fullscreen=False,
                      min_size=(200, 100), hidden=False, frameless=False,
                      easy_drag=True, shadow=False, focus=True, minimized=False, maximized=False,
                      on_top=False, confirm_close=False, background_color='#FFFFFF',
                      transparent=False, text_select=False, zoomable=False,
                      draggable=False, server=http.BottleServer, server_args={},
                      localization=None)

 

 pywebview 창을 만들고 인스턴스를 반환합니다. 여러 창을 만드는 데 사용할 수 있습니다(Android 제외). GUI 루프가 시작될 때까지 창이 표시되지 않습니다. GUI 루프 중에 함수가 호출되면 창이 즉시 표시됩니다.

  • title- 창 제목
  • url-  웹 페이지 URL.
  • html- HTML 직접 전달 가능
  • js_api- Python과 JavaScript 간 API 연결
  • width- 창 너비. 기본값은 800px입니다.
  • height- 창 높이. 기본값은 600px입니다.
  • x- 창 x 좌표. 기본값은 중앙입니다.
  • y- 창 y 좌표. 기본값은 중앙입니다.
  • screen- 다중 모니터에서 실행할 화면
  • resizable- 창 크기 조정 가능 여부입니다. 기본값은 True입니다.
  • fullscreen- 전체 화면 모드로 시작합니다. 기본값은 False입니다.
  • min_size- 창의 최소 크기를 지정합니다. 기본값은 200x100입니다.
  • hidden- 기본적으로 숨겨진 창을 만듭니다. 기본값은 False입니다.
  • frameless- 프레임 없는 창을 만듭니다. 기본값은 False입니다.
  • easy_drag- 창을 쉽게 드래그할 수 있도록 설정 (frameless=True일 때 유용)할 수 있습니다.
    기본값은 True입니다. 
  • shadow- 창 그림자 추가. 기본값은 False입니다. Windows 전용 .
  • focus- False이면 초점을 맞출 수 없는 창을 만듭니다. 기본값은 True입니다.
  • minimized- 디스플레이 창 최소화
  • maximized- 디스플레이 창 최대화
  • on_top- 창을 항상 다른 창 위에 표시되도록 설정합니다. 기본값은 False입니다.
  • confirm_close- 창을 닫을 때 사용자에게 확인 메시지 표시할지 여부입니다. 기본값은 False입니다.
  • background_color- 창의 배경색입니다. 16진수 색상으로 지정됩니다. 기본값은 흰색입니다.
  • transparent- 투명 창을 만듭니다. Windows에서는 지원되지 않습니다. 기본값은 False입니다.
    이 설정은 창 크롬을 숨기거나 투명하게 만들지 않습니다.
    창 크롬을 숨기려면 framelessTrue로 설정합니다.
  • text_select- 문서 텍스트 선택을 활성화합니다. 기본값은 False입니다.
    요소별로 텍스트 선택을 제어하려면 user-select CSS 속성을 사용합니다.
  • zoomable- 문서 확대/축소를 활성화합니다. 기본값은 False입니다.
  • draggable- 이미지 및 링크 객체 끌기 활성화. 기본값은 False server=http.BottleServer, server_args
  • vibrancy- 창 진동을 활성화합니다. 기본값은 False입니다. macOS만 해당.
  • server- 이 창에 대한 사용자 정의 WSGI 서버 인스턴스. 기본값은 BottleServer입니다.
  • server_args- 서버 인스턴스화에 전달할 인수 사전
  • localization- 창별 현지화에 대한 현지화 사전을 전달합니다.

 

Webview Start 옵션

webview.start(func=None, args=None, localization={}, gui=None, debug=False,
              http_server=False, http_port=None, user_agent=None, private_mode=True,
              storage_path=None, menu=[], server=http.BottleServer, ssl=False,
              server_args={}, icon=None):

GUI 루프를 시작하고 이전에 생성된 창을 표시합니다. 이 함수는 메인 스레드에서 호출해야 합니다.

  • func- GUI 루프를 시작할 때 호출할 함수입니다.
  • args- 함수 인수. 단일 값 또는 값 튜플이 될 수 있습니다.
  • localization- 지역화된 문자열이 있는 사전. 기본 문자열과 키는 localization.py에 정의되어 있습니다.
  • gui- 특정 GUI를 강제로 적용합니다. 허용되는 값은 플랫폼에 따라 cef, qt또는 입니다. 자세한 내용은 웹 엔진을 참조하세요 
  • debug- 디버그 모드를 활성화합니다. 자세한 내용은 디버깅을 참조하세요 .
  • http_server- 절대 로컬 경로에 내장 HTTP 서버를 활성화합니다. 상대 경로의 경우 HTTP 서버가 자동으로 시작되며 비활성화할 수 없습니다. 각 창에 대해 별도의 HTTP 서버가 생성됩니다. 이 옵션은 로컬이 아닌 URL에 대해 무시됩니다.
  • http_port- HTTP 서버의 포트 번호를 지정합니다. 기본적으로 포트는 무작위입니다.
  • user_agent- 사용자 에이전트 문자열을 변경합니다.
  • private_mode- 쿠키와 기타 영구 객체가 세션 간에 저장되는지 여부를 제어합니다. 기본적으로 개인 모드가 켜져 있고 세션 간에는 아무것도 저장되지 않습니다.
  • storage_path- 쿠키 및 로컬 스토리지와 같은 영구 객체를 저장할 하드 드라이브의 선택적 위치입니다. 기본적으로 ~/.pywebview*nix 시스템과 %APPDATA%\pywebviewWindows에서 사용됩니다.
  • menu- Menu 객체 목록을 전달하여 애플리케이션 메뉴를 만듭니다. 사용 세부 정보는 이 예를 참조하세요.
  • server- 사용자 정의 WSGI 서버 인스턴스. 기본값은 BottleServer입니다.
  • ssl- 기본 BottleServer(현재는 GTK 백엔드)를 사용하는 경우 웹뷰와 내부 서버 간에 SSL 암호화를 사용합니다. cryptography사용하려면 pip 종속성이 설치되어 있어야 합니다 ssl. 기본적으로 설치되지 않습니다.
  • server_args- 서버 인스턴스화에 전달할 인수 사전
  • icon- 애플리케이션 아이콘 경로. GTK/QT에서만 사용 가능. 다른 플랫폼의 경우 아이콘은 번들러를 통해 지정해야 함.

 

 

API | pywebview

 

pywebview.flowrl.com

 

728x90
반응형

'프로그래밍 > Python' 카테고리의 다른 글

[Python] PyWebView 란? 특징 및 사용방법  (0) 2025.02.21

댓글