com.github.gwtbootstrap.client.ui.SimplePager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gwt-bootstrap Show documentation
A GWT Library that provides the widgets of Twitter Bootstrap.
The newest version!
/*
 * Copyright 2010 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.github.gwtbootstrap.client.ui;

import com.github.gwtbootstrap.client.ui.constants.ButtonType;
import com.github.gwtbootstrap.client.ui.constants.IconType;
import com.github.gwtbootstrap.client.ui.constants.Placement;
import com.google.gwt.core.client.GWT;
import com.google.gwt.event.dom.client.ClickEvent;
import com.google.gwt.event.dom.client.ClickHandler;
import com.google.gwt.i18n.client.Constants;
import com.google.gwt.i18n.client.LocalizableResource.DefaultLocale;
import com.google.gwt.i18n.client.NumberFormat;
import com.google.gwt.resources.client.ClientBundle;
import com.google.gwt.uibinder.client.UiConstructor;
import com.google.gwt.user.cellview.client.AbstractPager;
import com.google.gwt.user.cellview.client.SimplePager.Style;
import com.google.gwt.user.client.ui.HTML;
import com.google.gwt.user.client.ui.HasVerticalAlignment;
import com.google.gwt.user.client.ui.HorizontalPanel;
import com.google.gwt.view.client.HasRows;
import com.google.gwt.view.client.Range;

/**
 * A pager for controlling a {@link HasRows} that only supports simple page
 * navigation.
 *
 * 
 * 
Example
 *
 *  *   
 *   
 *     
 *   
 * 
 *
 * 
 */
public class SimplePager extends AbstractPager {

    /**
     * Constant for labeling the simple pager navigational {@link ImageButton}s
     */
    @DefaultLocale("en_US")
    public interface ImageButtonsConstants extends Constants {
        @DefaultStringValue("Fast forward")
        String fastForward();

        @DefaultStringValue("First page")
        String firstPage();

        @DefaultStringValue("Last page")
        String lastPage();

        @DefaultStringValue("Next page")
        String nextPage();

        @DefaultStringValue("Previous page")
        String prevPage();
    }

    /**
     * A ClientBundle that provides styles for this widget.
     */
    public static interface Resources extends ClientBundle {

        /**
         * The styles used in this widget.
         */
        @Source("GwtBootstrapSimplePager.css")
        Style simplePagerStyle();
    }

    /**
     * The location of the text relative to the paging buttons.
     */
    public static enum TextLocation {
        CENTER, LEFT, RIGHT;
    }

    private static final int DEFAULT_FAST_FORWARD_ROWS = 100;
    private static Resources DEFAULT_RESOURCES;

    private static Resources getDefaultResources() {
        if (DEFAULT_RESOURCES == null) {
            DEFAULT_RESOURCES = GWT.create(Resources.class);
        }
        return DEFAULT_RESOURCES;
    }

    private final int tooltipDelay = 1000;
    private final Placement tooltipPlacement = Placement.BOTTOM;

    private final Button fastForward;
    private final Tooltip fastForwardTooltip;

    private int fastForwardRows;

    private final Button firstPage;
    private final Tooltip firstPageTooltip;

    /**
     * We use an {@link HTML} so we can embed the loading image.
     */
    private final HTML label = new HTML();

    private final Button lastPage;
    private final Button nextPage;
    private final Button prevPage;

    private final Tooltip lastPageTooltip;
    private final Tooltip nextPageTooltip;
    private final Tooltip prevPageTooltip;

    /**
     * The {@link Resources} used by this widget.
     */
    private final Resources resources;

    /**
     * The {@link Style} used by this widget.
     */
    private final Style style;

    /**
     * Construct a {@link SimplePager} with the default text location.
     */
    public SimplePager() {
        this(TextLocation.CENTER);
    }

    /**
     * Construct a {@link SimplePager} with the specified text location.
     *
     * @param location
     *            the location of the text relative to the buttons
     */
    @UiConstructor
    // Hack for Google I/O demo
    public SimplePager(TextLocation location) {
        this(location, getDefaultResources(), true, DEFAULT_FAST_FORWARD_ROWS, false);
    }

