OptButton Module

class epyk.core.html.options.OptButton.OptCheck(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)

class epyk.core.html.options.OptButton.OptCheckboxes(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)

property icon: The font-awesome icon reference.

class epyk.core.html.options.OptButton.OptMedia(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)

property autoplay

Set the autoplay flag.

Specifies that the video will start playing as soon as it is ready.

Usage:

:prop flag: Optional. Default value is true.

property controls

Specifies that video controls should be displayed (such as a play/pause button etc).

Related Pages:

https://www.w3schools.com/tags/tag_video.asp https://www.w3schools.com/tags/att_video_controls.asp

Prop bool:: Optional. Default value is false.

property loop

Specifies that the video will start over again, every time it is finished.

Related Pages:

https://www.w3schools.com/tags/tag_video.asp https://www.w3schools.com/tags/att_video_loop.asp

Prop bool:: Optional. Default value is false.

property muted

Specifies that the audio output of the video should be muted.

The muted attribute is a boolean attribute.

When present, it specifies that the audio output should be muted.

Related Pages:

https://www.w3schools.com/tags/tag_video.asp https://www.w3schools.com/tags/att_audio_muted.asp

Prop flag:: Optional. Default value is false.

property poster

Specifies an image to be shown while the video is downloading, or until the user hits the play button.

The poster attribute specifies an image to be shown while the video is downloading, or until the user hits the play button.

Related Pages:

https://www.w3schools.com/tags/tag_video.asp https://www.w3schools.com/tags/att_video_poster.asp

Prop url:: Url path for the image. Specifies the URL of the image file.

property preload

Specifies if and how the author thinks the video should be loaded when the page loads.

Related Pages:

https://www.w3schools.com/tags/tag_video.asp https://www.w3schools.com/tags/att_video_preload.asp

Prop value:: Optional. The preload attribute specifies if and how the author thinks that the video

should be loaded when the page loads.

class epyk.core.html.options.Options(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)

property builder

Add a JavaScript Builder function to the options.

This will be used to automatically map the Python component to its corresponding JavaScript builder function used by the build method.

Usage:

but = page.ui.button()
but.options.builder = "Button"

Prop value:: The JavaScript builder function name.

property config_default

The default value for the configuration in case of template.

Default value is an empty string.

Usage:

component.options.config_default = {"value": "test"}

config_html()

Return the HTML options used by the python and passed to the HTML.

Those options will not be available in the JavaScript layer and they are only defined either to build the HTML from Python or to set some HTML properties.

The returned dictionary is a copy so it can be changed or used in other processes. To change the internal component property, the options property should be used.

config_js(attrs: Optional[dict] = None)

Return the JavaScript options used by the builders functions.

Builder functions can be defined in the framework or external from the various packages.

The returned dictionary is a copy so it can be changed or used in other processes. To change the internal component property, the options property should be used.

Parameters:: attrs – Optional. The extra or overridden options

custom_config(name: str, value: Any, js_type: bool = False)

Add a custom JavaScript configuration.

Usage:

chart = page.ui.charts.apex.scatter()
chart.options.chart.zoom.custom_config("test", False)

Parameters:

name – The key to be added to the attributes
value – String or JString. The value of the defined attributes
js_type – Optional. Specify if the parameter is a JavaScript fragment

details()

Retrieve the defined properties details.

This function will return a dictionary with all the component attributes (required and optional) ones. It will provide the full available description of those components.

Usage:

but = page.ui.button()
pprint.pprint(but.options.details(), indent=4)

from_json(vals: dict, schema: Optional[dict] = None)

Load the option schema for a component from a json string.

TODO: add more feature to handle functions and enumeration

Parameters:

vals – The input schema
schema – The full object schema

has_attribute(cls_obj, name: Optional[str] = None)

Add an extra sub layer to the data structure.

The key in the object representation will be the function name.

Parameters:

cls_obj – Class. The sub data class used in the structure definition
name – The sub attribute name

isJsContent(property_name: str)

Check if the content of a property is defined to always be a JavaScript fragment.

Thus the framework will not convert it to a Json content.

Usage:

div = page.ui.div()
print(div.options.isJsContent("inline"))

Parameters:: property_name – The property name

property managed

Boolean flag to set if the component needs to be added to the page.

If set to False the component has to be managed manually in the page.

Usage:

but = page.ui.button()
but.options.managed = False

Prop bool:: Flag to specify if this component is automatically managed by the page

optional()

Return all options not added to the HTML component by default.

Those are options which will impact either the Python or the JavaScript builders.

To get the full definition of options the details method should be used.

Usage:

but = page.ui.button()
pprint.pprint(but.options.optional(), indent=4)

property profile

Boolean flag to set if extra logs need to be displayed.

This could help in debugging, default is the page verbose flag (default is false).

Usage:

but = page.ui.button()
but.options.verbose = True

Prop flag:: Flag to display / hide warning logs generated by the framework.

required()

Return all the mandatory / required options with the default values.

Those options are added by the framework to provide a default for the HTML components but they can be changed.

System options are also added to this category as they are always available in any HTML components.

To get the full definition of options the details method should be used.

Usage:

but = page.ui.button()
pprint.pprint(but.options.required(), indent=4)

set_attrs(vals: dict)

Set the object internal attributes.

Parameters:: vals – All the attributes to be added to the component

property style

Change some CSS attributes to the internal HTML component.

Related Pages:

https://www.w3schools.com/cssref/

Prop values:: The CSS attributes.

update_config(attrs: dict)

Update the option configuration.

Parameters:: attrs – The attributes to set

property verbose

Boolean flag to set if extra logs need to be displayed.

This could help in debugging, default is the page verbose flag (default is false).

Usage:

but = page.ui.button()
but.options.verbose = True

Prop flag:: Boolean. Flag to display / hide warning logs generated by the framework.

class epyk.core.html.options.OptButton.OptionsBadge(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)

class epyk.core.html.options.OptButton.OptionsButton(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)

property category: Button category to specify the style.

property group

Property to set the group name of a button.

Usage:

but = page.ui.button("Click Me")
but.options.group = "buttons"

Prop val:: String. The group name for several buttons.

property multiple

Property to define if multiple buttons can be selected at the same time. Default value is false.

Usage:

but = page.ui.button("Click Me")
but.options.multiple = False

Prop bool:: Boolean. To be used if multiple buttons are grouped.

class epyk.core.html.options.OptButton.OptionsButtonFilter(component: HtmlModel, attrs: Optional[dict] = None, options: Optional[dict] = None, js_tree: Optional[dict] = None, page: Optional[PageModel] = None)