(Widget) Language

Language Widget Options

Option	Type	Default	Description
label	string	"{lang[language_code]}-{lang[country_code]}"	The format string for the label.
label_alt	string	"{lang[full_name]}"	The alternative format string for the label. Useful for displaying the full language name.
update_interval	integer	5	The interval in seconds to update the language information. Must be between 1 and 3600.
callbacks	dict	{ 'on_left': 'toggle_label', 'on_middle': 'do_nothing', 'on_right': 'do_nothing' }	The dictionary of callback functions for different mouse actions.
animation	dict	{'enabled': True, 'type': 'fadeInOut', 'duration': 200}	Animation settings for the widget.
container_padding	dict	{'top': 0, 'left': 0, 'bottom': 0, 'right': 0}	Explicitly set padding inside widget container.
container_shadow	dict	None	Container shadow options.
label_shadow	dict	None	Label shadow options.
language_menu	dict	See below	Options for the language menu.

Callbacks

The callbacks option allows you to define custom actions for mouse events on the widget. The keys are:

• on_left: Action when the left mouse button is clicked.
• on_middle: Action when the middle mouse button is clicked.
• on_right: Action when the right mouse button is clicked.
• The values are the names of the callback functions that will be executed when the respective mouse button is clicked.
• toggle_label: A function to toggle the label between the main and alternative formats.
• toggle_menu: A function to toggle the visibility of the language selection menu.
• do_nothing: A placeholder function that does nothing when the mouse button is clicked.

Language Menu Configuration

The language_menu option allows you to configure the popup menu for language selection. It accepts the following keys:

Option	Type	Default	Description
blur	boolean	true	Enables a blur effect in the menu popup.
round_corners	boolean	true	If true, the menu has rounded corners.
round_corners_type	string	"normal"	Determines the corner style; allowed values are normal and small.
border_color	string	"system"	Sets the border color for the menu. Can be "system", None or HEX color.
alignment	string	"right"	Horizontal alignment of the menu relative to the widget (left, right, center).
direction	string	"down"	Direction in which the menu opens (down or up).
offset_top	integer	6	Vertical offset for fine positioning of the menu.
offset_left	integer	0	Horizontal offset for fine positioning of the menu.
layout_icon	string	"\uf11c"	Icon displayed next to layout names in the menu.
show_layout_icon	boolean	true	Whether to show the layout icon next to each language entry.

Example Configuration

language:
  type: "yasb.language.LanguageWidget"
  options:
    label: "{lang[language_code]}-{lang[country_code]}"
    label_alt: "{lang[full_name]}"
    update_interval: 5
    callbacks:
      on_left: "toggle_menu"
      on_middle: "do_nothing"
      on_right: "toggle_label"
    language_menu:
      blur: true
      round_corners: true
      round_corners_type: "normal"
      border_color: "system"
      alignment: "right"
      direction: "down"
      offset_top: 6
      offset_left: 0
      show_layout_icon: true
      layout_icon: "\uf11c"
    label_shadow:
      enabled: true
      color: "black"
      radius: 3
      offset: [ 1, 1 ]

Description of Options

• label: The format string for the label. You can use placeholders like {lang[language_code]}, {lang[country_code]}, {lang[full_name]}, {lang[native_country_name]}, {lang[native_lang_name]}, {lang[layout_name]}, {lang[full_layout_name]}, {lang[layout_country_name]}, {lang[iso_language_code]}.
• label_alt: The alternative format string for the label. Useful for displaying the full language name.
• update_interval: The interval in seconds to update the language information. Must be between 1 and 3600.
• callbacks: A dictionary specifying the callbacks for mouse events. The keys are on_left, on_middle, and on_right, and the values are the names of the callback functions.
• animation: A dictionary specifying the animation settings for the widget. It contains three keys: enabled, type, and duration. The type can be fadeInOut and the duration is the animation duration in milliseconds.
• container_padding: Explicitly set padding inside widget container. Use this option to set padding inside the widget container. You can set padding for top, left, bottom and right sides of the widget container.
• container_shadow: Container shadow options.
• label_shadow: Label shadow options.
• language_menu: A dictionary containing options for the language selection menu. It includes options like blur, round_corners, round_corners_type, border_color, alignment, direction, offset_top, offset_left, layout_icon, and show_layout_icon.

Example Style

.language-widget {}
.language-widget .widget-container {}
.language-widget .label {}
.language-widget .label.alt {}
.language-widget .icon {}
/* Language Menu */
.language-menu {}
.language-menu .header {}
.language-menu .footer {}
.language-menu .language-item {}
.language-menu .language-item.active {}
.language-menu .language-item .code {}
.language-menu .language-item .icon {}
.language-menu .language-item .name {}
.language-menu .language-item .layout {}

Example Style for Menu

.language-menu {
    background-color: rgba(17, 17, 27, 0.4);
    min-width: 300px;
}
.language-menu .header {
    font-family: 'Segoe UI';
    font-size: 14px;
    font-weight: 600;
    margin-bottom: 2px;
    padding: 12px;
    background-color: rgba(17, 17, 27, 0.6);
    border-bottom: 1px solid rgba(255, 255, 255, 0.1);
}
.language-menu .footer {
    font-family: 'Segoe UI';
    font-size: 12px;
    font-weight: 600;
    padding: 12px;
    margin-top: 2px;
    color: #9399b2;
    background-color: rgba(17, 17, 27, 0.6);
    border-top: 1px solid rgba(255, 255, 255, 0.1);
}
.language-menu .footer:hover {
    background-color: rgba(36, 36, 51, 0.6);
    color: #fff;
}
.language-menu .language-item {
    padding: 6px 12px;
    margin: 2px 4px;
}
.language-menu .language-item.active {
    background-color:rgba(255, 255, 255, 0.1);
    border-radius: 4px;
}
.language-menu .language-item:hover {
    background-color: rgba(255, 255, 255, 0.05);
}
.language-menu .language-item.active:hover {
    background-color:rgba(255, 255, 255, 0.1);
    border-radius: 4px;
}
.language-menu .language-item .code {
    font-weight: 900;
    font-size: 14px;
    min-width: 40px;
    text-transform: uppercase;
}
.language-menu .language-item .icon {
    font-size: 16px;
    margin-right: 8px;
    color: #fff;
}
.language-menu .language-item .name {
    font-weight: 600;
    font-family: 'Segoe UI';
    font-size: 14px;
}
.language-menu .language-item .layout {
    font-weight: 600;
    font-family: 'Segoe UI';
    font-size: 12px;
}

Preview of the Widget