EiFUddlmZddlZddlmZddlmZmZmZm Z ddl m Z m Z ddl mZmZmZddlmZddlmZdd lmZdd lmZerdd lmZehd Zd ed<dZd ed<ddZ ddZ!GddZ" d ddZ#y)) annotationsN)Path) TYPE_CHECKINGFinalLiteralcast)runtimeurl_util) LayoutConfigvalidate_heightvalidate_width)StreamlitAPIException)IFrame)caching)gather_metrics)DeltaGenerator>.htm.html.xhtmlr_HTML_EXTENSIONSi_MAX_PATH_LENGTHct|tkDsd|vry t|jS#tt t f$rYywxYw)z5Check if obj is a file path, without throwing if not.`_ documentation on MDN. Examples -------- >>> import streamlit.components.v1 as components >>> >>> components.iframe("https://example.com", height=500) )src scrollingr(stretchwidthheightiframe layout_config IFrameProtomarshallr dg_enqueue)selfr/r4r5r0r( iframe_protor8s r r-zIframeMixin._iframeIs^N#}    % ,%)#/6S ww,mTTr*_htmlct}t||||t||nd||nd}|jj d||S)aW Display an HTML string in an iframe. To use this function, import it from the ``streamlit.components.v1`` module. If you want to insert HTML text into your app without an iframe, try ``st.html`` instead. .. deprecated:: ``st.components.v1.html`` is deprecated and will be removed in a future release. Please use ``st.iframe`` instead, which provides the same functionality with additional features like automatic content sizing and local file support. .. warning:: Using ``st.components.v1.html`` directly (instead of importing its module) is deprecated and will be disallowed in a later version. Parameters ---------- html : str The HTML string to embed in the iframe. width : int The width of the iframe in CSS pixels. By default, this is the app's default element width. height : int The height of the frame in CSS pixels. By default, this is ``150``. scrolling : bool Whether to allow scrolling in the iframe. If this ``False`` (default), Streamlit crops any content larger than the iframe and does not show a scrollbar. If this is ``True``, Streamlit shows a scrollbar when the content is larger than the iframe. tab_index : int or None Specifies how and if the iframe is sequentially focusable. Users typically use the ``Tab`` key for sequential focus navigation. This can be one of the following values: - ``None`` (default): Uses the browser's default behavior. - ``-1``: Removes the iframe from sequential navigation, but still allows it to be focused programmatically. - ``0``: Includes the iframe in sequential navigation in the order it appears in the document but after all elements with a positive ``tab_index``. - Positive integer: Includes the iframe in sequential navigation. Elements are navigated in ascending order of their positive ``tab_index``. For more information, see the `tabindex `_ documentation on MDN. Examples -------- >>> import streamlit.components.v1 as components >>> >>> components.html( >>> "

Oops!