    /**
     * Construct a {@link SimplePager} with the default resources, fast forward
     * rows and default image button names.
     *
     * @param location
     *            the location of the text relative to the buttons
     * @param showFastForwardButton
     *            if true, show a fast-forward button that advances by a larger
     *            increment than a single page
     * @param showLastPageButton
     *            if true, show a button to go the the last page
     */
    public SimplePager(TextLocation location, boolean showFastForwardButton, boolean showLastPageButton) {
        this(location, showFastForwardButton, DEFAULT_FAST_FORWARD_ROWS, showLastPageButton);
    }

    /**
     * Construct a {@link SimplePager} with the default resources and default
     * image button names.
     *
     * @param location
     *            the location of the text relative to the buttons
     * @param showFastForwardButton
     *            if true, show a fast-forward button that advances by a larger
     *            increment than a single page
     * @param fastForwardRows
     *            the number of rows to jump when fast forwarding
     * @param showLastPageButton
     *            if true, show a button to go the the last page
     */
    public SimplePager(TextLocation location, boolean showFastForwardButton, final int fastForwardRows, boolean showLastPageButton) {
        this(location, getDefaultResources(), showFastForwardButton, fastForwardRows, showLastPageButton);
    }

    /**
     * Construct a {@link SimplePager} with the specified resources.
     *
     * @param location
     *            the location of the text relative to the buttons
     * @param resources
     *            the {@link Resources} to use
     * @param showFastForwardButton
     *            if true, show a fast-forward button that advances by a larger
     *            increment than a single page
     * @param fastForwardRows
     *            the number of rows to jump when fast forwarding
     * @param showLastPageButton
     *            if true, show a button to go the the last page
     * @param imageButtonConstants
     *            Constants that contain the image button names
     */
    public SimplePager(TextLocation location, Resources resources, boolean showFastForwardButton, final int fastForwardRows, boolean showLastPageButton, ImageButtonsConstants imageButtonConstants) {
        this.resources = resources;
        this.fastForwardRows = fastForwardRows;
        this.style = this.resources.simplePagerStyle();
        this.style.ensureInjected();

        // Create the buttons.
        firstPage = new Button();
        firstPage.setType(ButtonType.LINK);
        firstPage.setIcon(IconType.FAST_BACKWARD);
        firstPage.addClickHandler(new ClickHandler() {
            @Override
            public void onClick(ClickEvent event) {
                firstPage();
            }
        });
        firstPageTooltip = new Tooltip(imageButtonConstants.firstPage());
        firstPageTooltip.setWidget(firstPage);
        firstPageTooltip.setPlacement(tooltipPlacement);
        firstPageTooltip.setShowDelay(tooltipDelay);

        nextPage = new Button();
        nextPage.setType(ButtonType.LINK);
        nextPage.setIcon(IconType.STEP_FORWARD);
        nextPage.addClickHandler(new ClickHandler() {
            @Override
            public void onClick(ClickEvent event) {
                nextPage();
            }
        });
        nextPageTooltip = new Tooltip(imageButtonConstants.nextPage());
        nextPageTooltip.setWidget(nextPage);
        nextPageTooltip.setPlacement(tooltipPlacement);
        nextPageTooltip.setShowDelay(tooltipDelay);

        prevPage = new Button();
        prevPage.setType(ButtonType.LINK);
        prevPage.setIcon(IconType.STEP_BACKWARD);
        prevPage.addClickHandler(new ClickHandler() {
            @Override
            public void onClick(ClickEvent event) {
                previousPage();
            }
        });
        prevPageTooltip = new Tooltip(imageButtonConstants.prevPage());
        prevPageTooltip.setWidget(prevPage);
        prevPageTooltip.setPlacement(tooltipPlacement);
        prevPageTooltip.setShowDelay(tooltipDelay);

        if (showLastPageButton) {
            lastPage = new Button();
            lastPage.setType(ButtonType.LINK);
            lastPage.setIcon(IconType.FAST_FORWARD);
            lastPage.addClickHandler(new ClickHandler() {
                @Override
                public void onClick(ClickEvent event) {
                    lastPage();
                }
            });
            lastPageTooltip = new Tooltip(imageButtonConstants.lastPage());
            lastPageTooltip.setWidget(lastPage);
            lastPageTooltip.setPlacement(tooltipPlacement);
            lastPageTooltip.setShowDelay(tooltipDelay);
        } else {
            lastPage = null;
            lastPageTooltip = null;
        }
        if (showFastForwardButton) {
            fastForward = new Button();
            fastForward.setType(ButtonType.LINK);
            fastForward.setIcon(IconType.FORWARD);
            fastForward.addClickHandler(new ClickHandler() {
                @Override
                public void onClick(ClickEvent event) {
                    setPage(getPage() + getFastForwardPages());
                }
            });
            fastForwardTooltip = new Tooltip(imageButtonConstants.fastForward());
            fastForwardTooltip.setWidget(fastForward);
            fastForwardTooltip.setPlacement(tooltipPlacement);
            fastForwardTooltip.setShowDelay(tooltipDelay);
        } else {
            fastForward = null;
            fastForwardTooltip = null;
        }

        // Construct the widget.
        HorizontalPanel layout = new HorizontalPanel();
        layout.setVerticalAlignment(HasVerticalAlignment.ALIGN_MIDDLE);
        initWidget(layout);
        if (location == TextLocation.LEFT) {
            layout.add(label);
        }
        layout.add(firstPage);
        layout.add(firstPageTooltip);
        layout.add(prevPage);
        layout.add(prevPageTooltip);
        if (location == TextLocation.CENTER) {
            layout.add(label);
        }
        layout.add(nextPage);
        layout.add(nextPageTooltip);
        if (showFastForwardButton) {
            layout.add(fastForward);
            layout.add(fastForwardTooltip);
        }
        if (showLastPageButton) {
            layout.add(lastPage);
            layout.add(lastPageTooltip);
        }

        if (location == TextLocation.RIGHT) {
            layout.add(label);
        }

        // Add style names to the cells.
        firstPage.getElement().getParentElement().addClassName(style.button());
        prevPage.getElement().getParentElement().addClassName(style.button());
        label.getElement().getParentElement().addClassName(style.pageDetails());
        nextPage.getElement().getParentElement().addClassName(style.button());
        if (showFastForwardButton) {
            fastForward.getElement().getParentElement().addClassName(style.button());
        }
        if (showLastPageButton) {
            lastPage.getElement().getParentElement().addClassName(style.button());
        }

        // Disable the buttons by default.
        setDisplay(null);
    }

