file_download class

Allows downloading of a file content.

See full documentation and examples for this control

Methods

__init__()

__init__(
    content=None,
    label=None,
    on_action=None,
    auto=False,
    render=True,
    bypass_preview=True,
    name=None,
    width=None,
    active=True,
    id=None,
    properties=None,
    class_name=None,
    hover_text=None,
) -> None

Create a new file_download element.

Parameters:

Name	Type	Description	Default
content	Union[path,file,URL,ReadableBuffer,None] dynamic	The content to transfer. If this is a string, a URL, or a file, then the content is read from this source. If a readable buffer is provided (such as an array of bytes...), and to prevent the bandwidth from being consumed too much, the way the data is transferred depends on the data_url_max_size parameter of the application configuration (which is set to 50kB by default): If the buffer size is smaller than this setting, then the raw content is generated as a data URL, encoded using base64 (i.e. "data:<mimetype>;base64,<data>"). If the buffer size exceeds this setting, then it is transferred through a temporary file. If this property is set to None, that indicates that dynamic content is generated. Please take a look at the examples below for more details on dynamic generation.	None
label	str dynamic	The label of the button.	None
on_action	Union[str, Callable]	A function or the name of a function that is triggered when the download is terminated (or on user action if content is None). This function is invoked with the following parameters: state (State): the state instance. id (str): the identifier of the button if it has one. payload (dict): the details on this callback's invocation. This dictionary has two keys: action: the name of the action that triggered this callback. args: a list of two elements: args[0] reflects the name property and args[1] holds the file URL.	None
auto	bool	If True, the download starts as soon as the page is loaded.	False
render	bool dynamic	If True, the control is displayed. If False, the control is not displayed.	True
bypass_preview	bool	If False, allows the browser to try to show the content in a different tab. The file download is always performed.	True
name	str	A name proposition for the file to save, that the user can change.	None
width	Union[str, int]	The width of the element.	None
active	bool dynamic	Indicates if this component is active. An inactive component allows no user interaction.	True
id	str	The identifier that is assigned to the rendered HTML component.	None
properties	dict[str, Any]	Bound to a dictionary that contains additional properties for this element.	None
class_name	str dynamic	The list of CSS class names that are associated with the generated HTML Element. These class names are added to the default taipy-file_download class name.	None
hover_text	str dynamic	The information that is displayed when the user hovers over this element.	None