Since 8.0.2



@MatchMedia({"mediaQuery1", "mediaQuery2"})


Target: method

Purpose: For Responsive Web Design (RWD). To identify a MatchMedia method that will be invoked when matched with a media query.

Note: Values of this annotation should be unique in each ViewModel, and have to follow the criteria listed in this media query's spec.

A ClientInfoEvent will be sent when the media query is matched, and we will be able to get the client's information by using ContextParam parameter. (see example line 5, line 8)

Other parameter annotations could also be used; please refer to subsections of Parameters for more information.


String windowWidth = "700px";
String applyTemplateName = "min501";

// getter setter

@MatchMedia("all and (max-width: 500px)")
public void max500(@ContextParam(ContextType.TRIGGER_EVENT) ClientInfoEvent event) {
    windowWidth = "100%";
    applyTemplateName = "max500"; //change a template
    int desktopWidth = event.getDesktopWidth(); // get the desktop width by the event
    // do something according to desktopWidth

@MatchMedia("all and (min-width: 501px)")
public void min501() {
    windowWidth = "700px";
    applyTemplateName = "min501"; //change a template
<div viewModel="@id('vm') @init('org.zkoss.VM')">
    <window width="@bind(vm.windowWidth)">
        <apply template="@bind(vm.applyTemplateName)"/>
<template name="min501">
    //zk components
<template name="max500">
    //zk components