    /**
     * Construct a {@link SimplePager} with the specified resources and default
     * image button names.
     *
     * @param location
     *            the location of the text relative to the buttons
     * @param resources
     *            the {@link Resources} to use
     * @param showFastForwardButton
     *            if true, show a fast-forward button that advances by a larger
     *            increment than a single page
     * @param fastForwardRows
     *            the number of rows to jump when fast forwarding
     * @param showLastPageButton
     *            if true, show a button to go the the last page
     */
    public SimplePager(TextLocation location, Resources resources, boolean showFastForwardButton, final int fastForwardRows, boolean showLastPageButton) {
        this(location, resources, showFastForwardButton, fastForwardRows, showLastPageButton, GWT. create(ImageButtonsConstants.class));
    }

    @Override
    public void firstPage() {
        super.firstPage();
    }

    @Override
    public int getPage() {
        return super.getPage();
    }

    @Override
    public int getPageCount() {
        return super.getPageCount();
    }

    @Override
    public boolean hasNextPage() {
        return super.hasNextPage();
    }

    @Override
    public boolean hasNextPages(int pages) {
        return super.hasNextPages(pages);
    }

    @Override
    public boolean hasPage(int index) {
        return super.hasPage(index);
    }

    @Override
    public boolean hasPreviousPage() {
        return super.hasPreviousPage();
    }

    @Override
    public boolean hasPreviousPages(int pages) {
        return super.hasPreviousPages(pages);
    }

    @Override
    public void lastPage() {
        super.lastPage();
    }

    @Override
    public void lastPageStart() {
        super.lastPageStart();
    }

    @Override
    public void nextPage() {
        super.nextPage();
    }

    @Override
    public void previousPage() {
        super.previousPage();
    }

    @Override
    public void setDisplay(HasRows display) {
        // Enable or disable all buttons.
        boolean disableButtons = (display == null);
        setFastForwardDisabled(disableButtons);
        setNextPageButtonsDisabled(disableButtons);
        setPrevPageButtonsDisabled(disableButtons);
        super.setDisplay(display);
    }

