Widget shows current keyboard layout short name (usually two letters, for example 'us', 'de'). Indicator will be hidden if only one layout configured. Layout can be switched either by clicking on widget or by function keyboardlayout.next_layout()
Aleksey Fedotov