" >>> ) )srcdocr0r(r1r2r3r6r7r9)r>htmlr4r5r0r(r?r8s r r@zIframeMixin._htmls^X#}    % ,%)#/6S ww,mTTr*r6r1content)r4r5r(ct|dt|dt}d}t|tr t |n|}t|tr,|j |||jj}nxtj|dr||_ nYt|r,|j |||jj}n"|jdr||_ n ||_d}d|_t!||||_|}|} |s|dk(rd}|dk(rd } t%|| } |jj'd || S) a Embed content in an iframe. ``st.iframe`` embeds external URLs, HTML content, or local files in an iframe. It auto-detects the input type and handles it appropriately. Parameters ---------- src : str or Path The content to embed. This can be one of the following: - **Absolute URL**: A URL starting with ``http://``, ``https://``, or ``data:``. The URL is loaded directly in the iframe. - **Relative URL**: A path starting with ``/``, such as ``/app/static/report.html``. Useful for referencing files served via Streamlit's `static file serving `_. - **Local file path**: A path to a local file, either as a string or ``Path`` object. HTML files (``.html``, ``.htm``, ``.xhtml``) are read and embedded directly. Other files (PDF, images, SVG, etc.) are uploaded to Streamlit's media storage and rendered using the browser's native viewer. - **HTML string**: If ``src`` doesn't match any of the above patterns, it's treated as raw HTML and embedded directly in the iframe. width : int, "stretch", or "content" The width of the iframe. This can be one of the following: - ``"stretch"`` (default): The iframe fills the width of its container. - ``"content"``: The iframe matches the width of its content. - An ``int``: A fixed width in CSS pixels. height : int, "stretch", or "content" The height of the iframe. This can be one of the following: - ``"content"`` (default): The iframe automatically sizes to match its content height. For HTML strings and local HTML files, Streamlit measures the content height. For external URLs and non-HTML files, this falls back to 400px due to cross-origin restrictions. - ``"stretch"``: The iframe fills the available vertical space. Works best inside containers with defined heights. - An ``int``: A fixed height in CSS pixels. tab_index : int or None Controls keyboard navigation focus. This can be one of the following: - ``None`` (default): Browser default behavior. - ``-1``: Removes from tab order but allows programmatic focus. - ``0``: Adds to tab order in document position. - Positive ``int``: Adds to tab order at specified priority. For more information, see the `tabindex `_ documentation on MDN. Examples -------- Embed an external website: >>> import streamlit as st >>> st.iframe("https://docs.streamlit.io", height=600) Embed HTML content directly: >>> import streamlit as st >>> st.iframe( ... ''' ... ...

This is embedded HTML.

... ''', ... height=100, ... ) Embed a local HTML file: >>> import streamlit as st >>> from pathlib import Path >>> st.iframe(Path("reports/dashboard.html"), height=800) T) allow_contentF)httphttpsdata)allowed_schemas/rDr1ir3r6r7)r r r:r$rstr_process_local_filer<_get_delta_path_strr is_urlr/r! startswithrBr0r)r(r r=) r>r/r4r5r(r? uses_srcdocsrc_streffective_widtheffective_heightr8s r r6zIframeMixin.iframesGz uD1d3"}  )d3#c( c4 22gtww'B'B'DK__W6O P&L  g 22gtww'B'B'DK   $&L ")L K!% I&  %.L " ! !"+"#& $?CST ww,mTTr*ct|}|jj}|tvr- t |d5}|j |_dddy t |d5}|j }dddtj|\} } tjrVtj j"j%| xsd|} t'j(|| xsd|| |_y d |_y #1swYyxYw#ttttf$r}td|d||d}~wwxYw#1swYxYw#tttf$r}td|d||d}~wwxYw) a.Process a local file for embedding in the iframe. Parameters ---------- proto : IFrameProto The proto to populate with src or srcdoc. file_path : str Path to the local file. coordinates : str The element coordinates for media file tracking. Returns ------- bool True if the file was embedded via srcdoc (HTML), False if via src (URL). Raises ------ StreamlitAPIException If the file cannot be read. zutf-8)encodingNzUnable to read file 'z': Trbzapplication/octet-streamF)rsuffixlowerropenreadrBFileNotFoundErrorPermissionErrorrUnicodeDecodeErrorr mimetypes guess_typer exists get_instancemedia_file_mgraddrsave_media_datar/) r>proto file_path coordinatespathrYfe file_datamimetype_file_urls r rMzIframeMixin._process_local_files2I""$ % % )g6,!#$668EL, i& %!FFH  % **95 ! >> ++-<<@@8A'A;H  # #8A'A; !EIEIE,""   ,+I;c!=   % %!?G< '' {#aS9  sd DD D E(E 9E DDDE0EE EEF*E<<Fctd|S)zGet our DeltaGenerator.r)r)r>s r r<zIframeMixin.dgs$d++r*)NNF) r/rLr4 int | Noner5rrr0r&r(rrreturnr) rCrLr4rrr5rrr0r&r(rrrsr) r/z str | Pathr4#int | Literal['stretch', 'content']r5rtr(rrrsr)rgr:rhrLrirLrsr&)rsr) __name__ __module__ __qualname__rr-r@r6rMpropertyr<r*r r,r,HsI!! QU!%QU QUQU QU  QUQU QUQUfG!! VU!%VUVUVU VU  VUVU VUVUpH 6?6? $ KU KU3 KU 4 KU  KU KUKUZA A-0A?BA AF,,r*r,c`|||_|||_||_t||||_yy)aMarshalls data into an IFrame proto. These parameters correspond directly to