    @Override
    public void setPage(int index) {
        super.setPage(index);
    }

    @Override
    public void setPageSize(int pageSize) {
        super.setPageSize(pageSize);
    }

    @Override
    public void setPageStart(int index) {
        super.setPageStart(index);
    }

    /**
     * Let the page know that the table is loading. Call this method to clear
     * all data from the table and hide the current range when new data is being
     * loaded into the table.
     */
    public void startLoading() {
        getDisplay().setRowCount(0, true);
        label.setHTML("");
    }

    /**
     * Get the text to display in the pager that reflects the state of the
     * pager.
     *
     * @return the text
     */
    protected String createText() {
        // Default text is 1 based.
        NumberFormat formatter = NumberFormat.getFormat("#,###");
        HasRows display = getDisplay();
        Range range = display.getVisibleRange();
        int pageStart = range.getStart() + 1;
        int pageSize = range.getLength();
        int dataSize = display.getRowCount();
        int endIndex = Math.min(dataSize, pageStart + pageSize - 1);
        endIndex = Math.max(pageStart, endIndex);
        boolean exact = display.isRowCountExact();
        return formatter.format(pageStart) + "-" + formatter.format(endIndex) + (exact ? " of " : " of over ") + formatter.format(dataSize);
    }

    @Override
    protected void onRangeOrRowCountChanged() {
        HasRows display = getDisplay();
        label.setText(createText());

        // Update the prev and first buttons.
        setPrevPageButtonsDisabled(!hasPreviousPage());

        // Update the next and last buttons.
        if (isRangeLimited() || !display.isRowCountExact()) {
            setNextPageButtonsDisabled(!hasNextPage());
            setFastForwardDisabled(!hasNextPages(getFastForwardPages()));
        }
    }

    /**
     * Check if the next button is disabled. Visible for testing.
     */
    boolean isNextButtonDisabled() {
        return !nextPage.isEnabled();
    }

    /**
     * Check if the previous button is disabled. Visible for testing.
     */
    boolean isPreviousButtonDisabled() {
        return !prevPage.isEnabled();
    }

    /**
     * Get the number of pages to fast forward based on the current page size.
     *
     * @return the number of pages to fast forward
     */
    private int getFastForwardPages() {
        int pageSize = getPageSize();
        return pageSize > 0 ? fastForwardRows / pageSize : 0;
    }

    public int getFastForwardRows() {
        return fastForwardRows;
    }

    public void setFastForwardRows(int fastForwardRows) {
        this.fastForwardRows = fastForwardRows;
    }

    /**
     * Enable or disable the fast forward button.
     *
     * @param disabled
     *            true to disable, false to enable
     */
    private void setFastForwardDisabled(boolean disabled) {
        if (fastForward != null) {
            fastForward.setEnabled(!disabled);
            if (disabled) {
                fastForward.getElement().addClassName(style.disabledButton());
            } else {
                fastForward.getElement().removeClassName(style.disabledButton());
            }
        }
    }

    /**
     * Enable or disable the next page buttons.
     *
     * @param disabled
     *            true to disable, false to enable
     */
    private void setNextPageButtonsDisabled(boolean disabled) {
        nextPage.setEnabled(!disabled);
        if (disabled) {
            nextPage.getElement().addClassName(style.disabledButton());
        } else {
            nextPage.getElement().removeClassName(style.disabledButton());
        }
        if (lastPage != null) {
            lastPage.setEnabled(!disabled);
            if (disabled) {
                lastPage.getElement().addClassName(style.disabledButton());
            } else {
                lastPage.getElement().removeClassName(style.disabledButton());
            }
        }
    }

    /**
     * Enable or disable the previous page buttons.
     *
     * @param disabled
     *            true to disable, false to enable
     */
    private void setPrevPageButtonsDisabled(boolean disabled) {
        firstPage.setEnabled(!disabled);
        prevPage.setEnabled(!disabled);
        if (disabled) {
            firstPage.getElement().addClassName(style.disabledButton());
            prevPage.getElement().addClassName(style.disabledButton());
        } else {
            firstPage.getElement().removeClassName(style.disabledButton());
            prevPage.getElement().removeClassName(style.disabledButton());
        }
    }
}